Boost-Commit :

Date view	Thread view	Subject view	Author view

Subject: [Boost-commit] svn:boost r55592 - in trunk/libs/spirit/doc/html/spirit/qi: . reference string
From: hartmut.kaiser_at_[hidden]
Date: 2009-08-14 17:45:11

Author: hkaiser
Date: 2009-08-14 17:45:10 EDT (Fri, 14 Aug 2009)
New Revision: 55592
URL: http://svn.boost.org/trac/boost/changeset/55592

Log:
Spirit: delete old html files
Removed:
   trunk/libs/spirit/doc/html/spirit/qi/reference/char_.html
   trunk/libs/spirit/doc/html/spirit/qi/string.html
   trunk/libs/spirit/doc/html/spirit/qi/string/lit_string.html
   trunk/libs/spirit/doc/html/spirit/qi/string/symbols.html

Deleted: trunk/libs/spirit/doc/html/spirit/qi/reference/char_.html
==============================================================================
--- trunk/libs/spirit/doc/html/spirit/qi/reference/char_.html 2009-08-14 17:45:10 EDT (Fri, 14 Aug 2009)
+++ (empty file)
@@ -1,65 +0,0 @@
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>char_</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
-<link rel="home" href="../../../index.html" title="Spirit 2.1">
-<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="basics.html" title="Basics">
-<link rel="next" href="../string.html" title="String">
-</head>
-<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table cellpadding="2" width="100%"><tr>
-<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
-<td align="center">Home</td>
-<td align="center">Libraries</td>
-<td align="center">People</td>
-<td align="center">FAQ</td>
-<td align="center">More</td>
-</tr></table>
-<hr>
-<div class="spirit-nav">
-<a accesskey="p" href="basics.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../string.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
-</div>
-<div class="section" title="char_">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="spirit.qi.reference.char_"></a><a class="link" href="char_.html" title="char_">char_</a>
-</h4></div></div></div>
-<a name="spirit.qi.reference.char_.description"></a><h6>
-<a name="id1106045"></a>
- <a class="link" href="char_.html#spirit.qi.reference.char_.description">Description</a>
- </h6>
-
- The char_ parser matches any character.
- 
-<a name="spirit.qi.reference.char_.header"></a><h6>
-<a name="id1106063"></a>
- <a class="link" href="char_.html#spirit.qi.reference.char_.header">Header</a>
- </h6>
-<pre class="programlisting">#include <boost/spirit/home/qi/char/char.hpp> // main include
-#include <boost/spirit/include/qi_char.hpp> // or, forwarding header
-</pre>
-<a name="spirit.qi.reference.char_.module_headers"></a><h6>
-<a name="id1106192"></a>
- <a class="link" href="char_.html#spirit.qi.reference.char_.module_headers">Module Headers</a>
- </h6>
-
- Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
- 
-</div>
-<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
- de Guzman, Hartmut Kaiser
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
-</tr></table>
-<hr>
-<div class="spirit-nav">
-<a accesskey="p" href="basics.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../string.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
-</div>
-</body>
-</html>

