Difference between revisions of "Truxton file get details"

From truxwiki.com
Jump to navigation Jump to search
 
(One intermediate revision by the same user not shown)
Line 2: Line 2:
  
 
=Syntax=
 
=Syntax=
<syntaxhighlight lang="C">
+
<source lang="C">
 
void truxton_file_get_details( uint64_t file_handle, char * destination_string, size_t max_size );
 
void truxton_file_get_details( uint64_t file_handle, char * destination_string, size_t max_size );
</syntaxhighlight>
+
</source>
  
 
=Parameters=
 
=Parameters=
Line 22: Line 22:
  
 
=Sample=
 
=Sample=
<syntaxhighlight lang="C" highlight="12">
+
<source lang="C" highlight="12">
int print_id(uint64_t truxton)
+
void print_id( uint64_t truxton )
 
{
 
{
   uint64_t file = truxton_file_open_md5(truxton, "9ec8fb6095c35eff2b236863b7caaf10");
+
   uint64_t file = truxton_file_open_md5( truxton, "9ec8fb6095c35eff2b236863b7caaf10" );
  
 
   if ( file != 0 )
 
   if ( file != 0 )
 
   {
 
   {
       return(0);
+
       return;
 
   }
 
   }
  
 
   char json[ 16384 ];
 
   char json[ 16384 ];
  
   truxton_file_get_file_details(file, json, sizeof(json) );
+
   truxton_file_get_file_details( file, json, sizeof(json) );
  
   printf( "%s\n", name_string);
+
   printf( "%s\n", name_string );
  
   truxton_file_free(file);
+
   truxton_file_free( file );
 
}
 
}
</syntaxhighlight>
+
</source>

Latest revision as of 17:27, 10 February 2021

This retrieves a JSON blob containing details from the file's contents.

Syntax

void truxton_file_get_details( uint64_t file_handle, char * destination_string, size_t max_size );

Parameters

file_handle

The handle created by the truxton_file_open_id or truxton_file_open_md5 call.

destination_string

The string to be written to.

max_size

The maximum number of characters that can be written to destination_string.

Remarks

This method only works on files with contents. It does not work for every file type in Truxton. But, if it is a supported file type, Truxton will open the file, interpret the contents and output details in JSON format.

Sample

void print_id( uint64_t truxton )
{
   uint64_t file = truxton_file_open_md5( truxton, "9ec8fb6095c35eff2b236863b7caaf10" );

   if ( file != 0 )
   {
      return;
   }

   char json[ 16384 ];

   truxton_file_get_file_details( file, json, sizeof(json) );

   printf( "%s\n", name_string );

   truxton_file_free( file );
}