Spec-Zone.ru › OCaml 4.14

Модуль BytesLabels

module BytesLabels: sig .. end

Операции со последовательностями байтов.

Последовательность байтов — это изменяемая структура данных, содержащая последовательность байтов фиксированной длины. Каждый байт может быть индексирован за постоянное время для чтения или записи.

Учитывая последовательность байтов s длины l, мы можем получить доступ к каждому из l байтов s по его индексу в последовательности. Индексы начинаются с 0, и мы будем называть индекс допустимым в s, если он попадает в диапазон [0...l-1] (включительно). Позиция — это точка между двумя байтами или в начале или конце последовательности. Мы будем называть позицию допустимой в s, если она попадает в диапазон [0...l] (включительно). Обратите внимание, что байт с индексом n находится между позициями n и n+1.

Две переменные start и len считаются обозначающими допустимый диапазон s, если len >= 0 и start и start+len являются допустимыми позициями в s.

Последовательности байтов могут быть изменены на месте, например, с помощью функций set и blit, описанных ниже. См. также строки (модуль String), которые являются почти такой же структурой данных, но не могут быть изменены на месте.

Байты представлены типом OCaml char.

Отмеченная версия этого модуля может использоваться, как описано в модуле StdLabels.

  • Since 4.02.0
val length : bytes -> int

Возвращает длину (количество байтов) аргумента.

val get : bytes -> int -> char

get s n возвращает байт с индексом n в аргументе s.

  • Raises Invalid_argument если n не является допустимым индексом в s.
val set : bytes -> int -> char -> unit

set s n c изменяет s на месте, заменяя байт с индексом n на c.

  • Raises Invalid_argument если n не является допустимым индексом в s.
val create : int -> bytes

create n возвращает новую последовательность байтов длины n. Последовательность неинициализирована и содержит произвольные байты.

  • Raises Invalid_argument если n < 0 или n > Sys.max_string_length.
val make : int -> char -> bytes

make n c возвращает новую последовательность байтов длины n, заполненную байтом c.

  • Raises Invalid_argument если n < 0 или n > Sys.max_string_length.
val init : int -> f:(int -> char) -> bytes

init n f возвращает новую последовательность байтов длины n, в которой символ i инициализирован результатом f i (в порядке возрастания индекса).

  • Raises Invalid_argument если n < 0 или n > Sys.max_string_length.
val empty : bytes

Последовательность байтов размером 0.

val copy : bytes -> bytes

Возвращает новую последовательность байтов, содержащую те же байты, что и аргумент.

val of_string : string -> bytes

Возвращает новую последовательность байтов, содержащую те же байты, что и заданная строка.

val to_string : bytes -> string

Возвращает новую строку, содержащую те же байты, что и заданная последовательность байтов.

val sub : bytes -> pos:int -> len:int -> bytes

sub s ~pos ~len возвращает новую последовательность байтов длины len, содержащую подпоследовательность s, которая начинается в позиции pos и имеет длину len.

  • Raises Invalid_argument если pos и len не обозначают допустимого диапазона s.
val sub_string : bytes -> pos:int -> len:int -> string

То же, что и BytesLabels.sub, но возвращает строку вместо последовательности байтов.

val extend : bytes -> left:int -> right:int -> bytes

extend s ~left ~right возвращает новую последовательность байтов, которая содержит байты s, с left неинициализированными байтами, добавленными в начало, и right неинициализированными байтами, добавленными в конец. Если left или right отрицательны, то байты удаляются (вместо добавления) с соответствующей стороны s.

  • Since 4.05.0 in BytesLabels
  • Raises Invalid_argument если длина результата отрицательна или длиннее, чем Sys.max_string_length байтов.
val fill : bytes -> pos:int -> len:int -> char -> unit

fill s ~pos ~len c изменяет s на месте, заменяя len символы на c, начиная с pos.

  • Raises Invalid_argument если pos и len не обозначают допустимого диапазона s.
val blit : src:bytes -> src_pos:int -> dst:bytes -> dst_pos:int -> len:int -> unit

