System.IOUtils.TFile.ReadAllLines

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

class function ReadAllLines(const Path: string): TStringDynArray;
class function ReadAllLines(const Path: string;
const Encoding: TEncoding): TStringDynArray; overload; static;

C++

static System::TStringDynArray __fastcall ReadAllLines(const System::UnicodeString Path)/* overload */;
static System::TStringDynArray __fastcall ReadAllLines(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'un tableau de chaînes.

ReadAllLines lit le contenu d'un fichier texte et renvoie une chaîne tableau de chaînes contenant les lignes de texte récupérées.

ReadAllLines, avec un paramètre, lit d'abord les octets du préambule en commençant par le début du fichier texte Path. Puis : ReadAllLines ignore les octets du préambule et lit le contenu du fichier texte à partir de ce décalage. ReadAllLines renvoie un nouveau tableau de chaînes contenant les lignes de texte 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é.

ReadAllLines, 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 un tableau de chaînes contenant le texte lu dans le fichier.

ReadAllLines 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.
Remarque: Un préambule est une séquence d'octets qui spécifie le codage utilisé. On l'appelle BOM (Byte Order Mark).
Remarque: ReadAllLines déclenche une exception si le fichier ne peut pas être ouvert ou si le chemin n'est pas valide.
Remarque: ReadAllLines peut déclencher une exception EEncodingError si l'encodage spécifié est incorrect. Par exemple, si vous ouvrez un fichier qui contient des caractères ASCII étendus codés en ANSI mais que vous spécifiez UTF8 comme encodage, vous risquez d'obtenir une exception EEcondingError.

Voir aussi