std::sub_match
| Definido en el archivo de encabezado <regex>
|
||
| template<class BidirIt> class sub_match; |
(desde C++11) | |
El motor de expresiones regulares usa la plantilla de clase sub_match para indicar secuencias de caracteres que coinciden con subexpresiones marcadas.
Una coincidencia es un par [begin, end) dentro del rango de destino que coincide con la expresión regular, pero con funciones de obervación adicionales para mejorar la claridad del código.
Solo el constructor por defecto es de acceso público. Las instancias de sub_match normalmente se construyen y se rellenan como parte de un contenedor std::match_results durante el procesamiento de uno de los algoritmos de expresiones regulares.
Las funciones miembro devuelven valores definidos por defectoa menos que el miembro matched sea true.
sub_match hereda de std::pair<BidirIt, BidirIt>, aunque no puede tratarse como un objeto std::pair debido a que las funciones miembro tales como intercambio y asignación no funcionan como se espera.
Contenido |
[editar] Requerimientos de tipo
-BidirIt debe satisfacer los requisitos de BidirectionalIterator.
|
[editar] Especializaciones
Se proporcionan varias especializaciones para tipos de secuencia de caracteres comunes:
| Definido en el archivo de encabezado
<regex> | |
| Tipo | Definición |
csub_match
|
sub_match<const char*> |
wcsub_match
|
sub_match<const wchar_t*> |
ssub_match
|
sub_match<std::string::const_iterator> |
wssub_match
|
sub_match<std::wstring::const_iterator> |
[editar] Tipos miembro
| Tipo miembro | Definición |
iterator
|
BidirIt |
value_type
|
std::iterator_traits<BidirIt>::value_type |
difference_type
|
std::iterator_traits<BidirIt>::difference_type |
string_type
|
std::basic_string<value_type> |
[editar] Objetos miembro
| bool matched |
Indica si esta coincidencia tuvo éxito. (objeto miembro público) |
Heredado de std::pair
| BidirIt first |
Inicio de la secuencia de coincidencias. (objeto miembro público) |
| BidirIt second |
Un elemento después del fin de la secuencia de coincidencias. (objeto miembro público) |
[editar] Funciones miembro
| Construye el objeto de coincidencias. (función miembro pública) | |
Observadores | |
| Devuelve la longitud de la coincidencia (si la hay). (función miembro pública) | |
| Convierte al tipo de cadena subyacente. (función miembro pública) | |
| Compara una subsecuencia coincidente (si la hay) (función miembro pública) | |
[editar] Funciones no miembro
| (eliminado en C++20)(eliminado en C++20)(eliminado en C++20)(eliminado en C++20)(eliminado en C++20)(C++20) |
Compara un objeto sub_match con otro objeto sub_match, una cadena o un carácter. (plantilla de función) |
| Emite la subsecuencia de caracteres coincidentes. (plantilla de función) |
[editar] Véase también
| (C++11) |
Itera a través de las subexpresiones especificadas dentro de todas las coincidencias de expresiones regulares en una cadena dada o a través de subcadenas no coincidentes. (plantilla de clase) |
