FirebirdSQL logo

Littéraux (constantes)

Littéraux ou constante est une valeur insérée directement dans l’instruction SQL qui n’est pas dérivée d’une expression, d’un paramètre, d’une référence de colonne ou d’une variable.

Littérales de chaînes de caractères

Une chaîne de caractères est une séquence de caractères placée entre deux apostrophes (“guillemets simples”). La longueur maximale d’une constante de chaîne est de 65535 octets ; le nombre maximal de caractères sera déterminé par le nombre d’octets utilisés pour coder chaque caractère.

Syntaxe:
<character string literal> ::=
  [ <introducer> <character set specification> ]
    <quote> [ <character representation>... ] <quote>
    [ { <separator> <quote> [ <character representation>... ] <quote> }... ]

<separator> ::=
  { <comment> | <white space> }

<introducer> ::= underscore (U+005F)

<quote> ::= apostrophe (U+0027)

<char> ::= character representation;
l'apostrophe est échappée en la doublant
Example 1. Chaîne littérale simple
'Hello world'

Si une apostrophe littérale est requise dans une constante de chaîne, elle peut être "protégée" par une autre apostrophe qui la précède.

Example 2. Chaîne littérale contenant une apostrophe
'Mother O''Reilly''s home-made hooch'

Une autre façon d’écrire cette chaîne littérale est d’utiliser des guillemets alternatifs :

q'{Mother O'Reilly's home-made hooch}'

Un littéral de chaîne peut être "terminé" par un espace ou un commentaire si nécessaire.Cela peut être utilisé pour diviser un long littéral en plusieurs lignes ou pour fournir des commentaires en ligne.

Example 3. Chaînes littérales interrompues par un espace et un commentaire
-- Des espaces entre les caractères littéraux
select 'ab'
       'cd'
from RDB$DATABASE;
-- sortie: 'abcd'

-- Des espaces entre les commentaires littéraux
select 'ab' /* comment */ 'cd'
from RDB$DATABASE;
-- sortie: 'abcd'
Note
  • Les guillemets doubles devraient ne pas (autorisés par 1 dialecte) être utilisés pour le quota de chaînes. Dans SQL, ils sont fournis à d’autres fins.

  • Si une apostrophe littérale est requise dans une constante de chaîne, elle peut être "`screened'" par une autre apostrophe précédente. Par exemple,"Mother O''Reilly’s home-made hooch". Ou utilisez des guillemets alternés pour les littéraux : q'{Mother O''Reilly's home-made hooch}'.

  • Il faut faire attention à la longueur de la chaîne si la valeur doit être écrite dans une colonne de type VARCHAR. La longueur maximale de la chaîne pour le type VARCHAR est de 32765 octets (32767 pour le type CHAR). Si la valeur doit être écrite dans une colonne de type BLOB, la longueur maximale de la chaîne littérale est de 65535 octets.

On suppose que le jeu de caractères de la constante chaîne est le même que celui de la colonne dans laquelle elle est stockée.