Difference between revisions of "Truxton relation set b id"

From truxwiki.com
Jump to navigation Jump to search
(Created page with "This sets the B side of the relation in the sentence "A is a blank of B." This corresponds to the <code>[B_ID]</code> column of the the <code><nowiki>[</nowiki>Relation Tabl...")
 
Line 14: Line 14:
 
==<code>id</code>==
 
==<code>id</code>==
 
The string representation of a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID.]
 
The string representation of a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID.]
 +
This value is an identifier of an object in Truxton.
  
 
=Sample=
 
=Sample=
<source lang="C" line highlight="15">
+
<source lang="C" highlight="19">
 
void set_primary_photo( uint64_t truxton, uint64_t media, uint64_t child_file )
 
void set_primary_photo( uint64_t truxton, uint64_t media, uint64_t child_file )
 
{
 
{

Revision as of 07:05, 17 January 2021

This sets the B side of the relation in the sentence "A is a blank of B." This corresponds to the [B_ID] column of the the [Relation] table in the database.

Syntax

void truxton_relation_set_b_id(uint64_t relation_handle, char const * id);

Parameters

relation_handle

The relation object to free. This handle comes from calling truxton_relation_create().

id

The string representation of a GUID. This value is an identifier of an object in Truxton.

Sample

void set_primary_photo( uint64_t truxton, uint64_t media, uint64_t child_file )
{
   char media_id[ 65 ];
   char file_id[ 65 ];
   
   truxton_media_get_id( media, media_id, sizeof( media_id ) );
   truxton_child_file_get_id( child_file, file_id, sizeof( file_id ) );

   uint64_t relation = truxton_relation_create( truxton );

   // Now tell Truxton that child_file (A object) is the primary photo of media (B object)
   truxton_relation_set_relation( relation, RELATION_PRIMARY_PHOTO );

   // Set the A object, A is a file
   truxton_relation_set_a_id( relation, file_id );
   truxton_relation_set_a_type( relation, OBJECT_TYPE_FILE );

   // Set the B object, B is a piece of media
   truxton_relation_set_b_id( relation, media_id );
   truxton_relation_set_b_type( relation, OBJECT_TYPE_MEDIA );

   // Set the source object, source is a piece of media
   truxton_relation_set_source_id( relation, media_id );
   truxton_relation_set_source_type( relation, OBJECT_TYPE_MEDIA );

   // Commit the data to the database
   truxton_relation_save( relation );
   truxton_relation_destroy( relation );
}