Fonctions Left, Mid et Right

  • Article

S'applique à : Applications Canvas Colonnes de formule Dataverse Flux de bureau Applications pilotées par modèle CLI Power Platform

Extrait la partie de gauche, du milieu ou de droite d’une chaîne de texte.

Description

Les fonctions Left, Mid et Right renvoient une partie d’une chaîne.

  • Left renvoie les caractères de début d’une chaîne.
  • Mid renvoie les caractères du milieu d’une chaîne.
  • Right renvoie les caractères de fin d’une chaîne.

Si vous spécifiez une chaîne unique en tant qu’argument, la fonction renvoie la partie demandée de cette chaîne. Si vous spécifiez une table à une seule colonne qui contient des chaînes, la fonction renvoie une table à une seule colonne avec une colonne Valeur contenant les parties demandées de ces chaînes. Si vous spécifiez une table à plusieurs colonnes, vous pouvez la convertir en table à une seule colonne (voir Utilisation des tables).

Si la position de départ est négative ou se situe après la fin de la chaîne, Mid renvoie la valeur blank. Vous pouvez vérifier la longueur d’une chaîne à l’aide de la fonction Len. Si vous demandez un nombre de caractères supérieur à celui de la chaîne, la fonction renvoie le maximum de caractères possible.

Syntaxe

Left( String, NumberOfCharacters )
Mid( String, StartingPosition [, NumberOfCharacters ] )
Right( String, NumberOfCharacters )

  • String : obligatoire. Chaîne à partir de laquelle extraire le résultat.
  • StartingPosition : obligatoire (fonction Mid uniquement). Position de départ. La position 1 correspond au premier caractère de la chaîne.
  • NumberOfCharacters : obligatoire (Left et Right seulement). Nombre de caractères à renvoyer. Si omis pour la fonction Mid, la fonction renvoie la partie depuis la position de départ jusqu’à la fin de la chaîne.

Left( SingleColumnTable, NumberOfCharacters )
Mid( SingleColumnTable, StartingPosition [, NumberOfCharacters ] )
Right( SingleColumnTable, NumberOfCharacters )

  • SingleColumnTable : obligatoire. Table à colonne unique contenant les chaînes à partir desquelles extraire les résultats.
  • StartingPosition : obligatoire (fonction Mid uniquement). Position de départ. La position 1 correspond au premier caractère de la chaîne.
  • NumberOfCharacters : obligatoire (Left et Right seulement). Nombre de caractères à renvoyer. Si omis pour la fonction Mid, la fonction renvoie la partie depuis la position de départ jusqu’à la fin de la chaîne.

Exemples

Chaîne unique

Les exemples de cette section utilisent un contrôle d’entrée de texte comme source de données. Le contrôle est nommé Author et contient la chaîne « E. E. Cummings ».

Formule Description Résultat
Left( Author.Text, 5 ) Extrait jusqu’à cinq caractères à partir du début de la chaîne. "E. E."
Mid( Author.Text, 7, 4 ) Extrait jusqu’à quatre caractères, en commençant par le septième caractère, de la chaîne. "Cumm"
Mid( Author.Text, 7 ) Extrait tous les caractères, en commençant par le septième caractère, de la chaîne. "Cummings"
Right( Author.Text, 5 ) Extrait jusqu’à cinq caractères à partir de la fin de la chaîne. "mings"

Table à une seule colonne

Chaque exemple de cette section extrait des chaînes à partir de la colonneAddress de cette source de données, nommée People, et renvoie une table à une seule colonne contenant les résultats :

Nom  Address
« Jean » « 123 Main St NE »
« Fred » « 789 SW 39e # 3B »
Formula Description Result
Left( ShowColumns( People, "Address" ), 8 ) Extrait les huit premiers caractères de chaque chaîne. Table à une seule colonne avec une colonne Value contenant les valeurs suivantes : « 123 Main », « 789 SW 3 »
Mid( ShowColumns( People, "Address" ), 5, 7 ) Extrait les sept caractères du milieu de chaque chaîne, à partir du cinquième caractère. Table à une seule colonne avec une colonne Value contenant les valeurs suivantes : « Main St », « SW 39th »
Right( ShowColumns( People, "Address" ), 7 ) Extrait les sept derniers caractères de chaque chaîne. Table à une seule colonne avec une colonne Value contenant les valeurs suivantes : « n St NE », « 9th #3B »

Exemple étape par étape

  1. Importez ou créez une collection nommée Inventory et affichez-la dans une galerie en suivant la première procédure présentée dans l’article Afficher des images et du texte dans une galerie.

  2. Définissez la propriété Text de l’étiquette inférieure de la galerie sur cette fonction :

    Right(ThisItem.ProductName, 3)

    L’étiquette affiche les trois derniers caractères de chaque nom de produit.