std::basic_string::compare

This page has been machine-translated from the English version of the wiki using Google Translate.

The translation may contain errors and awkward wording. Hover over text to see the original version. You can help to fix errors and improve the translation. For instructions click here.

Click here for the English version of this page

std::basic_string

Las funciones miembro

basic_string::basic_string

basic_string::operator=

basic_string::assign

basic_string::get_allocator

Elemento acceso

basic_string::at

basic_string::operator[]

(C++11)

(C++11)

Los iteradores

basic_string::begin
basic_string::cbegin

(C++11)

basic_string::end
basic_string::cend

(C++11)

basic_string::rbegin
basic_string::crbegin

(C++11)

basic_string::rend
basic_string::crend

(C++11)

Capacidad

basic_string::empty

basic_string::size

basic_string::length

basic_string::max_size

basic_string::reserve

basic_string::capacity

basic_string::shrink_to_fit

(C++11)

Operaciones

basic_string::clear

basic_string::insert

basic_string::erase

basic_string::push_back

basic_string::pop_back

(C++11)

basic_string::append

basic_string::operator+=

basic_string::compare

basic_string::replace

Buscar

basic_string::find_first_of

basic_string::find_first_not_of

basic_string::find_last_of

basic_string::find_last_not_of

Constantes

basic_string::npos

Terceros funciones

operator+

operator==
operator!=
operator<
operator>
operator<=
operator>=

swap(std::basic_string)

operator<<
operator>>

getline

stoi
stol
stoll

(C++11)
(C++11)
(C++11)

stoul
stoull

(C++11)
(C++11)

stof
stod
stold

(C++11)
(C++11)
(C++11)

to_string

(C++11)

to_wstring

(C++11)

Clases de ayuda

hash<std::string>
hash<std::wstring>
hash<std::u32string>
hash<std::u16string>

(C++11)

[edit]


int compare( const basic_string& str ) const;	(1)

int compare( size_type pos1, size_type count1, const basic_string& str ) const;	(2)

int compare( size_type pos1, size_type count1, const basic_string& str, size_type pos2, size_type count2 ) const;	(3)

int compare( const CharT* s ) const noexcept;	(4)

int compare( size_type pos1, size_type count1, const CharT* s ) const;	(5)

int compare( size_type pos1, size_type count1, const CharT* s, size_type count2 ) const;	(6)

Compara dos secuencias de caracteres .

1)

Compara esta cadena str'. En primer lugar, se calcula el número de caracteres a comparar, como por size_type rlen = std::min(size(), str.size()). Luego compara llamando Traits::compare(data(), str.data(), rlen). Para las cadenas estándar esta función realiza carácter por carácter lexicográfico comparación. Si el resultado es cero (las cadenas son iguales hasta el momento), entonces sus tamaños se comparan como sigue:
Original:
Compares this string to str. First, calculates the number of characters to compare, as if by size_type rlen = std::min(size(), str.size()). Then compares by calling Traits::compare(data(), str.data(), rlen). For standard strings this function performs character-by-character lexicographical comparison. If the result is zero (the strings are equal so far), then their sizes are compared as follows:
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Condition		Result	Return value
`Traits::compare(data, arg, rlen) < 0`		data is less than arg	<0
`Traits::compare(data, arg, rlen) == 0`	`size(data) < size(arg)`	data is less than arg	<0
	`size(data) == size(arg)`	data is equal to arg	0
	`size(data) > size(arg)`	data is greater than arg	>0
`Traits::compare(data, arg, rlen) > 0`		data is greater than arg	>0

2)

Compara una subcadena [pos1, pos1+count1) de esta cadena str' como por basic_string(*this, pos1, count1).compare(str)
Original:
Compares a [pos1, pos1+count1) substring of this string to str as if by basic_string(*this, pos1, count1).compare(str)
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

3)

Compara una subcadena [pos1, pos1+count1) de esta cadena a una subcadena de [pos2, pas2+count2)' str como por basic_string(*this, pos1, count1).compare(basic_string(str, pos2, count2))
Original:
Compares a [pos1, pos1+count1) substring of this string to a substring [pos2, pas2+count2) of str as if by basic_string(*this, pos1, count1).compare(basic_string(str, pos2, count2))
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

