StrComp 関数
文字列比較の結果を表す値を返します。
StrComp(string1, string2[, compare])
引数
- string1
必ず指定します。任意の文字列式を指定します。 - string2
必ず指定します。任意の文字列式を指定します。 - compare
省略可能です。文字列式を評価するときに使用する文字列比較のモードを表す数値を指定します。引数 compare を省略すると、バイナリ モードで比較が行われます。設定する値については、次の「設定値」を参照してください。
設定値
引数 compare の設定値は次のとおりです。
| 定数 | 値 | 内容 |
|---|---|---|
| vbBinaryCompare | 0 | バイナリ モードで比較を行います。 |
| vbTextCompare | 1 | テキスト モードで比較を行います。 |
戻り値
StrComp 関数の戻り値は次のとおりです。
| 条件 | StrComp の戻り値 |
|---|---|
| string1 は string2 未満 | -1 |
| string1 と string2 は等しい | 0 |
| string1 は string2 を超える | 1 |
| string1 または string2 は Null 値 | Null 値 |
解説
次のコードは、StrComp 関数を使って文字列比較の結果を返す例です。3 番目の引数が 1 の場合は、テキスト モードで比較を行い、0 または省略された場合は、バイナリ モードで比較を行います。
Dim MyStr1, MyStr2, MyComp
MyStr1 = "ABCD": MyStr2 = "abcd" ' 変数を定義します。
MyComp = StrComp(MyStr1, MyStr2, 1) ' 0 を返します。
MyComp = StrComp(MyStr1, MyStr2, 0) ' -1 を返します。
MyComp = StrComp(MyStr2, MyStr1) ' 1 を返します。