Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: downloads/boost_1_34_1/libs/regex/doc/localisation.html @ 45

Last change on this file since 45 was 29, checked in by landauf, 17 years ago

updated boost from 1_33_1 to 1_34_1
File size: 39.3 KB
RevLine 
[29]1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<html>
3   <head>
4      <title>Boost.Regex: Localisation</title>
5      <meta name="generator" content="HTML Tidy, see www.w3.org">
6      <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
7      <link rel="stylesheet" type="text/css" href="../../../boost.css">
8   </head>
9   <body>
10      <p></p>
11      <table id="Table1" cellspacing="1" cellpadding="1" width="100%" border="0">
12         <tr>
13            <td valign="top" width="300">
14               <h3><a href="../../../index.htm"><img height="86" width="277" alt="C++ Boost" src="../../../boost.png" border="0"></a></h3>
15            </td>
16            <td width="353">
17               <h1 align="center">Boost.Regex</h1>
18               <h2 align="center">Localisation</h2>
19            </td>
20            <td width="50">
21               <h3><a href="index.html"><img height="45" width="43" alt="Boost.Regex Index" src="uarrow.gif" border="0"></a></h3>
22            </td>
23         </tr>
24      </table>
25      <br>
26      <br>
27      <hr>
28      <p>Boost.regex&nbsp;provides extensive support for run-time localization, the
29         localization model used can be split into two parts: front-end and back-end.</p>
30      <p>Front-end localization deals with everything which the user sees - error
31         messages, and the regular expression syntax itself. For example a French
32         application could change [[:word:]] to [[:mot:]] and \w to \m. Modifying the
33         front end locale requires active support from the developer, by providing the
34         library with a message catalogue to load, containing the localized strings.
35         Front-end locale is affected by the LC_MESSAGES category only.</p>
36      <p>Back-end localization deals with everything that occurs after the expression
37         has been parsed - in other words everything that the user does not see or
38         interact with directly. It deals with case conversion, collation, and character
39         class membership. The back-end locale does not require any intervention from
40         the developer - the library will acquire all the information it requires for
41         the current locale from the underlying operating system / run time library.
42         This means that if the program user does not interact with regular expressions
43         directly - for example if the expressions are embedded in your C++ code - then
44         no explicit localization is required, as the library will take care of
45         everything for you. For example embedding the expression [[:word:]]+ in your
46         code will always match a whole word, if the program is run on a machine with,
47         for example, a Greek locale, then it will still match a whole word, but in
48         Greek characters rather than Latin ones. The back-end locale is affected by the
49         LC_TYPE and LC_COLLATE categories.</p>
50      <p>There are three separate localization mechanisms supported by boost.regex:</p>
51      <h3>Win32 localization model.</h3>
52      <p>This is the default model when the library is compiled under Win32, and is
53         encapsulated by the traits class w32_regex_traits. When this model is in effect
54         each basic_regex object gets it's own LCID, by default this is the users
55         default setting as returned by GetUserDefaultLCID, but you can call <EM>imbue</EM>
56         on the basic_regex object to set it's locale to some other LCID if you wish.
57         All the settings used by boost.regex are acquired directly from the operating
58         system bypassing the C run time library. Front-end localization requires a
59         resource dll, containing a string table with the user-defined strings. The
60         traits class exports the function:</p>
61      <p>static std::string set_message_catalogue(const std::string&amp; s);</p>
62      <p>which needs to be called with a string identifying the name of the resource
63         dll, <i>before</i> your code compiles any regular expressions (but not
64         necessarily before you construct any <i>basic_regex</i> instances):</p>
65      <p>
66         boost::w32_regex_traits&lt;char&gt;::set_message_catalogue("mydll.dll");</p>
67      <p>
68         The library provides full Unicode support under NT, under Windows 9x the
69         library degrades gracefully - characters 0 to 255 are supported, the remainder
70         are treated as "unknown" graphic characters.</p>
71      <h3>C localization model.</h3>
72      <p>This model has been deprecated in favor of the C++ localoe for all non-Windows
73         compilers that support&nbsp;it.&nbsp; This locale is encapsulated by the traits
74         class <i>c_regex_traits</i>, Win32 users can force this model to take effect by
75         defining the pre-processor symbol BOOST_REGEX_USE_C_LOCALE. When this model is
76         in effect there is a single global locale, as set by <i>setlocale</i>. All
77         settings are acquired from your run time library, consequently Unicode support
78         is dependent upon your run time library implementation.</p>
79      <P>Front end localization is not supported.</P>
80      <P>Note that calling <i>setlocale</i> invalidates all compiled regular
81         expressions, calling <tt>setlocale(LC_ALL, "C")</tt> will make this library
82         behave equivalent to most traditional regular expression libraries including
83         version 1 of this library.</P>
84      <h3>C++ localization model.</h3>
85      <p>This model is the default for non-Windows compilers.</p>
86      <P>
87         When this model is in effect each instance of basic_regex&lt;&gt; has its own
88         instance of std::locale, class basic_regex&lt;&gt; also has a member function <i>imbue</i>
89         which allows the locale for the expression to be set on a per-instance basis.
90         Front end localization requires a POSIX message catalogue, which will be loaded
91         via the std::messages facet of the expression's locale, the traits class
92         exports the symbol:</P>
93      <p>static std::string set_message_catalogue(const std::string&amp; s);</p>
94      <p>which needs to be called with a string identifying the name of the message
95         catalogue, <i>before</i> your code compiles any regular expressions (but not
96         necessarily before you construct any <i>basic_regex</i> instances):</p>
97      <p>
98         boost::cpp_regex_traits&lt;char&gt;::set_message_catalogue("mycatalogue");</p>
99      <p>Note that calling basic_regex&lt;&gt;::imbue will invalidate any expression
100         currently compiled in that instance of basic_regex&lt;&gt;.</p>
101      <P>Finally note that if you build the library with a non-default localization
102         model, then the appropriate pre-processor symbol (BOOST_REGEX_USE_C_LOCALE or
103         BOOST_REGEX_USE_CPP_LOCALE) must be defined both when you build the support
104         library, and when you include &lt;boost/regex.hpp&gt; or
105         &lt;boost/cregex.hpp&gt; in your code. The best way to ensure this is to add
106         the #define to &lt;boost/regex/user.hpp&gt;.</P>
107      <h3>Providing a message catalogue:</h3>
108      <p>
109         In order to localize the front end of the library, you need to provide the
110         library with the appropriate message strings contained either in a resource
111         dll's string table (Win32 model), or a POSIX message catalogue (C++ models). In
112         the latter case the messages must appear in message set zero of the catalogue.
113         The messages and their id's are as follows:<br>
114         &nbsp;</p>
115      <p></p>
116      <table id="Table2" cellspacing="0" cellpadding="6" width="624" border="0">
117         <tr>
118            <td valign="top" width="8%">&nbsp;</td>
119            <td valign="top" width="21%">Message id</td>
120            <td valign="top" width="32%">Meaning</td>
121            <td valign="top" width="29%">Default value</td>
122            <td valign="top" width="9%">&nbsp;</td>
123         </tr>
124         <tr>
125            <td valign="top" width="8%">&nbsp;</td>
126            <td valign="top" width="21%">101</td>
127            <td valign="top" width="32%">The character used to start a sub-expression.</td>
128            <td valign="top" width="29%">"("</td>
129            <td valign="top" width="9%">&nbsp;</td>
130         </tr>
131         <tr>
132            <td valign="top" width="8%">&nbsp;</td>
133            <td valign="top" width="21%">102</td>
134            <td valign="top" width="32%">The character used to end a sub-expression
135               declaration.</td>
136            <td valign="top" width="29%">")"</td>
137            <td valign="top" width="9%">&nbsp;</td>
138         </tr>
139         <tr>
140            <td valign="top" width="8%">&nbsp;</td>
141            <td valign="top" width="21%">103</td>
142            <td valign="top" width="32%">The character used to denote an end of line
143               assertion.</td>
144            <td valign="top" width="29%">"$"</td>
145            <td valign="top" width="9%">&nbsp;</td>
146         </tr>
147         <tr>
148            <td valign="top" width="8%">&nbsp;</td>
149            <td valign="top" width="21%">104</td>
150            <td valign="top" width="32%">The character used to denote the start of line
151               assertion.</td>
152            <td valign="top" width="29%">"^"</td>
153            <td valign="top" width="9%">&nbsp;</td>
154         </tr>
155         <tr>
156            <td valign="top" width="8%">&nbsp;</td>
157            <td valign="top" width="21%">105</td>
158            <td valign="top" width="32%">The character used to denote the "match any character
159               expression".</td>
160            <td valign="top" width="29%">"."</td>
161            <td valign="top" width="9%">&nbsp;</td>
162         </tr>
163         <tr>
164            <td valign="top" width="8%">&nbsp;</td>
165            <td valign="top" width="21%">106</td>
166            <td valign="top" width="32%">The match zero or more times repetition operator.</td>
167            <td valign="top" width="29%">"*"</td>
168            <td valign="top" width="9%">&nbsp;</td>
169         </tr>
170         <tr>
171            <td valign="top" width="8%">&nbsp;</td>
172            <td valign="top" width="21%">107</td>
173            <td valign="top" width="32%">The match one or more repetition operator.</td>
174            <td valign="top" width="29%">"+"</td>
175            <td valign="top" width="9%">&nbsp;</td>
176         </tr>
177         <tr>
178            <td valign="top" width="8%">&nbsp;</td>
179            <td valign="top" width="21%">108</td>
180            <td valign="top" width="32%">The match zero or one repetition operator.</td>
181            <td valign="top" width="29%">"?"</td>
182            <td valign="top" width="9%">&nbsp;</td>
183         </tr>
184         <tr>
185            <td valign="top" width="8%">&nbsp;</td>
186            <td valign="top" width="21%">109</td>
187            <td valign="top" width="32%">The character set opening character.</td>
188            <td valign="top" width="29%">"["</td>
189            <td valign="top" width="9%">&nbsp;</td>
190         </tr>
191         <tr>
192            <td valign="top" width="8%">&nbsp;</td>
193            <td valign="top" width="21%">110</td>
194            <td valign="top" width="32%">The character set closing character.</td>
195            <td valign="top" width="29%">"]"</td>
196            <td valign="top" width="9%">&nbsp;</td>
197         </tr>
198         <tr>
199            <td valign="top" width="8%">&nbsp;</td>
200            <td valign="top" width="21%">111</td>
201            <td valign="top" width="32%">The alternation operator.</td>
202            <td valign="top" width="29%">"|"</td>
203            <td valign="top" width="9%">&nbsp;</td>
204         </tr>
205         <tr>
206            <td valign="top" width="8%">&nbsp;</td>
207            <td valign="top" width="21%">112</td>
208            <td valign="top" width="32%">The escape character.</td>
209            <td valign="top" width="29%">"\\"</td>
210            <td valign="top" width="9%">&nbsp;</td>
211         </tr>
212         <tr>
213            <td valign="top" width="8%">&nbsp;</td>
214            <td valign="top" width="21%">113</td>
215            <td valign="top" width="32%">The hash character (not currently used).</td>
216            <td valign="top" width="29%">"#"</td>
217            <td valign="top" width="9%">&nbsp;</td>
218         </tr>
219         <tr>
220            <td valign="top" width="8%">&nbsp;</td>
221            <td valign="top" width="21%">114</td>
222            <td valign="top" width="32%">The range operator.</td>
223            <td valign="top" width="29%">"-"</td>
224            <td valign="top" width="9%">&nbsp;</td>
225         </tr>
226         <tr>
227            <td valign="top" width="8%">&nbsp;</td>
228            <td valign="top" width="21%">115</td>
229            <td valign="top" width="32%">The repetition operator opening character.</td>
230            <td valign="top" width="29%">"{"</td>
231            <td valign="top" width="9%">&nbsp;</td>
232         </tr>
233         <tr>
234            <td valign="top" width="8%">&nbsp;</td>
235            <td valign="top" width="21%">116</td>
236            <td valign="top" width="32%">The repetition operator closing character.</td>
237            <td valign="top" width="29%">"}"</td>
238            <td valign="top" width="9%">&nbsp;</td>
239         </tr>
240         <tr>
241            <td valign="top" width="8%">&nbsp;</td>
242            <td valign="top" width="21%">117</td>
243            <td valign="top" width="32%">The digit characters.</td>
244            <td valign="top" width="29%">"0123456789"</td>
245            <td valign="top" width="9%">&nbsp;</td>
246         </tr>
247         <tr>
248            <td valign="top" width="8%">&nbsp;</td>
249            <td valign="top" width="21%">118</td>
250            <td valign="top" width="32%">The character which when preceded by an escape
251               character represents the word boundary assertion.</td>
252            <td valign="top" width="29%">"b"</td>
253            <td valign="top" width="9%">&nbsp;</td>
254         </tr>
255         <tr>
256            <td valign="top" width="8%">&nbsp;</td>
257            <td valign="top" width="21%">119</td>
258            <td valign="top" width="32%">The character which when preceded by an escape
259               character represents the non-word boundary assertion.</td>
260            <td valign="top" width="29%">"B"</td>
261            <td valign="top" width="9%">&nbsp;</td>
262         </tr>
263         <tr>
264            <td valign="top" width="8%">&nbsp;</td>
265            <td valign="top" width="21%">120</td>
266            <td valign="top" width="32%">The character which when preceded by an escape
267               character represents the word-start boundary assertion.</td>
268            <td valign="top" width="29%">"&lt;"</td>
269            <td valign="top" width="9%">&nbsp;</td>
270         </tr>
271         <tr>
272            <td valign="top" width="8%">&nbsp;</td>
273            <td valign="top" width="21%">121</td>
274            <td valign="top" width="32%">The character which when preceded by an escape
275               character represents the word-end boundary assertion.</td>
276            <td valign="top" width="29%">"&gt;"</td>
277            <td valign="top" width="9%">&nbsp;</td>
278         </tr>
279         <tr>
280            <td valign="top" width="8%">&nbsp;</td>
281            <td valign="top" width="21%">122</td>
282            <td valign="top" width="32%">The character which when preceded by an escape
283               character represents any word character.</td>
284            <td valign="top" width="29%">"w"</td>
285            <td valign="top" width="9%">&nbsp;</td>
286         </tr>
287         <tr>
288            <td valign="top" width="8%">&nbsp;</td>
289            <td valign="top" width="21%">123</td>
290            <td valign="top" width="32%">The character which when preceded by an escape
291               character represents a non-word character.</td>
292            <td valign="top" width="29%">"W"</td>
293            <td valign="top" width="9%">&nbsp;</td>
294         </tr>
295         <tr>
296            <td valign="top" width="8%">&nbsp;</td>
297            <td valign="top" width="21%">124</td>
298            <td valign="top" width="32%">The character which when preceded by an escape
299               character represents a start of buffer assertion.</td>
300            <td valign="top" width="29%">"`A"</td>
301            <td valign="top" width="9%">&nbsp;</td>
302         </tr>
303         <tr>
304            <td valign="top" width="8%">&nbsp;</td>
305            <td valign="top" width="21%">125</td>
306            <td valign="top" width="32%">The character which when preceded by an escape
307               character represents an end of buffer assertion.</td>
308            <td valign="top" width="29%">"'z"</td>
309            <td valign="top" width="9%">&nbsp;</td>
310         </tr>
311         <tr>
312            <td valign="top" width="8%">&nbsp;</td>
313            <td valign="top" width="21%">126</td>
314            <td valign="top" width="32%">The newline character.</td>
315            <td valign="top" width="29%">"\n"</td>
316            <td valign="top" width="9%">&nbsp;</td>
317         </tr>
318         <tr>
319            <td valign="top" width="8%">&nbsp;</td>
320            <td valign="top" width="21%">127</td>
321            <td valign="top" width="32%">The comma separator.</td>
322            <td valign="top" width="29%">","</td>
323            <td valign="top" width="9%">&nbsp;</td>
324         </tr>
325         <tr>
326            <td valign="top" width="8%">&nbsp;</td>
327            <td valign="top" width="21%">128</td>
328            <td valign="top" width="32%">The character which when preceded by an escape
329               character represents the bell character.</td>
330            <td valign="top" width="29%">"a"</td>
331            <td valign="top" width="9%">&nbsp;</td>
332         </tr>
333         <tr>
334            <td valign="top" width="8%">&nbsp;</td>
335            <td valign="top" width="21%">129</td>
336            <td valign="top" width="32%">The character which when preceded by an escape
337               character represents the form feed character.</td>
338            <td valign="top" width="29%">"f"</td>
339            <td valign="top" width="9%">&nbsp;</td>
340         </tr>
341         <tr>
342            <td valign="top" width="8%">&nbsp;</td>
343            <td valign="top" width="21%">130</td>
344            <td valign="top" width="32%">The character which when preceded by an escape
345               character represents the newline character.</td>
346            <td valign="top" width="29%">"n"</td>
347            <td valign="top" width="9%">&nbsp;</td>
348         </tr>
349         <tr>
350            <td valign="top" width="8%">&nbsp;</td>
351            <td valign="top" width="21%">131</td>
352            <td valign="top" width="32%">The character which when preceded by an escape
353               character represents the carriage return character.</td>
354            <td valign="top" width="29%">"r"</td>
355            <td valign="top" width="9%">&nbsp;</td>
356         </tr>
357         <tr>
358            <td valign="top" width="8%">&nbsp;</td>
359            <td valign="top" width="21%">132</td>
360            <td valign="top" width="32%">The character which when preceded by an escape
361               character represents the tab character.</td>
362            <td valign="top" width="29%">"t"</td>
363            <td valign="top" width="9%">&nbsp;</td>
364         </tr>
365         <tr>
366            <td valign="top" width="8%">&nbsp;</td>
367            <td valign="top" width="21%">133</td>
368            <td valign="top" width="32%">The character which when preceded by an escape
369               character represents the vertical tab character.</td>
370            <td valign="top" width="29%">"v"</td>
371            <td valign="top" width="9%">&nbsp;</td>
372         </tr>
373         <tr>
374            <td valign="top" width="8%">&nbsp;</td>
375            <td valign="top" width="21%">134</td>
376            <td valign="top" width="32%">The character which when preceded by an escape
377               character represents the start of a hexadecimal character constant.</td>
378            <td valign="top" width="29%">"x"</td>
379            <td valign="top" width="9%">&nbsp;</td>
380         </tr>
381         <tr>
382            <td valign="top" width="8%">&nbsp;</td>
383            <td valign="top" width="21%">135</td>
384            <td valign="top" width="32%">The character which when preceded by an escape
385               character represents the start of an ASCII escape character.</td>
386            <td valign="top" width="29%">"c"</td>
387            <td valign="top" width="9%">&nbsp;</td>
388         </tr>
389         <tr>
390            <td valign="top" width="8%">&nbsp;</td>
391            <td valign="top" width="21%">136</td>
392            <td valign="top" width="32%">The colon character.</td>
393            <td valign="top" width="29%">":"</td>
394            <td valign="top" width="9%">&nbsp;</td>
395         </tr>
396         <tr>
397            <td valign="top" width="8%">&nbsp;</td>
398            <td valign="top" width="21%">137</td>
399            <td valign="top" width="32%">The equals character.</td>
400            <td valign="top" width="29%">"="</td>
401            <td valign="top" width="9%">&nbsp;</td>
402         </tr>
403         <tr>
404            <td valign="top" width="8%">&nbsp;</td>
405            <td valign="top" width="21%">138</td>
406            <td valign="top" width="32%">The character which when preceded by an escape
407               character represents the ASCII escape character.</td>
408            <td valign="top" width="29%">"e"</td>
409            <td valign="top" width="9%">&nbsp;</td>
410         </tr>
411         <tr>
412            <td valign="top" width="8%">&nbsp;</td>
413            <td valign="top" width="21%">139</td>
414            <td valign="top" width="32%">The character which when preceded by an escape
415               character represents any lower case character.</td>
416            <td valign="top" width="29%">"l"</td>
417            <td valign="top" width="9%">&nbsp;</td>
418         </tr>
419         <tr>
420            <td valign="top" width="8%">&nbsp;</td>
421            <td valign="top" width="21%">140</td>
422            <td valign="top" width="32%">The character which when preceded by an escape
423               character represents any non-lower case character.</td>
424            <td valign="top" width="29%">"L"</td>
425            <td valign="top" width="9%">&nbsp;</td>
426         </tr>
427         <tr>
428            <td valign="top" width="8%">&nbsp;</td>
429            <td valign="top" width="21%">141</td>
430            <td valign="top" width="32%">The character which when preceded by an escape
431               character represents any upper case character.</td>
432            <td valign="top" width="29%">"u"</td>
433            <td valign="top" width="9%">&nbsp;</td>
434         </tr>
435         <tr>
436            <td valign="top" width="8%">&nbsp;</td>
437            <td valign="top" width="21%">142</td>
438            <td valign="top" width="32%">The character which when preceded by an escape
439               character represents any non-upper case character.</td>
440            <td valign="top" width="29%">"U"</td>
441            <td valign="top" width="9%">&nbsp;</td>
442         </tr>
443         <tr>
444            <td valign="top" width="8%">&nbsp;</td>
445            <td valign="top" width="21%">143</td>
446            <td valign="top" width="32%">The character which when preceded by an escape
447               character represents any space character.</td>
448            <td valign="top" width="29%">"s"</td>
449            <td valign="top" width="9%">&nbsp;</td>
450         </tr>
451         <tr>
452            <td valign="top" width="8%">&nbsp;</td>
453            <td valign="top" width="21%">144</td>
454            <td valign="top" width="32%">The character which when preceded by an escape
455               character represents any non-space character.</td>
456            <td valign="top" width="29%">"S"</td>
457            <td valign="top" width="9%">&nbsp;</td>
458         </tr>
459         <tr>
460            <td valign="top" width="8%">&nbsp;</td>
461            <td valign="top" width="21%">145</td>
462            <td valign="top" width="32%">The character which when preceded by an escape
463               character represents any digit character.</td>
464            <td valign="top" width="29%">"d"</td>
465            <td valign="top" width="9%">&nbsp;</td>
466         </tr>
467         <tr>
468            <td valign="top" width="8%">&nbsp;</td>
469            <td valign="top" width="21%">146</td>
470            <td valign="top" width="32%">The character which when preceded by an escape
471               character represents any non-digit character.</td>
472            <td valign="top" width="29%">"D"</td>
473            <td valign="top" width="9%">&nbsp;</td>
474         </tr>
475         <tr>
476            <td valign="top" width="8%">&nbsp;</td>
477            <td valign="top" width="21%">147</td>
478            <td valign="top" width="32%">The character which when preceded by an escape
479               character represents the end quote operator.</td>
480            <td valign="top" width="29%">"E"</td>
481            <td valign="top" width="9%">&nbsp;</td>
482         </tr>
483         <tr>
484            <td valign="top" width="8%">&nbsp;</td>
485            <td valign="top" width="21%">148</td>
486            <td valign="top" width="32%">The character which when preceded by an escape
487               character represents the start quote operator.</td>
488            <td valign="top" width="29%">"Q"</td>
489            <td valign="top" width="9%">&nbsp;</td>
490         </tr>
491         <tr>
492            <td valign="top" width="8%">&nbsp;</td>
493            <td valign="top" width="21%">149</td>
494            <td valign="top" width="32%">The character which when preceded by an escape
495               character represents a Unicode combining character sequence.</td>
496            <td valign="top" width="29%">"X"</td>
497            <td valign="top" width="9%">&nbsp;</td>
498         </tr>
499         <tr>
500            <td valign="top" width="8%">&nbsp;</td>
501            <td valign="top" width="21%">150</td>
502            <td valign="top" width="32%">The character which when preceded by an escape
503               character represents any single character.</td>
504            <td valign="top" width="29%">"C"</td>
505            <td valign="top" width="9%">&nbsp;</td>
506         </tr>
507         <tr>
508            <td valign="top" width="8%">&nbsp;</td>
509            <td valign="top" width="21%">151</td>
510            <td valign="top" width="32%">The character which when preceded by an escape
511               character represents end of buffer operator.</td>
512            <td valign="top" width="29%">"Z"</td>
513            <td valign="top" width="9%">&nbsp;</td>
514         </tr>
515         <tr>
516            <td valign="top" width="8%">&nbsp;</td>
517            <td valign="top" width="21%">152</td>
518            <td valign="top" width="32%">The character which when preceded by an escape
519               character represents the continuation assertion.</td>
520            <td valign="top" width="29%">"G"</td>
521            <td valign="top" width="9%">&nbsp;</td>
522         </tr>
523         <tr>
524            <td>&nbsp;</td>
525            <td>153</td>
526            <td>The character which when preceeded by (? indicates a zero width negated
527               forward lookahead assert.</td>
528            <td>!</td>
529            <td>&nbsp;</td>
530         </tr>
531      </table>
532      <br>
533      <br>
534      <p>Custom error messages are loaded as follows:&nbsp;</p>
535      <p></p>
536      <table id="Table3" cellspacing="0" cellpadding="7" width="624" border="0">
537         <tr>
538            <td valign="top" width="8%">&nbsp;</td>
539            <td valign="top" width="22%">Message ID</td>
540            <td valign="top" width="32%">Error message ID</td>
541            <td valign="top" width="31%">Default string</td>
542            <td valign="top" width="7%">&nbsp;</td>
543         </tr>
544         <tr>
545            <td valign="top" width="8%">&nbsp;</td>
546            <td valign="top" width="22%">201</td>
547            <td valign="top" width="32%">REG_NOMATCH</td>
548            <td valign="top" width="31%">"No match"</td>
549            <td valign="top" width="7%">&nbsp;</td>
550         </tr>
551         <tr>
552            <td valign="top" width="8%">&nbsp;</td>
553            <td valign="top" width="22%">202</td>
554            <td valign="top" width="32%">REG_BADPAT</td>
555            <td valign="top" width="31%">"Invalid regular expression"</td>
556            <td valign="top" width="7%">&nbsp;</td>
557         </tr>
558         <tr>
559            <td valign="top" width="8%">&nbsp;</td>
560            <td valign="top" width="22%">203</td>
561            <td valign="top" width="32%">REG_ECOLLATE</td>
562            <td valign="top" width="31%">"Invalid collation character"</td>
563            <td valign="top" width="7%">&nbsp;</td>
564         </tr>
565         <tr>
566            <td valign="top" width="8%">&nbsp;</td>
567            <td valign="top" width="22%">204</td>
568            <td valign="top" width="32%">REG_ECTYPE</td>
569            <td valign="top" width="31%">"Invalid character class name"</td>
570            <td valign="top" width="7%">&nbsp;</td>
571         </tr>
572         <tr>
573            <td valign="top" width="8%">&nbsp;</td>
574            <td valign="top" width="22%">205</td>
575            <td valign="top" width="32%">REG_EESCAPE</td>
576            <td valign="top" width="31%">"Trailing backslash"</td>
577            <td valign="top" width="7%">&nbsp;</td>
578         </tr>
579         <tr>
580            <td valign="top" width="8%">&nbsp;</td>
581            <td valign="top" width="22%">206</td>
582            <td valign="top" width="32%">REG_ESUBREG</td>
583            <td valign="top" width="31%">"Invalid back reference"</td>
584            <td valign="top" width="7%">&nbsp;</td>
585         </tr>
586         <tr>
587            <td valign="top" width="8%">&nbsp;</td>
588            <td valign="top" width="22%">207</td>
589            <td valign="top" width="32%">REG_EBRACK</td>
590            <td valign="top" width="31%">"Unmatched [ or [^"</td>
591            <td valign="top" width="7%">&nbsp;</td>
592         </tr>
593         <tr>
594            <td valign="top" width="8%">&nbsp;</td>
595            <td valign="top" width="22%">208</td>
596            <td valign="top" width="32%">REG_EPAREN</td>
597            <td valign="top" width="31%">"Unmatched ( or \\("</td>
598            <td valign="top" width="7%">&nbsp;</td>
599         </tr>
600         <tr>
601            <td valign="top" width="8%">&nbsp;</td>
602            <td valign="top" width="22%">209</td>
603            <td valign="top" width="32%">REG_EBRACE</td>
604            <td valign="top" width="31%">"Unmatched \\{"</td>
605            <td valign="top" width="7%">&nbsp;</td>
606         </tr>
607         <tr>
608            <td valign="top" width="8%">&nbsp;</td>
609            <td valign="top" width="22%">210</td>
610            <td valign="top" width="32%">REG_BADBR</td>
611            <td valign="top" width="31%">"Invalid content of \\{\\}"</td>
612            <td valign="top" width="7%">&nbsp;</td>
613         </tr>
614         <tr>
615            <td valign="top" width="8%">&nbsp;</td>
616            <td valign="top" width="22%">211</td>
617            <td valign="top" width="32%">REG_ERANGE</td>
618            <td valign="top" width="31%">"Invalid range end"</td>
619            <td valign="top" width="7%">&nbsp;</td>
620         </tr>
621         <tr>
622            <td valign="top" width="8%">&nbsp;</td>
623            <td valign="top" width="22%">212</td>
624            <td valign="top" width="32%">REG_ESPACE</td>
625            <td valign="top" width="31%">"Memory exhausted"</td>
626            <td valign="top" width="7%">&nbsp;</td>
627         </tr>
628         <tr>
629            <td valign="top" width="8%">&nbsp;</td>
630            <td valign="top" width="22%">213</td>
631            <td valign="top" width="32%">REG_BADRPT</td>
632            <td valign="top" width="31%">"Invalid preceding regular expression"</td>
633            <td valign="top" width="7%">&nbsp;</td>
634         </tr>
635         <tr>
636            <td valign="top" width="8%">&nbsp;</td>
637            <td valign="top" width="22%">214</td>
638            <td valign="top" width="32%">REG_EEND</td>
639            <td valign="top" width="31%">"Premature end of regular expression"</td>
640            <td valign="top" width="7%">&nbsp;</td>
641         </tr>
642         <tr>
643            <td valign="top" width="8%">&nbsp;</td>
644            <td valign="top" width="22%">215</td>
645            <td valign="top" width="32%">REG_ESIZE</td>
646            <td valign="top" width="31%">"Regular expression too big"</td>
647            <td valign="top" width="7%">&nbsp;</td>
648         </tr>
649         <tr>
650            <td valign="top" width="8%">&nbsp;</td>
651            <td valign="top" width="22%">216</td>
652            <td valign="top" width="32%">REG_ERPAREN</td>
653            <td valign="top" width="31%">"Unmatched ) or \\)"</td>
654            <td valign="top" width="7%">&nbsp;</td>
655         </tr>
656         <tr>
657            <td valign="top" width="8%">&nbsp;</td>
658            <td valign="top" width="22%">217</td>
659            <td valign="top" width="32%">REG_EMPTY</td>
660            <td valign="top" width="31%">"Empty expression"</td>
661            <td valign="top" width="7%">&nbsp;</td>
662         </tr>
663         <tr>
664            <td valign="top" width="8%">&nbsp;</td>
665            <td valign="top" width="22%">218</td>
666            <td valign="top" width="32%">REG_E_UNKNOWN</td>
667            <td valign="top" width="31%">"Unknown error"</td>
668            <td valign="top" width="7%">&nbsp;</td>
669         </tr>
670      </table>
671      <br>
672      <br>
673      <p>Custom character class names are loaded as followed:&nbsp;</p>
674      <p></p>
675      <table id="Table4" cellspacing="0" cellpadding="7" width="624" border="0">
676         <tr>
677            <td valign="top" width="8%">&nbsp;</td>
678            <td valign="top" width="22%">Message ID</td>
679            <td valign="top" width="32%">Description</td>
680            <td valign="top" width="31%">Equivalent default class name</td>
681            <td valign="top" width="7%">&nbsp;</td>
682         </tr>
683         <tr>
684            <td valign="top" width="8%">&nbsp;</td>
685            <td valign="top" width="22%">300</td>
686            <td valign="top" width="32%">The character class name for alphanumeric characters.</td>
687            <td valign="top" width="31%">"alnum"</td>
688            <td valign="top" width="7%">&nbsp;</td>
689         </tr>
690         <tr>
691            <td valign="top" width="8%">&nbsp;</td>
692            <td valign="top" width="22%">301</td>
693            <td valign="top" width="32%">The character class name for alphabetic characters.</td>
694            <td valign="top" width="31%">"alpha"</td>
695            <td valign="top" width="7%">&nbsp;</td>
696         </tr>
697         <tr>
698            <td valign="top" width="8%">&nbsp;</td>
699            <td valign="top" width="22%">302</td>
700            <td valign="top" width="32%">The character class name for control characters.</td>
701            <td valign="top" width="31%">"cntrl"</td>
702            <td valign="top" width="7%">&nbsp;</td>
703         </tr>
704         <tr>
705            <td valign="top" width="8%">&nbsp;</td>
706            <td valign="top" width="22%">303</td>
707            <td valign="top" width="32%">The character class name for digit characters.</td>
708            <td valign="top" width="31%">"digit"</td>
709            <td valign="top" width="7%">&nbsp;</td>
710         </tr>
711         <tr>
712            <td valign="top" width="8%">&nbsp;</td>
713            <td valign="top" width="22%">304</td>
714            <td valign="top" width="32%">The character class name for graphics characters.</td>
715            <td valign="top" width="31%">"graph"</td>
716            <td valign="top" width="7%">&nbsp;</td>
717         </tr>
718         <tr>
719            <td valign="top" width="8%">&nbsp;</td>
720            <td valign="top" width="22%">305</td>
721            <td valign="top" width="32%">The character class name for lower case characters.</td>
722            <td valign="top" width="31%">"lower"</td>
723            <td valign="top" width="7%">&nbsp;</td>
724         </tr>
725         <tr>
726            <td valign="top" width="8%">&nbsp;</td>
727            <td valign="top" width="22%">306</td>
728            <td valign="top" width="32%">The character class name for printable characters.</td>
729            <td valign="top" width="31%">"print"</td>
730            <td valign="top" width="7%">&nbsp;</td>
731         </tr>
732         <tr>
733            <td valign="top" width="8%">&nbsp;</td>
734            <td valign="top" width="22%">307</td>
735            <td valign="top" width="32%">The character class name for punctuation characters.</td>
736            <td valign="top" width="31%">"punct"</td>
737            <td valign="top" width="7%">&nbsp;</td>
738         </tr>
739         <tr>
740            <td valign="top" width="8%">&nbsp;</td>
741            <td valign="top" width="22%">308</td>
742            <td valign="top" width="32%">The character class name for space characters.</td>
743            <td valign="top" width="31%">"space"</td>
744            <td valign="top" width="7%">&nbsp;</td>
745         </tr>
746         <tr>
747            <td valign="top" width="8%">&nbsp;</td>
748            <td valign="top" width="22%">309</td>
749            <td valign="top" width="32%">The character class name for upper case characters.</td>
750            <td valign="top" width="31%">"upper"</td>
751            <td valign="top" width="7%">&nbsp;</td>
752         </tr>
753         <tr>
754            <td valign="top" width="8%">&nbsp;</td>
755            <td valign="top" width="22%">310</td>
756            <td valign="top" width="32%">The character class name for hexadecimal characters.</td>
757            <td valign="top" width="31%">"xdigit"</td>
758            <td valign="top" width="7%">&nbsp;</td>
759         </tr>
760         <tr>
761            <td valign="top" width="8%">&nbsp;</td>
762            <td valign="top" width="22%">311</td>
763            <td valign="top" width="32%">The character class name for blank characters.</td>
764            <td valign="top" width="31%">"blank"</td>
765            <td valign="top" width="7%">&nbsp;</td>
766         </tr>
767         <tr>
768            <td valign="top" width="8%">&nbsp;</td>
769            <td valign="top" width="22%">312</td>
770            <td valign="top" width="32%">The character class name for word characters.</td>
771            <td valign="top" width="31%">"word"</td>
772            <td valign="top" width="7%">&nbsp;</td>
773         </tr>
774         <tr>
775            <td valign="top" width="8%">&nbsp;</td>
776            <td valign="top" width="22%">313</td>
777            <td valign="top" width="32%">The character class name for Unicode characters.</td>
778            <td valign="top" width="31%">"unicode"</td>
779            <td valign="top" width="7%">&nbsp;</td>
780         </tr>
781      </table>
782      <br>
783      <br>
784      <p>Finally, custom collating element names are loaded starting from message id
785         400, and terminating when the first load thereafter fails. Each message looks
786         something like: "tagname string" where <i>tagname</i> is the name used inside
787         [[.tagname.]] and <i>string</i> is the actual text of the collating element.
788         Note that the value of collating element [[.zero.]] is used for the conversion
789         of strings to numbers - if you replace this with another value then that will
790         be used for string parsing - for example use the Unicode character 0x0660 for
791         [[.zero.]] if you want to use Unicode Arabic-Indic digits in your regular
792         expressions in place of Latin digits.</p>
793      <p>Note that the POSIX defined names for character classes and collating elements
794         are always available - even if custom names are defined, in contrast, custom
795         error messages, and custom syntax messages replace the default ones.</p>
796      <p></p>
797      <hr>
798      <p>Revised&nbsp; 
799         <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan --> 
800         26 June 2004&nbsp; 
801         <!--webbot bot="Timestamp" endspan i-checksum="39359" --></p>
802      <p><i>© Copyright John Maddock&nbsp;1998-
803            <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%Y" startspan -->  2004<!--webbot bot="Timestamp" endspan i-checksum="39359" --></i></p>
804      <P><I>Use, modification and distribution are subject to the Boost Software License,
805            Version 1.0. (See accompanying file <A href="../../../LICENSE_1_0.txt">LICENSE_1_0.txt</A>
806            or copy at <A href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>)</I></P>
807   </body>
808</html>
Note: See TracBrowser for help on using the repository browser.