Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

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\$1LENGTH
<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\$1LENGTH 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\$1LENGTH 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 |
+--------------+
```