NAME テキスト行取得

FORMAT {%GET_LINE(テキスト読み込み処理名)}

テキスト読み込みで読み込んだテキストを1行取得します。処理名に対象となるテキスト読み込みの処理名を指定してください。

{%MSGBOX({%GET_LINE(テキスト読み込み1)})}

NAME テキスト取得

FORMAT {%GET_FIELD_VALUE(テキスト読み込み処理名,列番号)}

テキスト読み込みで読み込んだテキスト、又は、SQL実行のSLELCT文の結果レコードを取得します。処理名に対象となるテキスト読み込み、又は、SQL実行の処理名を指定してください。

列番号は、対象の項目番号を指定します。

{%MSGBOX({%GET_FIELD_VALUE(テキスト読み込み1,2)})}

NAME テキスト項目設定

FORMAT {%SET_FIELD_VALUE(テキスト読み込み処理名,列番号,値)}

テキスト読み込みで読み込んだテキストの配列に値をセットします。処理名に対象となるテキスト読み込みを指定してください。

列番号は、対象の項目番号を指定します。

本マクロは、テキスト読み込みで読み込んだデータを部分的に変更したい場合に使用します。

{%SET_FIELD_VALUE(テキスト読み込み1,3,28)}

{%MSGBOX({%GET_FIELD_VALUE(テキスト読み込み1,3)})}

NAME CSVテキスト取得

FORMAT {%GET_FIELD_VALUES_IN_CSV(テキスト読み込み処理名,列番号,列番号,…)}

テキスト読み込みで読み込んだテキスト、又は、SQL実行のSLELCT文の結果レコードをCSV(カンマ区切り)で取得します。処理名に対象となるテキスト読み込み、又は、SQL実行の処理名を指定してください。

列番号は、対象の項目番号を指定します。列番号は複数記述することが可能です。例えば1番目と2番目の項目を取得したい場合は、1,2と記述します。2番目～5番目の項目を取得したい場合は、2-5と記述します。1,3-5のようにカンマとハイフンを組み合わせて指定することも可能です。1-や-3のように、開始や終了の列番号を省略することも可能です。

取得されるテキストはCSV形式になります。複数の項目がカンマで区切られ、項目中にカンマがある場合は、項目が”で囲われます。単一の列を取得する場合でも、項目中にカンマがある場合は、項目が”で囲われます。

項目中に"がある場合は、""と2つ続けて記述され、項目が”で囲われます。

{%MSGBOX({%GET_FIELD_VALUES_IN_CSV(テキスト読み込み1,2,4)})}

{%MSGBOX({%GET_FIELD_VALUES_IN_CSV(テキスト読み込み1,1-3)})}

{%MSGBOX({%GET_FIELD_VALUES_IN_CSV(テキスト読み込み1,1,4)})}

{%MSGBOX({%GET_FIELD_VALUES_IN_CSV(テキスト読み込み1,1,4,5)})}

NAME TSVテキスト取得

FORMAT {%GET_FIELD_VALUES_IN_TSV(テキスト読み込み処理名,列番号,列番号,…)}

テキスト読み込みで読み込んだテキスト、又は、SQL実行のSLELCT文の結果レコードをTSV(タブ区切り)で取得します。処理名に対象となるテキスト読み込み、又は、SQL実行の処理名を指定してください。

返却文字列がタブ区切りとなる以外は、CSVテキスト取得マクロと同じ仕様となります。

NAME SVテキスト取得

FORMAT {%GET_FIELD_VALUES_IN_SV(テキスト読み込み処理名,区切り文字,エスケープ有無(有|無),囲い文字,全項目囲い文字付与有無(有|無),項目番号,項目番号,…)}

テキスト読み込みで読み込んだテキスト、又は、SQL実行のSLELCT文の結果レコードを引数で指定された区切り文字区切りで取得します。処理名に対象となるテキスト読み込み、又は、SQL実行の処理名を指定してください。

基本的な動作はCSVテキスト取得マクロと同じですが、区切り文字、エスケープ処理の有無、囲い文字、全ての項目に囲い文字を付与するかどうかを指定可能です。

エスケープ処理は、項目中に区切り文字が含まれている場合に、囲い文字で項目を囲います。また、項目中に囲い文字が含まれている場合に囲い文字を2つ続けて記述し、囲い文字で項目を囲います。

例えば1番目のデータが「123」、2番目のデータが「A,BC」の場合、「123,"A,BC"」と取得されます。

1番目のデータが「123」、2番目のデータが「A"BC」の場合、「123,"A""BC"」と取得されます。

全項目囲い文字付与有無に「有」が指定された場合は、全項目が囲い文字で囲われます。エスケープ処理ではないので、同時にエスケープ処理を行いたい場合は、エスケープ有無に「有」を合わせて指定してください。

