Fonction scalaire VARCHAR_BIT_FORMAT

La fonction VARCHAR_BIT_FORMAT renvoie une représentation de chaîne de bits d'une chaîne de caractères qui a été formatée à l'aide d'un modèle de caractères.

Le schéma est SYSIBM.

Dans une base de données Unicode, si un argument fourni est une chaîne graphique, il est d'abord converti en chaîne de caractères avant l'exécution de la fonction.

expression-caractère

Expression qui renvoie une valeur qui est une chaîne de caractères intégrée qui n'est pas un objet CLOB (SQLSTATE 42815). La longueur requise est déterminée par la chaîne de format spécifiée et par la manière dont la valeur est interprétée. Si un argument format-string n'est pas spécifié, la longueur doit être un nombre pair de caractères compris entre'0'et'9','a'et'f'et'A'et'F'(SQLSTATE 42815).

chaîne-format

Constante alphanumérique qui contient un modèle indiquant comment les octets de expression-caractère doivent être interprétés.

Les chaînes de format valides sont les suivantes: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' et 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' (SQLSTATE 42815) où chaque'x'ou'X' correspond à un chiffre hexadécimal dans le résultat.

Le résultat de la fonction est une chaîne de caractères de longueur variable FOR BIT DATA avec l'attribut de longueur et la longueur réelle en fonction de la chaîne de format. Pour les deux chaînes de format valides répertoriées précédemment, l'attribut de longueur du résultat est 36 et la longueur réelle est 16. Si aucun argument format-string n'est spécifié, l'attribut de longueur du résultat est la moitié de l'attribut de longueur de character-expression et la longueur réelle est la moitié de la longueur réelle de character-expression. Si le premier argument peut être indéfini, le résultat peut être indéfini&rbl;; si le premier argument est indéfini, le résultat est une valeur indéfinie.

Exemples

Exemple 1: Représenter un identificateur unique universel sous sa forme binaire:

VARCHAR_BIT_FORMAT('d83d6360-1818-11db-9804-b622a1ef5492', 
                   'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx')

Résultat renvoyé:

	x'D83D6360181811DB9804B622A1EF5492'

Exemple 2: Représenter un identificateur unique universel sous sa forme binaire:

VARCHAR_BIT_FORMAT('D83D6360-1818-11DB-9804-B622A1EF5492',
                   'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX')

Résultat renvoyé:

	x'D83D6360181811DB9804B622A1EF5492'

Exemple 3: représentation d'une chaîne de caractères hexadécimaux au format binaire.
```
VARCHAR_BIT_FORMAT('ef01abC9')
```
Résultat renvoyé en tant que valeur VARCHAR (4) FOR BIT DATA:
```
	x'EF01ABC9'
```
Exemple 4: représentation d'une chaîne de caractères hexadécimaux sous forme de chaîne de caractères dans la page de codes de la base de données. Le résultat doit être transtypé en type de données VARCHAR avec la clause FOR MIXED DATA, en supposant que la base de données prend en charge les types graphiques. Sinon, le résultat doit être transtypé en type de données VARCHAR avec la clause FOR SBCS. L'exemple suivant suppose une base de données Unicode:
```
VALUES CAST(VARCHAR_BIT_FORMAT(HEX('abcdefg')) AS VARCHAR(10) FOR MIXED DATA) 
```
Résultat renvoyé:
```
abcdefg
```