blit ~src ~src_pos ~dst ~dst_pos ~len копирует len байта из последовательности src, начиная с индекса src_pos, в последовательность dst, начиная с индекса dst_pos . Это работает правильно даже если src и dst — это одна и та же последовательность байтов, и исходные и целевые интервалы перекрываются.

  • Raises Invalid_argument если src_pos и len не обозначают допустимого диапазона src, или если dst_pos и len не обозначают допустимого диапазона dst.
val blit_string : src:string -> src_pos:int -> dst:bytes -> dst_pos:int -> len:int -> unit

blit ~src ~src_pos ~dst ~dst_pos ~len копирует len байтов из строки src, начиная с индекса src_pos, в последовательность байтов dst, начиная с индекса dst_pos.

  • Since 4.05.0 in BytesLabels
  • Raises Invalid_argument если src_pos и len не обозначают допустимого диапазона src, или если dst_pos и len не обозначают допустимого диапазона dst.
val concat : sep:bytes -> bytes list -> bytes

concat ~sep sl конкатенирует список последовательностей байтов sl, вставляя разделительную последовательность байтов sep между каждой, и возвращает результат в виде новой последовательности байтов.

  • Raises Invalid_argument если результат длиннее, чем Sys.max_string_length байтов.
val cat : bytes -> bytes -> bytes

cat s1 s2 конкатенирует s1 и s2 и возвращает результат в виде новой последовательности байтов.

  • Since 4.05.0 in BytesLabels
  • Raises Invalid_argument если результат длиннее, чем Sys.max_string_length байтов.
val iter : f:(char -> unit) -> bytes -> unit

iter ~f s применяет функцию f по очереди ко всем байтам s. Это эквивалентно f (get s 0); f (get s 1); ...; f (get s
    (length s - 1)); ()
.

val iteri : f:(int -> char -> unit) -> bytes -> unit

То же, что и BytesLabels.iter, но функция применяется к индексу байта как первому аргументу, а сам байт — как второй аргумент.

val map : f:(char -> char) -> bytes -> bytes

map ~f s применяет функцию f по очереди ко всем байтам s (в порядке возрастания индекса) и сохраняет полученные байты в новой последовательности, которая возвращается в качестве результата.

val mapi : f:(int -> char -> char) -> bytes -> bytes

mapi ~f s вызывает f с каждым символом s и его индексом (в порядке возрастания индекса) и сохраняет полученные байты в новой последовательности, которая возвращается в качестве результата.

val fold_left : f:('a -> char -> 'a) -> init:'a -> bytes -> 'a

fold_left f x s вычисляет f (... (f (f x (get s 0)) (get s 1)) ...) (get s (n-1)), где n — длина s.

  • Since 4.13.0
val fold_right : f:(char -> 'a -> 'a) -> bytes -> init:'a -> 'a

fold_right f s x вычисляет f (get s 0) (f (get s 1) ( ... (f (get s (n-1)) x) ...)), где n — длина s.

  • Since 4.13.0
val for_all : f:(char -> bool) -> bytes -> bool

for_all p s проверяет, удовлетворяют ли все символы в s предикату p.

  • Since 4.13.0
val exists : f:(char -> bool) -> bytes -> bool

exists p s проверяет, удовлетворяет ли хотя бы один символ в s предикату p.

  • Since 4.13.0
val trim : bytes -> bytes

Возвращает копию аргумента без начальных и конечных пробелов. Байты, считающиеся пробелами, — это ASCII-символы ' ', '\012', '\n', '\r', и '\t'.

val escaped : bytes -> bytes

Возвращает копию аргумента, в котором специальные символы представлены последовательностями экранирования в соответствии с лексическими соглашениями OCaml. Все символы за пределами печатаемого ASCII-диапазона (32..126), а также обратный слэш и двойная кавычка экранируются.

  • Возбуждает исключение Invalid_argument если результат длиннее, чем Sys.max_string_length байтов.
val index : bytes -> char -> int

