Amazon Redshift ne prendra plus en charge l'utilisation des UDF Python après le 30 juin 2026. Nous allons commencer à l'appliquer par étapes. Pour plus d'informations sur les détails de la fin de vie de Python et des options de migration, consultez [ le billet de ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/) blog publié le 30 juin 2025. 

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.

# Fonction OCTET\_LENGTH
<a name="r_OCTET_LENGTH"></a>

Renvoie la longueur de la chaîne spécifiée en tant que nombre d’octets. 

## Syntaxe
<a name="r_OCTET_LENGTH-synopsis"></a>

```
OCTET_LENGTH(expression)
```

## Argument
<a name="r_OCTET_LENGTH-argument"></a>

 *expression*   
Chaîne `CHAR`, chaîne `VARCHAR`, expression `VARBYTE` ou expression qui équivaut implicitement à un type `CHAR`, `VARCHAR` ou `VARBYTE`. 

## Type de retour
<a name="r_OCTET_LENGTH-return-type"></a>

 INTEGER   
La fonction OCTET\_LENGTH renvoie un nombre entier indiquant le nombre d’octets dans la chaîne d’entrée.   
Si la chaîne d’entrée est une chaîne de caractères, la fonction [LEN](r_LEN.md) 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 fonction OCTET\_LENGTH renvoie `12` pour cette chaîne et la fonction LEN renvoie `3` pour cette même chaîne.

## Notes d’utilisation
<a name="r_OCTET_LENGTH_usage_notes"></a>

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
<a name="r_OCTET_LENGTH-example"></a>

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 de plus amples informations, veuillez consulter [Fonction CAST](r_CAST_function.md).

```
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 |
+--------------+
```