Difference between revisions of "Truxton file get depot length"

From truxwiki.com
Jump to navigation Jump to search
Line 1: Line 1:
This retrieves the number of bytes in the depot file where this file's contents are stored.
+
This retrieves the number of bytes in the [[Depot|depot file]] where this file's contents are stored.
 
It corresponds to the <code>[Length]</code> column of the <code>[Content]</code> table.
 
It corresponds to the <code>[Length]</code> column of the <code>[Content]</code> table.
  

Revision as of 11:01, 25 May 2022

This retrieves the number of bytes in the depot file where this file's contents are stored. It corresponds to the [Length] column of the [Content] table.

Syntax

uint64_t truxton_file_get_depot_length( uint64_t file_handle );

Parameters

file_handle

The handle created by the truxton_file_open_id or truxton_file_open_md5 call.

Return value

The number of bytes in the depot file used by storing this file's content.

Sample

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

   if ( file != 0 )
   {
      return;
   }

   uint64_t length = truxton_file_get_depot_length( file );

   printf( "Contents take up %" PRIu64 " bytes of depot storage\n", length );

   truxton_file_free( file );
}

Note, the PRIu64 in the sample code above is the new standard way of formatting a 64-bit integer in C. Over the years, different compilers on different operating systems used different format specifiers for things, these PRI macros, along with some tricky string concatenation the compilers perform for you, allow you to maintain a single code base without a bunch of macro magic.