std::basic_string::compare

 

C++

Suporte ao Compilador

Freestanding and hosted

Linguagem

Headers da Biblioteca Standard

Requerimentos nomeados

Feature test macros (C++20)

Biblioteca de suporte de língua

Biblioteca de conceitos(C++20)

Biblioteca de diagnósticos

Biblioteca de utilitários em geral

Biblioteca de strings

Biblioteca de containers

Ranges library(C++20)

Biblioteca de iteradores

Biblioteca de algorítmos

Biblioteca numérica

Biblioteca de localizações

Biblioteca de input/output

Biblioteca de sistema de arquivo(C++17)

Biblioteca de expressões regulares(C++11)

Biblioteca de operações atômicas(C++11)

Biblioteca de suporte de thread(C++11)

Especificações Técnicas

Índice de symbolos

Bibliotecas externas

 

Biblioteca cordas

Strings terminadas Original: Null-terminated strings The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

Cadeias de bytes

Multibyte cordas

Cordas de largura

Classes Original: Classes The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

basic_string

char_traits

 

std::basic_string

Funções de membro Original: Member functions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

basic_string::basic_string

basic_string::operator=

basic_string::assign

basic_string::get_allocator

acesso. Elemento Original: Element access The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

basic_string::at

basic_string::operator[]

basic_string::front (C++11)

basic_string::back (C++11)

basic_string::data

basic_string::c_str

Iteradores Original: Iterators The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

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)

Capacidade Original: Capacity The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

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)

Operações Original: Operations The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

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

basic_string::substr

basic_string::copy

basic_string::resize

basic_string::swap

Pesquisar Original: Search The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

basic_string::find

basic_string::rfind

basic_string::find_first_of

basic_string::find_first_not_of

basic_string::find_last_of

basic_string::find_last_not_of

Constantes Original: Constants The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

basic_string::npos

Não-membros funções Original: Non-member functions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

operator+

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

swap(std::basic_string)

operator<<operator>>

getline

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

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

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

to_string (C++11)

to_wstring (C++11)

Classes auxiliares Original: Helper classes The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string> (C++11)

 

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 )constnoexcept;	(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 duas sequências de caracteres.

Original:

Compares two character sequences.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

1)

Compara essa string para' str. Primeiro, calcula o número de caracteres para comparar, como se por size_type rlen =std::min(size(), str.size()). Em seguida, compara chamando Traits::compare(data(), str.data(), rlen). Para strings padrão esta função realiza caractere por caractere-lexicográfica comparação. Se o resultado for igual a zero (as cordas são iguais até agora), em seguida, os seus tamanhos são comparadas como se segue:

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 uma substring [pos1, pos1+count1) dessa seqüência para str', como se 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 uma substring [pos1, pos1+count1) dessa seqüência para uma substring [pos2, pas2+count2) de str como se 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 essa string para o início seqüência terminada em nulo personagem no caráter apontado por' s, como se 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 uma substring [pos1, pos1+count1) dessa seqüência para o início seqüência terminada em nulo personagem no caráter apontado por' s, como se 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 uma substring [pos1, pos1+count1) desta cadeia para os personagens count2 primeiro da matriz de caracteres cujo primeiro caractere é apontado por' s, como se por basic_string(*this, pos, count1).compare(basic_string(s, count2)). (Nota: os personagens de s para s+count2 podem 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.

Parâmetros

str	-	outra seqüência para 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	-	ponteiro para a cadeia de caracteres para 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 desta string 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	-	posição do primeiro caractere nesta seqüência 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 da seqüência de determinado 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	-	posição do primeiro caractere da string 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.

Valor de retorno

valor negativo se essa seqüência é menos do que a seqüência de outro personagem, zero se as seqüências de ambos os personagens são de valor, igual positivo se esta string é maior do que a sequência de caracteres de outros.

Original:

negative value if this string is less than the other character sequence, zero if the both character sequences are equal, positive value if this string is greater than the other character sequence.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Exceções

1)

noexcept specification:  

noexcept

  (desde C++11)

2-6)

Pode lançar as exceções lançadas pelos construtores basic_string correspondentes.

Original:

May throw the exceptions thrown by the corresponding basic_string constructors.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Possível implementação

template<class CharT, class Traits, class Alloc>int basic_string<CharT, Traits, Alloc>::compare(conststd::basic_string& str)constnoexcept{ 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)return1;return0;}

Veja também

operator== operator!= operator< operator> operator<= operator>=	lexicographically compara duas strings 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. (modelo de função)
substr	retorna uma substring 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. (função pública membro)
collate	define lexicográfica comparação e hash de strings 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. (modelo de classe)
strcoll	compara duas seqüências de acordo com a localidade 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. (função)