5.2.6 マージオプション（-merge）

キーフィールドを指定します。
1つのキーフィールドは、位置、長さ、データ形式、および操作で構成されます。
複数のキーフィールドを指定した場合、指定した順に比較が行われます。複数のキーフィールドを指定する場合は、キーフィールドをコンマ( , )で区切って指定します。また、keyオペランドを複数指定することもできます。
keyオペランドを省略した場合、レコード全体をキーフィールドとみなしてコードの昇順に並べます。

注意

テキストファイルCSV形式、テキストファイルTSV形式の場合、キーフィールドは省略できません。

記述形式

key=key-definition [ ,key-definition ...] [ key= ...]

key-definition の記述形式

key-definition の記述形式には、以下の2つの形式があります。

key-definition の記述形式1
key-definition の記述形式1では、入力レコード中のフィールドをキーフィールドとして指定します。
```
pos.len typ [ opt ]
```

key-definition の記述形式2
key-definition の記述形式2では、レコード全体をキーフィールドとして指定します。
テキストファイルCSV形式、テキストファイルTSV形式の場合は、指定できません。
```
ALL [ opt ]
```

pos

キーフィールドの位置を指定します。
バイナリファイルとテキストファイル固定フィールド指定の場合は、レコードの先頭を0としたバイト位置を指定します。テキストファイル浮動フィールド指定、テキストファイルCSV形式、およびテキストファイルTSV形式の場合は、0から数えたフィールド番号を指定します。

len

キーフィールドの長さをバイト数で指定します。
テキストファイル浮動フィールド指定、テキストファイルCSV形式、およびテキストファイルTSV形式の場合、指定したフィールド長よりも長いフィールドが現れた場合は、指定したフィールド長で処理します。指定したフィールド長よりも短いフィールドが現れた場合は、実際のフィールド長で処理します。
typ に符号なし2進数を指定する場合は、1バイト分のビットを選択するためのマスク値を10進数でlen に指定します。このとき、pos の位置にある1バイトのフィールド値とマスク値の論理積がキー値になります。
指定可能な各データ形式の長さについては、2.6.4.1 キーフィールドに指定可能なデータ形式を参照してください。

注意

テキストファイルCSV形式、およびテキストファイルTSV形式の場合、フィールドを囲むダブルクォーテーション( " )は、キーフィールドの長さに含みません。また、ダブルクォーテーション( " )で囲まれたフィールド内の2つ連続したダブルクォーテーション( "" )は、1つのダブルクォーテーション( " )として長さを計算します。

例) テキストファイルCSV形式における、キーフィールドと長さ

キーフィールド        キーフィールドとして有効な文字        キーフィールドの長さ
ABC                   ABC                                   3バイト
"ABC"                 ABC                                   3バイト
"A""B""C"             A"B"C                                 5バイト
"A,B,C"               A,B,C                                 5バイト

typ

キーフィールドのデータ形式を指定します。
指定可能なデータ形式については、2.6.4.1 キーフィールドに指定可能なデータ形式を参照してください。

opt

キーフィールドの操作を指定します。
指定可能な操作を以下に示します。バイナリファイルの場合は、a、r、およびwが指定できます。テキストファイルの場合は、全てのキーフィールドの操作が指定できます。複数の操作を指定する場合は、続けて記述します。aとrを両方とも省略した場合は、aを指定したものとして動作します。

opt	意味
a	昇順に並べます。 rとは排他関係にあります。
b	キーフィールドの先頭の空白とタブを無視します。
d	空白と英数字だけを比較の対象とします。
i	制御文字コードを無視します。
j	英小文字を英大文字として比較します。
n	符号を含んだ数字の文字列を算術的な値で比較します。文字列中に数字以外の文字が存在した場合の結果は保証されません。データ形式がASCIIコード、EBCDICコード、Unicode UCS-2形式、またはUnicode UTF-8形式の場合に指定できます。 N、およびwとは排他関係にあります。
N	英字と数字の連結データ(例えば「data123」など)を英字と数値に分けて評価し並べます。英字だけを比較の対象として比較後、数字だけの文字列を算術的な値で比較します。指定フィールドの左から評価し、有効データ後に出現したデータは無視します。データ形式がASCIIコード、EBCDICコード、Unicode UCS-2形式、またはUnicode UTF-8形式の場合に指定できます。 n、およびwとは排他関係にあります。
r	降順に並べます。 aとは排他関係にあります。
w	複数バイトから成る文字が混在していても文字ごとに比較して並べます。データ形式がASCIIコード、シフトJISコード、Unicode UCS-2形式、またはUnicode UTF-8形式で、入力ファイルのコード系(実行環境オプション(-option)のicodeオペランド)がEBCDICコード系以外の場合に指定できます。 n、およびNとは排他関係にあります。

注意

キーフィールドのデータ形式に照合順序変更を指定した場合、キーフィールドの操作にa、またはr以外を指定することはできません。
キーフィールドのデータ形式に文字形式2桁年号を指定した場合、キーフィールドの操作にa、またはr以外を指定しても無視されます。

ALL

key-definition の記述形式2の場合に、'ALL'の固定文字列を指定します。
キーフィールドの指定を省略し、レコード全体をキーフィールドとする場合に指定します。キーフィールドの操作を指定する必要がなければ、keyオペランドを省略できます。

記述例

例

例1) 入力レコードの先頭から長さ10バイトのASCIIコードのフィールドを昇順に並べる場合は、次のように指定します。

key=0.10asca

例2) 入力レコードの5バイト目から長さ8バイトの外部10進数のフィールドを降順に並べる場合は、次のように指定します。

key=4.8zdlr

例3) テキストファイル固定フィールド指定の場合、入力レコードの10バイト目から長さ20バイトのASCIIコードのフィールドを昇順に並べる場合は、次のように指定します。なお、キーフィールドの先頭の空白とタブは無視し、英小文字を英大文字として比較します。

key=9.20ascabj

例4) レコード全体をキーとして降順に並べる場合は、次のように指定します。

key=ALLr

参考

バイナリファイルの可変長レコード形式、またはテキストファイルの場合、キーフィールドが存在しないレコードが入力されたときは、キーフィールドが存在しない部分の値を0とみなして処理します。

5.2.6 マージオプション（-merge）

5.2.6.1 keyオペランド