fopen() — 파일 열기

F

고정 길이, 블록 해제된 레코드

FB

고정 길이, 블록화된 레코드

V

가변 길이, 블록 해제된 레코드

VB

가변 길이, 블록화된 레코드

VBS

테이프 파일에 대한 가변 길이, 블록화된, 스팬 레코드

VS

테이프 파일에 대한 가변 길이, 블록 해제된, 스팬 레코드

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를 위해 파일을 열도록 지정합니다. 2진 파일로 파일을 열어야 합니다. 그렇지 않으면 fopen() 함수가 실패합니다. 읽기 및 쓰기 조작은 fread() 함수 및 fwrite() 함수로 수행됩니다.

record 순차 레코드 I/O를 위해 파일이 열립니다(2진 스트림으로 파일을 열어야 함).

ccsid 키워드를 지정하는 경우 o_ccsid 키워드 또는 codepage 키워드를 지정할 수 없습니다.

변환된 데이터의 확장 또는 수축이 가능하기 때문에 데이터 크기와 현재 파일 오프셋을 가정하는 것은 위험합니다. 예를 들어, 파일의 실제 크기는 100바이트이지만 애플리케이션이 파일에서 100바이트를 읽은 후 현재 파일 오프셋은 단지 50입니다. 전체 파일을 읽으려면 애플리케이션이 관련된 CCSID에 따라 200바이트 이상을 읽어야 합니다. 따라서 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입니다. 전체 파일을 읽으려면 애플리케이션이 관련된 CCSID에 따라 200바이트 이상을 읽어야 합니다. 따라서 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. */

codepage 키워드를 지정하는 경우 ccsid 키워드 또는 o_ccsid 키워드를 지정할 수 없습니다.

열 파일이 없고 열기 모드가 파일을 작성해야 함을 지정하는 경우에는 파일이 작성되고 연산된 코드 페이지 태그가 붙습니다. 파일이 이미 있으면 파일에서 읽은 데이터가 파일의 코드 페이지에서 읽기 조작 동안 연산된 코드 페이지로 변환됩니다. 파일에 쓰여진 데이터는 연산된 코드 페이지에 있다고 가정하며 쓰기 조작 동안 파일의 코드 페이지로 변환됩니다.

Y 사용될 행 종료자가 캐리지 리턴[CR], 줄 바꾸기[NL] 조합입니다. 데이터를 읽으면 스트링 함수에 대해 모든 캐리지 리턴[CR]이 스트라이프됩니다. 파일에 데이터가 기록되면 캐리지 리턴[CR]이 각 줄 바꾸기[NL] 문자 앞에 추가됩니다. 행 종료자 처리는 파일이 텍스트 모드로 열린 경우에만 발생합니다. 이는 디폴트입니다.

N 사용될 행 종료자가 줄 바꾸기[NL]뿐입니다.