std::wcsncmp

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

ヌル終端ワイド文字列

関数
文字操作
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit iswblank (C++11) wctype iswctype	iswcntrl iswgraph iswspace iswprint iswpunct towlower towupper wctrans towctrans
数値形式への変換
wcstolwcstoll (C++11) wcstoulwcstoull (C++11)	wcstofwcstodwcstold (C++11)(C++11) wcstoimaxwcstouimax (C++11)(C++11)
文字列操作
wcslen wcscpy wcsncpy wcscat wcsncat wcscmp wcscoll wcsncmp	wcsxfrm wcschr wcsrchr wcspbrk wcsspn wcscspn wcsstr wcstok
配列操作
wmemcpy
wmemmove
wmemcmp
wmemchr
wmemset

 

<tbody> </tbody>

ヘッダ <cwchar> で定義
int wcsncmp( const wchar_t* lhs, const wchar_t* rhs, std::size_t count );

2つのヌル終端ワイド文字列の最大 count 個のワイド文字を比較します。 比較は辞書順で行われます。

結果の符号は比較する文字列内の最初の異なるワイド文字の組の値の差の符号です。

lhs または rhs がヌル終端文字列を指すポインタでない場合、動作は未定義です。

引数

lhs, rhs	-	比較するヌル終端ワイド文字列を指すポインタ
count	-	比較する最大文字数

戻り値

辞書順で lhs が rhs より前に現れる場合は負の値。

lhs と rhs が等しい場合はゼロ。

辞書順で lhs が rhs より後に現れる場合は正の値。

例

Run this code

#include <iostream>
#include <cwchar>
#include <clocale>
#include <locale>

void demo(const wchar_t* lhs, const wchar_t* rhs, int sz)
{
    int rc = std::wcsncmp(lhs, rhs, sz);
    if(rc == 0)
        std::wcout << "First " << sz << " characters of ["
                  << lhs << "] equal [" << rhs << "]\n";
    else if(rc < 0)
        std::wcout << "First " << sz << " characters of ["
                  << lhs << "] precede [" << rhs << "]\n";
    else if(rc > 0)
        std::wcout << "First " << sz << " characters of ["
                  << lhs << "] follow [" << rhs << "]\n";
}

int main()
{
    const wchar_t str1[] = L"안녕하세요";
    const wchar_t str2[] = L"안녕히 가십시오";

    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
    demo(str1, str2, 5);
    demo(str2, str1, 8);
    demo(str1, str2, 2);
}

出力:

First 5 characters of [안녕하세요] precede [안녕히 가십시오]
First 8 characters of [안녕히 가십시오] follow [안녕하세요]
First 2 characters of [안녕하세요] equal [안녕히 가십시오]

関連項目

strncmp	2つの文字列の文字を一定量比較します (関数)
wcscmp	2つのワイド文字列を比較します (関数)
wmemcmp	2つの配列のワイド文字を一定量比較します (関数)
wcscoll	現在のロケールに従って2つのワイド文字列を比較します (関数)
wcsncmp の C言語リファレンス