Truxton subject save

This saves the information in the subject object to the [Suspect] table.

Syntax

int truxton_subject_save( uint64_t subject_handle );

Parameters

subject_handle

The handle to the subject object. This comes from calling truxton_subject_create().

Return value

A non-zero value on success, zero on failure.

Sample

void create_villan( uint64_t truxton )
{
   uint64_t subject = truxton_subject_create( truxton );

   truxton_subject_set_name( subject, "Khaka Peü Peü" );
   truxton_subject_set_description( subject, "Last name translates to 'This strong hand or that strong hand.'" );
   truxton_subject_set_custom( subject, "Danville PD Tri-State ID: TSA-785543" );
   truxton_subject_set_birthday( subject, to_ticks( "1963-09-18" ) );
   truxton_subject_set_id( subject, "5068696E-6561-7320-616E-642046657262" );
   truxton_subject_set_picture( subject, base64_encode( "C:\Subjects\Photos\KPP.png" ) );

   // Commit the data to the database
   truxton_subject_save( subject );

   truxton_subject_tag( subject, "Prime Suspect", "As identified by The Beak", TAG_ORIGIN_HUMAN );
   truxton_subject_destroy( subject );
}