Difference between revisions of "Truxton file open id"

From truxwiki.com
Jump to navigation Jump to search
Line 12: Line 12:
 
==<code>guid_string</code>==
 
==<code>guid_string</code>==
 
The string representation of the identifier of the file to get in Truxton.
 
The string representation of the identifier of the file to get in Truxton.
This corresponds to the <code>ID</code> column of the <code>[[File Table|File]]</code> table.
+
This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table.
 
The [[TGUID#File_ID|file identifier]] is not random.
 
The [[TGUID#File_ID|file identifier]] is not random.
  

Revision as of 09:02, 21 October 2020

This retrieves a file from Truxton by its GUID.

Syntax

uint64_t truxton_file_open_id( uint64_t truxton_handle, char const * guid_string );

Parameters

truxton_handle

The handle created by the truxton_create call.

guid_string

The string representation of the identifier of the file to get in Truxton. This corresponds to the [ID] column of the [File] table. The file identifier is not random.

Return value

A handle to a read-only file in Truxton.

Sample

int check_it(uint64_t truxton)
{
   uint64_t file = truxton_file_open_id(truxton, "5ed3aeb7-3da4-5f5c-8c8f-af5200000000");

   if ( file != 0 )
   {
      return(0);
   }

   truxton_file_close(file);
   truxton_file_free(file);

   return(1)
}