fLoadText (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing external files

fLoadText

Presentation

Example

Viewing the content of a file in UNICODE format

See also

fLoadText (Function)

In french: fChargeTexte

Loads the content of a text file into any text control or text variable (string variable, edit control in a window, Static control in a report, etc.). fSaveBuffer is used to extract this file from the buffer.

The first bytes of the file are automatically analyzed: if the file is in Ansi or UTF8 format, it is automatically converted into Unicode.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 16 and later

This function is now available for Windows Phone applications.

New in version 16

This function is now available for Windows Phone applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Load the content of "C:\Temp\MyFile.txt" into
// the "EDT_Edit1" edit control
EDT_Edit1 = fLoadText("C:\Temp\MyFile.txt")

// Load the content of "\Temp\MyFile.txt" into
// the "EDT_Edit1" edit control
EDT_Edit1 = fLoadText("\Temp\MyFile.txt")

Syntax

<Result> = fLoadText(<Name and path of text file> [, <Load mode>])

<Result>: Character string

Content of text file,
Empty string ("") if an error occurred. To find out the error details, use ErrorInfo.

<Name and path of text file>: Character string (with quotes)

Name and full (or relative) path of the text file. A UNC path can be used. This file is not necessarily a file in TXT format: indeed, the binary zeros are allowed.
Versions 15 and later
This parameter can be in Ansi or Unicode format.
New in version 15
This parameter can be in Ansi or Unicode format.
This parameter can be in Ansi or Unicode format.
This path must be a full path or a UNC path. It cannot be a relative path.
Versions 16 and later
In Windows Phone, only the files found in the directory of the application can be handled.
New in version 16
In Windows Phone, only the files found in the directory of the application can be handled.
In Windows Phone, only the files found in the directory of the application can be handled.
Versions 17 and later
The path of this file can correspond to a full path or to a relative path in relation to the current directory (returned by fCurrentDir). This parameter is case sensitive.
New in version 17
The path of this file can correspond to a full path or to a relative path in relation to the current directory (returned by fCurrentDir). This parameter is case sensitive.
The path of this file can correspond to a full path or to a relative path in relation to the current directory (returned by fCurrentDir). This parameter is case sensitive.

<Load mode>: Integer constant

Versions 17 and later
Load mode of the file:
foAnsi Ansi file. In this case, <Result> will correspond to an Ansi character string.
foUnicode Unicode file. In this case, <Result> will correspond to an Unicode character string.
This parameter is not supported. The returned format corresponds to the format supported by the current platform.
New in version 17
Load mode of the file:
foAnsi Ansi file. In this case, <Result> will correspond to an Ansi character string.
foUnicode Unicode file. In this case, <Result> will correspond to an Unicode character string.
This parameter is not supported. The returned format corresponds to the format supported by the current platform.
Load mode of the file:
foAnsi Ansi file. In this case, <Result> will correspond to an Ansi character string.
foUnicode Unicode file. In this case, <Result> will correspond to an Unicode character string.
This parameter is not supported. The returned format corresponds to the format supported by the current platform.

Remarks

Viewing the content of a file in UNICODE format

To view the content of a file in UNICODE format, you must perform the following process:

// Load the content of "C:\MyFiles\MyFile.XML" into MyString
MyBuffer is Buffer
MyBuffer = fLoadText("C:\MyFiles\MyFile.XML")
MyString is UNICODE string
MyString = MyBuffer
Info(MyString)

Component : wd240std.dll