大文字小文字を区別する比較を有効にします。これらのディレクティブを指定すると、"ABC" と "abc" は異なるものとして扱われます。

大文字小文字を区別しない比較を有効にします（デフォルトの動作）。これらのディレクティブを指定すると、"ABC" と "abc" は同一として扱われます。

フィルタ式の最適化を有効にします（デフォルトの動作）。複雑な式の場合、パフォーマンスが向上する可能性があります。

フィルタ式の最適化を無効にします。デバッグ時や、最適化によって予期しない結果が発生する場合に役立ちます。

フィルタ式に名前を付けます。名前に空白や特殊文字を含む場合は、二重引用符で囲む必要があります。空白を含まない名前は引用符なしで指定できます。

指定した名前は、エラーメッセージや診断出力でフィルタを識別するために使用されます。複数の複雑なフィルタ式を扱う場合に特に便利です。

ファイルが存在する場合は true を返し、存在しない場合は false を返します。

ファイル名

拡張子を除いたファイル名を返します。たとえば、"document.txt" は "document" を返します。

ファイル拡張子

項目がフォルダー/ディレクトリの場合は true を返し、ファイルの場合は false を返します。

ファイル名およびベースフォルダーを除いた相対パスを返します。

比較ルートディレクトリからの相対パスを、フォルダーパスとファイル名を含めて返します。例えば、"C:\Project" を比較していて、ファイルが "C:\Project\src\main.cpp" にある場合、RelPath は "src\main.cpp" を返します。

ファイルのフルパスを返します。

ファイルサイズ

最終更新のタイムスタンプ

yyyy-MM-dd 形式の最終更新日付の文字列を返します。

作成日時のタイムスタンプを返します。

ファイル属性を整数値で返します。

ファイル属性の文字列を返します。例："R" は読み取り専用、"H" は隠しファイル、"A" はアーカイブ、"S" はシステムファイルを示します。

ファイルの内容を表します。FileContent 型の値を返します。この型には contains および recontains のみ使用できます。

フォルダーに直接含まれるファイル数。

すべてのサブフォルダーを含めた、フォルダー内のファイル総数。

フォルダーに直接含まれる項目（ファイルおよびサブフォルダー）の数。

すべてのサブフォルダーを含めた、フォルダー内の項目（ファイルおよびサブフォルダー）の総数。

フォルダーに直接含まれるすべてのファイルの合計サイズ（バイト単位）。

すべてのサブフォルダーを含めた、フォルダー内のすべてのファイルの合計サイズ（バイト単位）。

指定した正規プロパティ名に対応するプロパティ値の配列（Left、Middle、Right）を返します。例: prop("System.Title")

左側のファイルのプロパティ値を返します。例: leftprop("System.FileOwner")

中央のファイル（3-way 比較時）のプロパティ値を返します。

右側のファイルのプロパティ値を返します。

比較結果が項目が同一であることを示す場合は true、それ以外の場合は false を返します。これはグローバル属性（サイド別プレフィックスは使用不可）です。例: Identical と指定すると同一ファイルのみを表示します。

比較結果が項目が異なることを示す場合は true、それ以外の場合は false を返します。これはグローバル属性（サイド別プレフィックスは使用不可）です。例: Different と指定すると差異のあるファイルのみを表示します。

エラーやフィルタールールにより比較がスキップされた場合は true、それ以外の場合は false を返します。これはグローバル属性（サイド別プレフィックスは使用不可）です。例: Skipped と指定するとスキップされた項目のみを表示します。

ファイルがバイナリとして検出された場合は true、テキストの場合は false、ファイルが存在しない場合は none を返します。この属性はサイド別プレフィックス（例: LeftBinary、RightBinary）に対応しています。例: allof(Binary) と指定すると、すべての側でバイナリであるファイルを表示します。

3方向比較において左と中央のファイルが異なる場合は true、それ以外は false を返します。2方向比較では none を返します。これはグローバル属性（サイド別プレフィックスは使用不可）です。例: DifferentLeftMiddle and not DifferentMiddleRight と指定すると、左のみが中央と異なるファイルを見つけることができます。

3方向比較において中央と右のファイルが異なる場合は true、それ以外は false を返します。2方向比較では none を返します。これはグローバル属性（サイド別プレフィックスは使用不可）です。例: DifferentMiddleRight と指定すると、中央と右が異なるファイルを表示します。

3方向比較では左と右のファイルが異なる場合に true、それ以外は false を返します。2方向比較では両方のファイルが存在し、かつ異なる場合に true を返します。これはグローバル属性（サイド別プレフィックスは使用不可）です。例: DifferentLeftRight と指定すると、左と右が異なるファイルを表示します。

