- Managing errors
- Operating mode in Windows Vista (and later)
- Position in the file
- Managing the ANSI/UNICODE format
fWriteLine (Function) In french: fEcritLigne Syntax
Writing a line into an external file Hide the details
<Result> = fWriteLine(<File identifier> , <Line to write>)
<Result>: Boolean - True if the write operation was performed into the specified file,
- False if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.
<File identifier>: Integer Identifier of the file to use, defined by fOpen or fCreate. <Line to write>: Character string (with quotes) Line that must be written into the file (up to 2GB). Remarks fWriteLine generates an error in the following cases: - the file is not opened,
- the file is not accessible in write mode,
- the file is locked by another computer or by another application,
- no disk space is available.
Caution: fWriteLine can only be used on text files. This function does not support the binary 0 (the write operation is stopped). When opening a file, the current position corresponds to: - the first byte of the file (by default),
- the last byte of the file is the file is opened in "addition" mode (foAdd constant).
This position can be modified by fSeek. fWriteLine writes the specified elements from the current position. Once fWriteLine has been run, the current position corresponds to the last byte written. Managing the ANSI/UNICODE format fWriteLine is used to write: - a Unicode string into a Unicode file.
- an Ansi string into an Ansi file.
The file was created or opened by fCreate/ fOpen while specifying the file type. Remarks: - The size to write into Unicode file a must be multiplied by two compared to an ANSI file.
- If a character string in ANSI format is written into a UNICODE file (and conversely), the conversion will be implicitly performed.
| | | | | Format of the string passed in parameter | External file in ANSI format (fOpen or fCreate associated with the foAnsi constant) | External file in UNICODE format (fOpen or fCreate associated with the foUnicode constant) | fWriteLine | ANSI | No conversion is required before the write operation | Automatic conversion of the string before the write operation | UNICODE | Automatic conversion of the string before the write operation | No conversion is required before the write operation |
In the WINDEV and WEBDEV projects, in version 16 and in version 17 ("Use the ANSI strings at run time" option in the description of the project configuration), the opening mode used by default is foAnsi (1st column). In the WINDEV and WEBDEV projects, in version 17 and in Unicode mode ("Use the UNICODE strings at run time" option in the description of the project configuration), the opening mode used by default is foUnicode (second column). In the WINDEV Mobile projects, regardless of the version and mode, the opening mode used by default is foUnicode (second column).
Related Examples:
|
Unit examples (WINDEV): Handling text files
[ + ] Handling "text" files with WINDEV: - Create a text file - Write into a text file - Read in a text file
|
|
Unit examples (WEBDEV): Handling text files
[ + ] This example explains how to handle "non HFSQL" files with WEBDEV and it allows you to: - Create a text file - Write into a text file - Read in a text file
|
|
Unit examples (WINDEV Mobile): Handling text files
[ + ] Handling external "text" files: - Create a text file - Write into a text file - Read in a text file
|
|
Unit examples (WINDEV): The TableTo functions
[ + ] Exporting table data with the WLanguage functions. The following topics are presented in this example: 1/ interfacing with Word and Excel 2/ sending data to the clipboard 3/ generating a text file This example explains how to export the content of a table to a Word document, an Excel workbook, the clipboard or a text file via the following WLanguage functions: TableToWord, TableToExcel, ToClipboard, TableToText.
|
This page is also available for…
|
|
|