std::basic_string<CharT,Traits,Allocator>:: compare

두 문자 시퀀스를 비교합니다.

count1 개의 문자로 이루어진 문자 시퀀스가 data1 에서 시작하고, count2 개의 문자로 이루어진 문자 시퀀스가 data2 에서 시작하는 두 시퀀스를 다음과 같이 비교합니다:

• 먼저, 비교할 문자 수를 다음과 같이 계산합니다. size_type rlen = std:: min ( count1, count2 ) .
• 그런 다음 다음을 호출하여 시퀀스를 비교합니다. Traits :: compare ( data1, data2, rlen ) . 표준 문자열의 경우 이 함수는 문자 단위의 사전식 비교를 수행합니다. 결과가 0이면(지금까지 문자 시퀀스가 동일함) 크기를 다음과 같이 비교합니다:

매개변수

반환값

• 인수로 지정된 문자 시퀀스보다 사전식 순서에서 * this 가 앞서는 경우 음수 값
• 두 문자 시퀀스가 동등하게 비교되는 경우 0
• 인수로 지정된 문자 시퀀스보다 사전식 순서에서 * this 가 뒤따르는 경우 양수 값

예외

pos1 또는 pos2 매개변수를 취하는 오버로드는 인수가 범위를 벗어날 경우 std::out_of_range 를 발생시킵니다.

어떤 이유로든 예외가 발생하면, 이 함수는 아무런 효과를 가지지 않습니다( strong exception safety guarantee ).

가능한 구현

template<class CharT, class Traits, class Alloc>
int std::basic_string<CharT, Traits, Alloc>::compare
    (const std::basic_string& s) const noexcept
{
    size_type lhs_sz = size();
    size_type rhs_sz = s.size();
    int result = traits_type::compare(data(), s.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;
}

참고 사항

3방향 비교가 필요하지 않은 상황의 경우, std::basic_string 은 일반적인 관계 연산자들 ( < , <= , == , > , 등)을 제공합니다.

기본적으로 (기본 std::char_traits 사용 시), 이 함수는 로캘에 민감하지 않습니다. 로캘을 인식하는 3-way 문자열 비교를 위해서는 std::collate::compare 을 참조하십시오.

예제

#include <cassert>
#include <iomanip>
#include <iostream>
#include <string>
#include <string_view>
void print_compare_result(std::string_view str1,
                          std::string_view str2,
                          int compare_result)
{
    if (compare_result < 0)
        std::cout << std::quoted(str1) << " comes before "
                  << std::quoted(str2) << ".\n";
    else if (compare_result > 0)
        std::cout << std::quoted(str2) << " comes before "
                  << std::quoted(str1) << ".\n";
    else
        std::cout << std::quoted(str1) << " and "
                  << std::quoted(str2) << " are the same.\n";
}
int main()
{
    std::string batman{"Batman"};
    std::string superman{"Superman"};
    int compare_result{0};
    // 1) 다른 문자열과 비교
    compare_result = batman.compare(superman);
    std::cout << "1) ";
    print_compare_result("Batman", "Superman", compare_result);
    // 2) 부분 문자열을 다른 문자열과 비교
    compare_result = batman.compare(3, 3, superman);
    std::cout << "2) ";
    print_compare_result("man", "Superman", compare_result);
    // 3) 부분 문자열을 다른 부분 문자열과 비교
    compare_result = batman.compare(3, 3, superman, 5, 3);
    std::cout << "3) ";
    print_compare_result("man", "man", compare_result);
    // 부분 문자열을 다른 부분 문자열과 비교
    // 기본적으로 다른 문자열의 끝까지
    assert(compare_result == batman.compare(3, 3, superman, 5));
    // 4) char 포인터와 비교
    compare_result = batman.compare("Superman");
    std::cout << "4) ";
    print_compare_result("Batman", "Superman", compare_result);
    // 5) 부분 문자열을 char 포인터와 비교
    compare_result = batman.compare(3, 3, "Superman");
    std::cout << "5) ";
    print_compare_result("man", "Superman", compare_result);
    // 6) 부분 문자열을 char 포인터 부분 문자열과 비교
    compare_result = batman.compare(0, 3, "Superman", 5);
    std::cout << "6) ";
    print_compare_result("Bat", "Super", compare_result);
}

1) "Batman" comes before "Superman".
2) "Superman" comes before "man".
3) "man" and "man" are the same.
4) "Batman" comes before "Superman".
5) "Superman" comes before "man".
6) "Bat" comes before "Super".

결함 보고서

다음 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

참고 항목