Data.SqlExpr.TSQLBlobStream.Read

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function Read(Buffer: TBytes; Offset, Count: Longint): Longint; overload; override;
function Read(var Buffer; Count: Longint): Longint; overload; override; deprecated 'Use overloaded method instead';

C++

virtual int __fastcall Read(System::DynamicArray<System::Byte> Buffer, int Offset, int Count)/* overload */;
virtual int __fastcall Read _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (void *Buffer, int Count)/* overload */;
inline int __fastcall  Read(System::DynamicArray<System::Byte> &Buffer, int Count){ return System::Classes::TStream::Read(Buffer, Count); }

プロパティ

種類 可視性 ソース ユニット
function public
Data.SqlExpr.pas
Data.SqlExpr.hpp
Data.SqlExpr TSQLBlobStream

説明

Read は,メモリストリームから Count で指定するバイト数を Buffer に読み出し,ストリームの現在位置を読み出したバイト数だけ進めます。

Data.SqlExpr.TSQLBlobStream.Read は System.Classes.TCustomMemoryStream.Read を継承しています。以下の内容はすべて System.Classes.TCustomMemoryStream.Read を参照しています。

Read は,メモリストリームから Count で指定するバイト数を Buffer に読み出し,ストリームの現在位置を読み出したバイト数だけ進めます。

Read メソッドを呼び出すと,メモリストリームの内容のバッファへの読み出しを,現在の位置から開始することができます。Read メソッドは Memory 内の現在位置から Count で指定するバイト数を読み出します。Count で指定するバイト数がメモリバッファの最後を超えている場合は,Read メソッドは関連付けられたメモリバッファの最後までのデータを転送するだけです。Read メソッドは実際に Buffer に転送したバイト数を返し,その分だけ現在位置を進めます。戻り値が Count 値より少ない場合,ストリームデータの最後まで読み出したことを意味しています。

メモリストリームのデータを読み出すほかのメソッド(ReadBufferReadComponent)は,実際に読み出しを行うために Read メソッドを呼び出します。

メモ:  ReadCount で指定する値を上限とみなします。これとは対照的に,Count で指定されたバイト数が読み出せない場合,ReadBuffer メソッドは例外を生成します。

関連項目