Truxton relation create - Revision history

Sam at 13:05, 13 February 2021

2021-02-13T13:05:20Z

Sam: /* truxton_handle */

2021-01-18T15:01:17Z

truxton_handle

Sam: /* Sample */

2020-12-29T09:50:59Z

Sample

Sam: Created page with "This creates an object you can use to form a relationship between two other objects in Truxton. =Syntax= uint64_t truxton_relation_create(uint64_t truxton_h..."

2020-12-29T09:41:11Z

Created page with "This creates an object you can use to form a relationship between two other objects in Truxton. =Syntax= <source lang="C"> uint64_t truxton_relation_create(uint64_t truxton_h..."

New page

This creates an object you can use to form a relationship between two other objects in Truxton.

=Syntax=
<source lang="C">
uint64_t truxton_relation_create(uint64_t truxton_handle);
</source>

=Parameters=
==<code>truxton_handle</code>==
The Truxton instance this media will belong.
This handle comes from calling <code>[[truxton_create]]()</code>.

=Return value=
A handle to a relation object.

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

truxton_relation_set_relation( relation, RELATION_PRIMARY_PHOTO );
truxton_relation_set_a_id( relation, file_id );
truxton_relation_set_a_type( relation, OBJECT_TYPE_FILE );
truxton_relation_set_b_id( relation, media_id );
truxton_relation_set_b_type( relation, OBJECT_TYPE_MEDIA );
truxton_relation_set_source_id( relation, media_id );
truxton_relation_set_source_type( relation, OBJECT_TYPE_MEDIA );

truxton_relation_save( relation );
truxton_relation_destroy( relation );
}
</source>

@@ Line 3: / Line 3: @@
 =Syntax=
 <source lang="C">
-uint64_t truxton_relation_create(uint64_t truxton_handle);
+uint64_t truxton_relation_create( uint64_t truxton_handle );
 </source>

@@ Line 8: / Line 8: @@
 =Parameters=
 ==<code>truxton_handle</code>==
-The Truxton instance this media will belong.
+The Truxton instance this relation will belong.
 This handle comes from calling <code>[[truxton_create]]()</code>.

@@ Line 15: / Line 15: @@
 =Sample=
 <source lang="C" highlight="9">
-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 )
+{
     char media_id[ 65 ];
@@ Line 26: / Line 29: @@
     uint64_t relation = truxton_relation_create( truxton );
     truxton_relation_set_relation( relation, RELATION_PRIMARY_PHOTO );
     truxton_relation_set_a_id( relation, file_id );
     truxton_relation_set_a_type( relation, OBJECT_TYPE_FILE );
     truxton_relation_set_b_id( relation, media_id );
     truxton_relation_set_b_type( relation, OBJECT_TYPE_MEDIA );
     truxton_relation_set_source_id( relation, media_id );
     truxton_relation_set_source_type( relation, OBJECT_TYPE_MEDIA );
     truxton_relation_save( relation );
     truxton_relation_destroy( relation );
+}
 </source>