オフセット位置以降にある、文字列内の正規表現を検索します。一致が見つかると、関数は文字列を3つの部分文字列に分割します。正規表現は、パターンマッチングに使用する文字の特定の組み合わせを必要とします。この関数では、「正規表現で一致」関数よりも一致文字列に関するオプションが少ないですが、より速い速度で実行されます。

「パターンで一致」関数で使用できる正規表現は限定されており、文字のグループ化、代替パターン一致、前方参照、非グリーディ修飾はサポートされていません。特殊文字の特定のセットを使用すると、検索の精度を上げることができます。コネクタペーンには、この多態性関数のデフォルトのデータタイプが表示されます。


icon

入力/出力

  • cstr.png 文字列

    文字列には、関数により検索する入力文字列を指定します。

  • cstr.png 正規表現

    正規表現は、文字列内で検索するパターンです。関数により正規表現が検出されない場合、一致部分文字列は空文字列を返し、部分文字列の前文字列全体を返し、部分文字列の後は空を返し、そして一致後オフセットは–1を返します。

  • ci32.png オフセット (0)

    オフセットは、文字列に対して一致の検索を開始する文字数位置を指定します。オフセットは数値である必要があります。文字列の最初の文字のオフセットは0です。オフセットが未配線、または0未満の場合、関数はオフセットを0とみなします。

  • istr.png 部分文字列の前

    部分文字列の前は、一致した文字列の前のすべての文字を含む文字列を返します。

  • istr.png 一致部分文字列

    一致部分文字列は一致した文字列です。

  • istr.png 部分文字列の後

    部分文字列の後は、一致した文字列の後のすべての文字が含まれています。

  • ii32.png 一致後オフセット

    一致後オフセットは、部分文字列の後の最初の文字の文字列における指標です。関数が一致を検出しない場合は、一致後オフセットは–1になります。正規表現で空文字列が検索されると、オフセット入力と一致後オフセット出力が同じになる場合があります。たとえば、正規表現b*で、文字列入力がcdbの場合、一致後オフセットは0となります。文字列bbbcdの場合、一致後オフセットは3です。

  • この関数は「パターンの検索と置換」VIに似ています。「パターンで一致」関数では、「正規表現で一致」関数よりも文字列に一致するオプションが少ないですが、より速い速度で実行されます。たとえば、「パターンで一致」関数は括弧や垂直バー(|)の文字をサポートしていません。

    以下の表は、この関数と使用できる正規表現のサンプルを示します。一部のサンプルは、特殊文字を使用して検索を絞ります。

    メモ 検索文字列に特殊文字を含める場合は、各特殊文字を [ ] で囲む必要があります。たとえば、hz+という文字列を検索するには、正規表現を使ってhz[+]と入力します。それ以外の場合は、特殊文字を使用して検索が絞り込まれます。
    検索する文字列正規表現
    VOLTSVOLTS
    大文字と小文字のすべてのvoltsのパターン (VOLTSVoltsvoltsなど)[Vv][Oo][Ll][Tt][Ss]
    スペース、プラス記号、またはマイナス記号[ +-]
    1つまたは複数の数字のシーケンス[0-9]+
    ゼロ以上のスペース[\s*]または[ *] (つまり、スペースの後にアスタリスクマーク)
    1つまたは複数のスペース、タブ、新規の行、または復帰改行[\t \r \n \s]+
    数字以外の1つまたは複数の文字[~0-9]+
    文字列のオフセットポジションで始まる場合、語句はLevelのみ^Level
    文字列の最後に表示する場合、語句はVoltsのみVolts$
    括弧内の最長文字列(.*)
    括弧内の最長文字列で、内部に括弧が含まれないもの([~()]*)
    左括弧\[
    右括弧\]
    catdogcotdotcogなど。[cd][ao][tg]