fgetpos

获取流的文件位置指示器。

语法

int fgetpos(
   FILE *stream,
   fpos_t *pos
);

参数

stream
目标流。

pos
位置指示器存储。

返回值

如果成功,则 fgetpos 返回 0。 失败时,它返回一个非零值,并将 errno 设置为下列任一清单常量(在 STDIO.H 中定义):EBADF 或 EINVAL,前者意味着指定流不是有效文件指针或不可访问,后者意味着 stream 值或 pos 的值无效,例如如果任意一个为空指针。 如果 stream 或 pos 为 NULL 指针,此函数将调用无效参数处理程序,如参数验证中所述。

备注

fgetpos 函数获取 stream 参数的文件位置指示器的当前值,并将其存储在 pos 指向的对象中。 fsetpos 函数可以稍后使用存储在 pos 中的信息来重置在调用 fgetpos 时 stream 参数的指针所指向的位置。 pos 值以内部格式存储,且仅供 fgetpos 和 fsetpos 使用。

默认情况下,此函数的全局状态范围限定为应用程序。 若要更改此行为,请参阅 CRT 中的全局状态。

要求

函数 必需的标头
fgetpos <stdio.h>

有关兼容性的详细信息,请参阅 兼容性。

示例

// crt_fgetpos.c
// This program uses fgetpos and fsetpos to
// return to a location in a file.

#include <stdio.h>

int main( void )
{
   FILE   *stream;
   fpos_t pos;
   char   buffer[20];

   if( fopen_s( &stream, "crt_fgetpos.txt", "rb" ) ) {
      perror( "Trouble opening file" );
      return -1;
   }

   // Read some data and then save the position.
   fread( buffer, sizeof( char ), 8, stream );
   if( fgetpos( stream, &pos ) != 0 ) {
      perror( "fgetpos error" );
      return -1;
   }

   fread( buffer, sizeof( char ), 13, stream );
   printf( "after fgetpos: %.13s\n", buffer );

   // Restore to old position and read data
   if( fsetpos( stream, &pos ) != 0 ) {
      perror( "fsetpos error" );
      return -1;
   }

   fread( buffer, sizeof( char ), 13, stream );
   printf( "after fsetpos: %.13s\n", buffer );
   fclose( stream );
}

输入:crt_fgetpos.txt

fgetpos gets a stream's file-position indicator.

输出:crt_fgetpos.txt

after fgetpos: gets a stream
after fsetpos: gets a stream

另请参阅

流 I/O
fsetpos