Truxton file get number of children

This is the number files records that have this file as their parent. It corresponds to the [NumberOfChildren] column of the [File] table.

Syntax

uint32_t truxton_file_get_number_of_children( 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 file records that have this file as their parent.

Sample

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

   if ( file != 0 )
   {
      return;
   }

   uint32_t count = truxton_file_get_number_of_children( file );
   truxton_file_free( file );

   printf( "There are %" PRIu32 " children of this file.\n", count );
}

The PRIu32 in the sample code above is a standard way of formatting a 32-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.