<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.15"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <title>libstdc++: std::regex_traits< _Ch_type > Class Template Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="navtree.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="resize.js"></script> <script type="text/javascript" src="navtreedata.js"></script> <script type="text/javascript" src="navtree.js"></script> <script type="text/javascript"> /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ $(document).ready(initResizable); /* @license-end */</script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td id="projectalign" style="padding-left: 0.5em;"> <div id="projectname">libstdc++ </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.15 --> </div><!-- top --> <div id="side-nav" class="ui-resizable side-nav-resizable"> <div id="nav-tree"> <div id="nav-tree-contents"> <div id="nav-sync" class="sync"></div> </div> </div> <div id="splitbar" style="-moz-user-select:none;" class="ui-resizable-handle"> </div> </div> <script type="text/javascript"> /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ $(document).ready(function(){initNavTree('a06696.html','');}); /* @license-end */ </script> <div id="doc-content"> <div class="header"> <div class="summary"> <a href="#pub-types">Public Types</a> | <a href="#pub-methods">Public Member Functions</a> | <a href="#pub-static-methods">Static Public Member Functions</a> | <a href="#pro-attribs">Protected Attributes</a> | <a href="a06693.html">List of all members</a> </div> <div class="headertitle"> <div class="title">std::regex_traits< _Ch_type > Class Template Reference<div class="ingroups"><a class="el" href="a01493.html">Regular Expressions</a></div></div> </div> </div><!--header--> <div class="contents"> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-types"></a> Public Types</h2></td></tr> <tr class="memitem:ac2077e4399fe9cdf54aa9d3d649db9f0"><td class="memItemLeft" align="right" valign="top"><a id="ac2077e4399fe9cdf54aa9d3d649db9f0"></a> typedef _RegexMask </td><td class="memItemRight" valign="bottom"><b>char_class_type</b></td></tr> <tr class="separator:ac2077e4399fe9cdf54aa9d3d649db9f0"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:afee189518231263bb10265e032dd3936"><td class="memItemLeft" align="right" valign="top"><a id="afee189518231263bb10265e032dd3936"></a> typedef _Ch_type </td><td class="memItemRight" valign="bottom"><b>char_type</b></td></tr> <tr class="separator:afee189518231263bb10265e032dd3936"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:abb1aa132e73bd22096bed3feccde6ce5"><td class="memItemLeft" align="right" valign="top"><a id="abb1aa132e73bd22096bed3feccde6ce5"></a> typedef <a class="el" href="a05816.html">std::locale</a> </td><td class="memItemRight" valign="bottom"><b>locale_type</b></td></tr> <tr class="separator:abb1aa132e73bd22096bed3feccde6ce5"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a72bc2015db893e95d14e302f71996e32"><td class="memItemLeft" align="right" valign="top"><a id="a72bc2015db893e95d14e302f71996e32"></a> typedef <a class="el" href="a04768.html">std::basic_string</a>< char_type > </td><td class="memItemRight" valign="bottom"><b>string_type</b></td></tr> <tr class="separator:a72bc2015db893e95d14e302f71996e32"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a> Public Member Functions</h2></td></tr> <tr class="memitem:a4db88d5c982e69fbd0202c02de2f714a"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a06696.html#a4db88d5c982e69fbd0202c02de2f714a">regex_traits</a> ()</td></tr> <tr class="separator:a4db88d5c982e69fbd0202c02de2f714a"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aca8761334621d52895e4518448b6773c"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a05816.html">locale_type</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="a06696.html#aca8761334621d52895e4518448b6773c">getloc</a> () const</td></tr> <tr class="separator:aca8761334621d52895e4518448b6773c"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ae1d71eed7ede0411f443426e1d0b781d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a05816.html">locale_type</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="a06696.html#ae1d71eed7ede0411f443426e1d0b781d">imbue</a> (<a class="el" href="a05816.html">locale_type</a> __loc)</td></tr> <tr class="separator:ae1d71eed7ede0411f443426e1d0b781d"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ad819d5f658133c4dd71c1fa5a7cb9031"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="a06696.html#ad819d5f658133c4dd71c1fa5a7cb9031">isctype</a> (_Ch_type __c, char_class_type __f) const</td></tr> <tr class="separator:ad819d5f658133c4dd71c1fa5a7cb9031"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ae475712d0d2b637992cfe799ea83d99c"><td class="memTemplParams" colspan="2">template<typename _Fwd_iter > </td></tr> <tr class="memitem:ae475712d0d2b637992cfe799ea83d99c"><td class="memTemplItemLeft" align="right" valign="top">char_class_type </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a06696.html#ae475712d0d2b637992cfe799ea83d99c">lookup_classname</a> (_Fwd_iter __first, _Fwd_iter __last, bool __icase=false) const</td></tr> <tr class="separator:ae475712d0d2b637992cfe799ea83d99c"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ac1a97012352a2ccef114895cfb08307c"><td class="memTemplParams" colspan="2">template<typename _Fwd_iter > </td></tr> <tr class="memitem:ac1a97012352a2ccef114895cfb08307c"><td class="memTemplItemLeft" align="right" valign="top"><a class="el" href="a04768.html">string_type</a> </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a06696.html#ac1a97012352a2ccef114895cfb08307c">lookup_collatename</a> (_Fwd_iter __first, _Fwd_iter __last) const</td></tr> <tr class="separator:ac1a97012352a2ccef114895cfb08307c"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:af4d286d995ec6ff200854960c15b78c8"><td class="memTemplParams" colspan="2">template<typename _Fwd_iter > </td></tr> <tr class="memitem:af4d286d995ec6ff200854960c15b78c8"><td class="memTemplItemLeft" align="right" valign="top"><a class="el" href="a04768.html">string_type</a> </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a06696.html#af4d286d995ec6ff200854960c15b78c8">transform</a> (_Fwd_iter __first, _Fwd_iter __last) const</td></tr> <tr class="separator:af4d286d995ec6ff200854960c15b78c8"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a31b5b84c5919d3fd0658cf8c18df0160"><td class="memTemplParams" colspan="2">template<typename _Fwd_iter > </td></tr> <tr class="memitem:a31b5b84c5919d3fd0658cf8c18df0160"><td class="memTemplItemLeft" align="right" valign="top"><a class="el" href="a04768.html">string_type</a> </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a06696.html#a31b5b84c5919d3fd0658cf8c18df0160">transform_primary</a> (_Fwd_iter __first, _Fwd_iter __last) const</td></tr> <tr class="separator:a31b5b84c5919d3fd0658cf8c18df0160"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a001a4c2c5d9b06d4cc7e9a83310255c4"><td class="memItemLeft" align="right" valign="top">char_type </td><td class="memItemRight" valign="bottom"><a class="el" href="a06696.html#a001a4c2c5d9b06d4cc7e9a83310255c4">translate</a> (char_type __c) const</td></tr> <tr class="separator:a001a4c2c5d9b06d4cc7e9a83310255c4"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aa92edaaafe63f2333dc9d1ce9167c0f3"><td class="memItemLeft" align="right" valign="top">char_type </td><td class="memItemRight" valign="bottom"><a class="el" href="a06696.html#aa92edaaafe63f2333dc9d1ce9167c0f3">translate_nocase</a> (char_type __c) const</td></tr> <tr class="separator:aa92edaaafe63f2333dc9d1ce9167c0f3"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a5b1afcb8b3cb7d323dfb6fc8db08310a"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a06696.html#a5b1afcb8b3cb7d323dfb6fc8db08310a">value</a> (_Ch_type __ch, int __radix) const</td></tr> <tr class="separator:a5b1afcb8b3cb7d323dfb6fc8db08310a"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-static-methods"></a> Static Public Member Functions</h2></td></tr> <tr class="memitem:a2d1679803ff038b130a3ac2d545da164"><td class="memItemLeft" align="right" valign="top">static std::size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="a06696.html#a2d1679803ff038b130a3ac2d545da164">length</a> (const char_type *__p)</td></tr> <tr class="separator:a2d1679803ff038b130a3ac2d545da164"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-attribs"></a> Protected Attributes</h2></td></tr> <tr class="memitem:ad896e8cedee3f35e35d7b196588c44e8"><td class="memItemLeft" align="right" valign="top"><a id="ad896e8cedee3f35e35d7b196588c44e8"></a> <a class="el" href="a05816.html">locale_type</a> </td><td class="memItemRight" valign="bottom"><b>_M_locale</b></td></tr> <tr class="separator:ad896e8cedee3f35e35d7b196588c44e8"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><h3>template<typename _Ch_type><br /> class std::regex_traits< _Ch_type ></h3> <p>Describes aspects of a regular expression. </p> <p>A regular expression traits class that satisfies the requirements of section [28.7].</p> <p>The class regex is parameterized around a set of related types and functions used to complete the definition of its semantics. This class satisfies the requirements of such a traits class. </p> <p class="definition">Definition at line <a class="el" href="a00464_source.html#l00081">81</a> of file <a class="el" href="a00464_source.html">regex.h</a>.</p> </div><h2 class="groupheader">Constructor & Destructor Documentation</h2> <a id="a4db88d5c982e69fbd0202c02de2f714a"></a> <h2 class="memtitle"><span class="permalink"><a href="#a4db88d5c982e69fbd0202c02de2f714a">◆ </a></span>regex_traits()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname"><a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::<a class="el" href="a06696.html">regex_traits</a> </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Constructs a default traits object. </p> <p class="definition">Definition at line <a class="el" href="a00464_source.html#l00158">158</a> of file <a class="el" href="a00464_source.html">regex.h</a>.</p> </div> </div> <h2 class="groupheader">Member Function Documentation</h2> <a id="aca8761334621d52895e4518448b6773c"></a> <h2 class="memtitle"><span class="permalink"><a href="#aca8761334621d52895e4518448b6773c">◆ </a></span>getloc()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname"><a class="el" href="a05816.html">locale_type</a> <a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::getloc </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Gets a copy of the current locale in use by the regex_traits object. </p> <p class="definition">Definition at line <a class="el" href="a00464_source.html#l00371">371</a> of file <a class="el" href="a00464_source.html">regex.h</a>.</p> </div> </div> <a id="ae1d71eed7ede0411f443426e1d0b781d"></a> <h2 class="memtitle"><span class="permalink"><a href="#ae1d71eed7ede0411f443426e1d0b781d">◆ </a></span>imbue()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname"><a class="el" href="a05816.html">locale_type</a> <a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::imbue </td> <td>(</td> <td class="paramtype"><a class="el" href="a05816.html">locale_type</a> </td> <td class="paramname"><em>__loc</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Imbues the regex_traits object with a copy of a new locale. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__loc</td><td>A locale.</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>a copy of the previous locale in use by the regex_traits object.</dd></dl> <dl class="section note"><dt>Note</dt><dd>Calling imbue with a different locale than the one currently in use invalidates all cached data held by *this. </dd></dl> <p class="definition">Definition at line <a class="el" href="a00464_source.html#l00360">360</a> of file <a class="el" href="a00464_source.html">regex.h</a>.</p> </div> </div> <a id="ad819d5f658133c4dd71c1fa5a7cb9031"></a> <h2 class="memtitle"><span class="permalink"><a href="#ad819d5f658133c4dd71c1fa5a7cb9031">◆ </a></span>isctype()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type> </div> <table class="memname"> <tr> <td class="memname">bool <a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::isctype </td> <td>(</td> <td class="paramtype">_Ch_type </td> <td class="paramname"><em>__c</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">char_class_type </td> <td class="paramname"><em>__f</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> const</td> </tr> </table> </div><div class="memdoc"> <p>Determines if <code>c</code> is a member of an identified class. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__c</td><td>a character. </td></tr> <tr><td class="paramname">__f</td><td>a class type (as returned from lookup_classname).</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>true if the character <code>__c</code> is a member of the classification represented by <code>__f</code>, false otherwise.</dd></dl> <dl class="exception"><dt>Exceptions</dt><dd> <table class="exception"> <tr><td class="paramname">std::bad_cast</td><td>if the current locale does not have a ctype facet. </td></tr> </table> </dd> </dl> <p class="definition">Definition at line <a class="el" href="a00467_source.html#l00327">327</a> of file <a class="el" href="a00467_source.html">regex.tcc</a>.</p> </div> </div> <a id="a2d1679803ff038b130a3ac2d545da164"></a> <h2 class="memtitle"><span class="permalink"><a href="#a2d1679803ff038b130a3ac2d545da164">◆ </a></span>length()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static std::size_t <a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::length </td> <td>(</td> <td class="paramtype">const char_type * </td> <td class="paramname"><em>__p</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Gives the length of a C-style string starting at <code>__p</code>. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__p</td><td>a pointer to the start of a character sequence.</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the number of characters between <code>*__p</code> and the first default-initialized value of type <code>char_type</code>. In other words, uses the C-string algorithm for determining the length of a sequence of characters. </dd></dl> <p class="definition">Definition at line <a class="el" href="a00464_source.html#l00171">171</a> of file <a class="el" href="a00464_source.html">regex.h</a>.</p> </div> </div> <a id="ae475712d0d2b637992cfe799ea83d99c"></a> <h2 class="memtitle"><span class="permalink"><a href="#ae475712d0d2b637992cfe799ea83d99c">◆ </a></span>lookup_classname()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type > </div> <div class="memtemplate"> template<typename _Fwd_iter > </div> <table class="memname"> <tr> <td class="memname"><a class="el" href="a06696.html">regex_traits</a>< _Ch_type >::char_class_type <a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::lookup_classname </td> <td>(</td> <td class="paramtype">_Fwd_iter </td> <td class="paramname"><em>__first</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">_Fwd_iter </td> <td class="paramname"><em>__last</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">bool </td> <td class="paramname"><em>__icase</em> = <code>false</code> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> const</td> </tr> </table> </div><div class="memdoc"> <p>Maps one or more characters to a named character classification. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__first</td><td>beginning of the character sequence. </td></tr> <tr><td class="paramname">__last</td><td>one-past-the-end of the character sequence. </td></tr> <tr><td class="paramname">__icase</td><td>ignores the case of the classification name.</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>an unspecified value that represents the character classification named by the character sequence designated by the iterator range [__first, __last). If <code>icase</code> is true, the returned mask identifies the classification regardless of the case of the characters to be matched (for example, [[:lower:]] is the same as [[:alpha:]]), otherwise a case-dependent classification is returned. The value returned shall be independent of the case of the characters in the character sequence. If the name is not recognized then returns a value that compares equal to 0.</dd></dl> <p>At least the following names (or their wide-character equivalent) are supported.</p><ul> <li>d</li> <li>w</li> <li>s</li> <li>alnum</li> <li>alpha</li> <li>blank</li> <li>cntrl</li> <li>digit</li> <li>graph</li> <li>lower</li> <li>print</li> <li>punct</li> <li>space</li> <li>upper</li> <li>xdigit </li> </ul> <p class="definition">Definition at line <a class="el" href="a00467_source.html#l00283">283</a> of file <a class="el" href="a00467_source.html">regex.tcc</a>.</p> </div> </div> <a id="ac1a97012352a2ccef114895cfb08307c"></a> <h2 class="memtitle"><span class="permalink"><a href="#ac1a97012352a2ccef114895cfb08307c">◆ </a></span>lookup_collatename()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type > </div> <div class="memtemplate"> template<typename _Fwd_iter > </div> <table class="memname"> <tr> <td class="memname"><a class="el" href="a06696.html">regex_traits</a>< _Ch_type >::<a class="el" href="a04768.html">string_type</a> <a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::lookup_collatename </td> <td>(</td> <td class="paramtype">_Fwd_iter </td> <td class="paramname"><em>__first</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">_Fwd_iter </td> <td class="paramname"><em>__last</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> const</td> </tr> </table> </div><div class="memdoc"> <p>Gets a collation element by name. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__first</td><td>beginning of the collation element name. </td></tr> <tr><td class="paramname">__last</td><td>one-past-the-end of the collation element name.</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>a sequence of one or more characters that represents the collating element consisting of the character sequence designated by the iterator range [__first, __last). Returns an empty string if the character sequence is not a valid collating element. </dd></dl> <p class="definition">Definition at line <a class="el" href="a00467_source.html#l00127">127</a> of file <a class="el" href="a00467_source.html">regex.tcc</a>.</p> </div> </div> <a id="af4d286d995ec6ff200854960c15b78c8"></a> <h2 class="memtitle"><span class="permalink"><a href="#af4d286d995ec6ff200854960c15b78c8">◆ </a></span>transform()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type> </div> <div class="memtemplate"> template<typename _Fwd_iter > </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname"><a class="el" href="a04768.html">string_type</a> <a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::transform </td> <td>(</td> <td class="paramtype">_Fwd_iter </td> <td class="paramname"><em>__first</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">_Fwd_iter </td> <td class="paramname"><em>__last</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Gets a sort key for a character sequence. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__first</td><td>beginning of the character sequence. </td></tr> <tr><td class="paramname">__last</td><td>one-past-the-end of the character sequence.</td></tr> </table> </dd> </dl> <p>Returns a sort key for the character sequence designated by the iterator range [F1, F2) such that if the character sequence [G1, G2) sorts before the character sequence [H1, H2) then v.transform(G1, G2) < v.transform(H1, H2).</p> <p>What this really does is provide a more efficient way to compare a string to multiple other strings in locales with fancy collation rules and equivalence classes.</p> <dl class="section return"><dt>Returns</dt><dd>a locale-specific sort key equivalent to the input range.</dd></dl> <dl class="exception"><dt>Exceptions</dt><dd> <table class="exception"> <tr><td class="paramname">std::bad_cast</td><td>if the current locale does not have a collate facet. </td></tr> </table> </dd> </dl> <p class="definition">Definition at line <a class="el" href="a00464_source.html#l00224">224</a> of file <a class="el" href="a00464_source.html">regex.h</a>.</p> <p class="reference">Referenced by <a class="el" href="a00464_source.html#l00248">std::regex_traits< _CharType >::transform_primary()</a>.</p> </div> </div> <a id="a31b5b84c5919d3fd0658cf8c18df0160"></a> <h2 class="memtitle"><span class="permalink"><a href="#a31b5b84c5919d3fd0658cf8c18df0160">◆ </a></span>transform_primary()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type> </div> <div class="memtemplate"> template<typename _Fwd_iter > </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname"><a class="el" href="a04768.html">string_type</a> <a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::transform_primary </td> <td>(</td> <td class="paramtype">_Fwd_iter </td> <td class="paramname"><em>__first</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">_Fwd_iter </td> <td class="paramname"><em>__last</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Gets a sort key for a character sequence, independent of case. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__first</td><td>beginning of the character sequence. </td></tr> <tr><td class="paramname">__last</td><td>one-past-the-end of the character sequence.</td></tr> </table> </dd> </dl> <p>Effects: if typeid(use_facet<collate<_Ch_type> >) == typeid(collate_byname<_Ch_type>) and the form of the sort key returned by collate_byname<_Ch_type>::transform(__first, __last) is known and can be converted into a primary sort key then returns that key, otherwise returns an empty string.</p> <dl class="todo"><dt><b><a class="el" href="a01457.html#_todo000002">Todo:</a></b></dt><dd>Implement this function correctly. </dd></dl> <p class="definition">Definition at line <a class="el" href="a00464_source.html#l00248">248</a> of file <a class="el" href="a00464_source.html">regex.h</a>.</p> </div> </div> <a id="a001a4c2c5d9b06d4cc7e9a83310255c4"></a> <h2 class="memtitle"><span class="permalink"><a href="#a001a4c2c5d9b06d4cc7e9a83310255c4">◆ </a></span>translate()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">char_type <a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::translate </td> <td>(</td> <td class="paramtype">char_type </td> <td class="paramname"><em>__c</em></td><td>)</td> <td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Performs the identity translation. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__c</td><td>A character to the locale-specific character set.</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>__c. </dd></dl> <p class="definition">Definition at line <a class="el" href="a00464_source.html#l00182">182</a> of file <a class="el" href="a00464_source.html">regex.h</a>.</p> </div> </div> <a id="aa92edaaafe63f2333dc9d1ce9167c0f3"></a> <h2 class="memtitle"><span class="permalink"><a href="#aa92edaaafe63f2333dc9d1ce9167c0f3">◆ </a></span>translate_nocase()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">char_type <a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::translate_nocase </td> <td>(</td> <td class="paramtype">char_type </td> <td class="paramname"><em>__c</em></td><td>)</td> <td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Translates a character into a case-insensitive equivalent. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__c</td><td>A character to the locale-specific character set.</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the locale-specific lower-case equivalent of __c. </dd></dl> <dl class="exception"><dt>Exceptions</dt><dd> <table class="exception"> <tr><td class="paramname">std::bad_cast</td><td>if the imbued locale does not support the ctype facet. </td></tr> </table> </dd> </dl> <p class="definition">Definition at line <a class="el" href="a00464_source.html#l00195">195</a> of file <a class="el" href="a00464_source.html">regex.h</a>.</p> </div> </div> <a id="a5b1afcb8b3cb7d323dfb6fc8db08310a"></a> <h2 class="memtitle"><span class="permalink"><a href="#a5b1afcb8b3cb7d323dfb6fc8db08310a">◆ </a></span>value()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Ch_type> </div> <table class="memname"> <tr> <td class="memname">int <a class="el" href="a06696.html">std::regex_traits</a>< _Ch_type >::value </td> <td>(</td> <td class="paramtype">_Ch_type </td> <td class="paramname"><em>__ch</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>__radix</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> const</td> </tr> </table> </div><div class="memdoc"> <p>Converts a digit to an int. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__ch</td><td>a character representing a digit. </td></tr> <tr><td class="paramname">__radix</td><td>the radix if the numeric conversion (limited to 8, 10, or 16).</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the value represented by the digit __ch in base radix if the character __ch is a valid digit in base radix; otherwise returns -1. </dd></dl> <p class="definition">Definition at line <a class="el" href="a00467_source.html#l00341">341</a> of file <a class="el" href="a00467_source.html">regex.tcc</a>.</p> </div> </div> <hr/>The documentation for this class was generated from the following files:<ul> <li><a class="el" href="a00464_source.html">regex.h</a></li> <li><a class="el" href="a00467_source.html">regex.tcc</a></li> </ul> </div><!-- contents --> </div><!-- doc-content --> <!-- start footer part --> <div id="nav-path" class="navpath"><!-- id is needed for treeview function! --> <ul> <li class="navelem"><a class="el" href="a01538.html">std</a></li><li class="navelem"><a class="el" href="a06696.html">regex_traits</a></li> <li class="footer">Generated by <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.15 </li> </ul> </div> </body> </html>