Truxton message get depot length

This tells you how many bytes in the depot file this file's contents consume. This corresponds to the [Length] column of the [Content] table.

Syntax

uint32_t truxton_message_get_depot_length( uint64_t message_handle );

Parameters

message_handle

The handle to a message created by the truxton_message_create call.

Return value

The number of bytes in the depot that you can read for this file's contents.

Sample

void dump_length( uint64_t message )
{
   uint64_t value = truxton_message_get_depot_length( message );

   printf( "Size is %" PRIu64 "\n", value );
}

The PRIu64 in the sample code above is a standard way of formatting a 64-bit unsigned 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.