目次 - SDL 3.0 API(機能別) - 標準ライブラリ - SDL_wcsncmp

SDL_wcsncmp

2つのNUL終端のワイド文字列の最大n w_char個を比較する

ヘッダ

SDL3/SDL_stdinc.h

構文

int SDL_wcsncmp(const wchar_t *str1, const wchar_t *str2, size_t maxlen);

引数

const wchar_t *str1比較する1つ目の文字列. NULL不可
const wchar_t *str2比較する2つ目の文字列. NULL不可
size_tmaxlen比較する最大w_char数

戻り値

(int) str1str2「未満」のとき負の数, str1str2を「超える」とき正の数, 文字列が一致するとき0を戻す.

詳細

この関数はwchar_tのみの文字列を終端のNUL文字まで比較する. 正しいUTF-16(またはUTF-32, wchar_tのサイズは環境による)であるかや, 有効なUnicodeの値であるかは考慮されない.

この関数はUTF-16(またはUTF032, wchar_tのサイズは環境による)を想定しているが, Unicodeコードポイントではなく, wchar_tの値をそのまま比較している. maxlenは比較する最大wchar_t数である. この制限がUTF-16のマルチバイトの途中だった場合でも最後のwchar_tを比較するだけである.

maxlenは比較する最大wchar_t数である. 文字列がこのwchar_t数(またはこのwchar_t数以内に両方の文字列にNUL終端がある)で一致する場合, 文字列は一致するとみなされる.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

SDL Wikiへのリンク

SDL_wcsncmp - SDL Wiki