index s c возвращает индекс первого вхождения байта c в s.

  • Возбуждает исключение Not_found если c не встречается в s.
val index_opt : bytes -> char -> int option

index_opt s c возвращает индекс первого вхождения байта c в s или None если c не встречается в s.

  • С момента 4.05
val rindex : bytes -> char -> int

rindex s c возвращает индекс последнего вхождения байта c в s.

  • Возбуждает исключение Not_found если c не встречается в s.
val rindex_opt : bytes -> char -> int option

rindex_opt s c возвращает индекс последнего вхождения байта c в s или None если c не встречается в s.

  • С момента 4.05
val index_from : bytes -> int -> char -> int

index_from s i c возвращает индекс первого вхождения байта c в s после позиции i. index s c эквивалентно index_from s 0 c.

  • Возбуждает исключение
    • Invalid_argument если i не является допустимой позицией в s.
    • Not_found если c не встречается в s после позиции i.
val index_from_opt : bytes -> int -> char -> int option

index_from_opt s i c возвращает индекс первого вхождения байта c в s после позиции i или None если c не встречается в s после позиции i. index_opt s c эквивалентно index_from_opt s 0 c.

  • С момента 4.05
  • Возбуждает исключение Invalid_argument если i не является допустимой позицией в s.
val rindex_from : bytes -> int -> char -> int

rindex_from s i c возвращает индекс последнего вхождения байта c в s перед позицией i+1. rindex s c эквивалентно rindex_from s (length s - 1) c.

  • Возбуждает исключение
    • Invalid_argument если i+1 не является допустимой позицией в s.
    • Not_found если c не встречается в s перед позицией i+1.
val rindex_from_opt : bytes -> int -> char -> int option

rindex_from_opt s i c возвращает индекс последнего вхождения байта c в s перед позицией i+1 или None если c не встречается в s перед позицией i+1. rindex_opt s c эквивалентно rindex_from s (length s - 1) c.

  • С момента 4.05
  • Возбуждает исключение Invalid_argument если i+1 не является допустимой позицией в s.
val contains : bytes -> char -> bool

contains s c проверяет, появляется ли байт c в s.

val contains_from : bytes -> int -> char -> bool

contains_from s start c проверяет, появляется ли байт c в s после позиции start. contains s c эквивалентно contains_from
    s 0 c
.

  • Возбуждает исключение Invalid_argument если start не является допустимой позицией в s.
val rcontains_from : bytes -> int -> char -> bool

rcontains_from s stop c проверяет, появляется ли байт c в s перед позицией stop+1.

  • Возбуждает исключение Invalid_argument если stop < 0 или stop+1 не является допустимой позицией в s.
val uppercase : bytes -> bytes
Устарело. Функции, работающие с набором символов Latin-1, устарели.

Возвращает копию аргумента, в которой все строчные буквы заменены прописными, включая и акцентированные буквы набора символов ISO Latin-1 (8859-1).

val lowercase : bytes -> bytes
Устарело. Функции, работающие с набором символов Latin-1, устарели.

Возвращает копию аргумента, в которой все прописные буквы заменены строчными, включая и акцентированные буквы набора символов ISO Latin-1 (8859-1).

val capitalize : bytes -> bytes
Устарело. Функции, работающие с набором символов Latin-1, устарели.

Возвращает копию аргумента, в которой первый символ заменён прописным, используя набор символов ISO Latin-1 (8859-1).

val uncapitalize : bytes -> bytes
Устарело. Функции, работающие с набором символов Latin-1, устарели.

Возвращает копию аргумента, в которой первый символ заменён строчным, используя набор символов ISO Latin-1 (8859-1).

val uppercase_ascii : bytes -> bytes

Возвращает копию аргумента, в которой все строчные буквы заменены прописными, используя набор символов US-ASCII.

  • С момента 4.05.0
val lowercase_ascii : bytes -> bytes

Возвращает копию аргумента, в которой все прописные буквы заменены строчными, используя набор символов US-ASCII.

  • С момента 4.05.0
val capitalize_ascii : bytes -> bytes

