std:: match_results
|
Definido en el encabezado
<regex>
|
||
|
template
<
class
BidirIt,
|
(1) | (desde C++11) |
|
namespace
pmr
{
template
<
class
BidirIt
>
|
(2) | (desde C++17) |
La plantilla de clase
std::match_results
contiene una colección de secuencias de caracteres que representan el resultado de una coincidencia de expresión regular.
Este es un contenedor especializado con conocimiento de asignadores. Solo puede ser creado por defecto, obtenido de
std::regex_iterator
, o modificado por
std::regex_search
o
std::regex_match
. Debido a que
std::match_results
contiene
std::sub_match
es, cada uno de los cuales es un par de iteradores hacia la secuencia de caracteres original que fue coincidida, es comportamiento indefinido examinar
std::match_results
si la secuencia de caracteres original fue destruida o los iteradores hacia ella fueron invalidados por otras razones.
El primer
std::sub_match
(índice 0) contenido en un
std::match_result
siempre representa la coincidencia completa dentro de una secuencia objetivo realizada por una expresión regular, y los subsiguientes
std::sub_match
es representan coincidencias de subexpresiones que corresponden en secuencia al paréntesis izquierdo que delimita la subexpresión en la expresión regular.
std::match_results
cumple con los requisitos de un
AllocatorAwareContainer
y de un
SequenceContainer
, excepto que solo se admiten la asignación por copia, la asignación por movimiento y las operaciones definidas para contenedores constantes, y que la semántica de las funciones de comparación es diferente de la requerida para un contenedor.
Contenidos |
Requisitos de tipo
-
BidirIt
debe cumplir con los requisitos de
LegacyBidirectionalIterator
.
|
||
-
Alloc
debe cumplir con los requisitos de
Allocator
.
|
Especializaciones
Se proporcionan varias especializaciones para tipos comunes de secuencias de caracteres:
|
Definido en el encabezado
<regex>
|
|
| Tipo | Definición |
std::cmatch
|
std :: match_results < const char * > |
std::wcmatch
|
std :: match_results < const wchar_t * > |
std::smatch
|
std :: match_results < std :: string :: const_iterator > |
std::wsmatch
|
std :: match_results < std :: wstring :: const_iterator > |
std::pmr::cmatch
(C++17)
|
std :: pmr :: match_results < const char * > |
std::pmr::wcmatch
(C++17)
|
std :: pmr :: match_results < const wchar_t * > |
std::pmr::smatch
(C++17)
|
std :: pmr :: match_results < std :: string :: const_iterator > |
std::pmr::wsmatch
(C++17)
|
std :: pmr :: match_results < std :: wstring :: const_iterator > |
Tipos de miembros
| Tipo de miembro | Definición |
allocator_type
|
Allocator
|
value_type
|
std:: sub_match < BidirIt > |
const_reference
|
const value_type & |
reference
|
value_type&
|
const_iterator
|
definido por la implementación (depende del contenedor subyacente) |
iterator
|
const_iterator
|
difference_type
|
std:: iterator_traits < BidirIt > :: difference_type |
size_type
|
std:: allocator_traits < Alloc > :: size_type |
char_type
|
std:: iterator_traits < BidirIt > :: value_type |
string_type
|
std:: basic_string < char_type > |
Funciones miembro
|
construye el objeto
(función miembro pública) |
|
|
destruye el objeto
(función miembro pública) |
|
|
asigna los contenidos
(función miembro pública) |
|
|
devuelve el asignador asociado
(función miembro pública) |
|
Estado |
|
|
verifica si los resultados están disponibles
(función miembro pública) |
|
Tamaño |
|
|
verifica si la coincidencia fue exitosa
(función miembro pública) |
|
|
devuelve el número de coincidencias en un estado de resultado completamente establecido
(función miembro pública) |
|
|
devuelve el número máximo posible de subcoincidencias
(función miembro pública) |
|
Acceso a elementos |
|
|
devuelve la longitud de la subcoincidencia particular
(función miembro pública) |
|
|
devuelve la posición del primer carácter de la subcoincidencia particular
(función miembro pública) |
|
|
devuelve la secuencia de caracteres para la subcoincidencia particular
(función miembro pública) |
|
|
devuelve la subcoincidencia especificada
(función miembro pública) |
|
|
devuelve la subsecuencia entre el inicio de la secuencia objetivo y el inicio de la coincidencia completa
(función miembro pública) |
|
|
devuelve la subsecuencia entre el final de la coincidencia completa y el final de la secuencia objetivo
(función miembro pública) |
|
Iteradores |
|
|
devuelve el iterador al inicio de la lista de subcoincidencias
(función miembro pública) |
|
|
devuelve el iterador al final de la lista de subcoincidencias
(función miembro pública) |
|
Formato |
|
|
formatea los resultados de coincidencia para salida
(función miembro pública) |
|
Modificadores |
|
|
intercambia los contenidos
(función miembro pública) |
|
Funciones no miembro
|
(eliminado en C++20)
|
compara lexicográficamente los valores en los dos resultados de coincidencia
(plantilla de función) |
|
(C++11)
|
especializa el algoritmo
std::swap
(plantilla de función) |