BLOB fonction scalaire

La fonction BLOB renvoie une représentation BLOB d'une chaîne de n'importe quel type ou d'un type d'identifiant de ligne.

Le schéma est SYSIBM.

string-expression

Expression qui renvoie une valeur qui est une chaîne de caractères intégrée, une chaîne graphique, une chaîne binaire ou un type d'ID de ligne.

entier

Valeur entière qui spécifie l'attribut de longueur de la chaîne binaire résultante. La valeur doit être un entier compris entre 1 et la longueur maximale d'un BLOB.

Ne pas spécifier integer si string-expression est un type d'identifiant de ligne.

Si vous ne spécifiez pas d'entier et que l'expression de chaîne est une constante de chaîne vide, l'attribut de longueur du résultat est 1 et le résultat est une chaîne vide. Sinon, l'attribut de longueur du résultat est le même que l'attribut de longueur de l'expression-chaîne, sauf lorsque l'entrée est une donnée graphique. Dans ce cas, l'attribut length du résultat est deux fois plus long que l'expression.

Le résultat de la fonction est un BLOB.

Le résultat peut être nul; si le premier argument est nul, le résultat est la valeur nulle.

La longueur réelle du résultat est la plus petite des deux valeurs suivantes : l'attribut de longueur du résultat et la longueur réelle de l'expression-chaîne (ou deux fois la longueur de l'expression-chaîne lorsque l'entrée est constituée de données graphiques). Si la longueur de l'expression de chaîne est supérieure à l'attribut de longueur du résultat, la troncature est effectuée. Un avertissement est renvoyé sauf si le premier argument d'entrée est une chaîne de caractères et que tous les caractères tronqués sont des espaces, ou si le premier argument d'entrée est une chaîne graphique et que tous les caractères tronqués sont des espaces à double octet.

Exemple 1 : La fonction suivante renvoie un BLOB pour la chaîne « Ceci est un BLOB ».

   SELECT BLOB('This is a BLOB')
     FROM SYSIBM.SYSDUMMY1;

Exemple 2 : La fonction suivante renvoie un BLOB pour le grand objet identifié par le localisateur myclob_locator.

   SELECT BLOB(:myclob_locator)
     FROM SYSIBM.SYSDUMMY1;

Exemple 3 : Supposons qu'une table comporte une colonne BLOB nommée TOPOGRAPHIC_MAP et une colonne VARCHAR nommée MAP_NAME. Localiser toutes les cartes contenant la chaîne « Engles Island » et renvoyer une seule chaîne binaire avec le nom de la carte concaténé devant la carte réelle.

   SELECT BLOB(MAP_NAME || ':  ') || TOPOGRAPHIC_MAP
     FROM ONTARIO_SERIES_4
     WHERE TOPOGRAPHIC_MAP LIKE BLOB('%Engles Island%')