SpreadJS製品ヘルプ
SINGLE
関数リファレンス > 関数の一覧 > 検索/行列関数 > SINGLE

この関数は、交差ロジックを使用して、単一の値、単一のセル範囲、またはエラーを返します。交差ロジックには、暗黙的交差と明示的交差の2種類があります。

暗黙の交差ロジックは、値の配列から単一の値を選択すると同時に、数式がセルが保持できる1つの値のみを返すことを保証します。暗黙の交差は、ユーザーが単一の値を期待する関数の範囲引数を指定したいときに、数式が配列数式(Ctrl+Shift+Enter で入力される数式)でない場合に使用することができます。この場合、数式セルの列または行と交差する範囲のセル内の値が、関数に使用されます。

動的配列が有効な場合、「暗黙の交点」はサポートされないので、単一の値を返すためには、ユーザーはSINGLE関数(または「@」演算子)を使って「明示的交点」を指定する必要があります。これは、range引数を指定すると、関数に範囲が渡され、結果が動的配列として流出するためです。

書式

SINGLE(value)

引数

value - [必須] 暗黙の交点を用いて評価したい値を指定する。

データ型

セル範囲の形式で値を受け入れます。単一の値、単一のセル範囲、またはエラーを返します。

解説

ユーザーが指定した引数に範囲が含まれている場合、SINGLE関数は、数式セルの行または列の交点にあるセルを返します。ただし、交差がない場合、または複数のセルが交差に該当する場合、この関数は#VALUE!エラーを返します。さらに、ユーザーが指定した引数に配列が含まれている場合、SINGLE関数は最初の項目(すなわち、行1、列1)を​​返します。

サンプル

例えば、次の画像のセル A15 には、数式 "=SINGLE(A15:E15)" が含まれており、セル範囲 A15 から E15 の行と列の交差を評価することによって、セル C16 に結果 "C" が返されます。

利用可能なバージョン

この関数は、SpreadJS13以降で使用できます。