Difference between revisions of "Truxton artifact create"

From truxwiki.com
Jump to navigation Jump to search
Line 5: Line 5:
 
=Syntax=
 
=Syntax=
 
<source lang="C">
 
<source lang="C">
uint64_t truxton_artifact_create(uint64_t truxton_handle);
+
uint64_t truxton_artifact_create( uint64_t truxton_handle );
 
</source>
 
</source>
  
Line 18: Line 18:
 
=Sample=
 
=Sample=
 
<source lang="C" highlight="5">
 
<source lang="C" highlight="5">
void create_artifact(void)
+
void create_artifact( void )
 
{
 
{
 
   uint64_t truxton = truxton_create();
 
   uint64_t truxton = truxton_create();
  
   uint64_t artifact= truxton_artifact_create(truxton);
+
   uint64_t artifact= truxton_artifact_create( truxton );
  
 
   truxton_artifact_set_name( artifact, "Ducky Momo Server" );
 
   truxton_artifact_set_name( artifact, "Ducky Momo Server" );
Line 34: Line 34:
 
   printf( "Artifact ID is %s\n", id );
 
   printf( "Artifact ID is %s\n", id );
  
   truxton_artifact_destroy(artifact);
+
   truxton_artifact_destroy( artifact );
   truxton_destroy(truxton);
+
   truxton_destroy( truxton );
 
}
 
}
 
</source>
 
</source>

Revision as of 11:07, 10 February 2021

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 );
}