【機能】
文字列比較の結果を表す値を返します。
【構文】
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 を返します。
【必要条件】
バージョン 1