System.Net.Socket.TSocket.Send
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
: 送信するデータの先頭から読み飛ばすバイト数です。Count
:Buf
が指しているバッファの長さ(バイト単位)です。これは送信するデータの最大長でもあります。Flags
: Send の動作を左右するフラグの集合です。詳細については、MSDN で send 関数のドキュメントを参照してください。
バッファのポインタ(Buf
)を渡す代わりに、文字列(S
)またはバイト配列(B
)を渡すこともできます。
指定したデータの送信が成功すると、Send は送信されたバイト数を返します。ソケットが接続されていなければ、Send は -1 を返します。
例外
Send への呼び出しは、次の例外のいずれかを発生させます:
Exception | Exception.Message | シナリオ |
---|---|---|
Network socket error: <error message> (<error code>), on API 'send' |
| |
Socket type not compatible with call |
関連項目
- send 関数(MSDN)