Chaînes binaires

Le type bytea permet le stockage de chaînes binaires.

Une chaîne binaire est une suite d'octets qui ne possède pas, ou un ensemble de caractères, ou une collation associée à elle.Bytea permet le stockage d'octets de valeur zero et autres octets "non-imprimables".

Les octets de certaines valeurs doivent être échappés (mais toutes les valeurs d'octet peuvent être échappées) quand ils sont utilisés comme partie d'une chaîne littérale dans une clause SQL. En général, pour échapper un octet, il est converti en un nombre octal à trois chiffres équivalent à sa valeur en octet décimal, et précédé de deux backslashes (\\). Certaines valeurs d'octet ont des séquences d'échappement alternatives, comme indiqué en Table 7.

Notez que le résultat de chacun des exemples ci-dessus est d'exactement un octet de long, bien que la représentation à l'affichage du zero octet et du backslash soient de plus d'un caractère. Les octets de Bytea sont aussi échappés. En général, chaque valeur d'octet décimale "non-imprimable" est convertie en son équivalent en valeur octale à trois chiffres, et précédée par un backslash. La plupart des octets "imprimables" sont affichés par leur représentation standard dans le jeu de caractères du client. L'octet avec la valeur décimale 92 (backslash) possède un affichage alternatif particulier. Détails en Table 8.

Les chaînes littérales SQL (chaînes d'entrée) doivent être précédées de deux backslashes ce qui est dû au fait qu'elles doivent passer à travers deux analyseurs au niveau du serveur PostgreSQL. Le premier backslash est interprété comme un caractère d'échappement par l'analyseur de chaîne, et par conséquent consommé, laissant les octets qui suivent. Le backslash restant est reconnu par la fonction entrée bytea comme préfixe d'une valeur octale à trois chiffres. Par exemple, une chaîne littérale passée au serveur comme '\\001' devient '\001' après être passée par l'analyseur parser. Le '\001' est alors envoyé à la fonction bytea, où il est converti en un seul octet avec une valeur décimale de 1.

Pour une raison similaire, un backslash doit être entré comme '\\\\' (ou '\\134'). Le premier et le troisième backslash sont interprétés comme caractères d'échappement par l'analyseur, et par conséquent consommés, laissant deux backslashes dans la chaîne passée à la fonction entrée bytea, qui les interprète comme représentant un simple backslash. Par exemple, une chaîne passée au serveur comme '\\\\' devient '\\' après être passée par l'analyseur. Le '\\' est alors envoyé à la fonction bytea où il est converti en un simple octet avec une valeur décimale de 92.

L'apostrophe est un peu différent en ce qu'il doit être entré comme '\'' (ou '\\134'), non comme '\\''. Ceci parce que, tandis que l'analyseur interprète les apostrophes comme caractères spéciaux, and will consomme le backslash unique, la fonction entrée bytea ne reconnaît pas l'apostrophe comme octet spécial. Donc, une chaîne littérale passée au serveur comme '\'' devient ''' après être passée par l'analyseur de chaîne. Le ''' est alors envoyé à la fonction entrée bytea où il est vu comme simple octet décimal de valeur 39.

En fonction du client Postgres que vous utilisez, vous pouvez avoir d'autres choses à faire en termes d'échappement et non échappement de chaînes bytea. Par exemple, vous pouvez aussi avoir à échapper des suites de lignes et des retours chariots si votre interface ne le fait pas automatiquement. Ou vous pouvez avoir à doubler les backslashes si votre langage les traite comme caractères d'échappement.

Bytea procure la plupart des fonctionnalités du type chaîne binaire du SQL99 section 4.3. Une comparaison des chaînes binaires SQL99 et du bytea de PostgreSQL est présentée en Table 9.