WriteStringN()

Syntax

Result = WriteStringN(#File, Text$ [, Format])
Description
Write a string to a file and add an 'end of line' character.

Parameters

#File The file to write to.
Text$ The string to write.
Format (optional) The format in which to write the string. It can be one of the following values:
  #PB_Ascii  : Writes the string in ASCII format
  #PB_UTF8   : Writes the string in UTF8 format
  #PB_Unicode: Writes the string in UTF16 format
If this flag isn't set, then the format for writing the string depends on the related setting at the previously used CreateFile() or OpenFile() command.

Return value

Returns nonzero if the operation was successful and zero if it failed.

Remarks

Because of file buffering, this function may return successful even if there is not enough space left on the output device for the write operation. The file must be opened using a write-capable function (i.e. not with ReadFile()).

To place a BOM (byte order mark) to later identify the string encoding format of a file use the WriteStringFormat() function. To write a string without a newline sequence, use the WriteString() function.

For an example see the CreateFile() function.

See Also

ReadString(), WriteString(), WriteStringFormat(), CreateFile(), OpenFile()

Supported OS

All

<- WriteStringFormat() - File Index - WriteUnicodeCharacter() ->