ssu（同梱 SAORI）¶

ssu は里々に同梱されている文字列・計算・条件分岐用のユーティリティです。（calc、1+2） のように、里々の （） の中から関数として呼び出します。

関数をまとめて見渡したいときは、チートシートの早見表も使えます。

呼び出し方¶

里々（satori.dll）は ssu を内蔵しており、SAORI を経由せずに直接呼び出します。satori_conf.txt に SAORI の登録を書く必要はありません。

＊自己紹介
（sprintf、%05d、42）→（substr、あいうえお、1、2）

• 呼び出し名は下の一覧の名前です。里々起動時に、一覧にある名前がすべて 名前,saori/ssu.dll,名前 として自動登録されます。
• 同じ名前を ＠SAORI で自分で登録していた場合は、そちらが優先されます。
• 引数の区切りは , 、 ､ ， とバイト値 1 のどれでも構いません。詳しくは引数区切りを参照してください。

ssu.dll を単体の SAORI として呼び出すこともできます（ssu.dll を SSU_SAORI_CALL_INTERFACE を定義してビルドしたもの）。その場合は最初の引数（Argument0）が関数名になり、以降が引数になります。応答の Charset は常に UTF-8 です。

引数の計算¶

（） から SAORI（ssu を含む）を呼び出すときは、里々が引数を先に計算することがあります。＄SAORI引数の計算で切り替えられます。

計算は「厳密モード」で行われます。数値の式（1+2 など）だけが対象で、文字列の連結や削除などが必要な式は計算されず、そのまま渡されます。計算結果は半角数字です。

そのため、（calc_float、5/3） は 5/3 が先に整数で計算されて 1 になり、1.666667 にはなりません。小数を計算するときは ＄SAORI引数の計算＝無効 にしてください。

戻り値とエラー¶

• 正常に処理できた場合は、結果の文字列が （） の展開結果になります。
• 結果がない場合（204 No Content）は空文字列になります。
• 引数の数が合わないなどのエラー（400 Bad Request）の場合は、エラーメッセージがそのまま展開結果になり、エラーログにも出力されます（内蔵の ssu を使っているとき、ログの DLL のパスは Mc201-6以降 (internal ssu) と表示されます）。
• 結果に （） が含まれていると、もう一度展開されます。
• 複数の値を返す関数（split など）の値は、システム変数 （S0） （S1）…、個数は （Sの数） で参照します。（S0） などを上書きせずに分割したいときは、内蔵関数の split_to を使います。

文字の数え方¶

ssu は文字数を「文字」単位で数えます。サロゲートペアの文字（絵文字や「𠮷」など）は 1 文字です（Unicode 版）。

関数一覧¶

計算¶

条件分岐¶

文字列の切り出し・分割・結合¶

置換・削除・数え上げ¶

正規表現（Mc203-1以降）¶

書き方は 正規表現の書き方 を参照してください。

比較・判定¶

変換・整形¶

その他¶