Clase regex_traits
Describe las características de los elementos para buscar coincidencias.
Sintaxis
template<class Elem>
class regex_traits
Parámetros
Elem
El tipo de elemento de carácter que se va describir.
Comentarios
La plantilla de clase describe varios rasgos de expresión regular de tipo Elem. La plantilla de clase basic_regex usa esta información para manipular los elementos de tipo Elem.
Cada objeto regex_traits contiene un objeto de tipo regex_traits::locale que usan algunas de sus funciones miembro. La configuración regional predeterminada es una copia de regex_traits::locale(). La función miembro imbue reemplaza el objeto de configuración regional, y la función miembro getloc devuelve una copia del objeto de configuración regional.
Constructores
| Constructor | Descripción |
|---|---|
| regex_traits | Este constructor se usa para construir el objeto . |
Typedefs
| Nombre de tipo | Descripción |
|---|---|
| char_class_type | El tipo de designador de clases de caracteres. |
| char_type | El tipo de un elemento. |
| locale_type | El tipo de objeto de configuración regional almacenado. |
| size_type | Tipo de una longitud de secuencia. |
| string_type | Tipo de una cadena de elementos. |
Funciones miembro
| Función de miembro | Descripción |
|---|---|
| getloc | Devuelve el objeto de configuración regional almacenado. |
| imbue | Modifica el objeto de configuración regional almacenado. |
| isctype | Realiza pruebas de pertenencia a una clase. |
| length | Devuelve la longitud de una secuencia terminada en null. |
| lookup_classname | Asigna una secuencia a una clase de caracteres. |
| lookup_collatename | Asigna una secuencia a un elemento de intercalación. |
| transform | Convierte a la secuencia ordenada equivalente. |
| transform_primary | Convierte a la secuencia ordenada caseless equivalente. |
| translate | Convierte a un elemento coincidente equivalente. |
| translate_nocase | Convierte al elemento equivalente que coincide sin distinción entre mayúsculas y minúsculas. |
| value | Convierte un elemento en un valor de dígito. |
Requisitos
Encabezado:<regex>
Espacio de nombres: std
Ejemplo
// std__regex__regex_traits.cpp
// compile with: /EHsc
#include <regex>
#include <iostream>
typedef std::regex_traits<char> Mytr;
int main()
{
Mytr tr;
Mytr::char_type ch = tr.translate('a');
std::cout << "translate('a') == 'a' == " << std::boolalpha
<< (ch == 'a') << std::endl;
std::cout << "nocase 'a' == 'A' == " << std::boolalpha
<< (tr.translate_nocase('a') == tr.translate_nocase('A'))
<< std::endl;
const char *lbegin = "abc";
const char *lend = lbegin + strlen(lbegin);
Mytr::size_type size = tr.length(lbegin);
std::cout << "length(\"abc\") == " << size <<std::endl;
Mytr::string_type str = tr.transform(lbegin, lend);
std::cout << "transform(\"abc\") < \"abc\" == " << std::boolalpha
<< (str < "abc") << std::endl;
const char *ubegin = "ABC";
const char *uend = ubegin + strlen(ubegin);
std::cout << "primary \"ABC\" < \"abc\" == " << std::boolalpha
<< (tr.transform_primary(ubegin, uend) <
tr.transform_primary(lbegin, lend))
<< std::endl;
const char *dig = "digit";
Mytr::char_class_type cl = tr.lookup_classname(dig, dig + 5);
std::cout << "class digit == d == " << std::boolalpha
<< (cl == tr.lookup_classname(dig, dig + 1))
<< std::endl;
std::cout << "'3' is digit == " <<std::boolalpha
<< tr.isctype('3', tr.lookup_classname(dig, dig + 5))
<< std::endl;
std::cout << "hex C == " << tr.value('C', 16) << std::endl;
// other members
str = tr.lookup_collatename(dig, dig + 5);
Mytr::locale_type loc = tr.getloc();
tr.imbue(loc);
return (0);
}
translate('a') == 'a' == true
nocase 'a' == 'A' == true
length("abc") == 3
transform("abc") < "abc" == false
primary "ABC" < "abc" == false
class digit == d == true
'3' is digit == true
hex C == 12
regex_traits::char_class_type
El tipo de designador de clases de caracteres.
typedef T8 char_class_type;
Comentarios
El tipo es un sinónimo de un tipo no especificado que designa clases de caracteres. Se pueden combinar los valores de este tipo mediante el operador | para designar clases de caracteres que constituyen la unión de las clases designadas por los operandos.
regex_traits::char_type
El tipo de un elemento.
typedef Elem char_type;
Comentarios
La definición de tipo es un sinónimo del argumento de plantilla Elem.
regex_traits::getloc
Devuelve el objeto de configuración regional almacenado.
locale_type getloc() const;
Comentarios
La función miembro devuelve el objeto locale almacenado.
regex_traits::imbue
Modifica el objeto de configuración regional almacenado.
locale_type imbue(locale_type loc);
Parámetros
loc
El objeto de configuración regional que se va a almacenar.
Comentarios
La función miembro copia loc al objeto locale almacenado y devuelve una copia del valor anterior del objeto locale almacenado.
regex_traits::isctype
Realiza pruebas de pertenencia a una clase.
bool isctype(char_type ch, char_class_type cls) const;
Parámetros
Ch
Elemento que se va a comprobar.
cls
Las clases que se van a probar.
Comentarios
La función miembro devuelve true solo si el carácter ch está en la clase de caracteres designada por cls.
regex_traits::length
Devuelve la longitud de una secuencia terminada en null.
static size_type length(const char_type *str);
Parámetros
str
La secuencia terminada en null.
Comentarios
La función miembro estática devuelve std::char_traits<char_type>::length(str).
regex_traits::locale_type
El tipo de objeto de configuración regional almacenado.
typedef T7 locale_type;
Comentarios
La definición de tipo es un sinónimo de un tipo que encapsula las configuraciones regionales. En las especializaciones regex_traits<char> y regex_traits<wchar_t> es un sinónimo de std::locale.
regex_traits::lookup_classname
Asigna una secuencia a una clase de caracteres.
template <class FwdIt>
char_class_type lookup_classname(FwdIt first, FwdIt last) const;
Parámetros
first
Principio de la secuencia que se va a buscar.
last
Final de la secuencia que se va a buscar.
Comentarios
La función miembro devuelve un valor que designa la clase de caracteres denominada por la secuencia de caracteres a la que señalan sus argumentos. El valor es independiente de mayúsculas o minúsculas en los caracteres de la secuencia.
La especialización regex_traits<char> reconoce los nombres "d", "s", "w", "alnum", "alpha", "blank", "cntrl", "digit", "graph", "lower", "print", "punct", "space", "upper" y "xdigit" sin tener en cuenta mayúsculas o minúsculas.
La especialización regex_traits<wchar_t> reconoce los nombres L"d", L"s", L"w", L"alnum", L"alpha", L"blank", L"cntrl", L"digit", L"graph", L"lower", L"print", L"punct", L"space", L"upper" y L"xdigit" sin tener en cuenta mayúsculas o minúsculas.
regex_traits::lookup_collatename
Asigna una secuencia a un elemento de intercalación.
template <class FwdIt>
string_type lookup_collatename(FwdIt first, FwdIt last) const;
Parámetros
first
Principio de la secuencia que se va a buscar.
last
Final de la secuencia que se va a buscar.
Comentarios
La función miembro devuelve un objeto de cadena que contiene el elemento de intercalación correspondiente a la secuencia de [first, last)o una cadena vacía si la secuencia no es un elemento de intercalación válido.
regex_traits::regex_traits
Este constructor se usa para construir el objeto .
regex_traits();
Comentarios
El constructor crea un objeto cuyo objeto locale almacenado se inicializa en la configuración regional predeterminada.
regex_traits::size_type
Tipo de una longitud de secuencia.
typedef T6 size_type;
Comentarios
La definición de tipo es un sinónimo para un tipo entero sin signo. En las especializaciones regex_traits<char> y regex_traits<wchar_t> es un sinónimo de std::size_t.
La definición de tipo es un sinónimo de std::size_t.
regex_traits::string_type
Tipo de una cadena de elementos.
typedef basic_string<Elem> string_type;
Comentarios
La definición de tipo es un sinónimo de basic_string<Elem>.
regex_traits::transform
Convierte a la secuencia ordenada equivalente.
template <class FwdIt>
string_type transform(FwdIt first, FwdIt last) const;
Parámetros
first
Principio de la secuencia que se va a transformar.
last
Final de la secuencia que se va a transformar.
Comentarios
La función miembro devuelve una cadena que dicha función genera mediante una regla de transformación que depende del objeto locale almacenado. En el caso de dos secuencias de caracteres designadas por los rangos de iterador [first1, last1) y [first2, last2), transform(first1, last1) < transform(first2, last2) si la secuencia de caracteres designada por el rango de iterador [first1, last1) se ordena antes que la secuencia de caracteres designada por el rango de iterador [first2, last2).
regex_traits::transform_primary
Convierte a la secuencia ordenada caseless equivalente.
template <class FwdIt>
string_type transform_primary(FwdIt first, FwdIt last) const;
Parámetros
first
Principio de la secuencia que se va a transformar.
last
Final de la secuencia que se va a transformar.
Comentarios
La función miembro devuelve una cadena que dicha función genera mediante una regla de transformación que depende del objeto locale almacenado. En el caso de dos secuencias de caracteres designadas por los rangos de iterador [first1, last1) y [first2, last2), transform_primary(first1, last1) < transform_primary(first2, last2) si la secuencia de caracteres designada por el rango de iterador [first1, last1) se ordena antes que la secuencia de caracteres designada por el rango de iterador [first2, last2) sin tener en cuenta mayúsculas y minúsculas o acentos.
regex_traits::translate
Convierte a un elemento coincidente equivalente.
char_type translate(char_type ch) const;
Parámetros
Ch
El elemento que se va a convertir.
Comentarios
La función miembro devuelve un carácter que dicha función genera mediante una regla de transformación que depende del objeto locale almacenado. Para dos objetos char_type y ch1 de ch2, translate(ch1) == translate(ch2) solo si ch1 y ch2 deben coincidir cuando uno aparece en la definición de la expresión regular y el otro en la posición correspondiente de la secuencia de destino para una coincidencia que depende de la configuración regional.
regex_traits::translate_nocase
Convierte al elemento equivalente que coincide sin distinción entre mayúsculas y minúsculas.
char_type translate_nocase(char_type ch) const;
Parámetros
Ch
El elemento que se va a convertir.
Comentarios
La función miembro devuelve un carácter que dicha función genera mediante una regla de transformación que depende del objeto locale almacenado. Para dos objetos char_type y ch1 de ch2, translate_nocase(ch1) == translate_nocase(ch2) solo si ch1 y ch2 deben coincidir cuando uno aparece en la definición de la expresión regular y el otro en la posición correspondiente de la secuencia de destino para una coincidencia que no distingue entre mayúsculas y minúsculas.
regex_traits::value
Convierte un elemento en un valor de dígito.
int value(Elem ch, int radix) const;
Parámetros
Ch
El elemento que se va a convertir.
radix
Las operaciones aritméticas base que se van a usar.
Comentarios
La función miembro devuelve el valor representado por el carácter ch en la base radix o -1 si ch no es un dígito válido en la base radix. La función solo se llamará con un argumento radix de 8, 10 o 16.
Consulte también
<regex>
regex_constants (Clase)
regex_error (Clase)
<regex> functions
regex_iterator (Clase)
<regex> operators
regex_token_iterator (Clase)
<regex> typedefs
Clase regex_traits<char>
regex_traits<wchar_t>
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de