Deleted: trunk/libs/spirit/doc/html/spirit/qi/string.html
==============================================================================
--- trunk/libs/spirit/doc/html/spirit/qi/string.html 2009-08-14 17:45:10 EDT (Fri, 14 Aug 2009)
+++ (empty file)
@@ -1,59 +0,0 @@
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>String</title>
-<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
-<link rel="home" href="../../index.html" title="Spirit 2.1">
-<link rel="up" href="../qi.html" title="Qi">
-<link rel="prev" href="reference/char_.html" title="char_">
-<link rel="next" href="string/lit_string.html" title="lit/string">
-</head>
-<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table cellpadding="2" width="100%"><tr>
-<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
-<td align="center">Home</td>
-<td align="center">Libraries</td>
-<td align="center">People</td>
-<td align="center">FAQ</td>
-<td align="center">More</td>
-</tr></table>
-<hr>
-<div class="spirit-nav">
-<a accesskey="p" href="reference/char_.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="string/lit_string.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
-</div>
-<div class="section" title="String">
-<div class="titlepage"><div><div><h3 class="title">
-<a name="spirit.qi.string"></a><a class="link" href="string.html" title="String">String</a>
-</h3></div></div></div>
-<div class="toc"><dl>
-<dt>lit/string</dt>
-<dt>symbols</dt>
-</dl></div>
-
- This module includes parsers for strings. Currently, this module includes
- the literal and string parsers and the symbol table.
- 
-<a name="spirit.qi.string.module_header"></a><h5>
-<a name="id1106230"></a>
- <a class="link" href="string.html#spirit.qi.string.module_header">Module Header</a>
- </h5>
-<pre class="programlisting">// forwards to <boost/spirit/home/qi/string.hpp>
-#include <boost/spirit/include/qi_string.hpp>
-</pre>
-</div>
-<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
- de Guzman, Hartmut Kaiser
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
-</tr></table>
-<hr>
-<div class="spirit-nav">
-<a accesskey="p" href="reference/char_.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="string/lit_string.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
-</div>
-</body>
-</html>

