Truxton set black box source code location

This function writes information to the Black Box about where you are in your source code.

Syntax

void truxton_set_black_box_source_code_location( uint64_t source_code_file_identifier, uint64_t line_number_in_the_source_code_file );

Parameters

source_code_file_identifier

An integer value that you created to represent the name of the source code file.

line_number_in_the_source_code_file

An integer value that you created to represent the name of the source code file.

Sample

#define CHECK_SIZE_CPP (0x1122334455)

int is_valid_size( file_object * f )
{
   truxton_set_black_box_source_code_location( CHECK_SIZE_CPP, __LINE__ );

   if ( f->bytes_per_page < 3 )
   {
      return( 0 );
   }

   truxton_set_black_box_source_code_location( CHECK_SIZE_CPP, __LINE__ );

   if ( check_alignment( f ) == 0 )
   {
      return( 0 );
   }

   truxton_set_black_box_source_code_location( CHECK_SIZE_CPP, __LINE__ );

   if ( ( f->bytes_per_sector % 512 ) == 0 )
   {
      return( 1 );
   }
   
   truxton_set_black_box_source_code_location( CHECK_SIZE_CPP, __LINE__ );

   return( 0 );
}