# 文字列

このページ: https://emojicode-ide.com/docs/basics/strings/

文字列は `🔤` で挟んで書きます。型は `🔡` です。

## 値を埋め込む（🧲）

文字列の中で `🧲` と `🧲` に挟んだところには、変数や式の値が入ります。

```emojicode
🏁 🍇
  🔤えもじ🔤 ➡️ name
  😀 🔤こんにちは、🧲name🧲 さん🔤❗️
  😀 🔤1 ➕ 2 は 🧲1 ➕ 2🧲🔤❗️
  😀 🔤半分は 🧲1.5🧲🔤❗️
🍉
```

出力:

```text
こんにちは、えもじ さん
1 ➕ 2 は 3
半分は 1.500000
```

`🧲` に入れられるのは、文字列にできる型の値です。文字列・整数・実数は入りますが、真偽値やリスト、オプショナルはそのままでは入りません。実数は小数点以下 6 桁まで出るので、桁を決めたいときは、下の「数との変換」の `🔡 実数 桁数❗️` で文字列にしてから入れます。

コンパイルエラーになる例:

```emojicode
🏁 🍇
  🔢 🔤12🔤 10❗️ ➡️ n
  😀 🔤n は 🧲n🧲🔤❗️
🍉
```

エラー:

```text
is not compatible to
```

オプショナルは、中身を取り出してから入れます（[オプショナル](https://emojicode-ide.com/docs/basics/optionals.md)）。自分で作った型も、`❗️ 🔡 ➡️ 🔡` を用意してプロトコル `↘️🔸🔡` を守れば、`🧲` に入れられます（[プロトコル](https://emojicode-ide.com/docs/types/protocols.md)）。

## 特別な文字（❌）

改行やタブ、`🔤` そのものなどを文字列の中に書くときは、前に `❌` をつけます。

| 書き方 | 意味 |
|---|---|
| `❌n` | 改行 |
| `❌t` | タブ |
| `❌🔤` | `🔤` という文字 |
| `❌🧲` | `🧲` という文字 |
| `❌❌` | `❌` という文字 |

```emojicode
🏁 🍇
  😀 🔤1 行目❌n2 行目🔤❗️
  😀 🔤❌🔤 で文字列、❌🧲 で埋め込み🔤❗️
🍉
```

出力:

```text
1 行目
2 行目
🔤 で文字列、🧲 で埋め込み
```

## 数との変換

### 数 → 文字列

整数は `🔡 数❗️` で 10 進数の文字列になります。2 つ目の引数で基数（何進数か）を選べます。

```emojicode
🏁 🍇
  😀 🔡 255❗️❗️
  😀 🔡 255 16❗️❗️
  😀 🔡 255 2❗️❗️
🍉
```

出力:

```text
255
ff
11111111
```

実数は `🔡 数 桁数❗️` で、小数点以下を何桁まで出すかを選びます。

```emojicode
🏁 🍇
  😀 🔡 2.5 1❗️❗️
  😀 🔡 2.5 3❗️❗️
🍉
```

出力:

```text
2.5
2.500
```

> 実数を文字列にするとき、指定した桁より下は **四捨五入ではなく切り捨て** になります（`🔡 3.05 2❗️` が `3.04` になることもあります）。公式コンパイラのバグです。詳しくは [Emojicode言語のバグ](https://emojicode-ide.com/docs/about/known-issues.md) を見てください。

### 文字列 → 数

`🔢 文字列 基数❗️` で、文字列を整数に変えます。

文字列が数として読めないこともあるので、結果は「整数か、値なし」を表す `🍬🔢`（オプショナル）になります。中身を取り出すには `↪️ … ➡️ 名前` を使います。

```emojicode
🏁 🍇
  ↪️ 🔢 🔤42🔤 10❗️ ➡️ n 🍇
    😀 🔡 n ➕ 1❗️❗️
  🍉
  ↪️ 🔢 🔤よんじゅうに🔤 10❗️ ➡️ n 🍇
    😀 🔤ここには来ない🔤❗️
  🍉
  🙅 🍇
    😀 🔤数ではなかった🔤❗️
  🍉
🍉
```

出力:

```text
43
数ではなかった
```

`↪️` と `🙅` は条件分岐（if と else）です。オプショナルは、のちの章でくわしく扱います。

## よく使うメソッド

| 書き方 | 結果 |
|---|---|
| `📫 文字列❗️` | 大文字にする |
| `📪 文字列❗️` | 小文字にする |
| `🔪 文字列 開始 長さ❗️` | 一部を取り出す（位置と長さは見た目の 1 文字単位） |
| `🔧 文字列❗️` | 前後の空白を取り除く |
| `🔫 文字列 区切り❗️` | 区切りで分けて、リスト（`🍨🐚🔡🍆`）にする |
| `🔍 文字列 探す文字列❗️` | 見つかった位置（`🍬🔢`） |
| `🎼 文字列 先頭❗️` / `⛳️ 文字列 末尾❗️` | その文字列で始まる / 終わるか（`👌`） |

```emojicode
🏁 🍇
  😀 📫 🔤emojicode🔤❗️❗️
  😀 🔪 🔤🍎🍌🍇🍑🔤 1 2❗️❗️
  😀 🔧 🔤  まわりの空白  🔤❗️❗️
  ↪️ 🎼 🔤🍇🍉🔤 🔤🍇🔤❗️ 🍇
    😀 🔤🍇 で始まる🔤❗️
  🍉
🍉
```

出力:

```text
EMOJICODE
🍌🍇
まわりの空白
🍇 で始まる
```

`🔪` の位置は 0 から数えます。`🍎🍌🍇🍑` の 1 番目から 2 文字なので `🍌🍇` です。絵文字が複数のコードポイントでできていても、見た目の 1 文字として数えます。

> `📐 文字列❗️` は文字数ではなく、UTF-8 での **バイト数** を返します。`📐 🔤えもじ🔤❗️` は 9 です。

## 文字列の比較

`🙌` で、2 つの文字列が同じかどうかを比べます。

```emojicode
🏁 🍇
  🔤abc🔤 ➡️ a
  ↪️ a 🙌 🔤abc🔤 🍇
    😀 🔤同じ🔤❗️
  🍉
🍉
```

出力:

```text
同じ
```