{%MSGBOX({%GET_FIELD_VALUES_IN_SV(テキスト読み込み1,||,有,",有,1-)})}

{%MSGBOX({%GET_FIELD_VALUES_IN_SV(テキスト読み込み1,|,,無,',無,1-5)})}

{%MSGBOX({%GET_FIELD_VALUES_IN_SV(テキスト読み込み1,|,,有,',無,1-5)})}

NAME テキスト取得(列名で指定)

FORMAT {%GET_FIELD_VALUE_BY_NAME(テキスト読み込み処理名,列名)}

GET_FIELD_VALUE と同じですが、項目を列名で指定できます。但し、ヘッダ情報があるテキストを読み込んだ場合のみ使用できます。SQL実行のSELECT文の結果レコードに対しては使用できません。

{%MSGBOX({%GET_FIELD_VALUE(テキスト読み込み1,性別)})}

NAME CSVテキスト取得(列名で指定)

FORMAT {%GET_FIELD_VALUES_IN_CSV_BY_NAME(テキスト読み込み処理名,列名,列名,…)}

GET_FIELD_VALUES_IN_CSV と同じですが、項目を列名で指定できます。但し、ヘッダ情報があるテキストを読み込んだ場合のみ使用できます。SQL実行のSELECT文の結果レコードに対しては使用できません。

{%MSGBOX({%GET_FIELD_VALUES_IN_CSV_BY_NAME(テキスト読み込み1,性別,住所)})}

NAME TSVテキスト取得(列名で指定)

FORMAT {%GET_FIELD_VALUES_IN_TSV_BY_NAME(テキスト読み込み処理名,列名,列名,…)}

GET_FIELD_VALUES_IN_TSV と同じですが、項目を列名で指定できます。但し、ヘッダ情報があるテキストを読み込んだ場合のみ使用できます。SQL実行のSELECT文の結果レコードに対しては使用できません。

NAME SVテキスト取得(列名で指定)

FORMAT {%GET_FIELD_VALUES_IN_SV_BY_NAME(テキスト読み込み処理名,区切り文字,列名,列名,…)}

GET_FIELD_VALUES_IN_SV と同じですが、項目を列名で指定できます。但し、ヘッダ情報があるテキストを読み込んだ場合のみ使用できます。SQL実行のSELECT文の結果レコードに対しては使用できません。

NAME テキストファイル読み込み

FORMAT {%READ_FILE(ファイル名,ユーザーデータ名,文字コード(SJIS|UTF-8|UTF-16|UTF-16BE|EUC|JIS|自動),行モード(LINE|ALL))}

テキストファイルからテキストを読み込みます。本マクロはテキスト読み込み処理と関係なく単独で使用できます。文字コードは「SJIS」、「UTF-8」、「UTF-16」、「UTF-16BE」、「EUC」、「JIS」、「自動」の何れかを指定します。

ユーザーデータ名で指定されたユーザーデータを作成して、読み込んだテキストを格納します。行モードが「LINE」の場合、行単位に読み込み行番号をキーとしてユーザーデータに格納します。行モードが「ALL」の場合、全行を読み込み、キー「1」としてユーザーデータに格納します。

指定されたファイルが見つからない場合は、戻り値にFalseを返します。処理が正常に終了した場合はTrueを返します。

{%READ_FILE(D:\data.txt,text,SJIS,ALL)}

{%SET_CLIPBOARD_TEXT({%GET_USER_DATA(text,1)})}

{%READ_FILE(D:\data.txt,text,SJIS,LINE)}

{%SET_CLIPBOARD_TEXT({%GET_USER_DATA(text,2)})}

NAME テキストファイル書き込み

FORMAT {%WRITE_FILE(ファイル名,ユーザーデータ名,エンコーディング(SJIS|UTF-8|UTF-8WB|UTF-16|UTF-16BE|EUC|JIS),[書き込みモード(New|Append)])}

ユーザーデータの1階層目の1要素を1行として、全要素をファイルに書き込みます。

ユーザーデータは1階層のみ対象としています。(2階層以降のデータは無視されます)

エンコーディングの「UTF-8」 は、BOM無しUTF-8を「UTF-8WB」 は、BOM有りUTF-8を表しています。

書き込みモードが「New」の場合は新規でファイルを作成します。同名のファイルがある場合は上書きします。

書き込みモードが「Append」の場合は追加書き込みします。ファイルがない場合は新規作成します。

書き込みモードが省略された場合はNewとなります。

{%ADD_USER_DATA(writeData,WRITE_FILEマクロについて)}
{%ADD_USER_DATA(writeData,ユーザーデータの内容をファイルに保存します。)}
{%WRITE_FILE(D:\test.txt,writeData,SJIS,New)}

NAME CSVファイル読み込み

FORMAT {%READ_CSV_FILE(ファイル名,ユーザーデータ名,文字コード(SJIS|UTF-8|UTF-16|UTF-16BE|EUC|JIS|自動),ヘッダ行,データ開始行,行キー(項目番号|0),項目キータイプ(項目名|番号),[区切り文字])}

CSVファイルからテキストを読み込みます。本マクロはテキスト読み込み処理と関係なく単独で使用できます。文字コードは「SJIS」、「UTF-8」、「UTF-16」、「UTF-16BE」、「EUC」、「JIS」、「自動」の何れかを指定します。

ユーザーデータ名で指定されたユーザーデータを作成して、読み込んだテキストを格納します。行単位に読み込み、行番号を分類キーで作成し、項目毎にユーザーデータに格納します。

ヘッダ行にはヘッダの行番号を指定します。ヘッダ行がない場合は0を指定します。

データ開始行には、データ行の先頭の行番号を指定します。

行キーには、キーとなる項目番号(1～)を指定します。キーを複数指定する場合は、「1-2」のようにハイフンで区切ります。

行キーに項目番号を指定した場合、指定された項目のデータに重複がある場合、最後に読み込んだデータで上書きされます。また、項目が空文字だった場合は重複しない連番を自動付与したキーが作成されます。

行キーに0を指定すると行のキーは番号(1～)になります。

項目キータイプに項目名を指定した場合は、ヘッダ行に1以上の数字を指定する必要があります。ヘッダ行に指定された行の項目名をキーとして使用します。ヘッダ行が0の場合は項目名は番号となります。

項目キータイプに番号を指定した場合は項目番号がキーとなります。

区切り文字は省略可能です。指定した場合は指定した文字を区切り文字として処理します。タブを指定したい場合は「<Tab>」を指定します。

指定されたファイルが見つからない場合は、戻り値にFalseを返します。処理が正常に終了した場合はTrueを返します。

{%READ_CSV_FILE(D:\data.csv,csv,SJIS,0,1,0,番号)}
{%LOOP L1 {%GET_USER_DATA_KEY_COUNT(csv)}(
  {%LOOP L2 {%GET_USER_DATA_KEY_COUNT(csv,[L_IDX(L1)])}(
    {%WRITE_LOG({%GET_U(csv,[L_IDX(L1)],[L_IDX(L2)])})}    
  )}
)}

{%READ_CSV_FILE(D:\data.csv,csv,SJIS,1,2,0,項目名)}
{%LOOP L1 {%GET_USER_DATA_KEY_COUNT(csv)}(
  {%WRITE_LOG({%GET_U(csv,[L_IDX(L1)],氏名)})}    
  {%WRITE_LOG({%GET_U(csv,[L_IDX(L1)],年齢)})}    
  {%WRITE_LOG({%GET_U(csv,[L_IDX(L1)],電話番号)})}    
)}

{%READ_CSV_FILE(D:\data.csv,csv,SJIS,1,2,1,項目名)}

#学生番号が0003のデータを出力する
{%WRITE_LOG({%GET_U(csv,0003,氏名)})}    
{%WRITE_LOG({%GET_U(csv,0003,年齢)})}    
{%WRITE_LOG({%GET_U(csv,0003,電話番号)})}    

NAME CSVファイル書き込み

FORMAT {%WRITE_CSV_FILE(ファイル名,ユーザーデータ名,文字コード(SJIS|UTF-8|UTF-8WB|UTF-16|UTF-16BE|EUC|JIS),[書き込みモード(New|Append)],[区切り文字])}

ユーザーデータの1階層目の1要素を1行、2階層目の1要素を項目として、全ての行、全ての項目をファイルに書き込みます。

ユーザーデータのキーは参照しません。キーに何が格納されていても動作に影響はありません。

エンコーディングの「UTF-8」 は、BOM無しUTF-8を「UTF-8WB」 は、BOM有りUTF-8を表しています。

書き込みモードが「New」の場合は新規でファイルを作成します。同名のファイルがある場合は上書きします。

書き込みモードが「Append」の場合は追加書き込みします。ファイルがない場合は新規作成します。

書き込みモードが省略された場合はNewとなります。

{%ADD_USER_DATA(writeData,1,社員番号)}
{%ADD_USER_DATA(writeData,1,氏名)}
{%ADD_USER_DATA(writeData,2,0001)}
{%ADD_USER_DATA(writeData,2,織田信長)}
{%ADD_USER_DATA(writeData,3,0002)}
{%ADD_USER_DATA(writeData,3,武田信玄)}
{%WRITE_CSV_FILE(D:\data.csv,writeData,SJIS)}
結果
社員番号,氏名
0001,織田信長
0002,武田信玄

{%SET_U(writeData,1,1,社員番号)}
{%SET_U(writeData,1,2,氏名)}
{%WRITE_CSV_FILE(D:\data.csv,writeData,SJIS,New)}
{%SET_U(writeData,1,1,0001)}
{%SET_U(writeData,1,2,織田信長)}
{%WRITE_CSV_FILE(D:\data.csv,writeData,SJIS,Append)}
{%SET_U(writeData,1,1,0002)}
{%SET_U(writeData,1,2,武田信玄)}
{%WRITE_CSV_FILE(D:\data.csv,writeData,SJIS,Append)}
結果
社員番号,氏名
0001,織田信長
0002,武田信玄