Truxton relation save - Revision history

Sam at 12:58, 26 January 2021

2021-01-26T12:58:07Z

Sam at 22:25, 18 January 2021

2021-01-18T22:25:06Z

Sam: /* relation_handle */

2021-01-17T11:16:58Z

relation_handle

Sam: Created page with "This commits the information in the relation object to the `[Relation]` table in the database. =Syntax=
2021-01-17T10:50:21Z

Created page with "This commits the information in the relation object to the <code><nowiki>[</nowiki>Relation<nowiki>]</nowiki></code> table in the database. =Syntax= <sourc..."

New page
This commits the information in the relation object to the <code><nowiki>[</nowiki>[[Relation Table|Relation]]<nowiki>]</nowiki></code> table in the database.

=Syntax=
<source lang="C">
void truxton_relation_save(uint64_t relation_handle);
</source>

=Parameters=
==<code>relation_handle</code>==
The relation object to free.
This handle comes from calling <code>[[truxton_relation_create]]()</code>.

=Sample=
<source lang="C" highlight="27">
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 );
}
</source>