Sam at 14:21, 15 February 2021

2021-02-15T14:21:43Z

Sam at 10:14, 15 February 2021

2021-02-15T10:14:38Z

Sam: Created page with "This retrieves the identifier of the subject. This corresponds to the `[ID]` column of the `[Suspect]` table. =Syntax= void truxton_su..."

2021-02-15T10:08:35Z

Created page with "This retrieves the identifier of the subject. This corresponds to the <code>[ID]</code> column of the <code>[Suspect]</code> table. =Syntax= <source lang="C"> void truxton_su..."

New page

This retrieves the identifier of the subject.
This corresponds to the <code>[ID]</code> column of the <code>[Suspect]</code> table.

=Syntax=
<source lang="C">
void truxton_suspect_get_id( uint64_t subject_handle, char * destination_string, size_t max_size );
</source>

=Parameters=
==<code>subject_handle</code>==
This comes from calling <code>[[truxton_subject_create|truxton_subject_create()]]</code>.

==<code>destination_string</code>==
The string to be written to.

==<code>max_size</code>==
The maximum number of characters that can be written to <code>destination_string</code>.

=Sample=
<source lang="C" highlight="7">
void dump_subject( uint64_t subject_handle )
{
uint64_t integer_value = 0;

char temp_string[ 1024 ];

truxton_subject_get_id( subject_handle, temp_string, sizeof(temp_string) );
printf( "Subject ID is %s\n", temp_string );

truxton_subject_get_name( subject_handle, temp_string, sizeof(temp_string) );
printf( Name: %s\n", temp_string );

truxton_subject_get_description( subject_handle, temp_string, sizeof(temp_string) );
printf( "Description: %s\n", temp_string );

truxton_subject_get_custom( subject_handle, temp_string, sizeof(temp_string) );
printf( "Custom: %s\n", temp_string );

truxton_subject_get_picture( subject_handle, temp_string, sizeof(temp_string) );
display_base64_encoded_png( temp_string );

integer_value = truxton_subject_get_birthday( subject_handle );

if ( integer_value == 0 )
{
printf( "Birthday: Unknown\n" );
}
else
{
printf( "Birthday: %" PRIu64 "\n", integer_value );
}
}
</source>

The <code>PRIu64</code> in the sample code above is a standard way of [https://en.wikipedia.org/wiki/C_data_types#Printf_and_scanf_format_specifiers formatting] a 64-bit unsigned integer in C.
Over the years, different compilers on different operating systems used different format specifiers for things, these <code>PRI</code> 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.

@@ Line 29: / Line 29: @@
     truxton_subject_get_name( subject_handle, temp_string, sizeof(temp_string) );
-    printf( Name: %s\n", temp_string );
+    printf( "Name: %s\n", temp_string );
     truxton_subject_get_description( subject_handle, temp_string, sizeof(temp_string) );

@@ Line 4: / Line 4: @@
 =Syntax=
 <source lang="C">
-void truxton_suspect_get_id( uint64_t subject_handle, char * destination_string, size_t max_size );
+void truxton_subject_get_id( uint64_t subject_handle, char * destination_string, size_t max_size );
 </source>

Truxton subject get id - Revision history

Sam at 14:21, 15 February 2021

Sam at 10:14, 15 February 2021

Sam: Created page with "This retrieves the identifier of the subject. This corresponds to the [ID] column of the [Suspect] table. =Syntax= void truxton_su..."

Sam: Created page with "This retrieves the identifier of the subject. This corresponds to the `[ID]` column of the `[Suspect]` table. =Syntax= void truxton_su..."