[]
デモ ヘルプ APIリファレンス デザイナ
ダウンロード
(Showing Draft Content)

SJS.REGEXEXTRACT

この動的配列関数は、正規表現によって一致する部分文字列を抽出するのに役立ちます。動的配列は、単一のセルに入力した数式に基づいて自動的に計算を行い、複数のセルに値を返すサイズ変更可能な配列です。この関数を使用する前に、allowDynamicArray オプションを設定する必要があります。

書式

SJS.REGEXEXTRACT(text, regular_expression, [modifiers])

引数

有効な引数は次のとおりです。

引数

説明

text

検索するテキストを指定します。この関数は、文字列、セル参照、またはセル範囲参照を入力することができます。

regular_expression

抽出するテキストの条件を正規表現で指定します。

modifiers

（オプション） パターンを定義するために入力します。

  • g （グローバル）: 最後の一致のインデックスを保持し、次の検索を前の検索結果の末尾から開始することができます。

  • i （大文字と小文字を区別しない）: 表現全体を大文字小文字を区別しないようにします。

  • m （マルチライン）: m フラグを有効にすると、先頭と末尾のアンカーは、文字列全体の先頭と末尾ではなく、行の先頭と末尾と一致します。

  • u （unicode）: u フラグを有効にすると、フォームで拡張 Unicode エスケープを使用することができます。

  • s （dotall）：dotは改行を含む任意の文字と一致します。

解説

  • この関数は、テキスト（数値以外）を入力として使用し、テキストを出力として返すことができます。

  • 数値を出力として返す場合は、この関数と共に VALUE 関数を使用します。

  • 数値を入力として使用する場合は、TEXT 関数を使用して数値をテキストに変換します。

サンプル

spread.options.allowDynamicArray = true; すべてのサンプルで、allowDynamicArray を true に設定します。

SJS.REGEXEXTRACT("I think SpreadJS is Good", ".*(good).*", "i") 結果：Good

SJS.REGEXEXTRACT("There are 195 countries in the world", "\d+") 結果：195

SJS.REGEXEXTRACT("You can also extract multiple values from text.", "You can also (\w+) multiple (\w+) from text.") 結果：["extract", "values"]

エラー

  • textまたはregular_expressionの値がテキストでない場合は、#VALUE! エラーを返します。

  • パラメーターの長さが2未満の場合は、#N/A エラーを返します。

  • パラメーターが無効な場合は、#NAME エラーを返します。

  • regular_expression がテキストと一致しない場合は、 #N/A エラーを返します。

  • 配列結果が展開されていない場合は、#SPILL エラーを返します。