<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://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.5"/>
<title>libstdc++: std::regex_traits< _Ch_type > Struct 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="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
$(window).load(resizeHeight);
</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 style="padding-left: 0.5em;">
<div id="projectname">libstdc++
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.5 -->
</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">
$(document).ready(function(){initNavTree('a00959.html','');});
</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="a03289.html">List of all members</a> </div>
<div class="headertitle">
<div class="title">std::regex_traits< _Ch_type > Struct Template Reference<div class="ingroups"><a class="el" href="a01715.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:af437be329e87cd3c404df09556a92c3c"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af437be329e87cd3c404df09556a92c3c"></a>
typedef std::ctype_base::mask </td><td class="memItemRight" valign="bottom"><b>char_class_type</b></td></tr>
<tr class="separator:af437be329e87cd3c404df09556a92c3c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:afee189518231263bb10265e032dd3936"><td class="memItemLeft" align="right" valign="top"><a class="anchor" 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 class="anchor" id="abb1aa132e73bd22096bed3feccde6ce5"></a>
typedef <a class="el" href="a00861.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 class="anchor" id="a72bc2015db893e95d14e302f71996e32"></a>
typedef <a class="el" href="a00453.html">std::basic_string</a><br class="typebreak"/>
< 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="a00959.html#a4db88d5c982e69fbd0202c02de2f714a">regex_traits</a> ()</td></tr>
<tr class="separator:a4db88d5c982e69fbd0202c02de2f714a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a5724fe48011546cb282a69155a7f453c"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a00861.html">locale_type</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00959.html#a5724fe48011546cb282a69155a7f453c">getloc</a> () const </td></tr>
<tr class="separator:a5724fe48011546cb282a69155a7f453c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ae1d71eed7ede0411f443426e1d0b781d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a00861.html">locale_type</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00959.html#ae1d71eed7ede0411f443426e1d0b781d">imbue</a> (<a class="el" href="a00861.html">locale_type</a> __loc)</td></tr>
<tr class="separator:ae1d71eed7ede0411f443426e1d0b781d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga994216dc8e2fb4698a058fd2ed692c1d"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="a01715.html#ga994216dc8e2fb4698a058fd2ed692c1d">isctype</a> (_Ch_type __c, char_class_type __f) const </td></tr>
<tr class="separator:ga994216dc8e2fb4698a058fd2ed692c1d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0e91e4cb75494d687a62139e364c003f"><td class="memTemplParams" colspan="2">template<typename _Fwd_iter > </td></tr>
<tr class="memitem:a0e91e4cb75494d687a62139e364c003f"><td class="memTemplItemLeft" align="right" valign="top">char_class_type </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a00959.html#a0e91e4cb75494d687a62139e364c003f">lookup_classname</a> (_Fwd_iter __first, _Fwd_iter __last, bool __icase=false) const </td></tr>
<tr class="separator:a0e91e4cb75494d687a62139e364c003f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa33dfbec4502bbbe80de292e046624ce"><td class="memTemplParams" colspan="2">template<typename _Fwd_iter > </td></tr>
<tr class="memitem:aa33dfbec4502bbbe80de292e046624ce"><td class="memTemplItemLeft" align="right" valign="top"><a class="el" href="a00453.html">string_type</a> </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a00959.html#aa33dfbec4502bbbe80de292e046624ce">lookup_collatename</a> (_Fwd_iter __first, _Fwd_iter __last) const </td></tr>
<tr class="separator:aa33dfbec4502bbbe80de292e046624ce"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a5abab92650157031266dbca5071d4f7d"><td class="memTemplParams" colspan="2">template<typename _Fwd_iter > </td></tr>
<tr class="memitem:a5abab92650157031266dbca5071d4f7d"><td class="memTemplItemLeft" align="right" valign="top"><a class="el" href="a00453.html">string_type</a> </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a00959.html#a5abab92650157031266dbca5071d4f7d">transform</a> (_Fwd_iter __first, _Fwd_iter __last) const </td></tr>
<tr class="separator:a5abab92650157031266dbca5071d4f7d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a635924a23f1a10a8caf57bbf0a04efd5"><td class="memTemplParams" colspan="2">template<typename _Fwd_iter > </td></tr>
<tr class="memitem:a635924a23f1a10a8caf57bbf0a04efd5"><td class="memTemplItemLeft" align="right" valign="top"><a class="el" href="a00453.html">string_type</a> </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a00959.html#a635924a23f1a10a8caf57bbf0a04efd5">transform_primary</a> (_Fwd_iter __first, _Fwd_iter __last) const </td></tr>
<tr class="separator:a635924a23f1a10a8caf57bbf0a04efd5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a5327ab460a2798c778f5d884a3bcd1be"><td class="memItemLeft" align="right" valign="top">char_type </td><td class="memItemRight" valign="bottom"><a class="el" href="a00959.html#a5327ab460a2798c778f5d884a3bcd1be">translate</a> (char_type __c) const </td></tr>
<tr class="separator:a5327ab460a2798c778f5d884a3bcd1be"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a3df0683cd13b3bcde6100d7e09a06362"><td class="memItemLeft" align="right" valign="top">char_type </td><td class="memItemRight" valign="bottom"><a class="el" href="a00959.html#a3df0683cd13b3bcde6100d7e09a06362">translate_nocase</a> (char_type __c) const </td></tr>
<tr class="separator:a3df0683cd13b3bcde6100d7e09a06362"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1c9e781d8d15a3814a601f471797c825"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a01715.html#ga1c9e781d8d15a3814a601f471797c825">value</a> (_Ch_type __ch, int __radix) const </td></tr>
<tr class="separator:ga1c9e781d8d15a3814a601f471797c825"><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="a00959.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 class="anchor" id="ad896e8cedee3f35e35d7b196588c44e8"></a>
<a class="el" href="a00861.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/>
struct std::regex_traits< _Ch_type ></h3>
<p>Class regex_traits. 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>Definition at line <a class="el" href="a01468_source.html#l00051">51</a> of file <a class="el" href="a01468_source.html">regex.h</a>.</p>
</div><h2 class="groupheader">Constructor & Destructor Documentation</h2>
<a class="anchor" id="a4db88d5c982e69fbd0202c02de2f714a"></a>
<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="a00959.html">std::regex_traits</a>< _Ch_type >::<a class="el" href="a00959.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>Definition at line <a class="el" href="a01468_source.html#l00063">63</a> of file <a class="el" href="a01468_source.html">regex.h</a>.</p>
</div>
</div>
<h2 class="groupheader">Member Function Documentation</h2>
<a class="anchor" id="a5724fe48011546cb282a69155a7f453c"></a>
<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="a00861.html">locale_type</a> <a class="el" href="a00959.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>Definition at line <a class="el" href="a01468_source.html#l00270">270</a> of file <a class="el" href="a01468_source.html">regex.h</a>.</p>
</div>
</div>
<a class="anchor" id="ae1d71eed7ede0411f443426e1d0b781d"></a>
<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="a00861.html">locale_type</a> <a class="el" href="a00959.html">std::regex_traits</a>< _Ch_type >::imbue </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00861.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>Definition at line <a class="el" href="a01468_source.html#l00259">259</a> of file <a class="el" href="a01468_source.html">regex.h</a>.</p>
<p>References <a class="el" href="a01256_source.html#l02566">std::swap()</a>.</p>
</div>
</div>
<a class="anchor" id="a2d1679803ff038b130a3ac2d545da164"></a>
<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="a00959.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>Definition at line <a class="el" href="a01468_source.html#l00076">76</a> of file <a class="el" href="a01468_source.html">regex.h</a>.</p>
</div>
</div>
<a class="anchor" id="a0e91e4cb75494d687a62139e364c003f"></a>
<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">char_class_type <a class="el" href="a00959.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>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </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>
<dl class="todo"><dt><b><a class="el" href="a01752.html#_todo000013">Todo:</a></b></dt><dd>Implement this function. </dd></dl>
<p>Definition at line <a class="el" href="a01468_source.html#l00215">215</a> of file <a class="el" href="a01468_source.html">regex.h</a>.</p>
</div>
</div>
<a class="anchor" id="aa33dfbec4502bbbe80de292e046624ce"></a>
<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="a00453.html">string_type</a> <a class="el" href="a00959.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>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </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>
<dl class="todo"><dt><b><a class="el" href="a01752.html#_todo000012">Todo:</a></b></dt><dd>Implement this function. </dd></dl>
<p>Definition at line <a class="el" href="a01468_source.html#l00171">171</a> of file <a class="el" href="a01468_source.html">regex.h</a>.</p>
</div>
</div>
<a class="anchor" id="a5abab92650157031266dbca5071d4f7d"></a>
<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="a00453.html">string_type</a> <a class="el" href="a00959.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>Definition at line <a class="el" href="a01468_source.html#l00129">129</a> of file <a class="el" href="a01468_source.html">regex.h</a>.</p>
<p>References <a class="el" href="a01053_source.html#l01810">std::basic_string< _CharT, _Traits, _Alloc >::data()</a>, and <a class="el" href="a01053_source.html#l00715">std::basic_string< _CharT, _Traits, _Alloc >::size()</a>.</p>
</div>
</div>
<a class="anchor" id="a635924a23f1a10a8caf57bbf0a04efd5"></a>
<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="a00453.html">string_type</a> <a class="el" href="a00959.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="a01752.html#_todo000011">Todo:</a></b></dt><dd>Implement this function. </dd></dl>
<p>Definition at line <a class="el" href="a01468_source.html#l00153">153</a> of file <a class="el" href="a01468_source.html">regex.h</a>.</p>
</div>
</div>
<a class="anchor" id="a5327ab460a2798c778f5d884a3bcd1be"></a>
<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="a00959.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>Definition at line <a class="el" href="a01468_source.html#l00087">87</a> of file <a class="el" href="a01468_source.html">regex.h</a>.</p>
</div>
</div>
<a class="anchor" id="a3df0683cd13b3bcde6100d7e09a06362"></a>
<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="a00959.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>Definition at line <a class="el" href="a01468_source.html#l00100">100</a> of file <a class="el" href="a01468_source.html">regex.h</a>.</p>
</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="a01468_source.html">regex.h</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="a01662.html">std</a></li><li class="navelem"><a class="el" href="a00959.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.5 </li>
</ul>
</div>
</body>
</html>
