2.5. Blobs

BlobToBase64(Blob: blob): String

Кодирует бинарные данные в Base64

Parameters:Blob (Variant) – Бинарные данные
Return type:String

New in version 5.4.0.

Base64ToBlob(Base64String: String): Variant

Декодирует бинарные данные из Base64

Parameters:Base64String (String) – Строка Bаse64 кодировки
Return type:blob

New in version 5.4.0.

BlobToHex(Data: blob)

Кодирует бинарные данные в HEX-строку

Parameters:Data (blob) – Бинарные данные.
Return type:String

New in version 5.5.0.3950.

HexToBlob(Hex: String)

Декодирует бинарные данные из Hex-строки

Parameters:Hex (String) – HEX-строка
Return type:blob

New in version 5.5.0.3950.

BlobToString(Data: blob; CodePage: Integer)

Привести буфер бинарных данных к строке.

Warning

Метод предназначен для приведения буфера заведомо содержащего текстовые данные

Parameters:
  • Data (blob) – Текстовые данные в бинарном виде.
  • CodePage (Integer) – Кодировка текстовых данных.
Return type:

String

New in version 5.5.0.3950.

StringToBlob(Text: String; CodePage: Integer)

Привести строку к бинарному представлению.

Attention

Возвращаемый результат не содержит информацию о кодировке строки

Warning

При передаче строковых значений между разными переменными в Pascal-скрипте не гарантируется сохранность кодировки. Это следует учитывать при работе со StringToBlob и вызывать его сразу после получения значения в нужной кодировке, либо указывать требуемую кодировку явно. Наиболее частый, но не единственный, способ потери кодировки - использование массивов. Строковые значения элементов массивов могут быть представлены только юникодом. Из-за этого при присвоении элементам не юникодных строк они перекодируются в UTF16. Эту особенность нельзя обойти и её следует просто учитывать.

Parameters:
  • Text (String) – Текст
  • CodePage (Integer) –

    Кодировка которой должен соответствовать возвращаемый результат. Может отличаться от кодировки строки переданной в параметре AString. Если параметр не указан будет использована кодировка в которой передана строка.

    New in version 5.9.0.5400.
Return type:

blob

New in version 5.5.0.3950.

BlobIntToStr(VeryBigInteger: blob)

Привести сколь угодно большое целое беззнаковое число к строке, в десятиричном представлении.

Parameters:VeryBigInteger (blob) – Бинарное представление числа (BigEndian).
Returns:Десятиричная запись числа.
Return type:String

New in version 5.5.0.3950.

BlobRevers(Data: blob)

“Перевернуть” блоб. Возвращает блоб тех же данных, но с обратным порядком индексации: [Data[N], Data[N-1], ..., Data[0]].

Может быть полезно когда необходимо изменить порядковую нотацию BigEndian <-> LittleEndian.

Parameters:Data (blob) – Бинарные данные.
Return type:blob

New in version 5.5.0.3950.

BlobCopy(Blob: blob; StartByte, Count: Integer): blob

Копировать часть блоба

Parameters:
  • Blob (blob) – Блоб-источник
  • StartByte (Integer) – Порядковый номер байта в источнике, с которого начнётся копирование
  • Count (Integer) –

    Количество байт которое будет скопированио

    Примечание: если указано количество болшее доступно - будет скопировано всё что доступно (до конца блоба-источника)

New in version 5.5.8.4460.

BlobConcat(Blob1, Blob2[,... BlobN]): blob

Объеденить блобы в один общий

Перечисленные в параметрах блобы будут скопированы в итоговый в порядке как они перечислены в параметрах. Всего можно перечислить до 255 блобов.

New in version 5.5.8.4460.