std::strncmp
From cppreference.com
| ヘッダー <cstring> で定義 |
||
| int strncmp( const char* lhs, const char* rhs, std::size_t count ); |
||
2つの、ヌル終端されている可能性のある配列の最大count文字を比較します。比較は辞書順で行われます。ヌル文字の後の文字は比較されません。
結果の符号は、比較されている配列で異なる最初の文字ペアの値（両方ともunsigned charとして解釈されます）の差の符号です。
配列lhsまたはrhsのいずれかの終端を越えてアクセスが発生した場合、動作は未定義です。配列lhsまたはrhsがヌルポインタである場合、動作は未定義です。
目次 |
[編集] パラメータ
| lhs, rhs | - | 比較する、ヌル終端されている可能性のある配列へのポインタ |
| count | - | 比較する最大文字数 |
[編集] 戻り値
lhsが辞書順でrhsより前にある場合、負の値。
lhsとrhsが等しいと評価される場合、またはcountがゼロの場合、ゼロ。
lhsが辞書順でrhsより後にある場合、正の値。
[編集] 注記
std::strcollやstd::strxfrmとは異なり、この関数はロケールに依存しません。
[編集] 例
このコードを実行
#include <cstring> #include <iostream> void demo(const char* lhs, const char* rhs, int sz) { const int rc = std::strncmp(lhs, rhs, sz); if (rc < 0) std::cout << "First " << sz << " chars of [" << lhs << "] precede [" << rhs << "]\n"; else if (rc > 0) std::cout << "First " << sz << " chars of [" << lhs << "] follow [" << rhs << "]\n"; else std::cout << "First " << sz << " chars of [" << lhs << "] equal [" << rhs << "]\n"; } int main() { demo("Hello, world!", "Hello, everybody!", 13); demo("Hello, everybody!", "Hello, world!", 13); demo("Hello, everybody!", "Hello, world!", 7); demo("Hello, everybody!" + 12, "Hello, somebody!" + 11, 5); }
出力
First 13 chars of [Hello, world!] follow [Hello, everybody!] First 13 chars of [Hello, everybody!] precede [Hello, world!] First 7 chars of [Hello, everybody!] equal [Hello, world!] First 5 chars of [body!] equal [body!]
[編集] 関連項目
| 2つの文字列を比較する (関数) | |
| 2つのワイド文字列から指定された文字数を比較する (関数) | |
| 2つのバッファを比較する (関数) | |
| 現在のロケールに従って2つの文字列を比較する (関数) | |
| C言語のドキュメント strncmp
| |