ファイル比較におけるテキスト差分の数を返します。この属性は比較済みのテキストファイルに対してのみ有効です。これはグローバル属性（サイド別プレフィックスは使用不可）です。例: Differences > 0 と指定すると差分のあるファイルを表示し、Differences > 10 と指定すると差分が10個を超えるファイルを表示します。

ファイル比較において無視された差分の数（行フィルターや空白設定により除外された差分）を返します。この属性は比較済みのテキストファイルに対してのみ有効です。これはグローバル属性（サイド別プレフィックスは使用不可）です。例: IgnoredDiffs > 0 と指定すると無視された差分があるファイルを表示し、Differences = 0 and IgnoredDiffs > 0 と指定すると無視された差分を除けば同一であるファイルを表示します。

ファイル比較に使用された展開プラグインの名前を返します。展開プラグインが使用されていない場合は空文字列を返します。これはグローバル属性であり（左右別のプレフィックスには対応していません）。例: Unpacker = "CompareMSExcelFiles" は Excel 展開プラグインを使用して比較されたファイルを表示し、Unpacker != "" は展開プラグインが使用されたすべてのファイルを表示します。

ファイル比較に使用された比較前処理プラグインの名前を返します。比較前処理プラグインが使用されていない場合は空文字列を返します。これはグローバル属性であり（左右別のプレフィックスには対応していません）。例: Prediffer = "IgnoreColumns" は IgnoreColumns 比較前処理プラグインを使用して比較されたファイルを表示し、Prediffer != "" は比較前処理プラグインが使用されたすべてのファイルを表示します。

行末 (EOL) スタイルを整数値として返します。ファイルに対しては主要な EOL スタイルを返し、行に対してはその行の EOL スタイルを返します。

値: 0 = なし、1 = LF (Unix)、2 = CR (Mac)、3 = CRLF (Windows)、4 = 混在（ファイル内に複数の EOL スタイルあり）

行末（EOL）の形式を文字列として返します。ファイルの場合は、そのファイルで主に使用されている行末形式を返し、行の場合は、その特定の行の行末形式を返します。

行末 (EOL) スタイルを文字列として返します。ファイルに対しては主要な EOL スタイルを返し、行に対してはその行の EOL スタイルを返します。

ファイルのコードページ（文字エンコーディング）を整数値で返します。この属性はサイド別プレフィックス（例: LeftCodepage、RightCodepage）に対応しています。例: Codepage = 65001 と指定すると UTF-8 のファイルを表示し、allof(Codepage = 65001) と指定するとすべての側で UTF-8 のファイルを表示します。

ファイルに Byte Order Mark（BOM）がある場合は true、それ以外の場合は false を返します。この属性はサイド別プレフィックス（例: LeftHasBOM、RightHasBOM）に対応しています。例: HasBOM と指定すると BOM のあるファイルを表示し、not HasBOM と指定すると BOM のないファイルを表示します。

文字列の長さを Integer として返します。source が文字列の配列である場合、結果は整数の配列になります。例: strlen(Name)

str 内に部分文字列 substr が出現する回数を数えます。デフォルトでは大文字・小文字を区別しません (@cs/@ci ディレクティブに従います)。str が配列の場合、結果は各要素の件数を格納した整数配列になります。重複マッチは個別にカウントされます (例: strCount("aaaa", "aa") は 2 を返します)。

例:

str 内で正規表現 pattern がマッチする回数を数えます。デフォルトでは大文字・小文字を区別しません (@cs/@ci ディレクティブに従います)。str が配列の場合、結果は各要素の件数を格納した整数配列になります。無限ループを避けるため、ゼロ長のマッチも適切に処理されます。

例:

str 内の部分文字列 substr の N 番目の出現位置 (0 基底) を返します。省略可能な occurrence パラメータは何番目の出現を検索するかを指定します (0 基底、デフォルトは 0 で最初の出現)。デフォルトでは大文字・小文字を区別しません (@cs/@ci ディレクティブに従います)。部分文字列が見つからない場合や出現インデックスが範囲外の場合は none を返します。str が配列の場合、結果は位置 (または none 値) の配列になります。

例:

