Difference between revisions of "Truxton file get attributes"

From truxwiki.com
Jump to navigation Jump to search
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
This retrieves the filesystem attributes of the file.
 
This retrieves the filesystem attributes of the file.
It corresponds to the <code>Attributes</code> column of the <code>[[File Table | File]]</code> table.
+
It corresponds to the <code>[Attributes]</code> column of the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table.
  
 
=Syntax=
 
=Syntax=
Line 16: Line 16:
  
 
=Sample=
 
=Sample=
<syntaxhighlight lang="C" highlight="10">
+
<source lang="C" highlight="10">
int print_it(uint64_t truxton)
+
void print_it(uint64_t truxton)
 
{
 
{
 
   uint64_t file = truxton_file_open_md5(truxton, "9ec8fb6095c35eff2b236863b7caaf10");
 
   uint64_t file = truxton_file_open_md5(truxton, "9ec8fb6095c35eff2b236863b7caaf10");
Line 23: Line 23:
 
   if ( file != 0 )
 
   if ( file != 0 )
 
   {
 
   {
       return(0);
+
       return;
 
   }
 
   }
  
Line 29: Line 29:
  
 
   printf( "Attributes are %" PRIu32 "\n", attributes );
 
   printf( "Attributes are %" PRIu32 "\n", attributes );
 +
 +
  truxton_file_free( file );
 
}
 
}
</syntaxhighlight>
+
</source>
  
 
Note, the <code>PRIu32</code> in the sample code above is the new standard way of [https://en.wikipedia.org/wiki/C_data_types#Printf_and_scanf_format_specifiers formatting] a 32-bit integer in C.
 
Note, the <code>PRIu32</code> in the sample code above is the new standard way of [https://en.wikipedia.org/wiki/C_data_types#Printf_and_scanf_format_specifiers formatting] a 32-bit integer in C.
 
Over the years, different compilers on different operating systems used different format specifiers for things, these <code>PRI</code> macros, along with some tricky string concatenation the compilers perform for you, allow you to maintain a single code base without a bunch of macro magic.
 
Over the years, different compilers on different operating systems used different format specifiers for things, these <code>PRI</code> macros, along with some tricky string concatenation the compilers perform for you, allow you to maintain a single code base without a bunch of macro magic.

Latest revision as of 04:05, 9 November 2020

This retrieves the filesystem attributes of the file. It corresponds to the [Attributes] column of the [File] table.

Syntax

uint32_t truxton_file_get_attributes( uint64_t file_handle );

Parameters

file_handle

The handle created by the truxton_file_open_id or truxton_file_open_md5 call.

Return value

The attributes of the file. For a Microsoft filesystem, it will return a combination of the file attribute flags.

Sample

void print_it(uint64_t truxton)
{
   uint64_t file = truxton_file_open_md5(truxton, "9ec8fb6095c35eff2b236863b7caaf10");

   if ( file != 0 )
   {
      return;
   }

   uint32_t attributes = truxton_file_get_attributes( file );

   printf( "Attributes are %" PRIu32 "\n", attributes );

   truxton_file_free( file );
}

Note, the PRIu32 in the sample code above is the new standard way of formatting a 32-bit integer in C. Over the years, different compilers on different operating systems used different format specifiers for things, these PRI macros, along with some tricky string concatenation the compilers perform for you, allow you to maintain a single code base without a bunch of macro magic.