Sam at 12:22, 13 February 2021

2021-02-13T12:22:43Z

Sam: /* relation_handle */

2021-01-17T11:16:02Z

relation_handle

Sam: Created page with "This sets the origin of the relation. Relationships don't just happen, you have to work at them. The source of a relation is the object that contained the information from whi..."

2021-01-17T11:09:16Z

Created page with "This sets the origin of the relation. Relationships don't just happen, you have to work at them. The source of a relation is the object that contained the information from whi..."

New page

This sets the origin of the relation.
Relationships don't just happen, you have to work at them.
The source of a relation is the object that contained the information from which the relationship was deduced.
This corresponds to the <code>[SourceID]</code> column of the the <code><nowiki>[</nowiki>[[Relation Table|Relation]]<nowiki>]</nowiki></code> table in the database.

=Syntax=
<source lang="C">
void truxton_relation_set_source_id(uint64_t relation_handle, char const * id);
</source>

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

==<code>id</code>==
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=
<source lang="C" highlight="23">
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>

@@ Line 6: / Line 6: @@
 =Syntax=
 <source lang="C">
-void truxton_relation_set_source_id(uint64_t relation_handle, char const * id);
+void truxton_relation_set_source_id( uint64_t relation_handle, char const * id );
 </source>

@@ Line 11: / Line 11: @@
 =Parameters=
 ==<code>relation_handle</code>==
-The relation object to free.
+The relation object.
 This handle comes from calling <code>[[truxton_relation_create]]()</code>.

Truxton relation set source id - Revision history

Sam at 12:22, 13 February 2021

Sam: /* relation_handle */

Sam: Created page with "This sets the origin of the relation. Relationships don't just happen, you have to work at them. The source of a relation is the object that contained the information from whi..."