Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
OCTET_ LENGTH fonction
Renvoie la longueur de la chaîne spécifiée en tant que nombre d’octets.
Syntaxe
OCTET_LENGTH(expression)
Argument
- expression
-
Chaîne
CHAR
, chaîneVARCHAR
, expressionVARBYTE
ou expression qui équivaut implicitement à un typeCHAR
,VARCHAR
ouVARBYTE
.
Type de retour
- INTEGER
-
La LENGTH fonction OCTET _ renvoie un entier indiquant le nombre d'octets de la chaîne d'entrée.
Si la chaîne d’entrée est une chaîne de caractères, la fonction LEN renvoie le nombre de caractères dans des chaînes de plusieurs octets, pas le nombre d’octets. Par exemple, une colonne
VARCHAR(12)
est nécessaire pour stocker trois caractères chinois de quatre octets. La LENGTH fonction OCTET _ retournera12
pour cette chaîne, et la LEN fonction retournera3
pour cette même chaîne.
Notes d’utilisation
Si expression est une chaîne CHAR
, la fonction renvoie la longueur de la chaîne CHAR
. Par exemple, la sortie d’une entrée CHAR(6)
est un CHAR(6)
.
Si expression est une chaîne VARCHAR
, les espaces de fin sont comptés.
Exemples
Pour renvoyer le nombre d’octets lorsque la chaîne francais
avec trois espaces de fin est convertie en type CHAR
et VARCHAR
, utilisez l’exemple suivant. Pour plus d’informations, consultez le CASTfonction.
SELECT OCTET_LENGTH(CAST('francais ' AS CHAR(15))) AS octet_length_char, OCTET_LENGTH(CAST('francais ' AS VARCHAR(15))) AS octet_length_varchar;
+-------------------+----------------------+ | octet_length_char | octet_length_varchar | +-------------------+----------------------+ | 15 | 11 | +-------------------+----------------------+
Pour renvoyer le nombre d’octets et le nombre de caractères dans la chaîne français
, utilisez l’exemple suivant.
SELECT OCTET_LENGTH('français'), LEN('français');
+--------------+-----+ | octet_length | len | +--------------+-----+ | 9 | 8 | +--------------+-----+
Pour renvoyer le nombre d’octets lorsque la chaîne français
est convertie en VARBYTE
, utilisez l’exemple suivant.
SELECT OCTET_LENGTH(CAST('français' AS VARBYTE));
+--------------+ | octet_length | +--------------+ | 9 | +--------------+