4)

Compara esta cadena al comienzo caracteres terminada en nulo en la secuencia de caracteres apuntada por' s, como por compare(basic_string(s))
Original:
Compares this string to the null-terminated character sequence beginning at the character pointed to by s, as if by compare(basic_string(s))
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

5)

Compara una subcadena [pos1, pos1+count1) de esta cadena para el inicio caracteres terminada en nulo en la secuencia de caracteres apuntada por' s, como por basic_string(*this, pos, count1).compare(basic_string(s))
Original:
Compares a [pos1, pos1+count1) substring of this string to the null-terminated character sequence beginning at the character pointed to by s, as if by basic_string(*this, pos, count1).compare(basic_string(s))
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

6)

Compara una subcadena [pos1, pos1+count1) de esta cadena con los caracteres count2 primero de la matriz de caracteres cuyo primer carácter es apuntado por' s, como por basic_string(*this, pos, count1).compare(basic_string(s, count2)). (Nota: los personajes de s a s+count2 pueden incluir caracteres nulos))
Original:
Compares a [pos1, pos1+count1) substring of this string to the first count2 characters of the character array whose first character is pointed to by s, as if by basic_string(*this, pos, count1).compare(basic_string(s, count2)). (Note: the characters from s to s+count2 may include null characters))
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

[editar] Parámetros

str	-	otra cadena a comparar Original: other string to compare to The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
s	-	puntero a la cadena de caracteres a comparar Original: pointer to the character string to compare to The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
count1	-	número de caracteres de esta cadena para compore Original: number of characters of this string to compore The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
pos1	-	posición del primer carácter en esta cadena para comparar Original: position of the first character in this string to compare The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
count2	-	número de caracteres de la cadena dada compore Original: number of characters of the given string to compore The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
pos2	-	posición del primer carácter de la cadena dada para comparar Original: position of the first character of the given string to compare The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

[editar] Valor de retorno

valor negativo si esta cadena es menor' de la secuencia de otro carácter, cero si las secuencias de caracteres de ambos son igual valor, positivo si esta cadena es mayor' de la secuencia de caracteres de otro .

[editar] Excepciones

1)

noexcept specification:


noexcept

(desde C++11)

2-6)

Puede lanzar las excepciones producidas por los constructores basic_string correspondientes .

[editar] Posible implementación

template<class CharT, class Traits, class Alloc>
int basic_string<CharT, Traits, Alloc>::compare(const std::basic_string& str) const noexcept
{
    size_type lhs_sz = size();
    size_type rhs_sz = str.size();
    int result = traits_type::compare(data(), str.data(), std::min(lhs_sz, rhs_sz));
    if (result != 0)
        return result;
    if (lhs_sz < rhs_sz)
        return -1;
    if (lhs_sz > rhs_sz)
        return 1;
    return 0;
}

[editar] Ejemplo

[editar] Ver también


operator== operator!= operator< operator> operator<= operator>=	lexicográfico compara dos cadenas Original: lexicographically compares two strings The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (función de plantilla) [edit]

substr	devuelve una subcadena Original: returns a substring The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (miembro público función) [edit]

collate	define comparación lexicográfica y hash de cadenas Original: defines lexicographical comparison and hashing of strings The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (clase de plantilla) [edit]

strcoll	compara dos cadenas de acuerdo a la localización actual Original: compares two strings in accordance to the current locale The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (función) [edit]

Lenguaje
Cabeceras
Conceptos
Biblioteca de utilidades
Biblioteca de cadenas
Biblioteca de contenedores
Biblioteca de algoritmos
Biblioteca de iteradores
Biblioteca numérica
Biblioteca de entrada/salida
Biblioteca de localización
Biblioteca de expresiones regulares (C++11)
Biblioteca de operaciones atómicas (C++11)
Biblioteca de tareas/subprocesos (C++11)

cppreference.com

Buscar

Espacios de nombres

Variantes

Vistas

Acciones

std::basic_string::compare

Contenido

[editar] Parámetros

[editar] Valor de retorno

[editar] Excepciones

[editar] Posible implementación

[editar] Ejemplo

[editar] Ver también

Navegación

Herramientas