System.IOUtils.TFile.ReadAllLines
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 */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | System.IOUtils.pas System.IOUtils.hpp |
System.IOUtils | TFile |
説明
テキスト ファイルの内容を文字列の配列として返します。
ReadAllLines は、テキスト ファイルの内容を読み込み、抽出したテキスト行を格納した文字列の配列を返します。
1 のパラメータを持つ ReadAllLines は、まず Path
テキスト ファイルの最初からプリアンブル バイトを読み込みます。 そして、
ReadAllLines は、プリアンブル バイトをスキップし、このオフセットから始まるテキスト ファイルのコンテンツを読み込みます。
ReadAllLines は、ファイルから抽出したテキスト行を格納する文字列の配列を返します。
Path
ファイルが、標準エンコーディングのいずれかのバイト順マークを含んでいない場合、Default 標準エンコーディングが選択され、それに相当する数のバイトがスキップされます。
2 つのパラメータを持つ ReadAllLines は、まず Path
テキスト ファイルの最初から読み込み、指定された Encoding
のプリアンブルに相当するバイト数がスキップされます。 そして、ReadAllText は、このオフセットから始まるテキスト ファイルの内容を読み込み、ファイルから抽出したテキスト行を格納した文字列の配列を返します。
ReadAllLines には、次のパラメータがあります:
Path
は、ファイルへのパスです。Encoding
は、Path
ファイル内に格納されているテキストのエンコーディングです。
メモ: プリアンブル部は、使用されるエンコーディングを指定するバイトのシーケンスです。 これは、バイト順マーク(BOM)と呼ばれます。
メモ: ReadAllLines は、ファイルを開くことができない、またはパスが不正である場合に例外を発生させます。
メモ: 誤ったエンコーディングを指定すると、ReadAllLines は、EEncodingError 例外を送出する可能性があります。
たとえば、ANSI でエンコードされているにもかかわらず、エンコーディングに UTF8 を指定している、拡張 ASCII 文字を含むファイルを開くと、大抵の場合 EEcondingError 例外となります。