參考手冊

DTWF_DELETE


AIX HP-UX Linux OS/2 OS/390 OS/400 PTX SUN Win NT
X X X X X X X X X

目的

從文字檔中刪除一些行。

格式

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

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

@DTWF_DELETE(filename, transform, delimiter, retry)

@DTWF_DELETE(filename, transform, delimiter)

參數

表 172. DTW_DELETE 參數
資料類型 參數 使用 說明
字串 filename INOUT 所要刪除之記錄的檔案名稱。 呼叫順利完成時, 這個參數會傳回全部完整的檔名。
字串 transform IN 檔案的格式:
  • ASCIITEXT - 將表格寫入檔案,各直欄值之間放入換行字,並忽略 delimiter 參數。
  • DELIMITED - 使用指定在 delimiter 參數中的區隔字元來將表格寫入檔案中。
檔案中的換行字元指出 ASCIITEXT 與 DELIMITED 轉換的 Net.Data 巨集表格的橫列結尾。
字串 delimiter IN 一個指示值終止的字元字串。這個參數是區分大小寫 的。忽略,如果transform 是 ASCIITEXT。
整數 retry IN 如果記錄無法立刻刪除的話,所要重試 的次數。 預設值是不重試。
整數 rows IN 所要刪除之最大的的列數目。預設值 是刪除所有的列。 指定 0 將刪除所有的列。
整數 起始行 INOUT 開始刪除的行號。值 1 表示從第一行開始刪除。如果值大於檔案中的行數, 則傳回一個錯誤,且該參數值會被變更為檔案中的行數。 預設值是 1。

回覆碼

表 173. DTWF_DELETE 回覆碼
回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫上傳遞的參數數目不正確。
1005 函數呼叫上傳遞的參數必須是字串變數,但卻是不同的變數類型。
1006 文字字串傳遞給函數呼叫中的參數, 但此參數必須是輸出參數。
1007 參數包含的值無效。
2000 純本文檔介面內建函數找不到指定的檔案。
2003 純本文檔介面內建函數無法將一列資料讀入表格變數中, 因為橫列的位元組數超出支援的最大位元組數。
2004 純本文檔介面內建函數試圖尋找檔案, 但發現 FFI_PATH 架構檔變數中有一個路徑的長度超過支援的最大位元組數 4095。
2005 呼叫系統功能失敗。
2006 純本文檔介面內建函數無法存取指定的檔案, 因為檔案正被此處理或另一個處理使用,無法在指定模式之下共用。

範例

範例 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)


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]