> 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/ja/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://1391542330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI7BDE0UL8yoAyu9oYfUO%2Fuploads%2Fgit-blob-8fa14eed7461f98993322520aaf02259d622d048%2Fimage%20\(2\)%20\(1\).png?alt=media)

## 変数の取り扱いに関するヒント

#### 変数の値の確認（ピーキング）

Macでは、Shiftキーを押しながら変数にカーソルを合わせることで、その変数の値を確認できます。

<figure><img src="https://1391542330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI7BDE0UL8yoAyu9oYfUO%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://1391542330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI7BDE0UL8yoAyu9oYfUO%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://1391542330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI7BDE0UL8yoAyu9oYfUO%2Fuploads%2Fgit-blob-ac96699d8bdd6e0b02227a52d0cccd21433ca5d5%2FScreen%20Recording%202019-06-04%20at%2004.09%20pm.gif?alt=media)

### 変数名の変更

Soulverは、変数の名前を変更したときに、その変数を参照する行を自動的に更新できます。

Macでは、**Settings > Variables** の **Update lines when a variable is renamed** を **Always**、**Ask**、**Never** のいずれかに設定します。iPadとiPhoneでは、**Settings > Editing > Variable renaming** で同じ選択肢を選びます。変数を宣言した行で名前を変更し、カーソルを別の行に移動します。

## 変数宣言に関する注意点

#### 変数は使用前に宣言する必要があります

変数を使用する前に、その変数を参照することはできません。

この動作は、プログラミング言語における変数の動作と一貫していますが（Soulver 2とは異なります）、その点にご注意ください。

#### 通貨の丸め処理は変数宣言行には適用されません

通貨で変数を宣言する場合、その変数が保持している実際の値が曖昧にならないように、**丸め処理なし**で表示されます。

後続の行で使用される場合、通貨の丸め処理は通常通り適用されます。

<figure><img src="https://1391542330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI7BDE0UL8yoAyu9oYfUO%2Fuploads%2Fgit-blob-df66ca68c92b6c1dec43a9654a034d4ccb6437a4%2Fimage%20(12).png?alt=media" alt="" width="563"><figcaption><p>"1日あたりの費用"の実際の値が明確です</p></figcaption></figure>

#### 変数宣言をフローティング合計から除外できる

フローティング合計に変数宣言行を含めるか除外するかを設定するには、View > Total オプションメニューを使用します。

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