System.Net.Socket.TSocket.Send

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

Delphi

function Send(const Buf; Count: Integer; Flags: Integer): Integer; overload;
function Send(const Buf; Count: Integer; Flags: TSocketFlags = []): Integer; overload; inline;
function Send(const S: string; Flags: TSocketFlags = []): Integer; overload;
function Send(const B: TBytes; Offset: Integer = 0; Count: Integer = -1; Flags: TSocketFlags = []): Integer; overload;
function Send(const B: array of Byte; Offset: Integer = 0; Count: Integer = -1; Flags: TSocketFlags = []): Integer; overload;

C++

int __fastcall Send(const void *Buf, int Count, int Flags)/* overload */;
int __fastcall Send(const void *Buf, int Count, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::UnicodeString S, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::DynamicArray<System::Byte> B, int Offset = 0x0, int Count = 0xffffffff, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::Byte *B, const int B_High, int Offset = 0x0, int Count = 0xffffffff, TSocketFlags Flags = TSocketFlags() )/* overload */;

プロパティ

種類 可視性 ソース ユニット
function public
System.Net.Socket.pas
System.Net.Socket.hpp
System.Net.Socket TSocket


説明

指定されたデータを接続されたエンドポイントに送信します。

Send には、次のパラメータを渡すことができます。

  • Buf: 送信するデータを含むバッファのポインタです。
  • Offset: 送信するデータの先頭から読み飛ばすバイト数です。
  • CountBuf が指しているバッファの長さ(バイト単位)です。これは送信するデータの最大長でもあります。
  • FlagsSend の動作を左右するフラグの集合です。詳細については、MSDN で send 関数のドキュメントを参照してください。

バッファのポインタ(Buf)を渡す代わりに、文字列S)またはバイト配列B)を渡すこともできます。

指定したデータの送信が成功すると、Send は送信されたバイト数を返します。ソケットが接続されていなければ、Send は -1 を返します。

例外

Send への呼び出しは、次の例外のいずれかを発生させます:

Exception Exception.Message シナリオ

ESocketError

Network socket error: <error message> (<error code>), on API 'send'

Socket type not compatible with call

関連項目