/Src/Dependencies/Boost/libs/regex/doc/html/boost_regex/unicode.html

http://hadesmem.googlecode.com/ · HTML · 85 lines · 85 code · 0 blank · 0 comment · 0 complexity · 7a2659a911aa2f0e9f22a8317f69dc28 MD5 · raw file 

    

  1. <html>
    2. 

  2. <head>
    3. 

  3. <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
    4. 

  4. <title>Unicode and Boost.Regex</title>
    5. 

  5. <link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
    6. 

  6. <meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
    7. 

  7. <link rel="home" href="../index.html" title="Boost.Regex">
    8. 

  8. <link rel="up" href="../index.html" title="Boost.Regex">
    9. 

  9. <link rel="prev" href="introduction_and_overview.html" title="Introduction and Overview">
    10. 

  10. <link rel="next" href="captures.html" title="Understanding Marked Sub-Expressions and Captures">
    11. 

  11. </head>
    12. 

  12. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
    13. 

  13. <table cellpadding="2" width="100%"><tr>
    14. 

  14. <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
    15. 

  15. <td align="center"><a href="../../../../../index.html">Home</a></td>
    16. 

  16. <td align="center"><a href="../../../../../libs/libraries.htm">Libraries</a></td>
    17. 

  17. <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
    18. 

  18. <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
    19. 

  19. <td align="center"><a href="../../../../../more/index.htm">More</a></td>
    20. 

  20. </tr></table>
    21. 

  21. <hr>
    22. 

  22. <div class="spirit-nav">
    23. 

  23. <a accesskey="p" href="introduction_and_overview.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="captures.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
    24. 

  24. </div>
    25. 

  25. <div class="section" lang="en">
    26. 

  26. <div class="titlepage"><div><div><h2 class="title" style="clear: both">
    27. 

  27. <a name="boost_regex.unicode"></a><a class="link" href="unicode.html" title="Unicode and Boost.Regex">Unicode and Boost.Regex</a>
    28. 

  28. </h2></div></div></div>
    29. 

  29. <p>
    30. 

  30.       There are two ways to use Boost.Regex with Unicode strings:
    31. 

  31.     </p>
    32. 

  32. <a name="boost_regex.unicode.rely_on_wchar_t"></a><h5>
    33. 

  33. <a name="id990200"></a>
    34. 

  34.       <a class="link" href="unicode.html#boost_regex.unicode.rely_on_wchar_t">Rely on wchar_t</a>
    35. 

  35.     </h5>
    36. 

  36. <p>
    37. 

  37.       If your platform's <code class="computeroutput"><span class="keyword">wchar_t</span></code> type
    38. 

  38.       can hold Unicode strings, and your platform's C/C++ runtime correctly handles
    39. 

  39.       wide character constants (when passed to <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">iswspace</span></code>
    40. 

  40.       <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">iswlower</span></code> etc), then you can use <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">wregex</span></code>
    41. 

  41.       to process Unicode. However, there are several disadvantages to this approach:
    42. 

  42.     </p>
    43. 

  43. <div class="itemizedlist"><ul type="disc">
    44. 

  44. <li>
    45. 

  45.           It's not portable: there's no guarantee on the width of <code class="computeroutput"><span class="keyword">wchar_t</span></code>,
    46. 

  46.           or even whether the runtime treats wide characters as Unicode at all, most
    47. 

  47.           Windows compilers do so, but many Unix systems do not.
    48. 

  48.         </li>
    49. 

  49. <li>
    50. 

  50.           There's no support for Unicode-specific character classes: <code class="computeroutput"><span class="special">[[:</span><span class="identifier">Nd</span><span class="special">:]]</span></code>, <code class="computeroutput"><span class="special">[[:</span><span class="identifier">Po</span><span class="special">:]]</span></code>
    51. 

  51.           etc.
    52. 

  52.         </li>
    53. 

  53. <li>
    54. 

  54.           You can only search strings that are encoded as sequences of wide characters,
    55. 

  55.           it is not possible to search UTF-8, or even UTF-16 on many platforms.
    56. 

  56.         </li>
    57. 

  57. </ul></div>
    58. 

  58. <a name="boost_regex.unicode.use_a_unicode_aware_regular_expression_type_"></a><h5>
    59. 

  59. <a name="id990328"></a>
    60. 

  60.       <a class="link" href="unicode.html#boost_regex.unicode.use_a_unicode_aware_regular_expression_type_">Use
    61. 

  61.       a Unicode Aware Regular Expression Type.</a>
    62. 

  62.     </h5>
    63. 

  63. <p>
    64. 

  64.       If you have the <a href="http://www.ibm.com/software/globalization/icu/" target="_top">ICU
    65. 

  65.       library</a>, then Boost.Regex can be <a class="link" href="install.html#boost_regex.install.building_with_unicode_and_icu_support">configured
    66. 

  66.       to make use of it</a>, and provide a distinct regular expression type (boost::u32regex),
    67. 

  67.       that supports both Unicode specific character properties, and the searching
    68. 

  68.       of text that is encoded in either UTF-8, UTF-16, or UTF-32. See: <a class="link" href="ref/non_std_strings/icu.html" title="Working With Unicode and ICU String Types">ICU
    69. 

  69.       string class support</a>.
    70. 

  70.     </p>
    71. 

  71. </div>
    72. 

  72. <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
    73. 

  73. <td align="left"></td>
    74. 

  74. <td align="right"><div class="copyright-footer">Copyright &#169; 1998 -2010 John Maddock<p>
    75. 

  75.         Distributed under the Boost Software License, Version 1.0. (See accompanying
    76. 

  76.         file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
    77. 

  77.       </p>
    78. 

  78. </div></td>
    79. 

  79. </tr></table>
    80. 

  80. <hr>
    81. 

  81. <div class="spirit-nav">
    82. 

  82. <a accesskey="p" href="introduction_and_overview.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="captures.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
    83. 

  83. </div>
    84. 

  84. </body>
    85. 

  85. </html>
    86.