Возвращает копию аргумента, в которой первый символ заменён прописным, используя набор символов US-ASCII.

  • С момента 4.05.0
val uncapitalize_ascii : bytes -> bytes

Возвращает копию аргумента, в которой первый символ заменён строчным, используя набор символов US-ASCII.

  • С момента 4.05.0
type t = bytes 

Псевдоним для типа последовательностей байтов.

val compare : t -> t -> int

Функция сравнения для последовательностей байтов с тем же спецификацией, что и compare. Вместе с типом t, эта функция compare позволяет модулю Bytes быть переданным в качестве аргумента для функторов Set.Make и Map.Make.

val equal : t -> t -> bool

Функция равенства для последовательностей байтов.

  • С момента 4.05.0
val starts_with : prefix:bytes -> bytes -> bool

starts_with ~prefix s является true тогда и только тогда, когда s начинается с prefix.

  • С момента 4.13.0
val ends_with : suffix:bytes -> bytes -> bool

ends_with suffix s является true тогда и только тогда, когда s заканчивается на suffix.

  • С момента 4.13.0

Небезопасные преобразования (для продвинутых пользователей)

В этом разделе описаны небезопасные, низкоуровневые функции преобразования между bytes и string. Они не копируют внутренние данные; при неправильном использовании они могут нарушить инвариант неизменяемости строк, предоставляемый вариантом -safe-string . Они доступны авторам экспертных библиотек, но для большинства целей вы должны использовать всегда корректные BytesLabels.to_string и BytesLabels.of_string вместо них.

val unsafe_to_string : bytes -> string

Небезопасно преобразует последовательность байтов в строку.

Для анализа использования unsafe_to_string, удобно рассмотреть дисциплину «владения». Часть кода, которая манипулирует данными, «владеет» ими; существует несколько различных режимов владения, включая:

  • Уникальное владение: данные могут быть обработаны и изменены.
  • Общее владение: данные имеют несколько владельцев, которые могут только обращаться к ним, но не изменять их.

Уникальное владение является линейным: передача данных другой части кода означает передачу владения (мы не можем перезаписать данные). Уникальный владелец может решить сделать данные общими (отказавшись от прав на изменение), но общие данные не могут стать уникально-владеемыми снова.

unsafe_to_string s может использоваться только тогда, когда вызывающая сторона владеет последовательностью байтов s — либо уникально, либо как общие неизменяемые данные. Вызывающая сторона отказывается от владения s, и получает владение возвращенной строкой.

Существует два допустимых варианта использования, которые соблюдают эту дисциплину владения:

1. Создание строки путем инициализации и изменения последовательности байтов, которая никогда не изменяется после инициализации.

let string_init len f : string =
  let s = Bytes.create len in
  for i = 0 to len - 1 do Bytes.set s i (f i) done;
  Bytes.unsafe_to_string s
   

Эта функция безопасна, потому что последовательность байтов s никогда не будет обработана или изменена после вызова unsafe_to_string. Код string_init отказывается от владения s, и возвращает владение полученной строкой своему вызывающему объекту.

Обратите внимание, что это было бы небезопасно, если бы s передавался в качестве дополнительного параметра функции f, поскольку он мог бы таким образом выйти за пределы области видимости и быть изменён в будущем — string_init отказался бы от владения s для передачи его в f, и не смог бы безопасно вызвать unsafe_to_string.

Мы предоставили функции String.init, String.map и String.mapi для покрытия большинства случаев построения новых строк. Вы должны отдавать предпочтение этим функциям перед to_string или unsafe_to_string всякий раз, когда это возможно.

2. Временное предоставление владения последовательностью байтов функции, которая ожидает уникально владения строкой и возвращает владение обратно, чтобы мы могли снова изменить последовательность после завершения вызова.

let bytes_length (s : bytes) =
  String.length (Bytes.unsafe_to_string s)
   

