50.4. Типы данных в сообщениях
В этом разделе описываются базовые типы данных, применяемые в сообщениях.
- Int
n(i) Целое число из
nбит с сетевым порядком байт (наиболее значащий байт первый). Если указаноi, это поле будет содержать именно указанное значение, в противном случае значение переменное. Например: Int16, Int32(42).- Int
n[k] Массив из
kn-битовых целых, каждое записывается с сетевым порядком байт. Длина массиваkвсегда определяется по предыдущему полю сообщения, например Int16[M].- String(
s) Строка, оканчивающаяся нулём (строка в стиле C). На длину строк ограничение не накладывается. Если указывается
s, это поле будет содержать именно указанное значение, в противном случае значение переменное. Например: String, String("user").Примечание
Нет никакого предопределённого ограничения длины строки, которую может возвратить сервер. Поэтому при реализации клиента лучше использовать расширяемый буфер, чтобы он мог принять строку любого размера, умещающуюся в памяти. Если такой возможности нет, прочитайте строку целиком и отбросьте последние символы, не помещающиеся в ваш буфер фиксированного размера.
- Byte
n(c) В точности
nбайт. Если размер поляnзадаётся не константой, он всегда определяется по предыдущему полю сообщения. Если указываетсяc, оно задаёт точное значение. Например: Byte2, Byte1('\n').
50.4. Message Data Types
This section describes the base data types used in messages.
- Int
n(i) An
n-bit integer in network byte order (most significant byte first). Ifiis specified it is the exact value that will appear, otherwise the value is variable. Eg. Int16, Int32(42).- Int
n[k] An array of
kn-bit integers, each in network byte order. The array lengthkis always determined by an earlier field in the message. Eg. Int16[M].- String(
s) A null-terminated string (C-style string). There is no specific length limitation on strings. If
sis specified it is the exact value that will appear, otherwise the value is variable. Eg. String, String("user").Note
There is no predefined limit on the length of a string that can be returned by the backend. Good coding strategy for a frontend is to use an expandable buffer so that anything that fits in memory can be accepted. If that's not feasible, read the full string and discard trailing characters that don't fit into your fixed-size buffer.
- Byte
n(c) Exactly
nbytes. If the field widthnis not a constant, it is always determinable from an earlier field in the message. Ifcis specified it is the exact value. Eg. Byte2, Byte1('\n').