Deleted: trunk/libs/spirit/doc/html/spirit/qi/string/lit_string.html
==============================================================================
--- trunk/libs/spirit/doc/html/spirit/qi/string/lit_string.html 2009-08-14 17:45:10 EDT (Fri, 14 Aug 2009)
+++ (empty file)
@@ -1,451 +0,0 @@
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>lit/string</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
-<link rel="home" href="../../../index.html" title="Spirit 2.1">
-<link rel="up" href="../string.html" title="String">
-<link rel="prev" href="../string.html" title="String">
-<link rel="next" href="symbols.html" title="symbols">
-</head>
-<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table cellpadding="2" width="100%"><tr>
-<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
-<td align="center">Home</td>
-<td align="center">Libraries</td>
-<td align="center">People</td>
-<td align="center">FAQ</td>
-<td align="center">More</td>
-</tr></table>
-<hr>
-<div class="spirit-nav">
-<a accesskey="p" href="../string.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../string.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="symbols.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
-</div>
-<div class="section" title="lit/string">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="spirit.qi.string.lit_string"></a><a class="link" href="lit_string.html" title="lit/string">lit/string</a>
-</h4></div></div></div>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem">
-<code class="computeroutput">boost::spirit::lit</code>: generates a string parser (Same
- as <code class="computeroutput">boost::spirit::qi::lit</code>)
- </li>
-<li class="listitem">
-<code class="computeroutput">NS::string</code>: generates a string parser for
- the character encoding. <code class="computeroutput">NS</code>
- is a <a class="link" href="../reference/basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
- Encoding Namespace</a>.
- </li>
-</ul></div>
-<a name="spirit.qi.string.lit_string.description"></a><h6>
-<a name="id1106393"></a>
- <a class="link" href="lit_string.html#spirit.qi.string.lit_string.description">Description</a>
- </h6>
-
- The lit/string parser matches a string of characters. The lit/string parser
- is an implicit lexeme: the <code class="computeroutput">skip</code>
- parser is not applied in between characters of the string.
- 
-<a name="spirit.qi.string.lit_string.header"></a><h6>
-<a name="id1106417"></a>
- <a class="link" href="lit_string.html#spirit.qi.string.lit_string.header">Header</a>
- </h6>
-<pre class="programlisting">// forwards to <boost/spirit/home/qi/string/lit.hpp>
-#include <boost/spirit/include/qi_lit.hpp>
-</pre>
-
- Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
- 
-<a name="spirit.qi.string.lit_string.model_of"></a><h6>
-<a name="id1106491"></a>
- <a class="link" href="lit_string.html#spirit.qi.string.lit_string.model_of">Model of</a>
- </h6>
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <a class="link" href="../reference/parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
- 
-
- 
-</blockquote></div>
-<div class="variablelist" title="Notation">
-Notation
-<dl>
-<dt><code class="computeroutput">s</code></dt>
-<dd>
- A literal string, e.g. "Hello", or a pointer/reference to
- a null-terminated array of characters or a <code class="computeroutput">std::basic_string</code>.
- </dd>
-<dt><code class="computeroutput">fs</code></dt>
-<dd>
- A <a class="link" href="../reference/basics.html#spirit.qi.reference.basics.lazy_argument">Lazy Argument</a>
- that evaluates to a <code class="computeroutput">std::basic_string</code>
- or a pointer/reference to a null-terminated array of characters.
- </dd>
-<dt><code class="computeroutput">ns</code></dt>
-<dd>
- A <a class="link" href="../reference/basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
- Encoding Namespace</a>.
- </dd>
-</dl>
-</div>
-<a name="spirit.qi.string.lit_string.expression_semantics"></a><h6>
-<a name="id1106624"></a>
- <a class="link" href="lit_string.html#spirit.qi.string.lit_string.expression_semantics">Expression
- Semantics</a>
- </h6>
-
- Semantics of an expression is defined only where it differs from, or is
- not defined in <a class="link" href="../reference/parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
- 
-<div class="informaltable"><table class="table">
-<colgroup>
-<col>
-<col>
-</colgroup>
-<thead><tr>
-<th>
- 
- Expression
- 
- </th>
-<th>
- 
- Semantics
- 
- </th>
-</tr></thead>
-<tbody>
-<tr>
-<td>
- 
- <code class="computeroutput">s</code>
- 
- </td>
-<td>
- 
- Generate a string parser from a string, <code class="computeroutput">s</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">lit(s)</code>
- 
- </td>
-<td>
- 
- Generate a string parser from a string, <code class="computeroutput">s</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">ns::string(s)</code>
- 
- </td>
-<td>
- 
- Generate a string parser from a string, <code class="computeroutput">s</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">fs</code>
- 
- </td>
-<td>
- 
- Generate a string parser from a string, <code class="computeroutput">s</code>,
- returned by invoking <code class="computeroutput">fs</code>
- at parse time. See <a class="link" href="../reference/basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
- Argument</a>
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">lit(fs)</code>
- 
- </td>
-<td>
- 
- Generate a string parser from a string, <code class="computeroutput">s</code>,
- returned by invoking <code class="computeroutput">fs</code>
- at parse time. See <a class="link" href="../reference/basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
- Argument</a>
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">ns::string(fs)</code>
- 
- </td>
-<td>
- 
- Generate a string parser from a string, <code class="computeroutput">s</code>,
- returned by invoking <code class="computeroutput">fs</code>
- at parse time. See <a class="link" href="../reference/basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
- Argument</a>
- 
- </td>
-</tr>
-</tbody>
-</table></div>
-<a name="spirit.qi.string.lit_string.attributes"></a><h6>
-<a name="id1106972"></a>
- <a class="link" href="lit_string.html#spirit.qi.string.lit_string.attributes">Attributes</a>
- </h6>
-<div class="informaltable"><table class="table">
-<colgroup>
-<col>
-<col>
-</colgroup>
-<thead><tr>
-<th>
- 
- Expression
- 
- </th>
-<th>
- 
- Attribute
- 
- </th>
-</tr></thead>
-<tbody>
-<tr>
-<td>
- 
- <code class="computeroutput">s</code>
- 
- </td>
-<td>
- 
- <code class="computeroutput">unused</code>
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">lit(s)</code>
- 
- </td>
-<td>
- 
- <code class="computeroutput">unused</code>
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">ns::string(s)</code>
- 
- </td>
-<td>
- 
- <code class="computeroutput">std::basic_string<T></code>
- where <code class="computeroutput">T</code> is the
- underlying character type of <code class="computeroutput">s</code>
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">fs</code>
- 
- </td>
-<td>
- 
- <code class="computeroutput">std::basic_string<T></code>
- where <code class="computeroutput">T</code> is the
- underlying character type of <code class="computeroutput">s</code>
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">lit(fs)</code>
- 
- </td>
-<td>
- 
- <code class="computeroutput">std::basic_string<T></code>
- where <code class="computeroutput">T</code> is the
- underlying character type of <code class="computeroutput">s</code>
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">ns::string(fs)</code>
- 
- </td>
-<td>
- 
- <code class="computeroutput">std::basic_string<T></code>
- where <code class="computeroutput">T</code> is the
- underlying character type of <code class="computeroutput">s</code>
- 
- </td>
-</tr>
-</tbody>
-</table></div>
-<a name="spirit.qi.string.lit_string.complexity"></a><h6>
-<a name="id1107394"></a>
- <a class="link" href="lit_string.html#spirit.qi.string.lit_string.complexity">Complexity</a>
- </h6>
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- O(N)
- 
-
- 
-</blockquote></div>
-
- where <code class="computeroutput">N</code> is the number of
- characters in the string to be parsed.
- 
-<a name="spirit.qi.string.lit_string.example"></a><h6>
-<a name="id1107428"></a>
- <a class="link" href="lit_string.html#spirit.qi.string.lit_string.example">Example</a>
- </h6>
-
- Some includes:
- 
-
- 
-
-
-
-<pre class="programlisting">#include <boost/spirit/include/qi.hpp>
-#include <boost/spirit/include/phoenix_core.hpp>
-#include <boost/spirit/include/phoenix_operator.hpp>
-#include <iostream>
-#include <string>
-</pre>
-
- 
-
- 
-
- All code snippets below use this common test function:
- 
-
- 
-
-
-
-<pre class="programlisting">template <typename P>
-void test_parser(char const* input, P const& p)
-{
- std::string s(input);
- std::string::iterator f(s.begin());
- if (boost::spirit::qi::parse(f, s.end(), p))
- std::cout << "ok" << std::endl;
- else
- std::cout << "fail" << std::endl;
-}
-</pre>
-
- 
-
- 
-
- Some using declarations:
- 
-
- 
-
-
-
-<pre class="programlisting">using boost::spirit::qi::parse;
-using boost::spirit::qi::lit;
-using boost::spirit::ascii::string;
-</pre>
-
- 
-
- 
-
- Basic literals:
- 
-
- 
-
-
-
-<pre class="programlisting">test_parser("boost", "boost"); // plain literal
-test_parser("boost", lit("boost")); // explicit literal
-test_parser("boost", string("boost")); // ascii::string
-</pre>
-
- 
-
- 
-
- From a <code class="computeroutput">std::string</code>
- 
-
- 
-
-
-
-<pre class="programlisting">std::string s("boost");
-test_parser("boost", s); // direct
-test_parser("boost", lit(s)); // explicit
-test_parser("boost", string(s)); // ascii::string
-</pre>
-
- 
-
- 
-
- Lazy strings using Phoenix
- 
-
- 
-
-
-
-<pre class="programlisting">namespace phx = boost::phoenix;
-test_parser("boost", phx::val("boost")); // direct
-test_parser("boost", lit(phx::val("boost"))); // explicit
-test_parser("boost", string(phx::val("boost"))); // ascii::string
-</pre>
-
- 
-
- 
-</div>
-<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
- de Guzman, Hartmut Kaiser
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
-</tr></table>
-<hr>
-<div class="spirit-nav">
-<a accesskey="p" href="../string.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../string.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="symbols.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
-</div>
-</body>
-</html>

