System.IOUtils.TFile.ReadAllLines

• Übergeordnet: TFile

Delphi

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

C++

static System::DynamicArray<System::UnicodeString> __fastcall ReadAllLines(const System::UnicodeString Path)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall ReadAllLines(const System::UnicodeString Path, System::Sysutils::TEncoding* const Encoding)/* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.IOUtils.pas System.IOUtils.hpp	System.IOUtils	TFile

Beschreibung

Gibt den Inhalt einer Textdatei als String-Array zurück.

ReadAllLines liest den Inhalt einer Textdatei und gibt ein String-Array mit den abgerufenen Textzeilen zurück.

ReadAllLines mit einem Parameter liest zuerst die Präambel-Bytes vom Beginn der Path-Textdatei. Dann überspringt ReadAllLines die Präambel-Bytes und liest den Inhalt der Textdatei an diesem Offset. ReadAllLines gibt ein String-Array mit den aus der Datei abgerufenen Textzeilen zurück.
Wenn die Path-Datei kein BOM (Byte Order Mark) für eine der Standardcodierungen enthält, wird die Standardcodierung Default akzeptiert und die entsprechende Anzahl Bytes wird übersprungen.

ReadAllLines mit zwei Parametern liest zuerst ab dem Beginn der Path-Textdatei und überspringt die Anzahl Bytes, die der Präambel der angegebenen Encoding entspricht. Dann liest ReadAllText den Inhalt der Textdatei ab diesem Offset und gibt ein String-Array mit den aus der Datei abgerufenen Textzeilen zurück.

ReadAllLines hat die folgenden Parameter:

• Path ist der Pfad zu der Datei.
• Encoding ist die Codierung des Texts in der Path-Datei.

Hinweis: Eine Präambel ist eine Sequenz von Bytes, die die verwendete Codierung angibt. Sie wird als Byte Order Mark (BOM) bezeichnet.

Hinweis: ReadAllLines löst eine Exception aus, wenn die Datei nicht geöffnet werden kann oder der Pfad ungültig ist.

Hinweis: ReadAllLines kann eine EEncodingError-Exception auslösen, wenn die falsche Codierung angegeben wird. Zum Beispiel führt das Öffnen einer Datei, die als ANSI codierte erweiterte ASCII-Zeichen enthält, aber für die UTF8 als Codierung angegeben ist, wahrscheinlich zu einer EEcondingError-Exception.

Siehe auch

• System.Types.TStringDynArray
• System.IOUtils.TFile.ReadAllBytes
• System.IOUtils.TFile.ReadAllText
• Byte Order Mark (BOM)