中級

byte index is not a char boundary パニックの原因と直し方

Rustの文字列はUTF-8のバイト列として保持されており、日本語のようなマルチバイト文字の途中の位置でスライスしようとするとパニックします。文字単位で扱いたい場合はcharsなどのイテレータを使う必要があります。

エラーメッセージの読み方

thread 'main' panicked at main.rs:3:19:

main.rs

ファイル名

3

行番号 — 実際にクラッシュした行

19

列番号

panicked

パニック — 実行時に回復不能な状態になったことを示します。tryやResultで捕まえない限り、そのままプロセスが終了します

byte index 1 is not a char boundary; it is inside 'こ' (bytes 0..3) of `こんにちは`

詳細メッセージ — どの値が問題だったか

このエラーが出る典型パターン

 1  fn main() {
 2      let s = String::from("こんにちは");
 3      let slice = &s[0..1];
                          ^
 4      println!("{}", slice);
 5  }

 1  fn main() {
 2      let s = String::from("ありがとう");
 3      let slice = &s[0..2];
                          ^
 4      println!("{}", slice);
 5  }

 1  fn main() {
 2      let s = String::from("すし");
 3      let slice = &s[0..1];
                          ^
 4      println!("{}", slice);
 5  }

 1  fn main() {
 2      let s = String::from("ねこ");
 3      let slice = &s[0..2];
                          ^
 4      println!("{}", slice);
 5  }

 1  fn main() {
 2      let s = String::from("さくら");
 3      let slice = &s[0..1];
                          ^
 4      println!("{}", slice);
 5  }

よくある誤解

「文字列のスライスは英語と同じように1文字＝1バイトとして数えられるはず」という思い込みは誤りです。UTF-8ではマルチバイト文字の内部にバイト境界があり、その途中を指定するとパニックします。

まとめ

byte index is not a char boundary パニックの原因と直し方は中級でつまずきやすい項目です。上の5パターンを実際に手で直すと、エラーメッセージのどこを読めばよいかが掴めます。

演習をはじめる

関連するエラー

• range end index out of range for slice パニックの原因と直し方配列やVecをスライスする際、範囲の終端が要素数を超えているとパニックします。
• index out of bounds パニックの原因と直し方存在しない添字でVecや配列にアクセスすると、コンパイルは通りますが実行時にパニックしてプログラムが異常終了します。