SendNetworkString

SendNetworkString()

Синтаксис

Result = SendNetworkString(Connection , String$ [, Format])

Описание

Отправьте строку указанному клиенту. Эта функция может использоваться как клиентскими, так и серверными приложениями.

Параметры

Connection Идентификатор сетевого соединения, через которое должны быть отправлены данные. На стороне сервера параметр 'Connection' содержит идентификатор соединения клиента, который должен получать эти данные. На стороне клиента параметр 'Connection' содержит значение, возвращаемое функцией OpenNetworkConnection().

String$ Строка для отправки.
Format (дополн.)
Строковый Формат, используемый при отправке строки. Этот параметр может быть одним из следующих значений:
  #PB_Ascii  : Отправляет строки как ASCII.
  #PB_UTF8   : Отправляет строки как UTF8 (По умолчанию).
  #PB_Unicode: Отправляет строки как unicode.

Возвращаемое значение

Возвращает количество отправленных байтов.

Комментарии

Нет такой функции как ReceiveNetworkString(), функция SendNetworkString() лишь даёт средство быстрой отправки строк. Строка будет отправлена без завершающего символа NULL, и может быть принята с помощью функции ReceiveNetworkData(), после того как функция NetworkServerEvent() / NetworkClientEvent() возвратит значение #PB_NetworkEvent_Data). В режиме unicode, строка отправляется в кодировке UTF-8, не зависящей от процессора (в отличие от кодировки UTF-16, привязанной к порядку байтов в слове на данном процессоре).

См. также

SendNetworkData(), ReceiveNetworkData()

Поддерживаемые OS

Все

<- SendNetworkData() - Оглавление Network - ServerID()->

Connection	Идентификатор сетевого соединения, через которое должны быть отправлены данные. На стороне сервера параметр 'Connection' содержит идентификатор соединения клиента, который должен получать эти данные. На стороне клиента параметр 'Connection' содержит значение, возвращаемое функцией OpenNetworkConnection().
String$	Строка для отправки.
Format (дополн.)	Строковый Формат, используемый при отправке строки. Этот параметр может быть одним из следующих значений: #PB_Ascii : Отправляет строки как ASCII. #PB_UTF8 : Отправляет строки как UTF8 (По умолчанию). #PB_Unicode: Отправляет строки как unicode.