Voir la source de cpp/string/basic string/compare

Vous n’avez pas le droit de modifier cette page, pour la raison suivante :
L’action que vous essayez de réaliser n’est permise qu’aux utilisateurs d’un des groupes : Utilisateurs, Administrateurs.
Vous pouvez voir et copier le contenu de cette page.
{{tr_note}}
{{cpp/string/basic_string/title | compare}}
{{cpp/string/basic_string/navbar}}
{{dcl begin}}
{{dcl | num=1 |
int compare( const basic_string& str ) const;
}}
{{dcl | num=2 |
int compare( size_type pos1, size_type count1,
             const basic_string& str ) const;
}}
{{dcl | num=3 |
int compare( size_type pos1, size_type count1,
             const basic_string& str,
             size_type pos2, size_type count2 ) const;
}}
{{dcl | num=4 |
int compare( const CharT* s ) const noexcept;
}}
{{dcl | num=5 |
int compare( size_type pos1, size_type count1,
             const CharT* s ) const;
}}
{{dcl | num=6 |
int compare( size_type pos1, size_type count1,
             const CharT* s, size_type count2 ) const;
}}
{{dcl end}}

{{tr|Compare deux séquences de caractères . |Compares two character sequences. }}

1) {{tr|Compare cette chaîne str''''. Tout d'abord, calcule le nombre de caractères à comparer, comme par {{c|1=size_type rlen = std::min(size(), str.size())}}. Compare ensuite en appelant {{c|Traits::compare(data(), str.data(), rlen)}}. Pour les chaînes standards de cette fonction effectue caractère par caractère comparaison lexicographique. Si le résultat est égal à zéro (les chaînes sont égales à ce jour), leurs tailles sont comparés comme suit:|Compares this string to ''str''. First, calculates the number of characters to compare, as if by {{c|1=size_type rlen = std::min(size(), str.size())}}. Then compares by calling {{c|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:}}

{| class="wikitable" style="text-align:center;"
! colspan=2 | Condition
! Result
! Return value
|-
| colspan=2 style="text-align:left;" | {{tt|Traits::compare({{spar|data}}, {{spar|arg}}, {{spar|rlen}}) < 0}}
| {{spar|data}} is ''less'' than {{spar|arg}}
| {{c|<0}}
|-
| rowspan=3 | {{tt|Traits::compare({{spar|data}}, {{spar|arg}}, {{spar|rlen}}) {{==}} 0}}
| {{tt|size({{spar|data}}) < size({{spar|arg}})}}
| {{spar|data}} is ''less'' than {{spar|arg}}
| {{c|<0}}
|-
<!-- -->
| {{tt|size({{spar|data}}) {{==}} size({{spar|arg}})}}
| {{spar|data}} is ''equal'' to {{spar|arg}}
| {{c|0}}
|-
<!-- -->
| {{tt|size({{spar|data}}) > size({{spar|arg}})}}
| {{spar|data}} is ''greater'' than {{spar|arg}}
| {{c|>0}}
|-
| colspan=2 style="text-align:left;" | {{tt|Traits::compare({{spar|data}}, {{spar|arg}}, {{spar|rlen}}) > 0}}
| {{spar|data}} is ''greater'' than {{spar|arg}}
| {{c|>0}}
|}

2) {{tr|Compare une chaîne {{tt|[pos1, pos1+count1)}} de cette chaîne str'''' comme par {{c|basic_string(*this, pos1, count1).compare(str)}}|Compares a {{tt|[pos1, pos1+count1)}} substring of this string to ''str'' as if by {{c|basic_string(*this, pos1, count1).compare(str)}}}}

3) {{tr|Compare une chaîne {{tt|[pos1, pos1+count1)}} de cette chaîne à une chaîne de {{tt|[pos2, pas2+count2)}}'''' str comme par {{c|basic_string(*this, pos1, count1).compare(basic_string(str, pos2, count2))}}|Compares a {{tt|[pos1, pos1+count1)}} substring of this string to a substring {{tt|[pos2, pas2+count2)}} of ''str''  as if by {{c|basic_string(*this, pos1, count1).compare(basic_string(str, pos2, count2))}}}}

4) {{tr|Compare cette chaîne au début terminée par NULL séquence de caractères par le caractère pointé par s'''', comme par {{c|compare(basic_string(s))}}|Compares this string to the null-terminated character sequence beginning at the character pointed to by ''s'', as if by {{c|compare(basic_string(s))}}}}

5) {{tr|Compare une chaîne {{tt|[pos1, pos1+count1)}} de cette chaîne au début terminée par NULL séquence de caractères par le caractère pointé par s'''', comme par {{c|basic_string(*this, pos, count1).compare(basic_string(s))}}|Compares a {{tt|[pos1, pos1+count1)}} substring of this string to the null-terminated character sequence beginning at the character pointed to by ''s'', as if by {{c|basic_string(*this, pos, count1).compare(basic_string(s))}}}}

6) {{tr|Compare une chaîne {{tt|[pos1, pos1+count1)}} de cette chaîne de caractères {{tt|count2}} premiers du tableau de caractères dont le premier caractère est souligné par l'''', comme par {{c|basic_string(*this, pos, count1).compare(basic_string(s, count2)).}} (Remarque: les caractères de {{tt|s}} à {{tt|s+count2}} peuvent inclure des caractères nuls))|Compares a {{tt|[pos1, pos1+count1)}} substring of this string to the first {{tt|count2}} characters of the character array whose first character is pointed to by ''s'', as if by {{c|basic_string(*this, pos, count1).compare(basic_string(s, count2)).}} (Note: the characters from {{tt|s}} to {{tt|s+count2}} may include null characters))}}

===Paramètres===
{{par begin}}
{{par | str |{{tr| autre chaîne à comparer| other string to compare to}}}}
{{par | s |{{tr| pointeur vers la chaîne de caractères à comparer| pointer to the character string to compare to}}}}
{{par | count1 |{{tr| nombre de caractères de cette chaîne à compore| number of characters of this string to compore}}}}
{{par | pos1 |{{tr| position du premier caractère de cette chaîne à comparer| position of the first character in this string to compare}}}}
{{par | count2 |{{tr| nombre de caractères de la chaîne donnée compore| number of characters of the given string to compore}}}}
{{par | pos2 |{{tr| la position du premier caractère de la chaîne donnée à comparer| position of the first character of the given string to compare}}}}
{{par end}} 

===Retourne la valeur===
{{tr|valeur négative si cette chaîne est'' moins'' de la séquence de caractères autre, zéro si les deux séquences de caractères sont égaux, la valeur positive si cette chaîne est'' plus'' que la séquence de caractères autre .|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.}}

===Exceptions===
1) {{noexcept}}

2-6) {{tr|Peut lever les exceptions lancées par les constructeurs {{tt|basic_string}} correspondantes .|May throw the exceptions thrown by the corresponding {{tt|basic_string}} constructors.}}

===Mise en œuvre possible===
{{eq fun
 | 1=
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;
}
}}

===Exemple===
{{example
 | code=
 | output=
}}

===Voir aussi===
{{dsc begin}}
{{dsc inc | cpp/string/basic_string/dsc operator_cmp}}
{{dsc inc | cpp/string/basic_string/dsc substr}}
{{dsc inc | cpp/locale/dsc collate}}
{{dsc inc | cpp/string/byte/dsc strcoll}}
{{dsc end}}

[[de:cpp/string/basic string/compare]]
[[en:cpp/string/basic string/compare]]
[[es:cpp/string/basic string/compare]]
[[it:cpp/string/basic string/compare]]
[[ja:cpp/string/basic string/compare]]
[[pl:cpp/string/basic string/compare]]
[[pt:cpp/string/basic string/compare]]
[[ru:cpp/string/basic string/compare]]
[[zh:cpp/string/basic string/compare]]
Modèles utilisés par cette page :
Revenir à la page cpp/string/basic string/compare.
cppreference.com

Rechercher

Espaces de noms

Variantes

Affichages

Actions

Voir la source de cpp/string/basic string/compare

Navigation

Outils