Deleted: trunk/libs/spirit/doc/html/spirit/qi/string/symbols.html
==============================================================================
--- trunk/libs/spirit/doc/html/spirit/qi/string/symbols.html 2009-08-14 17:45:10 EDT (Fri, 14 Aug 2009)
+++ (empty file)
@@ -1,532 +0,0 @@
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>symbols</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
-<link rel="home" href="../../../index.html" title="Spirit 2.1">
-<link rel="up" href="../string.html" title="String">
-<link rel="prev" href="lit_string.html" title="lit/string">
-<link rel="next" href="../../karma.html" title="Karma">
-</head>
-<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table cellpadding="2" width="100%"><tr>
-<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
-<td align="center">Home</td>
-<td align="center">Libraries</td>
-<td align="center">People</td>
-<td align="center">FAQ</td>
-<td align="center">More</td>
-</tr></table>
-<hr>
-<div class="spirit-nav">
-<a accesskey="p" href="lit_string.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../string.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../karma.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
-</div>
-<div class="section" title="symbols">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="spirit.qi.string.symbols"></a><a class="link" href="symbols.html" title="symbols">symbols</a>
-</h4></div></div></div>
-<a name="spirit.qi.string.symbols.description"></a><h6>
-<a name="id1110179"></a>
- <a class="link" href="symbols.html#spirit.qi.string.symbols.description">Description</a>
- </h6>
-
- This class <code class="computeroutput">symbols</code> implements
- a symbol table: an associative container (or map) of key-value pairs where
- the keys are strings. The <code class="computeroutput">symbols</code>
- class can work efficiently with 8, 16, 32 and even 64 bit characters.
- 
-
- Traditionally, symbol table management is maintained seperately outside
- the grammar through semantic actions. Contrary to standard practice, the
- Spirit symbol table class symbols is-a parser. An instance of which may
- be used anywhere in the grammar specification. It is an example of a dynamic
- parser. A dynamic parser is characterized by its ability to modify its
- behavior at run time. Initially, an empty symbols object matches nothing.
- At any time, symbols may be added, thus, dynamically altering its behavior.
- 
-<a name="spirit.qi.string.symbols.header"></a><h6>
-<a name="id1110213"></a>
- <a class="link" href="symbols.html#spirit.qi.string.symbols.header">Header</a>
- </h6>
-<pre class="programlisting">// forwards to <boost/spirit/home/qi/string/symbols.hpp>
-#include <boost/spirit/include/qi_symbols.hpp>
-</pre>
-
- Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
- 
-<a name="spirit.qi.string.symbols.synopsis"></a><h6>
-<a name="id1110288"></a>
- <a class="link" href="symbols.html#spirit.qi.string.symbols.synopsis">Synopsis</a>
- </h6>
-<pre class="programlisting">template <typename Char, typename T>
-struct symbols;
-</pre>
-<a name="spirit.qi.string.symbols.template_parameters"></a><h6>
-<a name="id1110353"></a>
- <a class="link" href="symbols.html#spirit.qi.string.symbols.template_parameters">Template parameters</a>
- </h6>
-<div class="informaltable"><table class="table">
-<colgroup>
-<col>
-<col>
-<col>
-</colgroup>
-<thead><tr>
-<th>
- 
- Parameter
- 
- </th>
-<th>
- 
- Description
- 
- </th>
-<th>
- 
- Default
- 
- </th>
-</tr></thead>
-<tbody>
-<tr>
-<td>
- 
- <code class="computeroutput">Char</code>
- 
- </td>
-<td>
- 
- The character type of the symbol strings.
- 
- </td>
-<td>
- 
- <code class="computeroutput">char</code>
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">T</code>
- 
- </td>
-<td>
- 
- The data type associated with each symbol.
- 
- </td>
-<td>
- 
- <code class="computeroutput">unused_type</code>
- 
- </td>
-</tr>
-</tbody>
-</table></div>
-<a name="spirit.qi.string.symbols.model_of"></a><h6>
-<a name="id1110480"></a>
- <a class="link" href="symbols.html#spirit.qi.string.symbols.model_of">Model of</a>
- </h6>
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <a class="link" href="../reference/parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
- 
-
- 
-</blockquote></div>
-<div class="variablelist" title="Notation">
-Notation
-<dl>
-<dt><code class="computeroutput">Sym</code></dt>
-<dd>
- A <code class="computeroutput">symbols</code> type.
- </dd>
-<dt><code class="computeroutput">Char</code></dt>
-<dd>
- A character type.
- </dd>
-<dt><code class="computeroutput">T</code></dt>
-<dd>
- A data type.
- </dd>
-<dt><code class="computeroutput">sym</code></dt>
-<dd>
- A <code class="computeroutput">symbols</code> object.
- </dd>
-<dt><code class="computeroutput">sym2</code></dt>
-<dd>
- Another <code class="computeroutput">symbols</code> object.
- </dd>
-<dt><code class="computeroutput">sseq</code></dt>
-<dd>
- An STL container
- of strings.
- </dd>
-<dt><code class="computeroutput">dseq</code></dt>
-<dd>
- An STL container
- of data with <code class="computeroutput">value_type</code>
- <code class="computeroutput">T</code>.
- </dd>
-<dt><code class="computeroutput">s1</code>...<code class="computeroutput">sN</code></dt>
-<dd>
- A literal string, e.g. "Hello", or a pointer/reference to
- a null-terminated array of characters or a <code class="computeroutput">std::basic_string</code>.
- </dd>
-<dt><code class="computeroutput">d1</code>...<code class="computeroutput">dN</code></dt>
-<dd>
- Objects of type <code class="computeroutput">T</code>.
- </dd>
-<dt><code class="computeroutput">f</code></dt>
-<dd>
- A callable function or function object.
- </dd>
-</dl>
-</div>
-<a name="spirit.qi.string.symbols.expression_semantics"></a><h6>
-<a name="id1110782"></a>
- <a class="link" href="symbols.html#spirit.qi.string.symbols.expression_semantics">Expression
- Semantics</a>
- </h6>
-
- Semantics of an expression is defined only where it differs from, or is
- not defined in <a class="link" href="../reference/parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
- 
-<div class="informaltable"><table class="table">
-<colgroup>
-<col>
-<col>
-</colgroup>
-<thead><tr>
-<th>
- 
- Expression
- 
- </th>
-<th>
- 
- Semantics
- 
- </th>
-</tr></thead>
-<tbody>
-<tr>
-<td>
- 
- <code class="computeroutput">Sym()</code>
- 
- </td>
-<td>
- 
- Construct an empty symbols.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">Sym(sym)</code>
- 
- </td>
-<td>
- 
- Copy construct a symbols from <code class="computeroutput">sym2</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">Sym(sseq)</code>
- 
- </td>
-<td>
- 
- Construct symbols from <code class="computeroutput">sseq</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">Sym(sseq)</code>
- 
- </td>
-<td>
- 
- Construct symbols from <code class="computeroutput">sseq</code>
- and <code class="computeroutput">dseq</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">sym =
- sym</code>
- 
- </td>
-<td>
- 
- Assign <code class="computeroutput">sym2</code> to
- <code class="computeroutput">sym</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">sym =
- s1,
- s2,...
- sN</code>
- 
- </td>
-<td>
- 
- Assigns one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) to <code class="computeroutput">sym</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">sym +=
- s1,
- s2,...
- sN</code>
- 
- </td>
-<td>
- 
- Adds one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) to <code class="computeroutput">sym</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">sym.add(s1)(s2)...(sN)</code>
- 
- </td>
-<td>
- 
- Adds one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) to <code class="computeroutput">sym</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">sym.add(s1,
- d1)(s2,
- d2)...(sN,
- dN)</code>
- 
- </td>
-<td>
- 
- Adds one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) with associated data (<code class="computeroutput">d1</code>...<code class="computeroutput">dN</code>)
- to <code class="computeroutput">sym</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">sym -=
- s1,
- s2,...
- sN</code>
- 
- </td>
-<td>
- 
- Remove one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) from <code class="computeroutput">sym</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">sym.remove(s1)(s2)...(sN)</code>
- 
- </td>
-<td>
- 
- Remove one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) from <code class="computeroutput">sym</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">sym.clear()</code>
- 
- </td>
-<td>
- 
- Erase all of the symbols in <code class="computeroutput">sym</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">sym.at(s)</code>
- 
- </td>
-<td>
- 
- Returns a reference to the object associated with symbol, <code class="computeroutput">s</code>. If <code class="computeroutput">sym</code>
- does not already contain such an object, <code class="computeroutput">at</code>
- inserts the default object <code class="computeroutput">T()</code>.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">sym.find(s)</code>
- 
- </td>
-<td>
- 
- Returns a pointer to the object associated with symbol, <code class="computeroutput">s</code>. If <code class="computeroutput">sym</code>
- does not already contain such an object, <code class="computeroutput">find</code>
- returns a null pointer.
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <code class="computeroutput">sym.for_each(f)</code>
- 
- </td>
-<td>
- 
- For each symbol in <code class="computeroutput">sym</code>,
- <code class="computeroutput">s</code>, a <code class="computeroutput">std::basic_string<Char></code>
- with associated data, <code class="computeroutput">d</code>,
- an object of type <code class="computeroutput">T</code>,
- invoke <code class="computeroutput">f(s,
- d)</code>.
- 
- </td>
-</tr>
-</tbody>
-</table></div>
-<a name="spirit.qi.string.symbols.attributes"></a><h6>
-<a name="id1111858"></a>
- <a class="link" href="symbols.html#spirit.qi.string.symbols.attributes">Attributes</a>
- </h6>
-
- The attribute of <code class="computeroutput">symbol<Char, T></code>
- is <code class="computeroutput">T</code>.
- 
-<a name="spirit.qi.string.symbols.example"></a><h6>
-<a name="id1111909"></a>
- <a class="link" href="symbols.html#spirit.qi.string.symbols.example">Example</a>
- </h6>
-
- Some includes:
- 
-
- 
-
-
-
-<pre class="programlisting">#include <boost/spirit/include/qi.hpp>
-#include <boost/spirit/include/phoenix_core.hpp>
-#include <boost/spirit/include/phoenix_operator.hpp>
-#include <iostream>
-#include <string>
-</pre>
-
- 
-
- 
-
- Our test function:
- 
-
- 
-
-
-
-<pre class="programlisting">template <typename P, typename T>
-void test_parser_attr(char const* input, P const& p, T& attr)
-{
- std::string s(input);
- std::string::iterator f(s.begin());
- if (boost::spirit::qi::parse(f, s.end(), p, attr))
- std::cout << "ok" << std::endl;
- else
- std::cout << "fail" << std::endl;
-}
-</pre>
-
- 
-
- 
-
- Some using declarations:
- 
-
- 
-
-
-
-<pre class="programlisting">using boost::spirit::qi::parse;
-using boost::spirit::qi::symbols;
-</pre>
-
- 
-
- 
-
- Symbols with data:
- 
-
- 
-
-
-
-<pre class="programlisting">symbols<char, int> sym;
-
-sym.add
- ("Apple", 1)
- ("Banana", 2)
- ("orange", 3)
-;
-
-int i;
-test_parser_attr("Banana", sym, i);
-std::cout << i << std::endl;
-</pre>
-
- 
-
- 
-</div>
-<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
- de Guzman, Hartmut Kaiser
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
-</tr></table>
-<hr>
-<div class="spirit-nav">
-<a accesskey="p" href="lit_string.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../string.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../karma.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
-</div>
-</body>
-</html>

Date view	Thread view	Subject view	Author view

Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk