參考手冊

FFI 內建函數

• DTWF_APPEND

• DTWF_CLOSE

• DTWF_DELETE

• DTWF_INSERT

• DTWF_OPEN

• DTWF_READ

• DTWF_REMOVE

• DTWF_SEARCH

• DTWF_UPDATE

• DTWF_WRITE

DTWF_APPEND

目的

將 Net.Data 表格的目次寫入文字檔尾端。

格式

@DTWF_APPEND(filename, transform, delimiter, table, retry, rows)

@DTWF_APPEND(filename, transform, delimiter, table, retry)

@DTWF_APPEND(filename, transform, delimiter, table)

參數

表 167. DTWF_APPEND 參數

回覆碼

表 168. DTWF_APPEND 回覆碼

用法注意事項

檔案的現行內容會影響使用 DTWF_APPEND 的結果，尤其是最後一橫列的最後一直欄的內容。 如果換行字元後面跟著檔案的最後一橫列的最後一直欄值，附加的資料將置於新橫列中。 否則，附加的資料將變成檔案的最後一橫列的一部份。

範例

範例 1：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
%}
@DTWF_APPEND(myFile, "DELIMITED", " ;", myTable)

範例 2：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
%}
@DTWF_APPEND(myFile, "ASCIITEXT", " ;", myTable)

範例 3：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
%}
@DTWF_APPEND(myFile, "ASCIITEXT", " ;", myTable, "0", "10")

DTWF_CLOSE

目的

關閉由 DTWF_OPEN 所開啟的檔案。

格式

@DTWF_CLOSE(filename, retry)

@DTWF_CLOSE(filename)

參數

表 169. DTWF_CLOSE 參數

回覆碼

表 170. DTWF_CLOSE 回覆碼

範例

範例 1：

@DTWF_CLOSE(myFile, "5")

DTWF_DELETE

目的

從文字檔中刪除一些行。

格式

@DTWF_DELETE(filename, transform, delimiter, retry, rows, startrow)

@DTWF_DELETE(filename, transform, delimiter, retry, rows)

@DTWF_DELETE(filename, transform, delimiter, retry)

@DTWF_DELETE(filename, transform, delimiter)

參數

表 171. DTW_DELETE 參數

回覆碼

表 172. DTWF_DELETE 回覆碼

範例

範例 1：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myWait = "5000"
   myRows = "2"
%}
@DTWF_DELETE(myFile, "Delimited", "|", myWait, myRows)

範例 2：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_DELETE(myFile, "Asciitext", "|", "0", myRows, myStart)

DTWF_INSERT

目的

插入一些行到文字檔中。

格式

@DTWF_INSERT(filename, transform, delimiter, table, retry, rows, startrow)

@DTWF_INSERT(filename, transform, delimiter, table, retry, rows)

@DTWF_INSERT(filename, transform, delimiter, table, retry)

@DTWF_INSERT(filename, transform, delimiter, table)

參數

表 173. DTWF_INSERT 參數

回覆碼

表 174. DTWF_INSERT 回覆碼

範例

範例 1：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myWait = "3000"
%}
@DTWF_INSERT(myFile, "Delimited", "|", myTable, myWait)

範例 2：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_INSERT(myFile, "Asciitext", "|", myTable, "0", myRows, myStart)

DTWF_OPEN

目的

開啟文字檔。

格式

@DTWF_OPEN(filename, mode, retry)

@DTWF_OPEN(filename, mode)

參數

表 175. DTWF_OPEN 參數

回覆碼

表 176. DTWF_OPEN 回覆碼

用法注意事項

1. 當檔案不存在時，應該指定檔名的絕對路徑， 且將建立檔案的目錄須符合 FFI_PATH 中指定的目錄。 如果未使用絕對路徑，將開啟現行工作目錄中的檔案。

2. DTWF_OPEN 會保持檔案開啟，否則 在每一個純本文檔作業後，檔案會關閉。

3. 使用 DTWF_OPEN 來減少檔案開啟的次數。若未使用 DTWF_OPEN， 則在每一次純本文檔作業之後，檔案會關閉。 檔案會一直保持開啟，直到使用 DTWF_CLOSE 關閉，或 巨集處理程序終止。

範例

範例 1：

%DEFINE {
   myFile = "c:/private/myfile"
  myMode = "r+"
%}
@DTWF_OPEN(myFile, myMode, "1000")

DTWF_READ

目的

從文字檔讀取一些行到 Net.Data 表格中。

格式

@DTWF_READ(filename, transform, delimiter, table, retry, rows, startrow, columns)

@DTWF_READ(filename, transform, delimiter, table, retry, rows, startrow)

@DTWF_READ(filename, transform, delimiter, table, retry, rows)

@DTWF_READ(filename, transform, delimiter, table, retry)

@DTWF_READ(filename, transform, delimiter, table)

參數

表 177. DTWF_READ 參數

回覆碼

表 178. DTWF_READ 回覆碼

範例

範例 1：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
  myWait = "1000"
%}
@DTWF_READ(myFile, "DELIMITED", ";", myTable, myWait)

範例 2：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
  myWait = "0"
  myRows = "0"
  myStartrow = "1"
  myColumns = ""
%}
@DTWF_READ(myFile, "DELIMITED", ";", myTable, myWait, myRows,
             myStartrow, myColumns)

範例 3：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
%}
@DTWF_READ(myFile, "ASCIITEXT", ";", myTable)
@DTW_TB_TABLE(myTable,"BORDER","")

DTWF_REMOVE

目的

刪除整個檔案。

格式

@DTWF_REMOVE(filename, retry)

@DTWF_REMOVE(filename)

參數

表 179. DTW_REMOVE 參數

回覆碼

表 180. DTWF_REMOVE 回覆碼

範例

範例 1：

%DEFINE myFile = "c:/private/myfile"
@DTWF_REMOVE(myFile)

範例 2：

%DEFINE {
   myFile = "c:/private/myfile"
  myWait = "2000"
%}
@DTWF_REMOVE(myFile, myWait)

DTWF_SEARCH

目的

搜尋文字檔的字串，將結果傳回 Net.Data 表格。

格式

@DTWF_SEARCH(filename, transform, delimiter, table, searchFor, retry, rows, startrow)

@DTWF_SEARCH(filename, transform, delimiter, table, searchFor, retry, rows)

@DTWF_SEARCH(filename, transform, delimiter, table, searchFor, retry)

@DTWF_SEARCH(filename, transform, delimiter, table, searchFor)

參數

表 181. DTWF_SEARCH 參數

回覆碼

表 182. DTWF_SEARCH 回覆碼

用法注意事項

1. 因 DTWF_SEARCH 傳回的表格具有三欄。前兩欄含有找到相符字元的橫列與直欄號碼； 最後一直欄含有的直欄值具有 SearchFor 參數中所指定的字元。 例如，如果檔案的第 4 列含有第 3 欄的相符字元， 則傳回的表格將具有在第一欄具有號碼 4 一列， 來指出檔案的橫列的出處；它在第 2 欄具有號碼 3， 指出檔案的哪一欄具有相符字元；它在第 3 欄中具有完整的直欄值

2. SearchFor 參數無法包括 delimiter 參數的內容

範例

範例 1：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
  myWait = "1000"
  mySearch = "0123456789abcdef"
@DTWF_SEARCH(myFile, "DELIMITED", ";",
               myTable, mySearch, myWait)

範例 2：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
  mySearch = "answer:"
  myWait = "0"
  myRows = "0"
  myStartrow = "1"
%}
@DTWF_SEARCH(myFile, "DELIMITED", ";", myTable,
               mySearch, myWait, myRows, myStartrow)

DTWF_UPDATE

目的

以 Net.Data 表格中的資料更新文字檔中某些行。

格式

@DTWF_UPDATE(filename, transform, delimiter, table, retry, rows, startrow)

@DTWF_UPDATE(filename, transform, delimiter, table, retry, rows)

@DTWF_UPDATE(filename, transform, delimiter, table, retry)

@DTWF_UPDATE(filename, transform, delimiter, table)

參數

表 183. DTWF_UPDATE 參數

回覆碼

表 184. DTWF_UPDATE 回覆碼

用法注意事項

如果檔案不存在時，應該指定檔名的絕對路徑， 且將建立檔案的目錄須符合 FFI_PATH 中指定的目錄。如果未使用絕對路徑，將開啟現行工作目錄中的檔案。

範例

範例 1：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myWait = "1500"
   myRows = "2"
%}
@DTWF_UPDATE(myFile, "Delimited", "|", myTable, myWait, myRows)

範例 2：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_UPDATE(myFile, "Asciitext", "|", myTable, "0", myRows, myStart)

DTWF_WRITE

目的

將 Net.Data 表格目次寫入文字檔中。

格式

@DTWF_WRITE(filename, transform, delimiter, table, retry, rows, startrow)

@DTWF_WRITE(filename, transform, delimiter, table, retry, rows)

@DTWF_WRITE(filename, transform, delimiter, table, retry)

@DTWF_WRITE(filename, transform, delimiter, table)

參數

表 185. DTWF_WRITE 參數

回覆碼

表 186. DTWF_WRITE 回覆碼

用法注意事項

如果檔案不存在時，應該指定檔名的絕對路徑， 且將建立檔案的目錄須符合 FFI_PATH 中指定的目錄。如果未使用絕對路徑，將開啟現行工作目錄中的檔案。

範例

範例 1：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
%}
@DTWF_WRITE(myFile, "DELIMITED", ";", myTable)

範例 2：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
%}
@DTWF_WRITE(myFile, "ASCIITEXT", ";", myTable, "5000")

範例 3：

%DEFINE {
   myFile = "c:/private/myfile"
   myTable = %TABLE
%}
@DTWF_WRITE(myFile, "ASCIITEXT", ";", myTable, "5000", "10", "50")