В этом случае мы не гарантируем, что s никогда не будет изменён после вызова функции bytes_length s. Функция String.length временно заимствует уникальное владение последовательностью байтов (и рассматривает её как string), но возвращает это владение обратно вызывающей стороне, которая может предположить, что s по-прежнему является допустимой последовательностью байтов после вызова. Обратите внимание, что это верно только потому, что мы знаем, что String.length не захватывает свой аргумент — он может выйти за пределы области видимости через побочный канал, например, комбиниратор запоминания.

Вызывающая сторона не может изменять s, пока строка заимствуется (она временно отказалась от владения). Это затрагивает конкурентные программы, а также функции высшего порядка: если String.length возвратила замыкание для вызова в будущем, s не должна изменяться до тех пор, пока это замыкание не будет полностью применено и не вернёт владение.

val unsafe_of_string : string -> bytes

Небезопасно преобразует общую строку в последовательность байтов, которую нельзя изменять.

Такая же дисциплина владения, которая делает unsafe_to_string корректной, применима и к unsafe_of_string: вы можете использовать её, если вы являетесь владельцем значения string, и вы будете владеть возвращаемым значением bytes в том же режиме.

На практике, уникальное владение строковыми значениями чрезвычайно сложно правильно анализировать. Вы всегда должны предполагать, что строки являются общими, а не уникально-владеемыми.

Например, строковые литералы неявно являются общими для компилятора, поэтому вы никогда не владеете ими уникально.

let incorrect = Bytes.unsafe_of_string "hello"
let s = Bytes.of_string "hello"
    

Первое объявление некорректно, так как строковый литерал "hello" может быть общим для компилятора с другими частями программы, и изменение incorrect — это ошибка. Вы всегда должны использовать второй вариант, который выполняет копирование и, следовательно, является правильным.

Предположение об уникальном владении строками, которые не являются строковыми литералами, но частично построены из строковых литералов, также неверно. Например, изменение unsafe_of_string ("foo" ^ s) может изменить общую строку "foo" — предполагая представление строк в виде верёвки. Более общо, функции, работающие со строками, предполагают общее владение, они не сохраняют уникальное владение. Таким образом, неверно предполагать уникальное владение результатом unsafe_of_string.

Единственный случай, в котором мы можем с достаточной уверенностью утверждать безопасность, — это если полученная bytes является общей — используется как неизменяемая последовательность байтов. Это, возможно, полезно для поэтапной миграции низкоуровневых программ, которые обрабатывают неизменяемые последовательности байтов (например, Marshal.from_bytes) и ранее использовали тип string для этой цели.

val split_on_char : sep:char -> bytes -> bytes list

split_on_char sep s возвращает список всех (возможно, пустых) подпоследовательностей s, которые ограничены символом sep.

Выход функции определяется следующими инвариантами:

  • Список не пуст.
  • Сцепление его элементов с разделителем sep возвращает последовательность байтов, равную вводу (Bytes.concat (Bytes.make 1 sep)
          (Bytes.split_on_char sep s) = s
    ).
  • Ни одна последовательность байтов в результате не содержит символ sep.
  • Since 4.13.0

Итераторы

val to_seq : t -> char Seq.t

Итерирование по строке в порядке возрастания индексов. Изменения в строке во время итерации будут отражены в последовательности.

  • Since 4.07
val to_seqi : t -> (int * char) Seq.t

Итерирование по строке в порядке возрастания, возвращая индексы вместе с символами.

  • Since 4.07
val of_seq : char Seq.t -> t

Создание строки из генератора.

  • Since 4.07

Кодировки и валидация UTF

UTF-8

val get_utf_8_uchar : t -> int -> Uchar.utf_decode

get_utf_8_uchar b i декодирует символ UTF-8 по индексу i в b.

val set_utf_8_uchar : t -> int -> Uchar.t -> int

set_utf_8_uchar b i u кодирует UTF-8 символ u по индексу i в b и возвращает количество записанных байтов n, начиная с i. Если n равно 0, не было достаточно места для кодирования символа u по индексу i, и b осталось без изменений. В противном случае новый символ может быть закодирован по индексу i + n.

