System.IOUtils.TFile.ReadAllText

• Aller au parent : TFile

Delphi

class function ReadAllText(const Path: string): string; overload; inline; static;
class function ReadAllText(const Path: string;
const Encoding: TEncoding): string; overload; inline; static;

C++

static System::UnicodeString __fastcall ReadAllText(const System::UnicodeString Path)/* overload */;
static System::UnicodeString __fastcall ReadAllText(const System::UnicodeString Path, System::Sysutils::TEncoding* const Encoding)/* overload */;

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	System.IOUtils.pas System.IOUtils.hpp	System.IOUtils	TFile

Description

Renvoie le contenu d'un fichier texte sous la forme d'une chaîne.

ReadAllText lit le contenu d'un fichier texte et renvoie une chaîne contenant le texte lu dans le fichier.

ReadAllText, avec un paramètre, lit d'abord les octets du préambule en commençant par le début du fichier texte Path. Ensuite, ReadAllText ignore les octets du préambule et consulte le contenu du fichier texte à partir de ce décalage. ReadAllText renvoie une chaîne contenant le texte lu à partir du fichier.
Si le fichier Path ne contient pas de BOM pour l'un des codages standard, le codage standard Default est accepté et le nombre d'octets correspondant est ignoré.

ReadAllText, avec deux paramètres, lit d'abord le fichier texte Path à partir du début et ignore le nombre d'octets correspondant au préambule du paramètre Encoding spécifié. Ensuite, ReadAllText lit le contenu du fichier texte à partir de ce décalage et renvoie une chaîne contenant le texte lu dans le fichier.

ReadAllText comporte les paramètres suivants :

• Path est le chemin d'accès au fichier.
• Encoding est le codage du texte contenu dans le fichier Path.

Remarques:

• Un préambule est une séquence d'octets qui spécifie le codage utilisé. On l'appelle BOM (Byte Order Mark).
• ReadAllText déclenche une exception si le fichier ne peut pas être ouvert ou si le chemin n'est pas valide.
• Si le codage spécifié diffère du codage réel du fichier, la valeur renvoyée n'est pas définie. Dans certains cas, une exception EEncondingError est déclenchée. Par exemple, l'ouverture d'un fichier ANSI avec des caractères accentués comme UTF8 renvoie une chaîne aléatoire avec des caractères altérés ou génère une exception EEncondingError.

Voir aussi

• System.SysUtils.TEncoding.GetBufferEncoding
• System.IOUtils.TFile.ReadAllBytes
• System.IOUtils.TFile.ReadAllLines

• Encoding.GetPreamble (MSDN)

Exemples de code

• ReadWriteFile (Delphi)
• ReadWriteFile (C++)