WorksheetFunction.Match(Object, Object, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定された順序での指定された値と一致する要素の、配列内での相対的な位置を表す数値を返します。 アイテム自体ではなく範囲内のアイテムの位置が必要な場合は、Lookup(Object, Object, Object)関数の 1 つではなく、Match を使用します。
public double Match(object Arg1, object Arg2, object Arg3);Public Function Match (Arg1 As Object, Arg2 As Object, Optional Arg3 As Object) As Doubleパラメーター
- Arg1
- Object
検査値: 表の中で必要な項目を検索するために使用する値を指定します。
- Arg2
- Object
検査範囲: 検査値を含む隣接したセル範囲を指定します。 検査範囲は、配列または配列に対するセル参照を指定してもかまいません。
- Arg3
- Object
照合の型: -1、0、1 の数値のいずれかを指定します。 照合の型には、検査範囲の中で検査値を探す方法を指定します。
返品
注釈
Lookup_value には、lookup_array の中で照合する値を指定します。 たとえば、電話帳で誰かの番号を検索するとき、参照値としてその人の名前を使用していますが、電話番号は必要な値です。
検査値には、数値、文字列、論理値、またはこれらの値に対するセル参照を指定できます。
match_typeが 1 の場合、[ 一致 ] は lookup_value 以下の最大値を探します。 Lookup_array は昇順で配置する必要があります: ...-2、-1、0、1、2、...、A-Z、 false、 true。
match_typeが 0 の場合、[ 一致 ] は lookup_value と正確に等しい最初の値を検索します。 このとき検査範囲を並べ替えておく必要はありません。
match_type が -1 の場合、[ 一致 ] は lookup_value 以上の最小値を検索します。 Lookup_array は、 true、 false、za、...2、1、0、-1、-2、...など。match_typeを省略すると、1 と見なされます。
Match は、値自体ではなく、lookup_array内の一致した値の位置を返します。 たとえば、MATCH("b",{"a","b","c"},0) は、{"a"、"b"、"c"} の配列内での "b" の相対的な位置である "2" を返します。
一致 は、テキスト値の照合時に大文字と小文字を区別しません。
Match で一致が見つからなかった場合は、エラー値 #N/A が返されます。
If match_type is 0 and lookup_value is text, you can use the wildcard characters, question mark (?) and asterisk (*), in lookup_value. ワイルドカード文字の疑問符は任意の 1 文字を表し、アスタリスクは任意の文字列を表します。 ワイルドカード文字ではなく、通常の文字として疑問符やアスタリスクを検索する場合は、その文字の前に、"~*" のように半角のティルダ (~) を付けます。