val is_valid_utf_8 : t -> bool

is_valid_utf_8 b равно true, если и только если b содержит допустимые данные UTF-8.

UTF-16BE

val get_utf_16be_uchar : t -> int -> Uchar.utf_decode

get_utf_16be_uchar b i декодирует символ UTF-16BE по индексу i в b.

val set_utf_16be_uchar : t -> int -> Uchar.t -> int

set_utf_16be_uchar b i u кодирует UTF-16BE символ u по индексу i в b и возвращает количество записанных байтов n, начиная с i. Если n равно 0, не было достаточно места для кодирования символа u по индексу i, и b осталось без изменений. В противном случае новый символ может быть закодирован по индексу i + n.

val is_valid_utf_16be : t -> bool

is_valid_utf_16be b равно true, если и только если b содержит допустимые данные UTF-16BE.

UTF-16LE

val get_utf_16le_uchar : t -> int -> Uchar.utf_decode

get_utf_16le_uchar b i декодирует символ UTF-16LE по индексу i в b.

val set_utf_16le_uchar : t -> int -> Uchar.t -> int

set_utf_16le_uchar b i u кодирует UTF-16LE символ u по индексу i в b и возвращает количество записанных байтов n, начиная с i. Если n равно 0, не было достаточно места для кодирования символа u по индексу i, и b осталось без изменений. В противном случае новый символ может быть закодирован по индексу i + n.

val is_valid_utf_16le : t -> bool

is_valid_utf_16le b равно true, если и только если b содержит допустимые данные UTF-16LE.

Бинарное кодирование/декодирование целых чисел

Функции в этом разделе кодируют и декодируют целые числа в и из последовательностей байтов в двоичном формате.

Все следующие функции вызывают Invalid_argument, если необходимого места по индексу i для декодирования или кодирования целого числа недостаточно.

Маленький порядок байтов (соответственно, большой порядок байтов) означает, что наименее (соответственно, наиболее) значимые байты хранятся первыми. Большой порядок байтов также известен как сетевой порядок байтов. Порядок байтов по умолчанию — это либо малый, либо большой, в зависимости от Sys.big_endian.

32-битные и 64-битные целые числа представлены типами int32 и int64, которые могут интерпретироваться как знаковые или беззнаковые числа.

8-битные и 16-битные целые числа представлены типом int, который имеет больше битов, чем двоичное кодирование. Эти дополнительные биты обрабатываются следующим образом:

  • Функции, декодирующие знакомые (соответственно, беззнаковые) 8-битные или 16-битные целые числа, представленные значениями int, расширяют знак (соответственно, расширяют ноль) своего результата.
  • Функции, кодирующие 8-битные или 16-битные целые числа, представленные значениями int, обрезают свой вход до наименее значимых байтов.
val get_uint8 : bytes -> int -> int

get_uint8 b i — беззнаковое 8-битное целое число b, начинающееся с байтового индекса i.

  • Since 4.08
val get_int8 : bytes -> int -> int

get_int8 b i — это подписанное 8-битное целое число b, начинающееся с байтового индекса i.

  • Since 4.08
val get_uint16_ne : bytes -> int -> int

get_uint16_ne b i — это целое беззнаковое 16-битное число b с родным порядком байт, начинающееся с байтового индекса i.

  • Since 4.08
val get_uint16_be : bytes -> int -> int

get_uint16_be b i — это целое беззнаковое 16-битное число b с порядком байт big-endian, начинающееся с байтового индекса i.

  • Since 4.08
val get_uint16_le : bytes -> int -> int

get_uint16_le b i — это целое беззнаковое 16-битное число b с порядком байт little-endian, начинающееся с байтового индекса i.

  • Since 4.08
val get_int16_ne : bytes -> int -> int

get_int16_ne b i — это подписанное 16-битное целое число b с родным порядком байт, начинающееся с байтового индекса i.

  • Since 4.08
val get_int16_be : bytes -> int -> int

get_int16_be b i — это подписанное 16-битное целое число b с порядком байт big-endian, начинающееся с байтового индекса i.

  • Since 4.08
