Truxton media set id - Revision history

Sam at 11:38, 3 February 2024

2024-02-03T11:38:56Z

Sam at 19:56, 16 February 2021

2021-02-16T19:56:53Z

Sam at 03:39, 10 February 2021

2021-02-10T03:39:27Z

Sam at 12:30, 16 October 2020

2020-10-16T12:30:25Z

Sam at 12:17, 16 October 2020

2020-10-16T12:17:32Z

Sam: Created page with "Sets the identifier of the media object. This corresponds to the `ID` column of the `File` table. =Syntax= v..."

2020-07-09T10:15:14Z

Created page with "Sets the identifier of the media object. This corresponds to the <code>ID</code> column of the <code> File</code> table. =Syntax= <syntaxhighlight lang="C"> v..."

New page

Sets the identifier of the media object.
This corresponds to the <code>ID</code> column of the <code>[[File Table | File]]</code> table.

=Syntax=
<syntaxhighlight lang="C">
void truxton_media_set_id( uint64_t media_handle, char * id );
</syntaxhighlight>

=Parameters=
==<code>media_handle</code>==
The handle created by the [[truxton_media_create]] or [[truxton_media_open_id]] call.

==<code>id</code>==
The string representation of a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID.]

=Remarks=

This identifier will be stored in the <code>ID</code> column of the <code>Media</code> table in the database.

=Sample=
<syntaxhighlight lang="C" highlight="5">
void add_folder(uint64_t truxton, char * folder)
{
uint64_t media = truxton_media_create(truxton);

truxton_media_set_id( media, "1506fd04-3b7f-a872-ba0d-ec43efbdcf9e" );

load_all_files( media, folder );

truxton_media_free(media);
}
</syntaxhighlight>

@@ Line 1: / Line 1: @@
 Sets the identifier of the media object.
-This corresponds to the <code>[ID]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 The [[TGUID#Media_ID|media identifier]] is not random.

@@ Line 5: / Line 5: @@
 =Syntax=
 <source lang="C">
-void truxton_media_set_id( uint64_t media_handle, char * id );
+void truxton_media_set_id( uint64_t media_handle, char const * id );
 </source>
@@ Line 16: / Line 16: @@
 =Remarks=
 This identifier will be stored in the <code>[ID]</code> column of the <code>[Media]</code> table in the database.

@@ Line 4: / Line 4: @@
 =Syntax=
-<syntaxhighlight lang="C">
+<source lang="C">
 void truxton_media_set_id( uint64_t media_handle, char * id );
-</syntaxhighlight>
+</source>
 =Parameters=
@@ Line 20: / Line 20: @@
 =Sample=
-<syntaxhighlight lang="C" highlight="5">
+<source lang="C" highlight="5">
-void add_folder(uint64_t truxton, char * folder)
+void add_folder( uint64_t truxton, char * folder )
+{
-    uint64_t media = truxton_media_create(truxton);
+    uint64_t media = truxton_media_create( truxton );
     truxton_media_set_id( media, "1506fd04-3b7f-a872-ba0d-ec43efbdcf9e" );
@@ Line 29: / Line 29: @@
     load_all_files( media, folder );
-    truxton_media_free(media);
+    truxton_media_free( media );
+}
-</syntaxhighlight>
+</source>