fsetposfsetpos

스트림 위치 표시기를 설정합니다.Sets the stream-position indicator.

구문Syntax

int fsetpos(
   FILE *stream,
   const fpos_t *pos
);

매개 변수Parameters

스트림stream
FILE 구조체에 대한 포인터입니다.Pointer to FILE structure.

pospos
위치 표시기 스토리지입니다.Position-indicator storage.

Return ValueReturn Value

성공 하면 fsetpos 가 0을 반환 합니다.If successful, fsetpos returns 0. 오류가 발생 하면 함수는 0이 아닌 값을 반환 하 고 errno 를 errno에 정의 된 다음 매니페스트 상수 중 하나로 설정 합니다. H): Ebadf(파일에 액세스할 수 없거나 스트림이 가리키는 개체가 유효한 파일 구조가 아님을 의미 함) 또는 EINVAL입니다 .이는 stream 또는 pos 에 대해 잘못 된 값이 전달 되었음을 의미 합니다.On failure, the function returns a nonzero value and sets errno to one of the following manifest constants (defined in ERRNO.H): EBADF, which means the file is not accessible or the object that stream points to is not a valid file structure; or EINVAL, which means an invalid value for stream or pos was passed. 잘못된 매개 변수가 전달되면 이러한 함수는 매개 변수 유효성 검사의 설명대로 잘못된 매개 변수 처리기를 호출합니다.If an invalid parameter is passed in, these functions invoke the invalid parameter handler, as described in Parameter Validation.

이러한 반환 코드 및 기타 반환 코드에 대한 자세한 내용은 _doserrno, errno, _sys_errlist 및 _sys_nerr를 참조하세요.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, return codes.

설명Remarks

Fsetpos 함수는 스트림에 대 한 fgetpos대 한 이전호출에서 가져온 pos의 값으로 스트림에 대 한 파일 위치 표시기를 설정 합니다.The fsetpos function sets the file-position indicator for stream to the value of pos, which is obtained in a prior call to fgetpos against stream. 함수는 파일 끝 표시기를 지우고 스트림에서 ungetc 의 효과를 실행 취소 합니다.The function clears the end-of-file indicator and undoes any effects of ungetc on stream. Fsetpos를 호출한 후 스트림에 대 한 다음 작업은 입력 또는 출력 중 하나일 수 있습니다.After calling fsetpos, the next operation on stream may be either input or output.

기본적으로이 함수의 전역 상태는 응용 프로그램으로 범위가 지정 됩니다.By default, this function's global state is scoped to the application. 이를 변경 하려면 CRT의 전역 상태를 참조 하세요.To change this, see Global state in the CRT.

요구 사항Requirements

기능Function 필수 헤더Required header
fsetposfsetpos <stdio.h><stdio.h>

호환성에 대한 자세한 내용은 Compatibility을 참조하세요.For additional compatibility information, see Compatibility.

예제Example

fgetpos의 예제를 참조하세요.See the example for fgetpos.

참조See also

스트림 I/OStream I/O
fgetposfgetpos