System.Classes.TStrings.SaveToStream
Delphi
procedure SaveToStream(Stream: TStream); overload; virtual;
procedure SaveToStream(Stream: TStream; Encoding: TEncoding); overload; virtual;
C++
virtual void __fastcall SaveToStream(TStream* Stream)/* overload */;
virtual void __fastcall SaveToStream(TStream* Stream, System::Sysutils::TEncoding* Encoding)/* overload */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
public | System.Classes.pas System.Classes.hpp |
System.Classes | TStrings |
説明
Text プロパティの値を、Stream
ストリームに書き込みます。
SaveToStream は、すべての文字列を、現在の TStrings オブジェクトから取得し、それらを LineBreak シーケンスによって区切られた文字列を格納する 1 つの文字列にまとめます。その後、SaveToStream は、この文字列を指定された Encoding
を使用してエンコードします。そして、SaveToStream はそのエンコードされた文字列を、指定された Stream
ストリームに書き込みます。
WriteBOM が True
の場合、SaveToStream はまず指定された Encoding
または DefaultEncoding(Encoding
= nil
の場合)のプリアンブル部を取得し、メインの文字列の前に、ストリームへプリアンブル部のバイトを、ストリームに書き込みます。
Encoding
パラメータが指定されなかった場合、文字列は Encoding プロパティで指定されたエンコーディングで保存されます。
メモ: Windows では、LineBreak のデフォルト値は、復帰と改行の組み合わせ(#13#10)のところ、macOS では、改行(#10)のみです。
ストリームがファイル ストリームだった場合、SaveToStream は SaveToFile と同じことを行います(ただし、SaveToFile はファイル ストリームを破壊する点を除く)。
関連項目
- System.Classes.TStrings.LoadFromStream
- System.Classes.TStrings.SaveToFile
- System.Classes.TStrings.Encoding
- System.Classes.TStrings.Strings
- System.Classes.TStrings.Text
- System.Classes.TStrings.LineBreak
- System.Classes.TStrings.TrailingLineBreak
- System.Classes.TStrings.WriteBOM
- System.SysUtils.TEncoding.GetPreamble