5.10.14　formatオペランド

(a)　valサブオペランド指定との組み合わせ

valの指定が，文字または日付属性のフィールド名指定の場合

fieldで指定された開始位置から，lenで指定された長さ分のデータを挿入します。

lenが省略された場合，fieldで指定された長さ分のデータを挿入します。

lenにバイト長以外（小数部桁数など）を指定した場合エラーとなります。

入力データ長とlenで指定された長さの大小関係を次の表に示します。

表5‒45　入力データ長と指定された有効桁数の大小関係

len指定	挿入するデータ
無	フィールドで指定された開始位置から，フィールドで指定された長さのデータを挿入します。
有	入力レコードのフィールド長　≧　len指定値（バイト長） フィールドで指定された開始位置から，lenで指定された長さのデータを挿入します。次の図の【例1】を参照してください。 入力レコードのフィールド長　＜　len指定値（バイト長） フィールドで指定された開始位置から，フィールドで指定された長さのデータを挿入し，lenで指定された長さに足りない部分をパディングします。次の図の【例2】を参照してください。 パディング文字はpaddingサブオペランドで指定できます。 ただし，フィールド名の属性が「日付(g)」および「左分離符号付き数字(d)」の場合，paddingサブオペランドは無効です。空白でパディングします。 paddingサブオペランドは，「5.10.14(6)　paddingサブオペランド」を参照してください。

【例1】

フィールド長10バイトの入力レコードから，5バイトのデータを挿入する。

［指定例］

  -joininp alias=IN
           field=Cdata:c+0-10
    :
  -joinout format=val(IN.Cdata) len(5)

［出力結果］

　入力レコードの先頭から5バイトが挿入されます。

【例2】

フィールド長3バイトの入力レコードから，7バイトのデータを挿入する。

［指定例］

  -joininp alias=IN
           field=Cdata:c+5-3
    :
  -joinout format=val(IN.Cdata) len(7) padding(C'△')

［出力結果］

　入力レコードの5バイト目から3バイトが挿入されます。

　足りない部分は空白（△）でパディングされます。

フィールド名の属性が「日付(g)」でlenが指定された場合，lenで指定された有効桁に正規化して挿入します。正規化では入力データの形式チェックを行います。入力データの先頭2文字（西暦下2桁）に数字「0〜9」以外が含まれた場合，または入力データが1桁しかなかった場合，KBLS2416-Eエラーとなります。なお，年号以外のデータ（月，日）は，形式チェックしません。

入力データが無い場合，先頭2文字（西暦下2桁）に基準年，残りの桁に空白を仮定し，指定された桁で出力します。

データの形式については，「3.2　キー属性と形式」を参照してください。

valの指定が，C'文字列'，X'16進数'，別名指定，属性が内部浮動小数点数(f)のフィールド名の場合

lenは指定できません。

valの指定が，10進数属性のフィールド名指定の場合

入力した10進数データを，lenで指定された有効桁に正規化して挿入します。正規化では入力データの形式チェックを行います。入力データに数字「0〜9」および符号以外が含まれた場合，KBLS2416-Eエラーとなります。データの形式についは，「3.2　キー属性と形式」を参照してください。

lenの指定がないときは，入力した10進数データの桁数でデータを挿入します。正規化処理は行いません。

入力データの桁数指定は，fieldオペランドで指定します。

（1）小数部の扱い

• ファイル編成が固定長順編成ファイルおよびテキストファイルで扱う10進数形式では，小数点をデータ中に持てないため，利用者側で小数部の桁数を決めます。小数部桁数を省略した場合，0を仮定します。

  【例】

  入力データ「123456789」の9バイトの正の外部10進数の場合，有効桁数と小数部桁数の指定による10進数の意味を次の表に示します。

  表5‒46　10進数の意味

  項番	総桁数	小数部桁数	10進数の意味
  1	9	0	整数部9桁の「123456789」
  2	9	9	小数部9桁の「.123456789」
  3	9	3	整数部6桁小数部3桁の「123456.789」
  4	9	8	整数部1桁小数部8桁の「1.23456789」

• 総桁数が小数部桁数より小さい場合はエラーとなります。

（2）小数部の扱い

小数部桁の指定有無による小数部データ調整を次の表に示します。

表5‒47　小数部桁数の指定有無による小数部データ調整

入力データの小数部桁数指定	lenの小数部桁数指定	小数部データ調整
なし	なし	なし
なし	あり	0を挿入します。次の図の【例1】を参照してください。
あり	なし	なし
あり	あり	入力データの小数部桁数（A）とlenの小数部桁数（B）の大小関係から挿入データを決定します。 A ≧ B 入力データの小数部上位桁からBの長さのデータを挿入します。次の図の【例2】を参照してください。 A ＜ B 入力データの小数部をAの長さで上位桁に挿入し，「 B−A 」の長さで0を挿入します。次の図の【例3】を参照してください。

【例1】

【例2】

【例3】

（3）整数部データ調整

• （総桁数　−　小数部桁数）が整数部桁数となります。

  【例】

  入力データの整数部桁数（A）とlen指定の整数部桁数（B）の大小関係による整数部データ調整を次の表に示します。

  表5‒48　整数部データ調整

  大小関係	整数部データ調整
  A　≧　B	入力データの整数部右からB分挿入します。 次の図の【例1】，【例2】を参照してください。
  A　＜　B	入力データの整数部からA分挿入し，先頭桁に0を挿入します。 次の図の【例3】，【例4】を参照してください。

  【例1】外部10進数

  

  【例2】左分離符号付き外部10進数

  

  【例3】外部10進数

  

  【例4】左分離符号付き外部10進数

  

• 左側が空白のデータを入力した場合，空白を0とみなして有効桁に調整します。

(b)　calcサブオペランド指定との組み合わせ

• lenは必ず指定してください。

• 演算結果を挿入する項目の総桁数と小数部桁数を指定します。

• 演算結果の整数桁が，有効桁の最大値を超えた場合はKBLS2412-E（オーバーフロー）エラーに，lenで指定された整数桁（総桁数−小数桁）を超えた場合KBLS2423-Eエラーとなります。

• 演算結果の小数桁が，lenで指定された小数桁を超えた場合，右側の桁あふれ部分を丸めて，指定された有効桁数に調整されます。丸め処理はformatオペランドに指定された方式で行います。丸め方式については，「5.10.14(5)　桁の丸め方式サブオペランド」を参照してください。