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 TO\$1VARBYTE
<a name="r_TO_VARBYTE"></a>

TO\$1VARBYTE convertit une chaîne dans un format spécifié en valeur binaire. 

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

```
TO_VARBYTE(string, format)
```

## Arguments
<a name="r_TO_VARBYTE-arguments"></a>

 *chaîne*   
Chaîne `CHAR` ou `VARCHAR`. 

 *format*   
Format du fichier d'entrée. Les valeurs valides insensibles à la casse sont `hex`, `binary`, `utf8` (également `utf-8` et `utf_8`) et `base64`. 

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

`VARBYTE`

## Exemples
<a name="r_TO_VARBYTE-examples"></a>

Pour convertir la valeur hexadécimale `6162` en une valeur binaire, utilisez l'exemple suivant. Le résultat est automatiquement affiché sous forme de représentation hexadécimale de la valeur binaire.

```
SELECT TO_VARBYTE('6162', 'hex');
               
+------------+
| to_varbyte |
+------------+
|       6162 |
+------------+
```

Pour renvoyer la représentation binaire de `4d`, utilisez l'exemple suivant. La représentation binaire de « 4d » est `01001101`.

```
SELECT TO_VARBYTE('01001101', 'binary');
               
+------------+
| to_varbyte |
+------------+
|         4d |
+------------+
```

Pour convertir la chaîne `'a'` dans UTF-8 en une valeur binaire, utilisez l'exemple suivant. Le résultat est automatiquement affiché sous forme de représentation hexadécimale de la valeur binaire.

```
SELECT TO_VARBYTE('a', 'utf8');
               
+------------+
| to_varbyte |
+------------+
|         61 |
+------------+
```

Pour convertir la chaîne `'4'` hexadécimale en une valeur binaire, utilisez l'exemple suivant. Si la longueur de la chaîne hexadécimale est un nombre impair, alors un `0` est ajouté pour former un nombre hexadécimal valide.

```
SELECT TO_VARBYTE('4', 'hex');
               
+------------+
| to_varbyte |
+------------+
|         04 |
+------------+
```