Skip to main content

fseek

warning

This function starts with lowercase letter.

คำอธิบาย

Change the current position in the file. You can either seek forward or backward through the file.

NameDescription
handleThe file handle to use. Returned by fopen.
positionThe new position in the file, relative to the parameter whence (see below).
whenceThe starting position to which parameter position relates.
seek_startSet the file position relative to the start of the file (the position parameter must be positive).
seek_currentSet the file position relative to the current file position: the position parameter is added to the current position.
seek_endSet the file position relative to the end of the file (parameter position must be zero or negative).

ส่งคืน

The new position; relative to the start of the file.

ตัวอย่าง

// Open "file.txt" in "read only" mode
new File:handle = fopen("file.txt", io_read);

// If "file.txt" is open
if (handle)
{
// Success

// Jump to the 1st byte of "file.txt", and print its position
printf("Begin of file position: %d", fseek(handle, 0, seek_start));

// Jump to the last byte of "file.txt", and print its position
printf("End of file position: %d", fseek(handle, 0, seek_end));

// Jump to the same byte of "file.txt", and print its position
printf("Currrent file position: %d", fseek(handle, 0, seek_current));

// Close "file.txt"
fclose(handle);
}
else
{
// Error
print("Failed to open \"file.txt\".");
}

บันทึก

warning

Using an invalid handle will crash your server! Get a valid handle by using fopen or ftemp.

ฟังก์ชั่นที่เกี่ยวข้องกัน

  • fopen: Open a file.
  • fclose: Close a file.
  • ftemp: Create a temporary file stream.
  • fremove: Remove a file.
  • fwrite: Write to a file.
  • fread: Read a file.
  • fputchar: Put a character in a file.
  • fgetchar: Get a character from a file.
  • fblockwrite: Write blocks of data into a file.
  • fblockread: Read blocks of data from a file.
  • fseek: Jump to a specific character in a file.
  • flength: Get the file length.
  • fexist: Check, if a file exists.
  • fmatch: Check, if patterns with a file name matches.