Truxton file seek

This allows you to alter the offset into the opened file where the next read will take place.

Syntax

int64_t truxton_file_seek( uint64_t file_handle, int64_t distance, int whence );

Parameters

file_handle

The handle created by the truxton_file_open_id or truxton_file_open_md5 call.

distance

The number of bytes to move from whence

whence

Where to seek from.

• SEEK_SET - 0 - the beginning of the file
• SEEK_CUR - 1 - the current read offset
• SEEK_END - 2 - the end of the file

These values mimic standard C library's lseek() whence values.

Return value

The offset into the file where the next byte will be read from.

Sample

int does_file_have_deep_philosophical_meaning( uint64_t truxton )
{
   uint64_t file = truxton_file_open_id( truxton, "5ed3aeb7-3da4-5f5c-8c8f-af5200000000" );

   if ( file != 0 )
   {
      return( 0 );
   }

   truxton_file_seek( file, 42, SEEK_SET );

   int64_t read_position = truxton_file_tell( file );

   truxton_file_close( file );
   truxton_file_free( file );

   if ( read_position == 42 )
   {
      return( 1 );
   }

   return( 0 )
}