RPAD |
Cadré à droite |
| BigQuery |
Syntaxe
|
RPAD(original_value, return_length[, pattern])
|
Paramètres
| Nom |
Description |
| original_value |
Ce paramètre permet de spécifier la chaîne de caractères ou la séquence d'octets que vous souhaitez rembourrer. |
| return_length |
Ce paramètre permet de définir la longueur totale souhaitée de la chaîne résultante. Si la original_value est déjà plus longue que cette valeur, la chaîne sera tronquée à cette longueur. |
| pattern |
Ce paramètre facultatif permet de spécifier la chaîne de caractères à utiliser pour le rembourrage. Ces caractères seront ajoutés à la fin de la original_value jusqu'à atteindre la return_length. Si ce paramètre n'est pas fourni, le caractère d'espacement () est utilisé par défaut. |
Description
Cette fonction permet d'ajouter le caractère spécifié à la fin de façon à se que la chaîne de caractères atteint la longueur spécifié.
Remarques
- Ajout de caractères à droite de la chaîne : La fonction RPAD permet d'ajouter des caractères à la fin d'une chaîne donnée afin que sa longueur atteigne
la valeur spécifiée. C'est utile pour formater des données textuelles avec un alignement à gauche, en complétant à droite.
- Tronque si la chaîne dépasse la longueur demandée : Si la chaîne d'origine est plus longue que la longueur finale demandée, RPAD tronque la chaîne à
cette longueur, garantissant que le résultat ne dépasse jamais la taille indiquée.
- Pattern de rembourrage personnalisable : Le troisième paramètre facultatif permet d'indiquer la ou les chaînes utilisées pour remplir à droite. Si ce
paramètre est absent, c'est un espace (espace blanc) qui sera ajouté par défaut.
- Cycle du pattern si nécessaire : Lorsque le pattern est plus court que la différence entre la longueur finale et la chaîne d'origine, la fonction répète
le pattern en boucle jusqu'à ce que la longueur désirée soit atteinte.
- Utilisation fréquente pour le formatage de colonnes : RPAD est très utilisé pour créer des sorties alignées dans des rapports ou des exports de données,
par exemple pour aligner des codes ou des noms dans des colonnes à largeur fixe.
- Fonction compatible avec chaînes et séquences d'octets : La fonction accepte aussi bien des chaînes de caractères (STRING) que des séquences
d'octets (BYTES), ce qui est utile pour manipuler différents types de données textuelles ou binaires.
- Important pour les formats fixes dans les exports : En base de données, certains formats d'export ou d'interfaçage exigent des longueurs fixes de
champs. RPAD garantit que les valeurs respectent ces contraintes en ajoutant des caractères à droite.
- Peut affecter la comparaison ou l'entreposage : En ajoutant des espaces ou autres caractères, RPAD modifie la valeur textuelle, ce qui peut impacter
des comparaisons ou des regroupements si le résultat est utilisé en condition ou dans des index.
Dernière mise à jour : Jeudi, le 18 Juin 2020
