> 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/ru/documentation/variables.md).

# Переменные

### Объявление переменных

Объявите переменную с помощью знака равенства '='.

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

Переменная может быть одним словом или целой фразой.

### Глобальные переменные

Объявите переменные в **лист определений**, чтобы сделать их доступными для всех ваших листов и файлов Soulver. Используйте `=` так же, как и для обычной переменной.

На Mac откройте **Settings > Variables** и нажмите **Edit Definition Sheet…**.

Глобальные переменные в таблице определений также могут использовать вычисления с использованием переменных, объявленных над ними.

В Mac вы также можете добавлять глобальные переменные непосредственно в **Settings > Variables** с помощью кнопки **+**.

### Приоритет переменных

Если одно и то же имя переменной определено более чем в одном месте, Soulver использует следующий порядок:

1. **Локальные переменные** объявлен над текущей строкой вашего листа.
2. **Глобальные переменные в настройках.**
3. **Переменные в листе определений.**

Например, если в листе определения установлено значение `discount = 10%`, вы можете использовать `discount = 20%` на конкретном листе, чтобы переопределить его для последующих строк без изменения глобального значения.

### Переопределение переменных

Переменную можно переопределить, присвоив ей новое значение.

Для последующих строк будет использоваться самое последнее заданное значение.

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

#### Переменные можно прибавлять и вычитать

Используйте операторы `+=` и `-=` для изменения значения переменной

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

## Советы по работе с переменными

#### Просмотр значения переменной

На Mac просмотрите значение переменной, удерживая клавишу Shift и наводя курсор на переменную.

<figure><img src="https://3505856693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDLeRZV07lnXN432NWvoc%2Fuploads%2Fgit-blob-9f2384537de4e905201ee4ed27a15c0173088d3f%2Fimage%20(5)%20(1).png?alt=media" alt="" width="158"><figcaption><p>Просмотр значения переменной на Mac</p></figcaption></figure>

На iPad и iPhone выберите переменную, чтобы просмотреть ее значение.

<figure><img src="https://3505856693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDLeRZV07lnXN432NWvoc%2Fuploads%2Fgit-blob-a765b7d87db5425280e152ad0512525656ae74d6%2Fimage%20(6)%20(1).png?alt=media" alt="" width="359"><figcaption><p>Просмотр значения переменной на iPad и iPhone</p></figcaption></figure>

#### Автодополнение имен переменных

Вместо того чтобы вводить длинное имя переменной, вы можете нажать клавишу **escape**, а затем **return**, чтобы быстро вставить все имя переменной.

![Нажмите escape для автодополнения длинных имен переменных](https://3505856693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDLeRZV07lnXN432NWvoc%2Fuploads%2Fgit-blob-ac96699d8bdd6e0b02227a52d0cccd21433ca5d5%2FScreen%20Recording%202019-06-04%20at%2004.09%20pm.gif?alt=media)

### Переименование переменных

Soulver может автоматически обновлять строки, ссылающиеся на переменную, когда вы её переименовываете.

На Mac установите для **Update lines when a variable is renamed** в **Settings > Variables** значение **Always**, **Ask** или **Never**. На iPad и iPhone те же варианты доступны в **Settings > Editing > Variable renaming**. Переименуйте переменную в строке её объявления, затем переместите курсор на другую строку.

## Что следует знать об объявлениях переменных

#### Переменные должны быть объявлены перед использованием

Вы не можете сослаться на переменную *до* того, как она была объявлена.

Это поведение соответствует тому, как работают переменные в языках программирования (но отличается от Soulver 2).

#### Округление валюты не применяется к строкам объявления переменных

Когда вы объявляете переменную в валюте, она будет отображаться **без округления**, чтобы было однозначно, какое фактическое значение хранится в переменной.

При использовании в последующих строках будет применяться обычное округление валюты.

<figure><img src="https://3505856693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDLeRZV07lnXN432NWvoc%2Fuploads%2Fgit-blob-df66ca68c92b6c1dec43a9654a034d4ccb6437a4%2Fimage%20(12).png?alt=media" alt="" width="563"><figcaption><p>Ясно, каково фактическое значение "стоимость за день"</p></figcaption></figure>

#### Объявления переменных можно исключить из общей суммы

Используйте меню View > Total, чтобы настроить, должна ли общая сумма включать или исключать строки объявления переменных.

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