キーワード・マーカー
行頭に置く一文字――マーカー――が、その行の運命を決めますの。まずは Pasta DSL の「文字の意味」を覚えていただきますわ。
一文字で運命が決まるとは、まるで占いでございますね。
占い……言われてみれば、そうかもしれませんわね。一文字違えば、その行はまるで別物ですもの。この章は早見表として、手元に置いておくとよろしくてよ。
Pasta DSL は行指向文法であり、行頭の文字(マーカー)によって行の種類が確定する。ここではマーカー・演算子・区切り文字・基本要素を一覧する。すべてのマーカー・演算子・括弧は全角と半角の両方を許容し、両者は同等に扱われる(例外: さくらスクリプトの \ は半角のみ。ローカルシーンのマーカーは ・ と半角の - で、全角の - は使えない)。
全角・半角が同等なのはマーカーとして読むときだけであり、台詞として出力される文字は書いたとおりで、全角・半角の変換はされない。アクション行で @ や $ を文字として出力するには、同じ文字を 2 つ重ねて書く(@@・$$、@@・$$)。重ねた 2 文字目がそのまま出力される(@@ → @、@@ → @、@@ → @)。
マーカー一覧
| マーカー | 全角 | 半角 | 用途 |
|---|---|---|---|
| グローバルシーン | * | * | シーン定義 |
| ローカルシーン | ・ | - | サブシーン定義 |
| アクター辞書 | % | % | アクター辞書の定義・アクター指定行 |
| 属性 | & | & | シーンへの属性(属性)。式の中では連結演算子になる(属性マーカーと連結演算子) |
| 単語/関数 | @ | @ | 単語定義・参照・関数呼び出し。@$ は変数の値による単語参照・関数呼び出し(動的単語参照) |
| 選択肢 | @? | @? | 選択肢行(ジャンプ先+表示テキスト) |
| 変数 | $ | $ | 変数の代入・参照 |
| 代入 | = | = | 変数代入の区切り(アクター指定行の番号指定にも使う)。属性の中の $ で始まる項目では比較(属性の中の比較演算子) |
| Call | > | > | シーン呼び出し。属性の中の $ で始まる項目では比較(属性の中の比較演算子) |
| キューコマンド | ! | ! | 演出指示。!select だけが選択肢の制限時間を設定し、他のコマンドは何もしない |
| コメント | # | # | コメント |
| コロン | : | : | キー:値の区切り |
| さくらスクリプト | (なし) | \ | さくらスクリプトのコマンド(半角のみ) |
台本の言葉で言えば、*・・ の行と、それに付く &・シーンの中の % 行が柱、アクター:台詞 の行が台詞、>・@?・!・$ の行がト書き、インデントなしの %名前 が登場人物である(台本として読む)。
同じ文字の読み分け
&・*・%・=・> は、書く位置で意味が変わる。* と % は行頭ではマーカー、式の中では乗算・剰余の演算子になる(算術演算子)。= と > は、属性の中の $ で始まる項目では比較になる(属性の中の比較演算子)。& の読み分けは次のとおりである。
属性マーカーと連結演算子
& は属性のマーカーと連結演算子で同じ文字を使う。どちらになるかは書く位置で決まる。
| 書く位置 | & の意味 |
|---|---|
行頭の属性行(&名前:値)・シーン宣言行への付記(*会話&作者:Alice) | 属性のマーカー |
| 式の中(変数代入の右辺・式文・関数呼び出しの引数・Call の引数・動的ターゲット) | 連結演算子 |
| アクション行の台詞(継続行を含む) | 文字のまま出力される。ただし台詞の中の関数呼び出しの引数は式なので、連結演算子になる |
| 文字列リテラルの中・単語定義の値・選択肢行・キューコマンドの引数・コメント・属性の値 | 書いたとおりの文字 |
%ぱすた
*会話&ジャンル:日常
&季節:春
$名前=「ぱすた」
$挨拶=「こんにちは、」&$名前
ぱすた:$挨拶 です。$名前&ラザニアです
この例のシーン宣言行の付記 &ジャンル:日常 と属性行 &季節:春 は属性、$挨拶 の代入の右辺の & は連結演算子、台詞の & は文字である。アクション行は「こんにちは、ぱすたです。ぱすた&ラザニアです」と表示される。台詞と関数呼び出しの引数の扱いは 台詞と連結演算子 で扱う。
基本要素
識別子(Identifier)
識別子は Unicode の XID_START または _ で始まり、XID_CONTINUE が続く。ASCII の a-z A-Z 0-9 _、および平仮名・カタカナ・漢字なども使用できる。
__の後に_を含まない文字列が続き、再び__が現れる形で始まる識別子(例:__start__)はシステム予約であり使用できない。- 最長一致で切り出される。空白による区切りがない場合、識別子に含まれない文字が現れるまでを一括して取り込む。
次のアクション行では、単語参照の識別子は 挨拶 までであり、続く 、みんな! は通常のテキストとして出力される。
*会話
ぱすた:@挨拶、みんな!
コロン
コロン(: / :)はキー:値の関係を表す区切り文字である。使われるのは次の箇所。
- 単語定義の名前と値の区切り(
@名前:値) - 属性の名前と値の区切り(
&名前:値) - アクション行のアクター名と台詞の区切り(
アクター:台詞)、継続行の行頭(:台詞) - 引数リストの
名前:値の形の引数 - キューコマンドのスコープ内の
アクター名:名前の区切り
変数の代入には使わない。代入は = で書く($名前=値)。引数どうしの区切りもコロンではなく、読点・カンマ(、 , ,)を使う。
次の例では、1 行目が単語定義、*会話 の配下の 1 行目がアクション行、2 行目が変数代入(コロンではなく =)である。
@word_name:value1、value2
*会話
アクター:こんにちは
$var_name=10
インデント(Indent)
行頭の 1 つ以上の連続した空白。有無のみが判定基準であり、深さは判定しない。インデントなしの行はグローバルレベル(グローバルシーン・アクター辞書・グローバル単語定義など)、インデントありの行はその配下の行である。例は インデントの判定 にある。
改行(NEWLINE)
改行は \r\n / \n / \r のいずれか。行指向文法では改行により行の種類が確定し、すべての行は改行で終わる。
ファイルの最終行も改行で終わらなければならない。最終行が改行で終わっていないと、その行がパースエラーになり、ファイル全体が読み込まれない。エディタ拡張の診断も、pasta_check validate と同じ位置・同じ文でこの誤りを報告する。
空白(WHITE_SPACE)
空白として扱われる文字は次のとおり。改行(\r \n)は空白に含まれず、行の区切りとして機能する。
| 文字 | コードポイント |
|---|---|
| 半角スペース | U+0020 |
| タブ | U+0009 |
| 全角スペース | U+3000 |
| ノーブレークスペース | U+00A0 |
| オガム文字スペース | U+1680 |
| 各種幅のスペース | U+2000〜U+200A |
| 狭いノーブレークスペース | U+202F |
| 中くらいの数学用スペース | U+205F |
上の表に無い文字は空白として扱われない。Unicode で空白に分類される文字でも、U+000B(垂直タブ)・U+000C(改ページ)・U+0085・U+2028・U+2029 は空白ではない。空白は有効なトークン区切り文字であり、自動スキップされるわけではない。
演算子
式で使える演算子は算術演算子と連結演算子であり、比較の演算子は無い(= は代入、> は Call、< は使われない。ただし属性の中の $ で始まる項目では比較になる。属性の中の比較演算子)。条件による分岐は Lua で書く。
算術演算子
| 演算 | 全角 | 半角 |
|---|---|---|
| 加算 | + | + |
| 減算 | - | - |
| 乗算 | * × | * |
| 除算 | / ÷ | / |
| 剰余 | % | % |
* は乗算とグローバルシーンのマーカーで、% は剰余とアクター辞書のマーカーで、同じ文字を使う点に注意する(行頭か式の中かで区別される)。演算子の優先順位と評価のされ方は 変数・スコープ で扱う。
連結演算子
| 演算 | 全角 | 半角 |
|---|---|---|
| 連結 | & | & |
& は左右の被演算子を文字列にしてつなぐ(「合計」&3 は 合計3)。算術演算子より後に計算され、優先順位は *・/・% → +・- → & の順である。評価のされ方は 連結の評価 で扱う。
属性の中の比較演算子
属性の中の $ で始まる項目(&$*経験値≧500)では、次の 6 種が比較の演算子になる。式の中では比較の演算子として使えない。
| 演算 | 全角 | 半角 |
|---|---|---|
| 以上 | ≧ | >= |
| 以下 | ≦ | <= |
| より大きい | > | > |
| より小さい | < | < |
| 等しい | = | = |
| 等しくない | ≠ | != |
書き方は 条件の形 で扱う。
括弧
| 種類 | 全角 | 半角 |
|---|---|---|
| 左括弧 | ( | ( |
| 右括弧 | ) | ) |
単語値の区切り文字
単語定義の値リストは、全角読点(、)・全角コンマ(,)・半角カンマ(,)のいずれかで区切る。区切り文字の前後の空白は無視される。
@fruits:apple、banana、orange
@numbers:1、2、3
マーカー詳細への導線
各マーカーの詳細なセマンティクスは、それぞれ専用の章で扱う。
- 単語・関数
@の用法 → 単語定義 - 変数
$のスコープ修飾 → 変数・スコープ - Call
>のターゲット形式 → Call - アクター辞書
%→ アクター辞書 - さくらスクリプトの
\→ さくらスクリプト - 属性
&・選択肢@?・キューコマンド!→ 行とブロック構造
ね、一覧があれば怖くありませんでしょう? 次は、これらのマーカーが組み合わさる「行とブロック構造」へ参りましょう。
もっとも、覚えるかどうかは読者の方次第でございますが。
……それは、わたくしが言うつもりでしたのに。