Truxton child file end write - Revision history

Sam: /* Sample */

2024-04-14T06:59:57Z

Sample

Sam at 08:05, 13 February 2021

2021-02-13T08:05:41Z

Sam at 09:48, 13 November 2020

2020-11-13T09:48:43Z

Sam at 15:37, 20 May 2020

2020-05-20T15:37:12Z

Sam: Created page with "This API tells Truxton that you are finished writing contents. =Syntax= void truxton_child_file_end_write( uint64_t child_handle );
2020-05-20T14:25:31Z

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..."

New page
This API tells Truxton that you are finished writing contents.

=Syntax=
<syntaxhighlight lang="C">
void truxton_child_file_end_write( uint64_t child_handle );
</syntaxhighlight>

=Parameters=
==<code>child_handle</code>==

The handle created by the [[truxton_child_file_create]] call.

=Sample=

<syntaxhighlight lang="C" highlight="35">
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);
}
</syntaxhighlight>

@@ Line 15: / Line 15: @@
 =Sample=
-<source lang="C" highlight="35">
+<source lang="C" highlight="28">
 void add_text( uint64_t truxton, uint64_t parent_file )
+{
@@ Line 29: / Line 29: @@
     truxton_child_file_set_name( child, "Hi.txt" );
-    FILETIME now;
+    uint64_t now = truxton_time_now();
-   GetSystemTimePreciseAsFileTime( &now );
+    truxton_child_file_set_created( child, now );
+    truxton_child_file_set_accessed( child, now );
-   ULARGE_INTEGER ticks;
+    truxton_child_file_set_modified( child, now );
     truxton_child_file_set_origin( child, ORIGIN_GENERATED );

← Older revision		Revision as of 15:37, 20 May 2020
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=

@@ Line 16: / Line 16: @@
 =Sample=
 <source lang="C" highlight="35">
-void add_text(uint64_t truxton, uint64_t parent_file)
+void add_text( uint64_t truxton, uint64_t parent_file )
+{
-    truxton_start_adding_files(truxton);
+    truxton_start_adding_files( truxton );
-    uint64_t child = truxton_child_file_create(truxton);
+    uint64_t child = truxton_child_file_create( truxton );
     char id[40];
-    truxton_file_get_id(parent_file, id, sizeof(id));
+    truxton_file_get_id( parent_file, id, sizeof(id) );
-    truxton_child_file_set_parent_id(child, id);
+    truxton_child_file_set_parent_id( child, id );
-    truxton_child_file_set_type(child, Type_ASCII_Text);
+    truxton_child_file_set_type( child, Type_ASCII_Text );
-    truxton_child_file_set_name(child, "Hi.txt");
+    truxton_child_file_set_name( child, "Hi.txt" );
     FILETIME now;
-    GetSystemTimePreciseAsFileTime(&now);
+    GetSystemTimePreciseAsFileTime( &now );
     ULARGE_INTEGER ticks;
@@ Line 38: / Line 38: @@
     ticks.HighPart = now.dwHighDateTime;
-    truxton_child_file_set_created(child, ticks.QuadPart);
+    truxton_child_file_set_created( child, ticks.QuadPart );
-    truxton_child_file_set_accessed(child, ticks.QuadPart);
+    truxton_child_file_set_accessed( child, ticks.QuadPart );
-    truxton_child_file_set_modified(child, ticks.QuadPart);
+    truxton_child_file_set_modified( child, ticks.QuadPart );
-    truxton_child_file_set_origin(child, ORIGIN_GENERATED);
+    truxton_child_file_set_origin( child, ORIGIN_GENERATED );
-    truxton_child_file_begin_write(child);
+    truxton_child_file_begin_write( child );
     char * message = "Hello World\n";
-    truxton_child_file_write( child, message, strlen(message));
+    truxton_child_file_write( child, message, strlen(message) );
     truxton_child_file_end_write( child );
-    if ( truxton_child_file_save(child) == 0 )
+    if ( truxton_child_file_save( child ) == 0 )
+    {
        printf( "Failed to add child to Truxton\n" );
+    }
-    truxton_child_file_destroy(child);
+    truxton_child_file_destroy( child );
+}
 </source>

@@ Line 2: / Line 2: @@
 =Syntax=
-<syntaxhighlight lang="C">
+<source lang="C">
 void truxton_child_file_end_write( uint64_t child_handle );
-</syntaxhighlight>
+</source>
 =Parameters=
 ==<code>child_handle</code>==
 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=
+<source lang="C" highlight="35">
 void add_text(uint64_t truxton, uint64_t parent_file)
+{
@@ Line 34: / Line 31: @@
     FILETIME now;
-    GetSystemTimeAsFileTime(&now);
+    GetSystemTimePreciseAsFileTime(&now);
     ULARGE_INTEGER ticks;
@@ Line 62: / Line 59: @@
     truxton_child_file_destroy(child);
+}
-</syntaxhighlight>
+</source>