Difference between revisions of "Truxton subject save"

From truxwiki.com
Jump to navigation Jump to search
(Created page with "This saves the information in the subject object to the <code>[Suspect]</code> table. =Syntax= <source lang="C"> void truxton_subject_save( uint64_t subject_handle ); </sourc...")
 
 
Line 3: Line 3:
 
=Syntax=
 
=Syntax=
 
<source lang="C">
 
<source lang="C">
void truxton_subject_save( uint64_t subject_handle );
+
int truxton_subject_save( uint64_t subject_handle );
 
</source>
 
</source>
  
Line 10: Line 10:
 
The handle to the subject object.
 
The handle to the subject object.
 
This comes from calling <code>[[truxton_subject_create|truxton_subject_create()]]</code>.
 
This comes from calling <code>[[truxton_subject_create|truxton_subject_create()]]</code>.
 +
 +
=Return value=
 +
A non-zero value on success, zero on failure.
  
 
=Sample=
 
=Sample=

Latest revision as of 14:46, 25 May 2021

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 );
}