fopen ()- 開啟檔案

F

固定長度， deblocked 記錄

FB

固定長度，區塊記錄

V

可變長度， deblocked 記錄

VB

可變長度，區塊記錄

VBS

磁帶檔案的可變長度、區塊、跨區記錄

VS.

磁帶檔案的可變長度、deblocked、跨區記錄

D

磁帶檔案的 ASCII D 格式的可變長度、解除鎖定、非跨距記錄

DB

磁帶檔案的 ASCII D 格式的可變長度、區塊化、非跨距記錄

U

磁帶檔案的未定義格式

FA

固定長度，使用印表機檔案的第一個字元格式控制資料

N 此參數識別此檔案未在確定控制下開啟。 這是預設值。

Y 此參數識別在確定控制下開啟此檔案。

在編譯指令上指定 LOCALETYPE (*LOCALEUTF) 時，預設值是 LC_CTYPE CCSID 值，由現行語言環境設定決定。 如需語言環境設定的進一步相關資訊，請參閱 setlocale ()-設定語言環境 。 未在編譯指令上指定 LOCALETYPE (*LOCALEUTF) 時，預設值為工作 CCSID 值。 如需檔案 CCSID 值的進一步相關資訊，請參閱 檔案 CCSID 。

N 此參數識別以建立檔案的方式處理此檔案。 這是預設值。

Y 此參數識別以到達順序處理此檔案。

N 此參數識別顯示器、ICF 或印表機檔案中的指示器儲存在檔案緩衝區中。 這是預設值。

Y 此參數識別顯示器、ICF 或印表機檔案中的指示器儲存在個別指示器區域中，而不是儲存在檔案緩衝區中。 檔案緩衝區是系統在寫入及讀取時，用來與使用者程式及作業系統來回傳送資料的區域。 在處理 ICF 檔案時，您必須將指示器儲存在個別指示器區域中。

memory 此參數會將此檔案識別為只能從 C 程式使用的記憶體檔。 這是預設值。

record 此參數指定要開啟檔案以進行循序記錄 I/O。 檔案必須以二進位檔開啟; 否則， fopen() 函數會失敗。 讀取及寫入作業是使用 fread() 函數及 fwrite() 函數來完成。

record 開啟檔案以進行循序記錄 I/O。 (檔案必須以二進位串流開啟。)

如果您指定 ccsid 關鍵字，則無法指定 o_ccsid 關鍵字或字碼頁關鍵字。

由於轉換資料可能擴充或縮小，因此假設資料大小及現行檔案偏移是危險的。 例如，檔案可能具有 100 個位元組的實體大小，但在應用程式從檔案讀取 100 個位元組之後，現行檔案偏移可能只有 50 個位元組。 為了讀取整個檔案，應用程式可能必須讀取 200 個位元組以上，視所涉及的 CCSID 而定。 因此，檔案定位功能 (例如 ftell()、 fseek()、 fgetpos()及 fsetpos()) 可能無法運作。 這些功能可能因錯誤 ENOTSUP 而失敗。 如果緩衝功能已開啟，則讀取功能也將無法運作，因為依預設是如此。 若要關閉緩衝功能，請搭配使用 setvbuf 函數與 _IONBF 關鍵字。

在編譯指令上指定 LOCALETYPE (*LOCALEUTF) 時，預設值是 LC_CTYPE CCSID 值，由現行語言環境設定決定。 如需語言環境設定的進一步相關資訊，請參閱 setlocale ()-設定語言環境 。 未在編譯指令上指定 LOCALETYPE (*LOCALEUTF) 時，預設值為工作 CCSID 值。 如需檔案 CCSID 值的進一步相關資訊，請參閱 檔案 CCSID 。

此參數類似於 ccsid 參數，但指定的值不會轉換為字碼頁。 此外，還支援混合資料。 如果建立檔案，則會以指定的 CCSID 來標示它。 如果檔案已存在，則在讀取作業上，資料將從檔案的 CCSID 轉換為指定的 CCSID。 在寫入作業時，會假設資料採用指定的 CCSID ，並轉換成檔案的 CCSID。

由於轉換資料可能擴充或縮小，因此假設資料大小及現行檔案偏移是危險的。 例如，檔案可能具有 100 個位元組的實體大小，但在應用程式從檔案讀取 100 個位元組之後，現行檔案偏移可能只有 50 個位元組。 為了讀取整個檔案，應用程式可能必須讀取 200 個位元組以上，視所涉及的 CCSID 而定。 因此，檔案定位功能 (例如 ftell()、 fseek()、 fgetpos()及 fsetpos() ) 將無法運作。 這些功能將因 ENOTSUP 而失敗。 如果緩衝功能已開啟，則讀取功能也將無法運作，因為依預設是如此。 若要關閉緩衝功能，請搭配使用 setvbuf 函數與 _IONBF 關鍵字。

使用 o_ccsid 的範例

/* Create a file that is tagged with CCSID 37 */
if ((fp = fopen("/MYFILE" , "w, o_ccsid=37")) == NULL) {
   printf("Failed to open file with o_ccsid=37\n");
}

fclose(fp);

/* Now reopen the file with CCSID 13488, because your application
 wants to deal with the data in UNICODE */

if ((fp = fopen("/MYFILE" , "r+, o_ccsid=13488")) == NULL) {
   printf("Failed to open file with o_ccsid=13488\n");
}
/* Turn buffering off because read functions do not work when
buffering is on */

if (setbuf(fp, NULL, _IONBF, 0) != 0){
    printf("Unable to turn buffering off\n");
}
/* Because you opened with o_ccsid = 13488, you must provide
all input data as unicode.
If this program is compiled with LOCALETYPE(*LOCALEUCS2),
L constrants will be unicode. */

funcreturn = fputws(L"ABC", fp); /* Write a unicode ABC to the file. */

if (funcreturn < 0) {
   printf("Error with 'fputws' on line %d\n", __LINE__);
}
/* Because the file was tagged with CCSID 37, the unicode ABC was
converted to EBCDIC ABC when it was written to the file. */

如果您指定字碼頁關鍵字，則無法指定 ccsid 關鍵字或 o_ccsid 關鍵字。

如果要開啟的檔案不存在，且開啟模式指定應該建立檔案，則會建立檔案並以計算的字碼頁標示。 如果檔案已存在，則在讀取作業期間，從檔案讀取的資料會從檔案的字碼頁轉換為計算的字碼頁。 寫入檔案的資料會假設為計算的字碼頁，並在寫入作業期間轉換為檔案的字碼頁。

Y 要使用的行終止符號是換行 [CR] ，新行 [NL] 組合。 讀取資料時，會針對字串函數刪除所有換行 [CR]。 將資料寫入檔案時，會在每一個換行 [NL] 字元之前新增換行 [CR]。 只有在以文字模式開啟檔案時，才會進行字行終止字元處理。 這是預設值。

N 要使用的行終止符號僅是換行 [NL]。