Difference between revisions of "Extensions.File.WriteBytes"

From emotive
Jump to navigation Jump to search
Line 16: Line 16:
 
{| {{TableHeader}}
 
{| {{TableHeader}}
 
{{TableRowPropertiesHeader}}
 
{{TableRowPropertiesHeader}}
{{TableRowPropertie1| handle| [[Extensions.File.FileWriteHandle|FileWriteHandle]] | [[Term]] | - | [1..1] | The handle for the file that the related file object encapsulates.}}
+
{{TableRowPropertie1| Handle| [[Extensions.File.FileWriteHandle|FileWriteHandle]] | [[Term]] | - | [1..1] | The handle for the file that the related file object encapsulates.}}
{{TableRowPropertie2| value| [[Core.DataTypes.ComplexDataType.ByteField|ByteField]] | [[Term]] | - | [1..1] | The ByteField to write to the file.}}
+
{{TableRowPropertie2| Value| [[Core.DataTypes.ComplexDataType.ByteField|ByteField]] | [[Term]] | - | [1..1] | The ByteField to write to the file.}}
 
|}
 
|}
  

Revision as of 03:03, 25 October 2018

Classification

Name WriteBytes
Short Description Appends the specified bytes to the filehandle
Class Action
Extension OTX File extension
Group File related Actions
Exceptions FileAccessException
FileFormatException
FileLockException
Checker Rules -
Standard Compliant Yes

OTL Syntax

File.WriteBytes(FileWriteHandleTerm, ByteFieldTerm);

Description

The WriteBytes activity appends the specified bytes to the filehandle.

The first read or write activity on a file handle defines if an access shall be realized by line, bytes or file. Mixed access will lead to a FileFormatException.

Properties

Name Data Type Class Default Cardinality Description
Handle FileWriteHandle Term - [1..1] The handle for the file that the related file object encapsulates.
Value ByteField Term - [1..1] The ByteField to write to the file.

OTL Examples

/// Local Declarations

File.FileWriteHandle FileWriteHandle1;

/// Flow

FileWriteHandle1 = File.OpenFileForWrite("file:///D:/abc/abc.txt", false, @Encoding:UTF-8);
File.WriteBytes(FileWriteHandle1, &48656C6C6F);

See also

CloseFile
DeleteDirectory
DeleteFile
SaveFile
WriteFile
WriteLine