str 内で正規表現が N 番目にマッチする位置 (0 基底)を返します。省略可能な group パラメータは検索するキャプチャグループを指定します (0 基底、デフォルトは 0 でマッチ全体)。省略可能な occurrence パラメータはパターンの何番目の出現を検索するかを指定します (0 基底、デフォルトは 0 で最初の出現)。デフォルトでは大文字・小文字を区別しません (@cs/@ci ディレクティブに従います)。パターンがマッチしない場合、グループインデックスが範囲外の場合、または出現インデックスが範囲外の場合は none を返します。str が配列の場合、結果は位置 (または none 値) の配列になります。

例:

文字列または文字列の配列 から指定範囲の文字列を String 型で返します。source が文字列配列の場合、結果は文字列配列になります。例: substr(Name, 0, 3)

文字列内に含まれる部分文字列 'from' をすべて 'to' に置換します。strが文字列配列の場合、結果は文字列配列になります。例: replace(name, "_old", "_new")

正規表現 pattern に一致するすべての部分を replacement 文字列で置換します。replacement 文字列では後方参照（$1、$2 など）を使用できます。strが文字列配列の場合、結果は文字列配列になります。例: regexReplace(name, "^(\w+)(\w+)$", "$2$1") は、アンダースコアで区切られた単語の順序を入れ替えます。

タブ区切りファイルから読み込んだ置換ルールを使用して、str 内の複数の文字列を置換します。ファイル形式は 1 行につき 1 つの置換ルールで、search_string<TAB>replacement_string の形式です。# で始まる行はコメントとして扱われ、無視されます。空行も無視されます。str が配列の場合、置換が適用された文字列の配列が結果として返されます。

ファイル形式の例:

# コメント行
apple	orange
cat	dog
old	new

例:

タブ区切りファイルから読み込んだ正規表現パターンを使用して、str 内の文字列を置換します。ファイル形式は 1 行につき 1 つのパターンで、regex_pattern<TAB>replacement_string の形式です。置換文字列には、キャプチャされたグループへの後方参照 ($1, $2 など) を含めることができます。# で始まる行はコメントとして扱われ、無視されます。空行も無視されます。str が配列の場合、置換が適用された文字列の配列が結果として返されます。

ファイル形式の例:

# コメント行
\d+	NUMBER
(\d{4})-(\d{2})-(\d{2})	$1_$2_$3

例:

文字列から正規表現パターンにマッチするテキストを取り出します。省略可能な group パラメータは抽出するキャプチャグループを指定します (0 基底)。グループ 0 (デフォルト) はマッチ全体を返し、グループ 1、2 などはパターン内の括弧で定義された対応するキャプチャグループを返します。省略可能な offset パラメータはパターンの何番目の出現を取り出すかを指定します (0 基底)。オフセット 0 (デフォルト) は最初のマッチを返し、オフセット 1 は 2 番目のマッチを返します。これは文字列内の 2 番目の数値など、行内の N 番目の出現を取り出す際に便利です。パターンがマッチしない場合、グループインデックスが範囲外の場合、またはオフセットがマッチ数を超える場合は none を返します。str が配列の場合、結果は各要素のキャプチャを格納した配列になります。デフォルトでは大文字・小文字を区別しません (@cs/@ci ディレクティブに従います)。

例:

Unicode 文字列を正規化します。省略可能な form パラメータで正規化形式を指定できます。指定可能な形式は "NFC" または "C"（既定値）、"NFD" または "D"、"NFKC" または "KC"、"NFKD" または "KD" です。数値形式も指定できます: 1=NFC、2=NFD、5=NFKC、6=NFKD。strが文字列配列の場合、結果は文字列配列になります。例: normalizeUnicode(name, "NFC")

文字列内のすべての文字を小文字に変換します。str が配列の場合、結果は小文字に変換された文字列の配列になります。例: toLower("Hello World") は "hello world" を返します。

文字列内のすべての文字を大文字に変換します。str が配列の場合、結果は大文字に変換された文字列の配列になります。例: toUpper("Hello World") は "HELLO WORLD" を返します。

全角文字を半角文字に変換します。主に全角の英数字やカタカナを半角に変換するために使用されます。str が配列の場合、結果は変換された文字列の配列になります。

半角文字を全角文字に変換します。主に半角の英数字やカタカナを全角に変換するために使用されます。str が配列の場合、結果は変換された文字列の配列になります。

ひらがなをカタカナに変換します。ひらがな以外の文字は変更されません。str が配列の場合、結果は変換された文字列の配列になります。

カタカナをひらがなに変換します。カタカナ以外の文字は変更されません。str が配列の場合、結果は変換された文字列の配列になります。

繁体字中国語を簡体字中国語に変換します。簡体字が存在しない文字は変更されません。str が配列の場合、結果は変換された文字列の配列になります。

