StrComp 関数
文字列比較の結果を示す、サブタイプが整数型 (Integer) であるバリアント型 (Variant) の値を返します。
構文
StrComp(string1, string2, [ compare ])
StrComp 関数の構文には、次の名前付き引数があります。
| 指定項目 | 説明 |
|---|---|
| string1 | 必須です。 任意の有効な文字列式を指定します。 |
| string2 | 必須。 任意の有効な文字列式を指定します。 |
| compare | 省略可能。 文字列比較の種類を指定します。 compare引数が Null の場合、エラーが発生します。 compare が省略された場合、Option Compare 設定は比較のタイプを決定します。 |
Settings
compare 引数の設定値は以下のとおりです。
| 定数 | 値 | 説明 |
|---|---|---|
| vbUseCompareOption | -1 | Option Compare ステートメントの設定を使用して比較を実行します。 |
| vbBinaryCompare | 0 | バイナリ比較を実行します。 |
| vbTextCompare | 1 | テキスト比較を実行します。 |
| vbDatabaseCompare | 2 | Microsoft Access のみ。 データベース内の情報に基づいて比較を実行します。 |
戻り値
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" ' Define variables.
MyComp = StrComp(MyStr1, MyStr2, 1) ' Returns 0.
MyComp = StrComp(MyStr1, MyStr2, 0) ' Returns -1.
MyComp = StrComp(MyStr2, MyStr1) ' Returns 1.
関連項目
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。