{"id":697,"date":"2009-12-10T22:39:36","date_gmt":"2009-12-11T06:39:36","guid":{"rendered":"http:\/\/boost-spirit.com\/home\/?page_id=697"},"modified":"2009-12-15T07:49:11","modified_gmt":"2009-12-15T15:49:11","slug":"from-spirit-2-0-beta-to-spirit-2-1","status":"publish","type":"page","link":"http:\/\/boost-spirit.com\/home\/articles\/spirit2-1-release\/from-spirit-2-0-beta-to-spirit-2-1\/","title":{"rendered":"Porting Spirit 2.0 (beta) to Spirit 2.1"},"content":{"rendered":"

Spirit 2 has undergone lots of revisions from its inception to what you are seeing now. An early beta\u00a0 release, dubbed Spirit 2 beta, was included as part of Boost 1.39. The adventurous among you started using it as soon as it was released. Spirit 2.1 is essentially the same as Spirit2 beta apart from some cosmetic differences and QOI changes. For the sake of those who started using Spirit from 2.0 beta, here’s what’s changed:<\/p>\n

    \n
  1. Namespace spirit::arg_names ceased to exist. All the <\/span>placeholders (_0…_N, _r1…_rN, _val, _a…_j) are now in boost::spirit.<\/li>\n
  2. Components in boost::spirit that are used by qi (and karma) are hoisted <\/span>into qi and karma. So, you don’t have to <\/span>memorize which component lives in boost::spirit::qi (or karma) or the outer <\/span>boost::spirit namespace. Example:\n
    \r\nusing boost::spirit::qi::int_;\r\nusing boost::spirit::qi::lit;\r\nusing boost::spirit::qi::unused_type;\r\nusing boost::spirit::qi::_1;\r\nusing boost::spirit::qi::omit;\r\n<\/pre>\n<\/li>\n
  3. There are multiple versions of char_ and no_case in different <\/span>“char encoding” namespaces. For example, there is boost::spirit::ascii::char_ and boost::spirit::iso8859_1::char_.<\/li>\n
  4. wchar ceases to exist. Use standard_wide::char_ instead.<\/li>\n
  5. xxx(f) where xxx is a spirit parser and\u00a0 f is a callable function, is possible everywhere. <\/span>for example: char_(phoenix::var(ch)).<\/li>\n
  6. repeat, repeat(from, to), repeat(from, inf) is implemented.<\/li>\n
  7. All traits are in spirit::traits. There is no spirit::qi::traits.<\/li>\n
  8. Error handling now uses the spirit::info class instead of std::string <\/span>for the “what” part. There’s support for printing out the info <\/span>(i.e. operator<<) so, code should run as usual. spirit::info is <\/span>UTF8 savvy, with additional features to make it easy and more powerful to provide error messages.<\/li>\n
  9.  Changed parameter sequence of qi<\/span>::<\/span>phrase_parse<\/span><\/code>,         qi<\/span>::<\/span>phrase_match<\/span><\/code>, karma<\/span>::<\/span>generate_delimited<\/span><\/code>,         and match_delimited<\/span><\/code>. The         attribute is now always the last parameter.<\/li>\n<\/ol>\n
    The list above enumerates the most important changes you need to know in order to port your Spirit 2.0 beta code over to Spirit 2.1. There are more smaller details here and there. For more info see: What’s New<\/a>.<\/p>\n
    Share this:<\/h3>