指定した値式の文字列をファイルに出力します。

WRITE LINE 値式

• 値式

ファイルに出力する値式を指定します。

値式についての規則を次に示します。

1. 値式に指定できるものを次に示します。
   
   • 定数
   • USER
   • SQL変数，又はSQLパラメタ
   • 連結演算
   • スカラ関数
   • 関数呼出し
   • CASE式
   • CAST指定
   • SQLERRM_OF_LAST_CONDITION
2. 値式のデータ型は，文字データ型（CHAR及びVARCHAR），各国文字データ型（NCHAR及びNVARCHAR），又は混在文字データ型（MCHAR及びMVARCHAR）にしてください。
3. 値式の結果のデータ型が文字データ型となる場合，ファイルに出力する文字の文字集合は値式で指定した文字集合となります。
4. 値式の出力先は，クライアント環境定義PDWRTLNPATHで指定した出力先となります。また，値式を出力するファイルの最大サイズは，クライアント環境定義PDWRTLNFILSZで指定します。PDWRTLNPATH，及びPDWRTLNFILSZについては，マニュアル「HiRDB Version 8 UAP開発ガイド」を参照してください。
5. 値式の文字列の最後に，HiRDBサーバ側の環境の改行コードが付加されます。改行コードは，HiRDBサーバのOSによって異なります。また，値式の値がクライアント環境定義PDWRTLNCOMSZで指定したサイズを超えた場合，最後に付加するHiRDBサーバ側の改行コードは，PDWRTLNCOMSZで指定したサイズに収まるように，値式の文字列の後方を削除して，改行コードを付加します。PDWRTLNCOMSZについては，マニュアル「HiRDB Version 8 UAP開発ガイド」を参照してください。
   付加されるHiRDBサーバ側の改行コードを次の表に示します。
   

   表7-4　付加されるHiRDBサーバ側の改行コード

   HiRDBサーバのOS	付加される改行コード
   HP-UX	NL(X'0a')
   Solaris	NL(X'0a')
   AIX	NL(X'0a')
   Linux	NL(X'0a')
   Windows	CR(X'0d')＋NL(X'0a')

6. 値式の値がナル値の場合は，ファイルに出力しません。
7. 値式中には，副問合せを指定できません。

1. WRITE LINE文は，SQL手続き，及びトリガに指定できます。SQL関数中には指定できません。
2. クライアント環境定義PDWRTLNFILSZを指定しなかった場合，WRITE LINE文は実行できません。

日付データ型のSQLパラメタ「fromdate」を文字列に変換して，ファイルに出力します。

 
  CREATE PROCEDURE proc_1(IN fromdate DATE)
    BEGIN
      WRITE LINE 'fromdate='||char(fromdate);
    END;