FirebirdSQL logo
 Операторы процедурного SQL (PSQL)Агрегатные функции 

OCTET_LENGTH()

Доступно в

DSQL, PSQL

Синтаксис
OCTET_LENGTH (string)
Table 1. Параметры функции OCTET_LENGTH
Параметр Описание

string

Выражение строкового типа.
Тип возвращаемого результата:

BIGINT

Функция OCTET_LENGTH возвращает количество байт занимаемое строкой.

При работе с параметрами типа CHAR функция возвращает значение всей формальной строковой длины.Для того чтобы узнать “логическую” длину строки в байтах, то перед передачей аргумента функции следует применить RIGHT TRIM.

Note

Следует помнить, что не во всех наборах символов количество байт занимаемых строкой равно количеству символов.

Примеры OCTET_LENGTH

Example 1. Использование функции OCTET_LENGTH
SELECT OCTET_LENGTH('Hello!')
FROM rdb$database
-- возвратит 6

SELECT OCTET_LENGTH(_iso8859_1 'Grüß di!')
FROM rdb$database
-- возвратит 8: ü и ß занимают не более 1 байта в ISO8859_1

SELECT
  OCTET_LENGTH(CAST(_iso8859_1 'Grüß di!' AS VARCHAR(24) CHARACTER SET utf8))
FROM rdb$database
-- возвратит 10: ü и ß занимают 2 байта в UTF8

SELECT
  OCTET_LENGTH(CAST(_iso8859_1 'Grüß di!' AS CHAR(24) CHARACTER SET utf8))
FROM rdb$database
-- возвратит 26: всего 24 CHAR позиции, и две из них занимают 2 байта
См. также:

[fblangref-scalarfuncs-bit-length], [fblangref-scalarfuncs-char-length].