Sam: /* Sample */

2021-02-06T11:15:09Z

Sample

Sam: Created page with "This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the source object of the relation. This corresponds to the `[SourceID]` col..."

2021-01-17T12:02:49Z

Created page with "This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the source object of the relation. This corresponds to the <code>[SourceID]</code> col..."

New page

This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the source object of the relation.
This corresponds to the <code>[SourceID]</code> column of the <code><nowiki>[</nowiki>[[Relation Table|Relation]]<nowiki>]</nowiki></code> table.

=Syntax=
<source lang="C">
void truxton_relation_get_source_id( uint64_t relation_handle, char * destination_string, size_t max_size );
</source>

=Parameters=
==<code>relation_handle</code>==
This handle comes from calling <code>[[truxton_relation_create]]()</code>

==<code>destination_string</code>==
The string to be written to.

==<code>max_size</code>==
The maximum number of characters that can be written to <code>destination_string</code>.

=Sample=
<source lang="C" highlight="18">
void dump_relation(uint64_t relation_handle)
{
uint64_t value = 0;
char guid_string[ 65 ];

value = truxton_relation_get_a_type( relation_handle );
truxton_relation_get_a_id( relation_handle, guid_string, sizeof( guid_string ) );
printf( "A (%" PRIu64 ") %s is a ", value, guid_string );

value = truxton_relation_get_relation( relation_handle );
printf( "%" PRIu64 " of ", value );

value = truxton_relation_get_b_type( relation_handle );
truxton_relation_get_b_id( relation_handle, guid_string, sizeof( guid_string ) );
printf( "B (%" PRIu64 ") %s is a ", value, guid_string );

value = truxton_relation_get_source_type( relation_handle );
truxton_relation_get_source_id( relation_handle, guid_string, sizeof( guid_string ) );

printf( "Source (%" PRIu64 ") is %s\n", value, guid_string );
}
</source>

← Older revision		Revision as of 11:15, 6 February 2021
Line 41:		Line 41:
	}		}
	</source>		</source>
		+
		+	The <code>PRIu64</code> in the sample code above is a standard way of [https://en.wikipedia.org/wiki/C_data_types#Printf_and_scanf_format_specifiers formatting] a 64-bit unsigned integer in C.
		+	Over the years, different compilers on different operating systems used different format specifiers for things, these <code>PRI</code> macros, along with some tricky string concatenation the compilers perform for you, allow you to maintain a single code base without a bunch of macro magic.

Truxton relation get source id - Revision history

Sam: /* Sample */

Sam: Created page with "This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the source object of the relation. This corresponds to the [SourceID] col..."

Sam: Created page with "This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the source object of the relation. This corresponds to the `[SourceID]` col..."