FILEステートメント

DATAステップのPUTステートメントの出力先に使用する外部ファイルを指定します。file-specificationには、次の形式を指定できます。

デバイスの種類またはアクセス方式を指定します。これは、ファイル参照名が入出力デバイスや物理ファイルではない場所を参照している場合に使用されます。

infile dummy ftp user='myuid' pass='xxxx' filevar=file_to_read;

出力ファイルのブロックサイズを指定します。

変数名を指定します。指定した変数の値は、ポインタの現在の列位置を示す値に設定されます。この変数は、自動変数と同じようにデータセットに書き込まれません。

リスト出力のdelimiterに使用する、ブランクのかわりの区切り文字を指定します。使用できる区切り文字は次の通りです。

DLMSTR=Tオプションの解析オプションを指定します。指定すると、区切り文字の末尾にあるブランクを削除します。

リスト出力のdelimiter（ブランクのかわりの区切り文字）として使用する文字列を指定します。使用できる区切り文字は次の通りです。

FILEステートメントのLINESIZE=オプションまたはLRECL=オプションに指定した出力行の長さを超えるデータを切り捨てます。

タブやカンマなどの区切り文字を含むデータ値を一重引用符で囲むように指定します。DSDオプションでは、区切り文字を含むデータ値をリスト出力に書き込むことができます。このオプションは他の種類の出力(例:フォーマット出力、カラム出力、名前付き出力)では無視されます。データ値に含まれる二重引用符は2回繰り返されます。変数の値に区切り文字が含まれ、FILEステートメントにDSDを指定する場合、変数の値は出力が生成されるときに二重引用符で囲まれます。例として、次のコードを示します。

DATA _NULL_;
  FILE log dsd;
  x='"lions, tigers, and bears"';
  put x ' "Oh, my!"';
run;

"""lions, tigers, and bears""", "Oh, my!"

DATA _NULL_;
  FILE log dsd;
  PUT 'lions, tigers, and bears';
run;

lions, tigers, and bears

出力ファイルへの書き込み時に使用するエンコーディングを指定します。ENCODING=の値は、出力ファイルのエンコーディングが現在のセッションエンコーディングとは異なることを示しています。

文字変数の名前を指定します。指定した変数の値には、PUTステートメントの出力で現在開いているファイルの物理名が設定されます。物理名には動作環境でファイルを判別できる名前を指定します。

変数の名前を指定します。この変数の値が変化すると、FILEステートメントは現在の出力ファイルを閉じます。FILEステートメントを次に実行するときに、新しいファイルを開きます。次のPUTステートメントの出力先は、FILEVAR=オプションの変数の値に指定した新しいファイルになります。

現在の行の長さを超えるデータは、新しい行に書き込まれます。指定した行の最大長(FILEステートメントのLINESIZE=オプションに指定)を超える書き込みをPUTステートメントが行う場合、現在の出力行をファイルに出力した後、現在の行の長さを超えるデータ項目は新しい行に書き込まれます。

現在定義されているフットノートを出力するかどうかを制御します。

ステートメントラベルを定義します。このラベルは、新しいページへの出力を開始するたびに実行するSASステートメントのグループを特定します。

変数の名前を指定します。ここに指定した変数の値には、出力ポインタを移動できる行範囲での現在の相対行番号が設定されます。変数名を指定すると、値が自動的に割り当てられます。

レポートの1行あたりの最大列数、およびデータファイルの最大レコード長を設定します。

現在のページの残りの行数を格納する変数の名前を指定します。指定した変数には、現在のページの残りの行数の値が自動的に割り当てられます。LINESLEFT=変数の値は、PUTステートメントの実行終了時に設定されます。

出力ファイルの論理レコード長を指定します。

ファイル内の既存の行の後に出力行を書き出します。

DATAステップの現在の反復で出力ポインタの移動に使用できる行数を指定します。available-linesには、数値(n)を指定するか、またはキーワードPAGESIZEやPSを指定できます。

ODS(Output Delivery System)を使用してDATAステップの出力をフォーマットします。ここでは、データコンポーネントの構造を定義し、DATAステップの結果を保持します。また、そのコンポーネントをテーブル定義に関連付け、出力オブジェクトを生成します。ODSはこのオブジェクトを開かれているすべてのODS出力先に送信し、それぞれの出力先で出力が適切にフォーマットされるようにします。ODS-suboptionsおよびODS (Output Delivery System)の詳細については、XisError: No pubcode in link data found for odsugを参照してください。

ファイルの古い内容を置き換えます。

LRECL=オプションに指定した長さに達するまで、外部ファイルに書き込むレコードにブランクを追加するかどうかを指定します。

レポートの1ページあたりの行数を設定します。

キャリッジコントロール文字を出力行で使用するかどうかを制御します。

出力ファイルのレコード形式を指定します。

PUTステートメントが現在の行の長さを超えてデータ項目を書き込もうとする場合、DATAステップの処理を直ちに中止します。その場合、SASは現在の行の長さを超えたデータ項目を破棄し、エラー発生前に作成された行を書き込んでから、エラーメッセージを発行します。

現在のタイトル行をファイルのページ上に出力するかどうかを制御します。NOTITLESの指定を省略するか、TITLESを指定する場合、定義されているタイトルがあれば出力されます。

このFILEステートメントの現在の出力バッファを参照する文字変数の名前を指定します。この変数は他の変数と同じように使用できます。また、値を割り当てることもできます。この変数の値は自動的に保持されます。初期値はブランクです。自動変数と同じように、_FILE_=に指定した変数はデータセットに書き込まれません。