Gauche (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Fonctions de gestion des chaînes

Fonction Gauche et UNICODE

Fonctionnement différent en mode GO et en utilisation réelle

Constantes de gestion des chaînes de caractères

Constantes de sérialisation

Contient

Droite

DécomplèteRep

EntierSystèmeVersEntier

Fonctions de gestion des chaînes de caractères

Gauche

Gestion de l'Unicode dans les chaînes de caractères

Manipuler les chaînes de caractères

NumériqueVersEcritureFinancièreChinoise

VérifieExpressionRégulière

Fonction Gauche et UNICODE
Fonctionnement différent en mode GO et en utilisation réelle

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Gauche (Fonction)

En anglais : Left

Extrait la partie gauche (c'est-à-dire les premiers caractères) d'une chaîne de caractères ou d'un buffer.

Dans cette version, il n'est pas possible d'extraire la partie gauche d'un buffer.

Versions 15 et supérieures

Cette fonction est désormais disponible pour les applications Android.

Nouveauté 15

Cette fonction est désormais disponible pour les applications Android.

Versions 17 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 17

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 18 et supérieures

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Nouveauté 18

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Versions 21 et supérieures

Cette fonction est désormais disponible en mode Apple Watch.

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Nouveauté 21

Cette fonction est désormais disponible en mode Apple Watch.

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Cette fonction est désormais disponible en mode Apple Watch.

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Exemple

Gauche("Le coucou", 6) // Renvoie "Le cou"
Gauche("ABC", 50) // Renvoie "ABC"
Gauche("AZELMA ") // Renvoie "AZELMA"

MaChaîne est une chaîne = "Développez facilement"
Gauche(MaChaîne, 10) // Renvoie "Développez"

// Extraction d'octets
MonBuffer est un Buffer = "Développez facilement"
Gauche(MonBuffer, 10) // Renvoie "Développez"

Syntaxe

Extraire la partie gauche d'une chaîne de caractères Masquer les détails

<Résultat> = Gauche(<Chaîne initiale> [, <Longueur>])

<Résultat> : Chaîne de caractères

Partie gauche spécifiée de <Chaîne initiale>. Correspond à <Chaîne initiale> si le paramètre <Longueur> est supérieur à la taille de <Chaîne initiale>.
EOT si le paramètre <Longueur> est négatif. Une erreur du WLangage est générée (erreur non fatale). Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.

<Chaîne initiale> : Chaîne de caractères (avec guillemets)

Chaîne de caractères dont il faut extraire la partie gauche. Cette chaîne n'est pas modifiée.

<Longueur> : Entier optionnel

Nombre de caractères à extraire. Si ce paramètre n'est pas précisé, <Résultat> correspond à <Chaîne initiale> sans les espaces à droite.

Extraire la partie gauche d'un buffer Masquer les détails

<Résultat> = Gauche(<Buffer initial> [, <Taille>])

<Résultat> : Chaîne de caractères

Partie gauche spécifiée de <Buffer initial>. Correspond à <Buffer initial> si le paramètre <Taille> est supérieur à la taille de <Buffer initial>.
EOT si le paramètre <Taille> est négatif. Une erreur du WLangage est générée (erreur non fatale). Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
Buffer invalide si <Buffer initial> contient une chaîne de caractères au format UNICODE.
Buffer invalide si <Buffer initial> contient une chaîne de caractères au format ANSI.

<Buffer initial> : Buffer

Buffer dont il faut extraire la partie gauche. Ce buffer n'est pas modifié.

<Taille> : Entier optionnel

Nombre d'octets à extraire. Si ce paramètre n'est pas précisé, <Résultat> correspond à <Buffer initial> sans les espaces à droite.
En UNICODE, chaque caractère occupe deux octets de mémoire. Le nombre d'octets correspond donc au double du nombre de caractères.

Remarques

Fonction Gauche et UNICODE

Si la chaîne passée en paramètre est au format ANSI, le résultat sera au format ANSI.

Si la chaîne passée en paramètre est au format UNICODE, le résultat sera au format UNICODE.

Rappel : En UNICODE, chaque caractère occupe deux octets de mémoire. La taille mémoire d'une chaîne UNICODE correspond donc au double du nombre de caractères réellement contenu dans la chaîne.

Le premier caractère de la chaîne possède l'indice 1.

Remarque : Si le résultat sur une chaîne ANSI est affecté à une chaîne UNICODE (et inversement), la conversion sera implicitement réalisée.

Pour plus de détails, consultez Gestion de l'UNICODE.

Fonctionnement différent en mode GO et en utilisation réelle

En mode GO (simulation sur le poste de développement), lors de l'extraction de la partie gauche d'un buffer (syntaxe 2), la <Taille> correspond au nombre de caractères à extraire et non au nombre d'octets.

Par exemple, exécution du code suivant :

MonBuffer est un Buffer = "WINDEV est formidable"
Gauche(MonBuffer, 6)

Le résultat est le suivant :