EQ2EMu/EQ2/source/depends/boost_1_72_0/libs/metaparse/doc/one_char_except_c.qbk

[#one_char_except_c]
[section one_char_except_c]

[h1 Synopsis]

  template <char... Cs>
  struct one_char_except_c;

This is a [link parser parser].

[table Arguments
  [[Name]       [Type]]
  [[`Cs`]       [character values]]
]

[h1 Description]

`one_char_except_c` accepts one character except any of `Cs`. When the input is
empty or begins with one of the non-accepted characters, `one_char_except_c`
rejects the input. Otherwise it accepts the input and the result of parsing is
the character value.

On compilers, which are not C++11-compliant, the maximum number of characters
this class can have is the value the macro
`BOOST_METAPARSE_LIMIT_ONE_CHAR_EXCEPT_SIZE` expands to. Its default value is
10.

[h1 Header]

  #include <boost/metaparse/one_char_except_c.hpp>

[h1 Expression semantics]

For any `s` compile-time string and `c1`, ..., `cn` characters the following are
equivalent

  one_char_except_c<c1, ..., cn>::apply<s, pos>
  
  boost::metaparse::one_char::apply<s, pos>

when `s` is empty or it begins with a character other than `c1`, ..., `cn`.
Otherwise `one_char_except_c<c1, ..., cn>::appl<s, pos>` returns a parsing
error.

[h1 Example]

  #include <boost/metaparse/one_char_except_c.hpp>
  #include <boost/metaparse/lit_c.hpp>
  #include <boost/metaparse/middle_of.hpp>
  #include <boost/metaparse/repeated.hpp>
  #include <boost/metaparse/start.hpp>
  #include <boost/metaparse/string.hpp>
  #include <boost/metaparse/get_result.hpp>
  
  #include <boost/mpl/vector.hpp>
  #include <boost/mpl/char.hpp>
  #include <boost/mpl/equal.hpp>
  
  using namespace boost::metaparse;
  
  using string_literal_parser =
    middle_of<lit_c<'"'>, repeated<one_char_except_c<'"'>>, lit_c<'"'>>;
  
  static_assert(
    boost::mpl::equal<
      boost::mpl::vector<
        boost::mpl::char_<'h'>,
        boost::mpl::char_<'e'>,
        boost::mpl::char_<'l'>,
        boost::mpl::char_<'l'>,
        boost::mpl::char_<'o'>
      >,
      get_result<
        string_literal_parser::apply<BOOST_METAPARSE_STRING("\"hello\""), start>
      >::type
    >::type::value,
    "it should return the content of the string literal"
  );

[endsect]