Difference between revisions of "Truxton artifact create"

From truxwiki.com
Jump to navigation Jump to search
Line 4: Line 4:
  
 
=Syntax=
 
=Syntax=
<syntaxhighlight lang="C">
+
<source lang="C">
 
uint64_t truxton_artifact_create(uint64_t truxton_handle);
 
uint64_t truxton_artifact_create(uint64_t truxton_handle);
</syntaxhighlight>
+
</source>
  
 
=Parameters=
 
=Parameters=
Line 17: Line 17:
  
 
=Sample=
 
=Sample=
<syntaxhighlight lang="C" highlight="5">
+
<source lang="C" highlight="5">
 
void create_artifact(void)
 
void create_artifact(void)
 
{
 
{
Line 37: Line 37:
 
   truxton_destroy(truxton);
 
   truxton_destroy(truxton);
 
}
 
}
</syntaxhighlight>
+
</source>

Revision as of 04:45, 2 December 2020

This creates an artifact object. Internally, Truxton calls these entities. You can use this to add records to the [Entity] table in the database.

Syntax

uint64_t truxton_artifact_create(uint64_t truxton_handle);

Parameters

truxton_handle

The Truxton instance this artifact will belong. This handle comes from calling truxton_create().

Return value

A handle to an artifact object.

Sample

void create_artifact(void)
{
   uint64_t truxton = truxton_create();

   uint64_t artifact= truxton_artifact_create(truxton);

   truxton_artifact_set_name( artifact, "Ducky Momo Server" );
   truxton_artifact_save( artifact);
   truxton_artifact_tag( artifact, "Too Young", "Yes, yes I am", 1 );

   char id[ 65 ];

   truxton_artifact_get_id( artifact, id, sizeof( id ) );

   printf( "Artifact ID is %s\n", id );

   truxton_artifact_destroy(artifact);
   truxton_destroy(truxton);
}