val get_int16_le : bytes -> int -> int

get_int16_le b i — это подписанное 16-битное целое число b с порядком байт little-endian, начинающееся с байтового индекса i.

  • Since 4.08
val get_int32_ne : bytes -> int -> int32

get_int32_ne b i — это 32-битное целое число b с родным порядком байт, начинающееся с байтового индекса i.

  • Since 4.08
val get_int32_be : bytes -> int -> int32

get_int32_be b i — это 32-битное целое число b с порядком байт big-endian, начинающееся с байтового индекса i.

  • Since 4.08
val get_int32_le : bytes -> int -> int32

get_int32_le b i — это 32-битное целое число b с порядком байт little-endian, начинающееся с байтового индекса i.

  • Since 4.08
val get_int64_ne : bytes -> int -> int64

get_int64_ne b i — это 64-битное целое число b с родным порядком байт, начинающееся с байтового индекса i.

  • Since 4.08
val get_int64_be : bytes -> int -> int64

get_int64_be b i — это 64-битное целое число b с порядком байт big-endian, начинающееся с байтового индекса i.

  • Since 4.08
val get_int64_le : bytes -> int -> int64

get_int64_le b i — это 64-битное целое число b с порядком байт little-endian, начинающееся с байтового индекса i.

  • Since 4.08
val set_uint8 : bytes -> int -> int -> unit

set_uint8 b i v устанавливает b's беззнаковое 8-битное целое число, начинающееся с байтового индекса i, на значение v.

  • Since 4.08
val set_int8 : bytes -> int -> int -> unit

Устанавливает знаковое 8-битное целое число b начиная с индекса байта i в v.

  • Since 4.08
val set_uint16_ne : bytes -> int -> int -> unit

Устанавливает собственно-порядковое 16-битное беззнаковое целое число b начиная с индекса байта i в v.

  • Since 4.08
val set_uint16_be : bytes -> int -> int -> unit

Устанавливает 16-битное беззнаковое целое число в порядке big-endian b начиная с индекса байта i в v.

  • Since 4.08
val set_uint16_le : bytes -> int -> int -> unit

Устанавливает 16-битное беззнаковое целое число в порядке little-endian b начиная с индекса байта i в v.

  • Since 4.08
val set_int16_ne : bytes -> int -> int -> unit

Устанавливает собственно-порядковое 16-битное знаковое целое число b начиная с индекса байта i в v.

  • Since 4.08
val set_int16_be : bytes -> int -> int -> unit

Устанавливает 16-битное знаковое целое число в порядке big-endian b начиная с индекса байта i в v.

  • Since 4.08
val set_int16_le : bytes -> int -> int -> unit

Устанавливает 16-битное знаковое целое число в порядке little-endian b начиная с индекса байта i в v.

  • Since 4.08
val set_int32_ne : bytes -> int -> int32 -> unit

Устанавливает собственно-порядковое 32-битное целое число b начиная с индекса байта i в v.

  • Since 4.08
val set_int32_be : bytes -> int -> int32 -> unit

Устанавливает 32-битное целое число в порядке big-endian b начиная с индекса байта i в v.

  • Since 4.08
val set_int32_le : bytes -> int -> int32 -> unit

Устанавливает 32-битное целое число в порядке little-endian b начиная с индекса байта i в v.

  • Since 4.08
val set_int64_ne : bytes -> int -> int64 -> unit

Устанавливает собственно-порядковое 64-битное целое число b начиная с индекса байта i в v.

  • Since 4.08
val set_int64_be : bytes -> int -> int64 -> unit

Устанавливает 64-битное целое число в порядке big-endian b начиная с индекса байта i в v.

  • Since 4.08
val set_int64_le : bytes -> int -> int64 -> unit

Устанавливает 64-битное целое число в порядке little-endian b начиная с индекса байта i в v.

  • Since 4.08

© 1995-2022 INRIA.
https://v2.ocaml.org/releases/4.14/htmlman/libref/BytesLabels.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API