Difference between revisions of "Truxton file read"

From truxwiki.com
Jump to navigation Jump to search
(Created page with "This is how you read data from the file. =Syntax= <syntaxhighlight lang="C"> int64_t truxton_file_read( uint64_t file_handle, uint8_t * buffer, size_t buffer_size ) </syntaxh...")
 
Line 9: Line 9:
 
==<code>file_handle</code>==
 
==<code>file_handle</code>==
  
The handle created by the [[truxton_file_open_id]] of [[truxton_file_open_md5]] call.
+
The handle created by the [[truxton_file_open_id]] or [[truxton_file_open_md5]] call.
  
 
==<code>buffer</code>==
 
==<code>buffer</code>==

Revision as of 09:05, 6 June 2020

This is how you read data from the file.

Syntax

int64_t truxton_file_read( uint64_t file_handle, uint8_t * buffer, size_t buffer_size )

Parameters

file_handle

The handle created by the truxton_file_open_id or truxton_file_open_md5 call.

buffer

The memory where the bytes will be written.

buffer_size

The number of bytes to read from the file and write to the buffer.

Return value

The number of bytes written to buffer.

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);
   }

   int return_value = 0;

   uint32_t integer_value = 0;

   truxton_file_seek(file, 42, 0 );

   if ( truxton_file_read( file, &integer_value, sizeof(integer_value) ) == sizeof(integer_value) )
   {
      // We succeeded in reading all of the bytes in the integer

      if ( integer_value == 42 )
      {
         return_value = 1;
      }
   }

   truxton_file_free(file);

   return( return_value );
}