たまに StringScanner を使おうとすると「似てるメソッドがいろいろあるけどどのメソッドで何ができるんだっけ？」「○○がしたいんだけどどのメソッドを使えばいいんだっけ？」となりがちで、一度チートシート的に整理しておきたかったのでした。

「スキャンポインタとは何か？」といったあたりについてはリファレンスマニュアルで説明されていますので、そちらを見てください。

scan_full 系

スキャンポインタの扱いと返り値の種類の組み合わせで4パターン。

この組み合わせは scan_full メソッドの引数 s, f の指定に対応しており、上記の4つのメソッドは scan_full の糖衣のようなメソッドと捉えることができます。

または、「これら4つのメソッドを個別に覚えていなくても scan_full メソッドについて知っていれば用が足りる」という見方もできるかもしれません。

search_full 系

scan_full 系のメソッドとの規則性が見てとれますね。大きなところでは「マッチを試みる位置」が違っています。

scan_full 系のメソッドと同様に、これら4つの組み合わせは search_full メソッドの引数 s, f の指定に対応しています。

(1) 大まかには「マッチさせたい位置」の違いで scan_full 系と search_full 系の2つに分けられる。

(2) 細かく見ると

の組み合わせにより全部で 8 パターンに分けられる。

8パターンの中から用途に応じて使いたいものを選ぶことになります。

たとえば

だったら skip_until または search_full(regexp, true, false) を使えばよいわけです。

たまに StringScanner を使おうとすると「似てるメソッドがいろいろあるけどどのメソッドで何ができるんだっけ？」「○○がしたいんだけどどのメソッドを使えばいいんだっけ？」となりがちで、一度チートシート的に整理しておきたかったのでした。

そのうち書くつもりだったのを @okuramasafumi さんの記事を見て思い出し、よい機会なので書いてみました。

以前 JavaScript で StringScanner みたいなものを使いたくなったことがあって、私も簡単なものを書いたことがありました。

ベタに書くとスキャンポインタなどの状態を操作するコードがロジックのあちこちに散らばって鬱陶しいことになり、それをどうにかしようとすると StringScanner のような別オブジェクトに状態を管理させた方がよい、となるんですよね。オブジェクト指向プログラミングのある種の典型だと思います。