簡体字中国語を繁体字中国語に変換します。繁体字が存在しない文字は変更されません。str が配列の場合、結果は変換された文字列の配列になります。

文字列の先頭および末尾の空白文字（スペース、タブ、改行、復帰）を除去します。str が配列の場合、結果はトリムされた文字列の配列になります。

例:

文字列の先頭の空白文字（スペース、タブ、改行、復帰）を除去します。末尾の空白はそのまま保持されます。str が配列の場合、結果は左トリムされた文字列の配列になります。

例:

文字列の末尾の空白文字（スペース、タブ、改行、復帰）を除去します。先頭の空白はそのまま保持されます。str が配列の場合、結果は右トリムされた文字列の配列になります。

例:

ファイル内容またはファイル内容の配列の行数を Integer として返します。content が配列の場合、結果は整数の配列になります。例: lineCount(Content)

ファイル内容またはファイル内容の配列から、指定した開始行から指定行数の行を抽出し、連結した文字列として返します。content が配列の場合、結果は文字列の配列になります。

文字列を数値に変換します。toNumber は入力形式に応じて整数または浮動小数点数を返します。toInt は整数のみを返します。toDouble は浮動小数点数のみを返します。入力内のカンマは無視されます。パース失敗時は none を返します。例: le:toInt(Column("Count")) > 100

文字列をタイムスタンプ値に変換します。複数の日付・時刻形式をサポートします。文字列をパースできない場合は none を返します。例: toDateTime("2025-01-15") > today()

現在の日時を Timestamp 型の値として返します。

本日の日付を、日の始まりである 00:00:00.000 を表す Timestamp 型として返します。

週の初日（日曜日）を返します。ロケールには依存しません。

月の初日を返します。

年の初日を返します。

指定されたタイムスタンプをyyyy-MM-dd 形式の文字列に変換して返します。timestampがタイムスタンプ配列の場合、結果は文字列配列になります。

整数または整数の配列 の絶対値を返します。value が整数配列である場合、結果は整数配列になります。

value が範囲 [min, max]（両端を含む）内にある場合に true を返します。整数、浮動小数点数、タイムスタンプ、文字列（大文字小文字を区別しない比較）に対応しています。value が配列の場合は、各要素を個別に評価した真偽値の配列を返します。

例:

value が範囲 [min, max)（下限を含み、上限を含まない）内にある場合に true を返します。整数、浮動小数点数、タイムスタンプ、文字列（大文字小文字を区別しない比較）に対応しています。value が配列の場合は、各要素を個別に評価した真偽値の配列を返します。

例:

指定された値から配列を作成します。例：array(1, 2, 3)

指定されたインデックス（0から数える）の位置にある要素を返します。負のインデックスは末尾から数えます。例：at(array(1, 2, 3), -1) は3 を返します

ブール値の配列 のいずれかの要素が条件を満たす場合に true を返します。

ブール値の配列 のすべての要素が条件を満たす場合に true を返します。

配列内のすべての値が等しい場合に true を返します。

値の長さを Integer として返します。

動作:

例:

condition が true と評価された場合は trueValue を返し、それ以外の場合は falseValue を返します。この関数は短絡評価を行います（返される側の分岐のみが評価されます）。

例:

要素ごとの条件付き選択を行います。conditionArray の各要素について、条件が true の場合は trueValue の対応する要素を、false の場合は falseValue の対応する要素を返します。trueValue または falseValue がスカラー値の場合は、すべての要素にブロードキャストされます。

例:

index に基づいて引数の中から値を選択します。index が 0 の場合は value0 を、1 の場合は value1 を返します。負のインデックスは 0 として扱われます。最後の値を超えるインデックスが指定された場合は、最後の値を返します。

例:

要素ごとの値選択を行います。indexArray の各インデックスに対して、残りの引数から対応する値を選択します。indexArray がスカラー値の場合は choose と同じ動作になります。

例:

要素ごとの論理演算を行います。これらの関数は、真偽値、真偽値配列、またはその組み合わせに対して動作します。

引数がスカラー値の場合はスカラーの真偽値を返します。一方が配列でもう一方がスカラー値の場合は、スカラー値がすべての要素にブロードキャストされます。両方が配列の場合は、要素ごとの演算が行われます。

例:

すべての引数の文字列表現を連結してログに出力します（それぞれエラー、警告、情報レベルで出力）。引数は空白で区切られ、最後の引数の値が関数の戻り値として返されます。これらの関数はフィルタ式のデバッグに便利です。

使用例（戻り値を利用する場合）: