`fsetpos`

Artikel
10/12/2023

Mengatur indikator posisi aliran.

Sintaks

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

Parameter

stream
Penunjuk ke FILE struktur.

pos
Penyimpanan indikator posisi.

Nilai hasil

Jika berhasil, fsetpos mengembalikan 0. Jika gagal, fungsi mengembalikan nilai bukan nol dan diatur ke salah satu konstanta errno manifes berikut (ditentukan dalam ERRNO. H): EBADF, yang berarti file tidak dapat diakses atau objek yang menunjuk ke bukan struktur file yang stream valid; atau EINVAL, yang berarti nilai yang tidak valid untuk stream atau pos diteruskan. Jika parameter yang tidak valid diteruskan, fungsi-fungsi ini memanggil handler parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter.

Untuk informasi selengkapnya tentang kode pengembalian, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.

Keterangan

Fungsi fsetpos mengatur indikator posisi file untuk stream ke nilai pos, yang diperoleh dalam panggilan sebelumnya ke fgetpos terhadap stream. Fungsi ini menghapus indikator akhir file dan membatalkan efek apa pun pada ungetcstream. Setelah panggilan ke fsetpos, operasi stream berikutnya mungkin berupa input atau output.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Persyaratan

Function	Header yang diperlukan
`fsetpos`	<stdio.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Lihat contoh untuk fgetpos.