DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des chaînes
  • Divers
  • Fonction Complète et UNICODE
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Renvoie une chaîne de caractères spécifique de taille déterminée. Cette chaîne peut être tronquée ou complétée par des espaces (ou par un caractère) pour atteindre la taille requise.
Exemple
Complète("Alain", 8)        // Renvoie "Alain   "
Complète("Alain", 8, "A")   // Renvoie "AlainAAA"
Complète("Alexandre", 4)    // Renvoie "Alex"
Syntaxe
<Résultat> = Complète(<Chaîne à manipuler> , <Taille> [, <Caractère>])
<Résultat> : Chaîne de caractères
Chaîne de caractères à la taille spécifiée, complétée ou tronquée.
  • Si <Chaîne à manipuler> a une taille inférieure à <Taille>, la chaîne est complétée à droite par des espaces ou par des caractères si le paramètre <Caractère> est spécifié.
  • Si <Chaîne à manipuler> a une taille supérieure à <Taille>, la chaîne est tronquée à droite (équivalent à la fonction Gauche).
<Chaîne à manipuler> : Chaîne de caractères
Chaîne de caractères à compléter ou à tronquer. Cette chaîne de caractères n'est pas modifiée.
<Taille> : Entier
Nouvelle taille de la chaîne de caractères (supérieure ou égale à 0).
<Caractère> : Caractère optionnel
Caractère utilisé pour compléter la chaîne. Par défaut, ce caractère correspond à un espace.
Remarques

Divers

  • Si le paramètre <Taille> est inférieur à 0, une erreur du WLangage est générée.
  • Par convention, le premier indice d'une chaîne de caractères est 1.

Fonction Complète et UNICODE

Les paramètres <Chaîne à manipuler> et <Caractère> peuvent être tous les deux :
  • soit au format ANSI.
  • soit au format UNICODE.
  • soit des buffers.
Il est possible d'utiliser des chaînes ANSI, Unicode et des buffers dans les différents paramètres de la fonction.
La règle de conversion utilisée est la suivante pour les systèmes Ansi (Windows ou Linux) :
  • Si l'une au moins des chaînes est un buffer, toutes les chaînes sont converties en buffer, et l'opération est réalisée avec des buffers.
  • Si la première condition n'est pas remplie, si l'une au moins des chaînes est Unicode, toutes les chaînes sont converties en Unicode et l'opération est réalisée en Unicode (si nécessaire, la conversion est réalisée avec l'alphabet courant).
  • Sinon, l'opération est réalisée en Ansi.
La règle de conversion utilisée est la suivante pour les systèmes Unicode :
  • Si l'une au moins des chaînes est un buffer, toutes les chaînes sont converties en buffers et l'opération est réalisée avec des buffers.
  • Sinon, l'opération est réalisée en Unicode.
Pour plus de détails sur l'UNICODE, consultez Gestion de l'UNICODE.
Rappel : Les paramètres linguistiques utilisés sont définis lors de l'appel de la fonction ChangeAlphabet.
Classification Métier / UI : Code neutre
Composante : wd300vm.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 29/03/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale