# Left Fonction de script et de graphique

Left() renvoie une chaîne composée des premiers caractères de la chaîne d'entrée (en partant de la gauche) et dont le nombre de caractères est déterminé par le deuxième argument.

Syntaxe :

Left(text, count)

Type de données renvoyé : chaîne

Arguments

| Argument | Description |
| --- | --- |
| text | Chaîne d'origine. |
| count | Définit le nombre de caractères à inclure en partant de l'extrémité gauche de la chaîne text. |

Exemple : Expression de graphique

| Exemple | Résultat |
| --- | --- |
| `Left( 'abcdef', 3 )` | Renvoie `abc`. |

## Exemple - Les bases de Left

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Left.htm)

#### Expression de graphique

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.

Le script de chargement contient :

* Jeu de données chargé dans une table de données appelée `Example`.

* Champs suivants dans la table de données :

  * `InputText`

  * `NoOfChars`

Script de chargement

```
Example:
Load * inline [
InputText, NoOfChars
'abcdef', 3
'2021-07-14', 4
'2021-07-14', 2
];
```

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

* ` InputText
                                   `

* `NoOfChars`

Créez la dimension calculée suivante :

* `=Left(InputText,NoOfChars)`

Tableau de résultats

| InputText | NoOfChars | Left(InputText,NoOfChars) |
| --- | --- | --- |
| abcdef | 3 | abc |
| 2021-07-14 | 2 | 20 |
| 2021-07-14 | 4 | 2021 |

La première ligne renvoie `abc`, car il s'agit des 3 premiers caractères à partir de la gauche de la chaîne `InputText`.

La deuxième ligne renvoie `20`, car il s'agit des 2 premiers caractères à partir de la gauche de la chaîne `InputText`.

La troisième ligne renvoie `2021`, car il s'agit des 4 premiers caractères à partir de la gauche de la chaîne `InputText`.

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Left.htm)

#### Script de chargement

Le code suivant montre comment utiliser la fonction dans un script de chargement.

```
Example:
Load
*,
left(Text,NoOfChars) as Left;
Load * inline [
Text, NoOfChars
'abcdef', 3
'2021-07-14', 4
'2021-07-14', 2
];
```

Tableau de résultats

| Text | NoOfChars | Left |
| --- | --- | --- |
| abcdef | 3 | abc |
| 2021-07-14 | 4 | 2021 |
| 2021-07-14 | 2 | 20 |

## Exemple - Scénario Left

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Left.htm)

#### Expression de graphique

Vue d'ensemble

Cet exemple analyse les codes de commande d'un jeu de données, qui contiennent un code de région, une année et un numéro de commande, afin de créer un nouveau champ pour l'analyse des données.

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.

Le script de chargement contient :

* Jeu de données chargé dans une table de données appelée `Example`.

* Champs suivants dans la table de données :

  * `OrderID`

  * `CustomerName`

  * `SalesAmount`

Script de chargement

```
Example:
Load * inline [
OrderID, CustomerName, SalesAmount
US2024001, John Doe, 1500
EU2024002, Jane Smith, 2300
AS2024003, Mike Davis, 1800
];
```

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

* `OrderID`

* `CustomerName`

* `SalesAmount`

Créez la dimension calculée suivante :

* `=Left(OrderID, 2)` pour calculer la région.

Tableau de résultats

| OrderID | CustomerName | SalesAmount | Left(OrderID, 2) |
| --- | --- | --- | --- |
| AS2024003 | Mike Davis | 1800 | AS/400 |
| EU2024002 | Jane Smith | 2300 | EU |
| US2024001 | John Doe | 1500 | US |

La sortie de la fonction `Left` analyse la valeur OrderID pour en extraire la région, créant ainsi un nouveau champ à utiliser pour une analyse plus poussée des données.

## Exemple - Scénario Left avancé

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Left.htm)

#### Expression de graphique

Vue d'ensemble

Cet exemple analyse les codes de produit d'un jeu de données, qui contiennent un code de catégorie de service et un identificateur unique, afin de créer un nouveau champ pour l'analyse des données.

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.

Le script de chargement contient :

* Jeu de données chargé dans une table de données appelée Example.

* Champ dans la table de données portant le nom ProductCode.

Script de chargement

```
Example:
Load * inline [
ProductCode
ELC12345
HOM67890
FAS09876
];
```

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension :

* ProductCode

Créez la dimension calculée suivante :

* =Pick(Match(left(ProductCode,3),'ELC','HOM','FAS'),'Electronics','Home Appliances','Fashion') pour calculer le service.

Tableau de résultats

| ProductCode | Pick(Match(left(ProductCode,3),'ELC','HOM','FAS'),'Electronics','Home Appliances','Fashion') |
| --- | --- |
| ELC12345 | Electronics |
| FAS09876 | Fashion |
| HOM67890 | Home Appliances |

La sortie utilise les fonctions Pick, Match et Left pour extraire le service du code de produit, créant ainsi un nouveau champ pour l'analyse des données.

Voir également [Index Fonction de script et de graphique](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Index.htm), qui permet une analyse de chaîne plus complexe.