> For the complete documentation index, see [llms.txt](https://documentation.soulver.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.soulver.app/fr/documentation/variables.md).

# Variables

### Déclaration de variables

Déclarez une variable avec le symbole égal '='.

```
discount = 10%                         | 10%
cost = $550                            | $550
cost - discount                        | $495.00  
```

Une variable peut être un seul mot ou une phrase entière.

### Variables globales

Déclarez les variables dans le **feuille de définitions** pour les rendre disponibles dans toutes vos feuilles et fichiers Soulver. Utilisez `=` comme vous le feriez pour une variable normale.

Sur Mac, ouvrez **Settings > Variables** et cliquez sur **Edit Definition Sheet…**.

Les variables globales de la feuille de définition peuvent également utiliser des calculs impliquant des variables déclarées au-dessus d'elles.

Sur Mac, vous pouvez également ajouter des variables globales directement dans **Settings > Variables** à l'aide du bouton **+**.

### Priorité variable

Si le même nom de variable est défini à plusieurs endroits, Soulver utilise cet ordre :

1. **Variables locales** déclaré au-dessus de la ligne actuelle de votre feuille.
2. **Variables globales dans les réglages.**
3. **Variables dans la feuille de définitions.**

Par exemple, si la feuille de définition définit `discount = 10%`, vous pouvez utiliser `discount = 20%` dans une feuille particulière pour la remplacer pour les lignes suivantes sans modifier la valeur globale.

### Redéfinition des variables

Une variable peut être redéfinie en lui donnant une nouvelle valeur.

La valeur la plus récemment définie sera utilisée sur les lignes suivantes.

```
monthly rent = $1,900 // 2018      | $1,900
monthly rent = $2,150 // 2019      | $2,150   
monthly rent / 4 people            | $537.50
```

#### Variables pouvant être ajoutées et soustraites

Utilisez les opérateurs `+=` et `-=` pour modifier la valeur d'une variable

![](https://1675407794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FikLsBlZJcwZsqfACFJ5S%2Fuploads%2Fgit-blob-8fa14eed7461f98993322520aaf02259d622d048%2Fimage%20\(2\)%20\(1\).png?alt=media)

## Conseils pour travailler avec les variables

#### Aperçu de la valeur d'une variable

Sur Mac, apercevez la valeur d'une variable en maintenant la touche Shift enfoncée et en survolant la variable.

<figure><img src="https://1675407794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FikLsBlZJcwZsqfACFJ5S%2Fuploads%2Fgit-blob-9f2384537de4e905201ee4ed27a15c0173088d3f%2Fimage%20(5)%20(1).png?alt=media" alt="" width="158"><figcaption><p>Aperçu de la valeur d'une variable sur Mac</p></figcaption></figure>

Sur iPad et iPhone, sélectionnez une variable pour voir sa valeur.

<figure><img src="https://1675407794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FikLsBlZJcwZsqfACFJ5S%2Fuploads%2Fgit-blob-a765b7d87db5425280e152ad0512525656ae74d6%2Fimage%20(6)%20(1).png?alt=media" alt="" width="359"><figcaption><p>Aperçu de la valeur d'une variable sur iPad et iPhone</p></figcaption></figure>

#### Complétion automatique des noms de variables

Au lieu de taper un long nom de variable, vous pouvez appuyer sur la touche **Échap** puis sur **Entrée** pour insérer rapidement l'intégralité du nom de la variable.

![Appuyez sur Échap pour compléter automatiquement les noms de variables longs](https://1675407794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FikLsBlZJcwZsqfACFJ5S%2Fuploads%2Fgit-blob-ac96699d8bdd6e0b02227a52d0cccd21433ca5d5%2FScreen%20Recording%202019-06-04%20at%2004.09%20pm.gif?alt=media)

### Renommage des variables

Soulver peut mettre à jour automatiquement les lignes qui font référence à une variable lorsque vous la renommez.

Sur Mac, réglez **Update lines when a variable is renamed** dans **Settings > Variables** sur **Always**, **Ask** ou **Never**. Sur iPad et iPhone, choisissez les mêmes options dans **Settings > Editing > Variable renaming**. Renommez la variable sur sa ligne de déclaration, puis déplacez le curseur sur une autre ligne.

## Points à noter sur les déclarations de variables

#### Les variables doivent être déclarées avant utilisation

Vous ne pouvez pas faire référence à une variable *avant* qu'elle n'ait été déclarée.

Ce comportement est cohérent avec le fonctionnement des variables dans les langages de programmation (mais diffère de Soulver 2).

#### L'arrondi des devises ne s'applique pas aux lignes de déclaration de variables

Lorsque vous déclarez une variable en devise, elle sera affichée **sans arrondissement** afin qu'il ne soit pas ambigu quelle est la valeur réelle stockée dans la variable.

Lorsqu'elle est utilisée sur les lignes suivantes, l'arrondi des devises s'appliquera comme d'habitude.

<figure><img src="https://1675407794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FikLsBlZJcwZsqfACFJ5S%2Fuploads%2Fgit-blob-df66ca68c92b6c1dec43a9654a034d4ccb6437a4%2Fimage%20(12).png?alt=media" alt="" width="563"><figcaption><p>Il est clair quelle est la valeur réelle de "coût par jour"</p></figcaption></figure>

#### Les déclarations de variables peuvent être exclues du total flottant

Utilisez le menu Vue > Options de total pour configurer si le total flottant doit inclure ou exclure les lignes de déclaration de variables.

<figure><img src="https://1675407794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FikLsBlZJcwZsqfACFJ5S%2Fuploads%2Fgit-blob-cd2f6be4c07a60accbaca965d8768fc73d7249d9%2Fimage%20(4)%20(1).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
