DESCRIPTION.

La fonction LEFT$() retourne ou modifie le début d'une chaine de caractères donnée en argument.

SYNTAXE.

kchaine$ = LEFT$( source , longueur )

LEFT$( source, longueur ) = nouveau

REMARQUES.

- source est la chaine de caractères ;

- longueur un nombre entier indiquant combien de caractères seront retournés ou modifiés, si longueur est :

- absent , longueur sera égal à LEN( source ) - 1 ;

- négatif ou supérieur à LEN( source ), LEFT$() retourne source ;

- 0, LEFT$() retourne une chaine vide ;

- nouveau doit être une chaine de caractères.

Si l'appel de la fonction a la forme LEFT$( source , longueur ) par exemple avec l'instruction PRINT, ou à la droite d'un signe =, c'est-à-dire après, elle retourne une nouvelle chaine de caractères, depuis le début de source et d'une taille de longueur caractères. 

Si l'appel de la fonction a la forme LEFT$( source, longueur ) = nouveau, elle remplacera le début de source par les longueur premiers caractères de nouveau. dans ce cas, aucune nouvelle chaine de caractères n'est retournée, car c'est bien source qui est modifiée. Si longueur est supérieur à LEN( nouveau ), longueur prendra la valeur de LEN( nouveau ). À noter qu'avec cette forme, source doit être une variable et qu'il ne doit pas y avoir d'espace entre source et la virgule qui le suit, sinon une erreur sera détectée.

Rappel : dans BBC BASIC, le premier caractère d'une chaine de caractères est à la position 1.

Voir la fonction FN_uleft() du module utf8lib.bbc qui retourne le début d'une chaine de caractères au format UTF-8.

RUBRIQUES.

Les chaines de caractères pour plus de détails sur la gestion des chaines de caractères.

EXEMPLES.

1. Retourner le début d'une chaine de caractères.

kmessage$ = "Le BBC BASIC est un langage simple mais puissant."

klangage$ = LEFT$( kmessage$ , 12 ) 

PRINT klangage$ : REM retourne Le BBC BASIC

PRINT LEFT$( kmessage$ , 12 ) : REM retourne Le BBC BASIC

PRINT LEFT$( kmessage$ , 123 ) : REM retourne Le BBC BASIC est un langage simple mais puissant.

PRINT LEFT$( kmessage$ , -12 ) : REM retourne Le BBC BASIC est un langage simple mais puissant.

PRINT LEFT$( kmessage$ ) : REM retourne Le BBC BASIC est un langage simple mais puissant

PRINT LEFT$( kmessage$ , 0 ) : REM retourne Le BBC BASIC est un langage simple mais puissant

2. Modifier le début d'une chaine de caractères.

kslogan$ = "Le --- ----- est puissant."

PRINT kslogan$ : REM retourne Le --- ----- est puissant.

LEFT$( kslogan$, 12 ) = "Le BBC BASIC"

PRINT kslogan$ : REM retourne Le BBC BASIC est puissant.

PRINT LEFT$( "Le --- ----- est puissant.", 12 ) = "Le BBC BASIC" : REM retourne 0

kslogan$ = "Le --- ----- est puissant."

PRINT kslogan$ : REM retourne Le --- ----- est puissant.

LEFT$( kslogan$, 12 ) = "Le BBC "

PRINT kslogan$ : REM retourne Le BBC ----- est puissant.