FirebirdSQL logo
 Instructions de procédure SQL (PSQL)Fonctions agrégées 

OCTET_LENGTH()

Disponible en

DSQL, PSQL

Syntaxe
OCTET_LENGTH (string)
Table 1. paramètres de fonction OCTET_LENGTH
Paramètre Description

string

Une expression de type chaîne de caractères.
Le type de résultat renvoyé :

BIGINT

La fonction OCTET_LENGTH renvoie le nombre d’octets occupés par la chaîne de caractères.

Lorsqu’il s’agit de paramètres de type CHAR, la fonction renvoie la longueur totale de la chaîne formelle. Pour connaître la longueur logique de la chaîne en octets, RIGHT TRIM doit être appliqué avant de passer l’argument à la fonction.

Note

Notez que tous les jeux de caractères n’ont pas le même nombre d’octets que le nombre de caractères.

Exemple OCTET_LENGTH

Example 1. Utilisation de la fonction OCTET_LENGTH
SELECT OCTET_LENGTH('Hello!')
FROM rdb$database
-- retournera 6

SELECT OCTET_LENGTH(_iso8859_1 'Grüß di!')
FROM rdb$database
-- retournera 8 : ü et ß n'occupent pas plus d'un octet en ISO8859_1

SELECT
  OCTET_LENGTH(CAST(_iso8859_1 'Grüß di!' AS VARCHAR(24) CHARACTER SET utf8))
FROM rdb$database
-- retournera 10 : ü et ß occupent 2 octets en UTF8

SELECT
  OCTET_LENGTH(CAST(_iso8859_1 'Grüß di!' AS CHAR(24) CHARACTER SET utf8))
FROM rdb$database
-- retournera 26 : un total de 24 positions CHAR et deux d'entre elles occupent 2 octets.
Voir aussi :

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