參考手冊

DTWF_OPEN


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

目的

開啟文字檔。

格式

@DTWF_OPEN(filename, mode, retry)

@DTWF_OPEN(filename, mode)

參數

表 176. DTWF_OPEN 參數
資料類型 參數 使用 說明
字串 filename INOUT 所要開啟的檔案名稱。呼叫順利完成時, 這個參數會傳回全部完整的檔名。
字串 mode IN 所要求的存取類型:
  • r - 開啟舊有的檔案以供讀取。
  • w - 建立一個檔案以供撰寫。(將舊有之相同的檔案名稱銷毀,如果存在的話。)
  • a - 開啟一個檔案以供附加。如果找不到的話,Net.Data 會建立檔案。
  • r+ - 開啟一個舊有的檔案以供讀取和寫入。
  • w+ - 建立一個檔案以供讀取和寫入。(將舊有之相同的檔案名稱銷毀,如果存在的話。)
  • a+ - 以附加模式開啟檔案以供讀取或附加。如果找不到的話,Net.Data 會建立檔案。
整數 retry IN 如果檔案無法立刻開啟的話,所要重試 的次數。 預設值是不重試。

回覆碼

表 177. DTWF_OPEN 回覆碼
回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫上傳遞的參數數目不正確。
1005 函數呼叫上傳遞的參數必須是字串變數,但卻是不同的變數類型。
1006 文字字串傳遞給函數呼叫中的參數, 但此參數必須是輸出參數。
1007 參數包含的值無效。
2000 純本文檔介面內建函數找不到指定的檔案。
2001 純本文檔介面內建函數無法開啟指定的檔案, 因為檔案正被此處理或另一個處理使用,無法在指定模式之下共用。

用法注意事項

  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")


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