Difference between revisions of "Truxton child file end write"

From truxwiki.com
Jump to navigation Jump to search
(Created page with "This API tells Truxton that you are finished writing contents. =Syntax= <syntaxhighlight lang="C"> void truxton_child_file_end_write( uint64_t child_handle ); </syntaxhighlig...")
 
Line 10: Line 10:
  
 
The handle created by the [[truxton_child_file_create]] call.
 
The handle created by the [[truxton_child_file_create]] call.
 +
 +
=Remarks=
 +
 +
If the [[truxton_child_file_set_modified | modified]] time was not set on the file prior to writing, the modified timestamp will be set to when the current time.
 +
If the [[truxton_child_file_set_size | file size]] was not set on the file prior to writing, it will be set to the total number of byte written to the file.
  
 
=Sample=
 
=Sample=

Revision as of 11:37, 20 May 2020

This API tells Truxton that you are finished writing contents.

Syntax

void truxton_child_file_end_write( uint64_t child_handle );

Parameters

child_handle

The handle created by the truxton_child_file_create call.

Remarks

If the modified time was not set on the file prior to writing, the modified timestamp will be set to when the current time. If the file size was not set on the file prior to writing, it will be set to the total number of byte written to the file.

Sample

void add_text(uint64_t truxton, uint64_t parent_file)
{
   truxton_start_adding_files(truxton);

   uint64_t child = truxton_child_file_create(truxton);

   char id[40];

   truxton_file_get_id(parent_file, id, sizeof(id));
   truxton_child_file_set_parent_id(child, id);
   truxton_child_file_set_type(child, Type_ASCII_Text);
   truxton_child_file_set_name(child, "Hi.txt");

   FILETIME now;

   GetSystemTimeAsFileTime(&now);

   ULARGE_INTEGER ticks;

   ticks.LowPart = now.dwLowDateTime;
   ticks.HighPart = now.dwHighDateTime;

   truxton_child_file_set_created(child, ticks.QuadPart);
   truxton_child_file_set_accessed(child, ticks.QuadPart);
   truxton_child_file_set_modified(child, ticks.QuadPart);

   truxton_child_file_set_origin(child, ORIGIN_GENERATED);

   truxton_child_file_begin_write(child);

   char * message = "Hello World\n";

   truxton_child_file_write( child, message, strlen(message));

   truxton_child_file_end_write( child );

   if ( truxton_child_file_save(child) == 0 )
   {
      printf( "Failed to add child to Truxton\n" );
   }

   truxton_child_file_destroy(child);
}