Difference between revisions of "Extensions.File.WriteBytes"

From emotive
Jump to navigation Jump to search
Line 10: Line 10:
 
== Description ==
 
== Description ==
 
The '''WriteBytes''' activity appends the specified bytes to the filehandle.
 
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 [[Extensions.File.FileFormatException|FileFormatException]].
 
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 [[Extensions.File.FileFormatException|FileFormatException]].
  

Revision as of 04:32, 27 September 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

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