PROC FORMAT入門9 : CNTLIN=オプション

（落とし穴もあるので記事を最後までご覧ください。落とし穴を解説した記事のリンクも貼ってます）

CNTLIN=オプションを使うと、「データセット」から「フォーマット」を生成する事ができます。（つまり前回紹介した「CNTLOUT=オプション」の逆が出来る）

まずは簡単な例から。



例１

---

たとえば、FORMATを定義したいとき以下のように書きますが、、

proc format;    value TEST1_        1 = "MALE"        2 = "FEMALE"    ;    value $TEST2_        "Y" = "YES"        "N" = "NO"    ; run;

別のアプローチ「CNTLIN=オプション」を使って、同様のFORMATを定義できます。

（記事の最後に、この方法の落とし穴についてのリンク記事をのせているので必ず参照下さい）

*** 定義したいFORMATの内容をデータセットで持たせておく ; data FMT; input FMTNAME:$7. START:$1. LABEL:$6.; cards; TEST1_ 1 MALE TEST1_ 2 FEMALE $TEST2_ N NO $TEST2_ Y YES ; *** 上記データセットをCNTLIN=オプションに指定してFORMATに変換する ; proc format lib=work cntlin=FMT; run; ログ NOTE: 出力形式TEST1_を作成しました。 NOTE: 出力形式$TEST2_を作成しました。

ログを見ると分かる通り、見事データセットからフォーマット「TEST1_」と「TEST2_」を生成する事が出来ました。



構文

---

PROC FORMAT LIBRARY=ライブラリ.カタログ名  CNTLIN=FORMAT変換用のデータセット; RUN;

• 「LIBRARY=ライブラリ名」というようにカタログ名を省略した場合、ライブラリ内の「FORMATS」という名前のカタログがデフォルトで選択されます。
• FORMAT変換用のデータセットには少なくとも「FMTNAME」「START」「LABEL」という変数が必要です。

あとは以下の中から、定義したいFORMATにあわせて、必要な変数を選択してデータセットに含めます。



CNTLIN = データセットの各変数の説明

---

変数名	型	内容
FMTNAME	文字	フォーマット名
START	文字	開始値
END	文字	終了値
LABEL	文字	出力値
MIN	数値	MIN=オプション値
MAX	数値	MAX=オプション値
DEFAULT	数値	DEFAULT=オプション値
LENGTH	数値	LENGTH=オプション値 。。とリファレンスに書いてありますが、  そんなオプション存在しないと思われるので詳細不明
FUZZ	数値	FUZZ=オプション値
PREFIX	文字	PICTUREフォーマットのPREFIX=オプション値
MULT	数値	PICTUREフォーマットのMULTIPLIER=オプション値
FILL	文字	PICTUREフォーマットのFILL=オプション値
NOEDIT	数値	PICTUREフォーマットのNOEDITオプションが有効かどうか  (1=有効 0=無効)
TYPE	文字	フォーマットの種類   N = 数値フォーマット   C = 文字フォーマット   I = 数値インフォーマット   J = 文字インフォーマット   P = PICTUREフォーマット
SEXCL	文字	開始値の取扱い  ("Y"=開始値を含めない "N"=開始値を含める)
EEXCL	文字	終了値の取扱い  ("Y"=終了値を含めない "N"=終了値を含める)
HLO	文字	開始値・終了値の追加情報 (すごく重要な変数)   O = OTHER   L = LOW   H = HIGH   R = PICTUREフォーマットのROUNDオプション   ...等。詳細はリファレンスを参照   (組み合わせて使用します。例：Low-High…LH)
DECSEP	文字	PICTUREフォーマットのDECSEP=オプション値
DIG3SEP	文字	PICTUREフォーマットのDIG3SEP=オプション値
DATATYPE	文字	PICTUREフォーマットのDATATYPE=オプション値
LANGUAGE	文字	PICTUREフォーマットのLAUNGUAGE=オプション値

これ見て頂くと分かる通り、前回紹介したCNTLOUT=で出来るデータセットと同じ構造です。



ここまで特に難しいことはないんですが、、ただですね、、
CNTLIN=オプションは先の例のような簡単なFORMATを定義する分にはいいけど、複雑なFORMATを定義したい場合、それなりの知識が必要になります。


例えば、以下のPICTUREフォーマットをご覧ください。



例2

---

proc format;    picture TEST7_ (round)       low - high = '009.00%'    ; run;

ここで問題です。
上のと同様のフォーマットをCNTLIN=で作るには、どんなプログラムを書けばよいでしょうか？




以下が正解の一例。

data FMT2; length FMTNAME START END LABEL $10. MULT 8. TYPE HLO $10.; FMTNAME = 'TEST7_'; START   = 'LOW'; END     = 'HIGH'; LABEL   = '009.00%'; MULT    = 100; TYPE    = 'P'; HLO     = 'LHR'; run; proc format lib=WORK cntlin=FMT2; run;

パッとこれが思い浮かべばいいですが、詳しくないと中々難しいと思います。

私の知る限り、実務ではこの記事の最初の方に載せた「例１」程度の簡単なフォーマットを作るのにCNTLIN=オプションを使っているのはよく見かけますね。




落とし穴

---

その①

「CNTLOUT=」でフォーマットをデータセット化して、そのデータセットに手を加えてから「CNTLIN=」でまたフォーマット化する、みたいな事をする事がありますが、、

例えば「CNTLIN=」に読み込ませるデータセットで、フォーマット値に関連する変数（START、END、LABEL等）に手を加えた場合、フォーマットの文字の長さに関連する変数（DEFAULT、MIN、MAXなど）も修正するのを忘れずに。

その②

割と問題ありな落とし穴について、以下記事をご覧ください。

【PROC FORMAT】CNTLIN=オプションの落とし穴

PROC FORMAT入門 : 記事一覧

---

1. VALUEステートメント

2. INVALUEステートメント
3. 範囲の指定
4. PICTUREステートメント1
5. PICTUREステートメント2
6. PICTUREステートメント3
7. フォーマットカタログの保存
8. CNTLOUT=オプション
9. CNTLIN=オプション