![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
#author("2022-12-13T09:47:43+09:00","default:post","post") #author("2022-12-15T20:51:13+09:00","default:post","post") *関数一覧 [#ea945048] ssu+内部関数の一覧。~ Mc157-1よりssu関数が里々内部に統合され、ssuも不要になりました。~ 里々で使うことのできる関数の一覧。~ Mc157-1からssu((里々の関数をまとめたSAORI。初期の里々は多くの関数を外部関数として利用する形式でした。))は里々内部に統合され不要になりました。~ ｜[[構文・コマンド>#category_top]]｜[[ループ>#category_loop]]｜[[条件分岐>#category_bran]]｜[[文字列操作>#category_str]]｜[[文字列調査>#category_chk]]｜[[未分類>#category_misc]]｜ -関数一覧 |LEFT:BGCOLOR(white):|LEFT:|LEFT:SIZE(14):|LEFT:|c |BGCOLOR(#efefef):~関数名|BGCOLOR(#d6d6ea):概説|BGCOLOR(#d6d6ea):参考書式例|BGCOLOR(#d6d6ea):備考&aname(category_top);| |[[calc>#calc]]|計算|（calc,計算式）|| |[[calc_float>#calc]]|~|（calc_float,計算式）|| |[[set>#set]]|変数設定|（set,変数名,値）|| |[[nop>#nop]]|出力の抑制|（nop,引数）|| |[[call>#call]]|関数呼び出し|（call,関数名[,引数n…]）|| |[[vncall>#vncall]]|~|（vncall,関数名[,引数n…]）|Mc158-1| |>|>|>|BGCOLOR(#caf0e6):ループ&aname(category_loop);| |[[loop>#loop]]|ループ&br;[[※特記事項>#loop_w]]|（loop,文または単語群名,ループ回数）&br;（loop,文または単語群名,開始値,終了値[,増分]）|| |[[times>#times]]|~|（times,ループ回数[,開始値],処理）|Mc146-1| |[[while>#while]]|~|（while,条件式[,開始値],処理）|Mc146-1| |[[for>#for]]|~|（for,開始値,終了値[,増分],処理）|Mc146-1| |>|>|>|BGCOLOR(#caf0e6):条件分岐&aname(category_bran);| |[[if>#ifwhen]]|分岐|（if,条件式,真の結果[,偽の結果]）|| |[[when>#ifwhen]]|~|（when,条件式,真の結果[,偽の結果]）|Mc145-1| |[[unless>#unless]]|~|（unless,条件式,偽の結果[,真の結果]）|| |[[iflist>#ifwhenlist]]|複数分岐|（iflist,左辺,右辺１,結果１[,右辺n,結果n…][,偽の結果]）|| |[[whenlist>#ifwhenlist]]|~|（whenlist,左辺,右辺１,結果１[,右辺n,結果n…][,偽の結果]）|Mc156-1| |[[switch>#switch]]|~|（switch,左辺,右辺１,結果１[,右辺n,結果n…][,該当なし]）|| |[[nswitch>#nswitch]]|~|（nswitch,数値,結果１[,結果n…]）|| |>|>|>|BGCOLOR(#caf0e6):文字列操作&aname(category_str);| |[[substr>#substr]]|抽出|（substr,文字列,開始位置[,文字数]）|| |[[at>#at]]|~|（at,文字列,位置）|| |[[split>#split]]|分割|（split,文字列[,区切文字[,最大分割数[,空要素分割可否]]]）|Mc147-4r2| |[[replace>#replace]]|置換|（replace,文字列,検索文字列,置換文字列）|| |[[replace_first>#replace]]|~|（replace_first,文字列,検索文字列,置換文字列）|| |[[erase>#erase]]|削除|（erase,文字列,消去文字列）|| |[[erase_first>#erase]]|~|（erase_first,文字列,消去文字列）|| |[[join>#join]]|接続|（join,区切り文字,文字列１[,文字列n…]）|| |[[reverse>#reverse]]|反転|（reverse,文字列）|| |[[zen2han>#w2con1]]|全角→半角|（zen2han,文字列[,変換タイプ]）|Mc137-1| |[[han2zen>#w2con1]]|半角→全角|（han2zen,文字列[,変換タイプ]）|Mc137-1| |[[kata2hira>#w2con2]]|片仮名→平仮名|（kata2hira,文字列）|| |[[hira2kata>#w2con2]]|平仮名→片仮名|（hira2kata,文字列）|| |>|>|>|BGCOLOR(#caf0e6):文字列調査&aname(category_chk);| |[[compare>#compare]]|比較&br;[[※判定の差異>#d026a1db]]|（compare,文字列,比較文字列）|| |[[compare_head>#compare]]|~|（compare_head,文字列,比較文字列）|| |[[compare_tail>#compare]]|~|（compare_tail,文字列,比較文字列）|| |[[compare_case>#compare_case]]|~|（compare_case,文字列,比較文字列）|Mc150-1| |[[compare_head_case>#compare_case]]|~|（compare_head_case,文字列,比較文字列）|Mc150-1| |[[compare_tail_case>#compare_case]]|~|（compare_tail_case,文字列,比較文字列）|Mc150-1| |[[equal>#equal]]|~|（equal,文字列,比較文字列）|Mc157-1| |[[count>#count]]|検索|（count,文字列,検索文字列）|| |[[length>#length]]|文字数計測|（length,文字列）|| |[[is_empty>#is_empty]]|文字列判定|（is_empty,文字列）|| |[[is_digit>#is_digit]]|~|（is_digit,文字列[,integer]）|| |[[is_alpha>#is_alpha]]|~|（is_alpha,文字列）|| |>|>|>|BGCOLOR(#caf0e6):未分類&aname(category_misc);| |[[choice>#choice]]|ランダム選択|（choice,引数１[,引数n…]）|| |[[lsimg>#lsimg]]|画像数検索|（lsimg,絶対パス）|| |[[mkdir>#mkdir]]|フォルダ作成|（mkdir,絶対パス又はベースウェアからの相対パス）|| |[[remember>#remember]]|スクリプト参照|（remember,参照値）|| |[[sync>#sync]]|同期|（sync,関数名[,引数n…]）|| |[[sprintf>#sprintf]]|フォーマット出力&br;[[※特記事項>#sprintf_doc]]|（sprintf,フォーマット[,引数n…]）|| |[[バイト値>#bytes]]|バイト値出力|（バイト値、１）|| |[[単語の追加>#s_word_ad]]|単語群操作|（単語の追加,単語群名,単語）|| |[[追加単語の削除>#s_word_dl]]|~|（追加単語の削除,単語群名,単語）|| |[[追加単語の全削除>#s_word_ac]]|~|（追加単語の全削除,単語群名）|| |[[合成単語群>#s_word_mc]]|~|（合成単語群,単語群名１[,単語群名n…]）|Mc140-1| |[[load_saori>#load_saori]]|SAORI追加読込| （load_saori,呼び出し名,モジュールパス[,引数n…]）|Mc163-3| ---- #contents ---- *関数解説 [#ff9e065c] **calc / calc_float [#calc] （calc,計算式） （calc_float,計算式） 計算式を計算した結果が返ります。~ calcは小数点以下を無視（切り捨て？）して計算し、calc_floatは小数点以下も計算します。~ ただしこのままだと整数で計算した結果を渡してしまうため、自動計算は無効にしておく必要があります。~ [[if>#ifwhen]]や[[switch>#switch]]などの引数は、暗黙のうちにこれを実行しているようです。~ ＊ ＄SAORI引数の計算【タブ】無効 ：計算するよー。５÷２は（calc_float,５÷２）っ！ ＄SAORI引数の計算【タブ】自動 ↓ 計算するよー。５÷２は2.5っ！ **set [#set] （set,変数名,値） 変数に値を代入します。値が式の場合計算結果が入ります。 ＄変数名＝値 と基本的には同じ。（set,変数名,）と空を代入する事で変数の削除ができる点も同じ。~ 各種[[特殊変数]]への設定についても使用できます。~ 関連→[[変数]]~ 「＄変数名＝値」記法との違い -関数なので文の中でも単語群の中でも使える -変数名や値に区切り文字に使っている文字が含まれていないか注意がいる -値の数値計算は引数の自動計算の仕様に準ずる --つまり特殊変数「[[SAORI引数の計算>特殊変数#hedbd483]]」が無効だと引数は計算されない --計算結果は必ず半角数値となる（＄変数名＝値だと必ず全角数値が代入される） **nop [#nop] （nop,引数） 何も表示しません。~ 具体的には引数に指定したものを括弧ごと非表示にします。~ 使い所は、関数やSAORIの戻り値を捨てる時など。~ 例えば[[split関数>#split]]は分割数を返し、そのままトーク中に使うと処理のあとに分割数を喋ってしまうので、次のようにnopで包んで何も表示しないようにします。~ （nop,（split,一二三四五六七八九）） **call [#call] （call,文または単語群名[,引数n…]） 文または単語群名を引数つきで呼び出します。~ 詳しくは[[call関数]]を参照。~ **vncall [#vncall] [[call>#call]]関数に与える引数を「名前」で与えるバージョンの関数。~ ただしwhenのような引数を解釈するタイミングに違いのある関数を呼び出したケースはサポートしていません。~ ＄v0【タブ】ユーザ名 ＄v1【タブ】ユーザさん （vncall,set,v0,v1） （call,set,（v0）,（v1）） 上のように書くと、呼び出す際に下のイメージで解釈され、v0とv1がその名前の「中身」に置き換えられます。~ 最終的には（set,ユーザ名,ユーザさん）と同じ結果が得られます。~ #br ただし、「最初に引数を区切った後はそれ以降引数を区切らない」というルールがあります。~ これにより里々の区切り文字問題を解決できます。~ たとえばssuのsplit関数を使って文字を「,（カンマ）」で区切りたい場合、普通に呼び出すと「,」が区切り文字として解釈されて期待する結果が得られませんが、vncallで次のように書くと期待通りの結果を得ることが出来ます。 たとえばssuのsplit関数を使って文字を「,（カンマ）」で区切りたい場合、普通に呼び出すと「,」が区切り文字として解釈されて期待する結果が得られませんが、vncallで次のように書くと期待通りの結果を得ることができます。 ＄v0【タブ】区切りたい,文字 ＄v1【タブ】, （vncall,split,v0,v1） *ループ [#loop_w] 里々ではループは構文でサポートされていないので、関数または[[ジャンプ文>ループ処理#bcb72342]]で実現します。~ loop関数のみ昔からある関数で、times,for,while関数は、整備班verで追加された関数です。~ この二つにはループ本文やループカウンタの扱いで下記の差があります。 -ループ本文 --loop関数~ ループ本文を関数外に用意する必要があります、引数として呼出先の[[＊>特殊記号一覧#d0671588]]または[[＠>特殊記号一覧#fbe5f29b]]名を渡します。 --times,for,while関数~ ループ本文を引数として記述出来ます、関数外にループ本文を置く場合は明示的に呼び出す必要があります。 ループ本文を引数として記述できます、関数外にループ本文を置く場合は明示的に呼び出す必要があります。 -ループカウンタ名 （ループ中にループ回数を数えている変数） --loop関数~ （"呼出先の[[＊>特殊記号一覧#d0671588]]または[[＠>特殊記号一覧#fbe5f29b]]名"カウンタ） --times,for,while関数~ [[（Ｃ０）>情報取得変数#s8d0383c]]、多重ループの場合は上位のループカウンタを（Ｃ１）、（Ｃ２）…と参照できます。~ カウンタは0からスタートします。つまりループ一回目は0、二回目は1…という風に増えていきます。~ ループブレイクは loop,for,times関数では出来ません、while関数か[[ジャンプ文によるループ>ループ処理#bcb72342]]を使って下さい。~ ループブレイクは loop,for,times関数ではサポートされていません。while関数か[[ジャンプ文によるループ>ループ処理#bcb72342]]を使って下さい。~ ''&color(#ff0000){[注意]引数区切りについて};''~ times,while,for関数は、括弧の展開を遅らせる仕組みの関係上、~ （バイト値、１）のように''引数区切りを括弧で呼び出すと''、~ （C0）の中身が常に空となり、正しく動作しないようです。~ [[⇒対処法>関数#ebbcd3ea]] **loop [#loop] ある文または単語群を指定回数だけ繰り返し呼び出す関数。~ この関数のみ、ループ本文を文または単語群で書かないといけません。~ （loop,文または単語群名,回数） （loop,文または単語群名,開始値,終了値） （loop,文または単語群名,開始値,終了値,増分） ＊文または単語群名 ループさせたい本文 ループ中は本文に''（[文または単語群名]カウンタ）''という名前の変数が使用できるようになります。~ -&color(#ff0000){回数}; ... [文または単語群名]をループさせる回数です。 -&color(#ff0000){開始値、終了値、増分}; ... カウンタの開始値～終了値を制御します。 --増分は１ループ時に増加するカウンタ量。当然、デフォルトは１です。 --開始値～終了値を設定すると、ループ回数は （ [終了値]－[開始値] ）÷[増分] 回となります。 単語群での使用例 ＊ ：好きな食べ物は （loop,好きな食べ物,３）だよ ＠好きな食べ物 すきやき、 焼肉、 フライドチキン、 焼き鳥、 シャブシャブ、 手羽先、 カウンタとトークでの使用例（ヘッドラインを変数に落とす） ＊installedheadlinename （loop,ＨＬ格納,０,（Ｒの数）） ＊ＨＬ格納 ＄ＨＬ（ＨＬ格納カウンタ）【タブ】（Ｒ（ＨＬ格納カウンタ）） プログラミング的な記述の仕方に慣れている人はloopより[[times>#times]]の方が使いやすいかも。 **times [#times] 指定回数ループを繰り返します。 （times,回数[,カウンタ初期値],ループ本体） 「ループ本体」を「回数」回繰り返し、戻り値を連結して返す。~ プログラムに慣れてる人は[[loop>#loop]]よりこちらの方が分かりやすいかも。~ ＃----loopとtimesの指定方法の違い。どちらも同じものを出力する。 ＊サンプル （loop,ただの幼女好きの犬コロ,３） （times,３,（ただの幼女好きの犬コロ）） ＠ただの幼女好きの犬コロ エンテイ **while [#while] （while,条件式[,カウンタ初期値],ループ本体） 条件式が真（0以外）である限り、ループ本体を繰り返します。結果は連結して返します。~ その性質から''無限ループに陥りやすいので取り扱いは慎重に。''最悪フリーズしたり落ちたりする事も。~ ＊異なる乱数を二つ作る ＄ランダム１【タブ】（乱数０～９） ＄ランダム２【タブ】（乱数０～９） （while,（ランダム１）==（ランダム２）,（set,ランダム２,（乱数０～９））） **for [#for] 指定開始値から増分ずつカウンタを増加させ、終了値迄ループを繰り返します。 （for,開始値,終了値[,増分],ループ本体） カウンタが「開始値」から「終了値」に向かって「増分」ずつ進み、その度に「ループ本体」を繰り返し、結果を連結して返します。~ （C0）も同様に「開始値」から「終了値」に向かって「増分」ずつ進みます。~ 「開始値」が「終了値」より大きい値で「増分」にマイナス値も指定できます。~ loopと構文が入れ替わった感じ。when同様、カッコは事前に評価されない……はず。~ 使用例（ヘッドラインを変数に落とす） ＊installedheadlinename （for,0,（Ｒの数）-1,（ＨＬ格納）） ＊ＨＬ格納 ＄ＨＬ（Ｃ０）【タブ】（Ｒ（Ｃ０）） ＊installedheadlinename （for,0,（Ｒの数）-1,（set、ＨＬ（Ｃ０）、（Ｒ（Ｃ０）））） *条件分岐 [#h27c97dd] **if / when [#ifwhen] （if,条件式,真の結果[,偽の結果]） （when,条件式,真の結果[,偽の結果]） [[条件式>少し詳しい調理方法#dbd3478d]]を評価し、真ならば真の結果を、そうでないなら偽の結果を返します。~ 偽の結果は省略でき、その場合は空を返します。 ＊ ＄たこ数【タブ】（乱数０～３） ：たこが（たこ数）匹釣れました。今日は（if,（たこ数）＞１,大漁,普通）です。 ：（if,（たこ数）＝＝０,普通ってお前、釣れてないだろそれ……。） whenは、ifよりも使いやすいように処理順序が修正された関数です。~ ''迷ったらwhenを使っておけば間違いありません。'' #br もう少し詳しくいうと、里々は&color(red){原則として内側のカッコから順番に展開する};ので、結果に関数などの命令を入れてしまうと条件式に関係なく両方実行されてしまうのです。~ 下記はその例。~ （if,（天気）＝＝晴れ,（set,気分,１）,（set,気分,０）） （when,（天気）＝＝晴れ,（set,気分,１）,（set,気分,０）） |CENTER:BGCOLOR(white):|CENTER:BGCOLOR(white):|c |BGCOLOR(#caf0e6):ifの場合|BGCOLOR(#caf0e6):whenの場合| |「気分」に１をset&br;↓&br;「気分」に０をset&br;↓&br;「天気」が「晴れ」かどうかチェック&br;（チェックするだけ）&br;↓&br;「気分」は常に０になる|「天気」が「晴れ」かどうかチェック&br;↓&br;「天気」が「晴れ」なら「気分」に１をset&br;それ以外は「気分」に０をset| このようにwhenはカッコの展開の順番に手を加え、条件式を評価したあと「真の結果」「偽の結果」の片方だけを展開します。~ ただし、when関数でも区切りを（バイト値、１）のように括弧で呼び出すと、ifと同じ動作になってしまうようです。~ [[⇒対処法>関数#ebbcd3ea]]~ 結果の部分にかっこ付きの処理を書く場合はwhenを、そうでなければどちらを使ってもOKといったところですが、~ 先述したように迷ったらwhenを使えば間違いありません。 **unless [#unless] （unless,条件式,偽の結果[,真の結果]） [[ifやwhen>#ifwhen]]と同じように条件式を評価し、分岐します。~ 違いは条件式の結果が偽なら偽の結果を返し、それ以外で真の結果を返す点（真の結果を省略したら空）。~ つまり偽の結果を先に書きたい時に。 **iflist / whenlist [#ifwhenlist] （iflist,左辺,右辺１,結果１[,右辺２,結果２[…,右辺ｎ,結果ｎ]]） （iflist,左辺,右辺１,結果１[,右辺２,結果２[…,右辺ｎ,結果ｎ]],偽の結果） （whenlist,左辺,右辺１,結果１[,右辺２,結果２[…,右辺ｎ,結果ｎ]]） （whenlist,左辺,右辺１,結果１[,右辺２,結果２[…,右辺ｎ,結果ｎ]],偽の結果） [[if>#ifwhen]]と違う点は、条件式が左右に分かれ、複数の条件を順番に評価する点。~ ifとwhenの違いについては[[if / when>#ifwhen]]を参照のこと。迷ったらwhenlistを使っておけばOKです。~ 順序としては以下のようになります。 +左辺と右辺１を組み合わせた条件式が真 → 結果１が返る~ +左辺と右辺２と組み合わせた条件式が真 → 結果２が返る~ +左辺と右辺３を…以下略~ という風に、組み合わせた条件式を「真だったら結果を返し、偽だったら次の条件式へ」と順番に評価します。~ どの条件式も真にならなかった場合、偽の結果（省略した場合は空）が返ります。~ 左辺と右辺の文字列を単純に結合した結果を数式として取り扱い真偽判定するので、結合した結果が正しい数式となるよう注意してください。~ 通常は''左辺の右端か右辺の左端のいずれかに演算子（＝＝とか）を入れる''必要があります。 （iflist,（現在時）＝＝,６,朝飯,１２,昼飯,１５,おやつ,１７,ディナー） 上の例では演算子を左辺に使っていますが、右辺に使っても動作します。~ **switch [#switch] （switch,左辺,右辺１,結果１[,右辺２,結果２[,右辺n,結果n…]][,該当なし]） 条件並列分岐。左辺も右辺も数値である必要があります。~ [[iflist>#ifwhenlist]]と似ていて、こちらは左辺と右辺が「等しいかどうか」を順番にチェックする簡略的な関数です。~ +左辺と右辺１が等しい → 結果１が返る~ +左辺と右辺２が等しい → 結果２が返る~ +左辺と右辺３を…以下略~ いずれの右辺とも等しくなかった場合は、該当なし（省略した場合は空）を返します。 内部では、 （左辺）＝＝（右辺１） （左辺）＝＝（右辺２） （左辺）＝＝（右辺３） … というふうに数式を使い真偽を判定しているので、左辺・右辺ともに「括弧を展開した結果が数値として扱えるもの」にする必要があります。~ また、上記仕組みのため、iflist/whenlistと比べて、処理速度はほとんど変わらない、単なる簡略表記になります。 ''サンプル：'' ＊ ：今月は（switch、 （現在月）、 １、お正月ですね、 ２、バレンタインデーがあります、 ３、ひなまつりがあります、 ５、こどもの日があります、 ８、夏休みですね、 １２、クリスマスがあります、 特に何もありません）。 **nswitch [#nswitch] （nswitch,数値,結果１[,結果２[…,結果ｎ]]） 数値による分岐。[[switch>#switch]]をさらにシンプルにしたような関数です。~ 数値が１なら結果１を、数値が２なら結果２を…というように、数字順にしたもの。~ 数値に文字列を指定したり、０以下だったり、結果の数より大きい値だったりした場合は空が返ります。~ ＊ ：サイコロを振りました。 （nswitch、（乱数１～６）、一、ニ、三、四、五、六）がでました。 *文字列操作 [#a017707f] **substr [#substr] （substr,文字列,開始位置[,抽出文字数]） 文字列の開始位置から抽出文字数ぶんを取り出します。~ マイナス値も指定可能。~ 開始位置の場合 0 1 2 3 4 5 あいうえおかきくけこ -5-4-3-2-1 長さの場合（開始位置が「か」の場合） 1 2 3 4 5 あいうえおかきくけこ -5-4-3-2-1 （substr,あいうえおかきくけこ,5,3） （substr,あいうえおかきくけこ,5,-3） ↓ かきく うえお **at [#at] （at,文字列,位置） 0から始まる指定文字数目の文字を返します。~ （at,お酒に逃げた,3） ↓ 逃 **split [#split] （split,分割する文字列[,区切文字列[,最大分割数[,空要素分割可否]]]） 文字列を分割し、分割数を返します。~ 分割数がいらない時は[[nop関数>#nop]]とセットで使います。~ -分割された文字列は、[[変数（Ｓ○）>情報取得変数#udf5ebeb]]に順番に格納されます。~ -区切文字列以降を省略した場合、1文字ずつに分割します。~ -最大分割数によって、分割数の上限を指定する事もできます。0を指定すると制限なし。~ -空要素分割可否に1を指定すると、文字列内に区切文字列が連続していている場合は空の要素として分割します。0を指定する、もしくは指定なしの場合は空要素は無視して整頓されます。 （split,栄☆養☆☆補☆給,☆,0,1） ＃splitの戻り値=５ ＃（Ｓ０）栄 （Ｓ１）[空] （Ｓ２）養 （Ｓ３）補 （Ｓ４）給 （split,栄☆養☆☆補☆給,☆,0,0） ＃splitの戻り値=４ ＃（Ｓ０）栄 （Ｓ１）養 （Ｓ２）補 （Ｓ３）給 -また、分割文字列は一文字ごとに判定されます。 （split,焼きイカ風味カルビ味ソイソース,イカ） ＃splitの戻り値=４ ＃（Ｓ０）焼き （Ｓ１）風味 （Ｓ２）ルビ味ソ （Ｓ３）ソース 上記の場合、『焼き』『風味カルビ味ソイソース』ではありません。「イ」「カ」それぞれ一文字で分割されます。~ ×『焼き&color(red){イカ};風味カルビ味ソイソース』~ ○『焼き&color(red){イ};&color(blue){カ};風味&color(blue){カ};ルビ味ソ&color(red){イ};ソース』~ 二文字以上からなる文字列で分割したい場合、あらかじめ[[replace>#replace]]関数で一文字の記号に置換するなどの工夫が必要です。~ #br よくイベントの引数（Ｒ０など）で使用されているバイト値1区切りのデータを分割するのも、[[sprintf>#sprintf]]関数と組み合わせる事で対処できます。~ 様々なデータを取り扱おうと考えると、分割文字列に半角カンマ","がよく使われるので、これで文字列を分割する場合は下記を使います。~ （split,（Ｒ０）,（sprintf,%c,1）） （split、（Ｒ０）、,） 文字列に","や"、"が両方とも含まれる可能性がある場合は、引数区切り文字を新たに定義する事で対応します。使用する文字は文字列中に含まれないと断定可能な文字ならなんでも良いですが通常はバイト値を使用しましょう。~ ＄Ｂ３【タブ】（バイト値、３） ＄引数区切り追加【タブ】（Ｂ３） （split（Ｂ３）（Ｒ０）（Ｂ３）（バイト値、１）） ＄引数区切り削除【タブ】（Ｂ３） [[特殊変数]]の引数区切り参考。~ **replace / replace_first [#replace] （replace,文字列,検索文字列,置換文字列） （replace_first,文字列,検索文字列,置換文字列） 文字列の中にある、検索文字列を置換文字列で全て置き換えます。~ replace_firstは最初の候補ひとつだけ置換します。~ （replace,なまむぎなまごめなまたまご,なま,生） ↓ 生むぎ生ごめ生たまご （replace_first,なまむぎなまごめなまたまご,なま,生） ↓ 生むぎなまごめなまたまご **erase / erase_first [#erase] （erase,文字列,消去文字列） （erase_first,文字列,消去文字列） 文字列の中にある、消去文字列を全て消します。 ~ erase_firstは最初の候補ひとつだけ消去します。~ （erase,なまむぎなまごめなまたまご,なま） ↓ むぎごめたまご （erase_first,なまむぎなまごめなまたまご,なま） ↓ むぎなまごめなまたまご **join [#join] （join,区切り文字,文字列１[,文字列n…]） 引数の文字列１～ｎを区切り文字で連結したものが返ります。~ （join,と,汗,涙,酒） ↓ 汗と涙と酒 **reverse [#reverse] （reverse,文字列） 文字列を前後反転して返します。~ （reverse,文字列） ↓ 列字文 **zen2han / han2zen [#w2con1] （zen2han,文字列[,変換タイプ]） （han2zen,文字列[,変換タイプ]） zen2hanは文字列の中にある「数字、アルファベット、カナ、一部の記号」を全角から半角に変換します。~ han2zenは逆に半角を全角に変換します。~ 変換タイプは変換する文字の種類を指定でき、「数字」「アルファベット」「カナ」「記号」から複数指定・任意の組み合わせができます。~ 指定は空白等適当な文字で区切って行い、指定したタイプのもののみ変換されます。省略時は全てが対象です。~ **kata2hira / hira2kata [#w2con2] （kata2hira,文字列） （hira2kata,文字列） kata2hiraは文字列の中にあるカタカナをひらがなに、hira2kataはひらがなをカタカナに変換します。~ *文字列調査 [#d026a1db] -''文字列比較関数の挙動の違い''~ compare、compare_case、equalは大文字・小文字、半角・全角を同一視するかどうかで違います。 |LEFT:BGCOLOR(white):|CENTER:BGCOLOR(white):|CENTER:BGCOLOR(white):|CENTER:BGCOLOR(white):|c ||BGCOLOR(#caf0e6):compare|BGCOLOR(#caf0e6):compare_case|BGCOLOR(#caf0e6):equal| |BGCOLOR(#d6d6ea):大文字・小文字を同一視|する|しない|しない| |BGCOLOR(#d6d6ea):半角・全角を同一視|する|する|しない| -例示~ |LEFT:BGCOLOR(white):|CENTER:BGCOLOR(white):|CENTER:BGCOLOR(white):|CENTER:BGCOLOR(white):|SIZE(14):|c |BGCOLOR(#d6d6ea):CENTER:比較例|BGCOLOR(#caf0e6):compare|BGCOLOR(#caf0e6):compare_case|BGCOLOR(#caf0e6):equal|※備考| |BGCOLOR(#d6d6ea):ABC012,Ａｂｃ０１２|1|0|0|英数字の半角/全角/大文字/小文字が異なる| |BGCOLOR(#d6d6ea):ABC012,Abc０１２ |1|0|0|数字の半角/全角、英字の大文字/小文字が異なる| |BGCOLOR(#d6d6ea):ABC012,Ａｂｃ012 |1|0|0|英字の半角/全角/大文字/小文字が異なる| |BGCOLOR(#d6d6ea):ABC012,Abc012 |1|0|0|英字の大文字/小文字が異なる| |BGCOLOR(#d6d6ea):ABC012,ＡＢＣ０１２|1|1|0|英数字の半角/全角が異なる| |BGCOLOR(#d6d6ea):ABC012,ABC０１２ |1|1|0|数字の半角/全角が異なる| |BGCOLOR(#d6d6ea):ABC012,ＡＢＣ012 |1|1|0|英字の半角/全角が異なる| |BGCOLOR(#d6d6ea):ABC012,ABC012 |1|1|1|混在なし、完全一致文字列| |BGCOLOR(#d6d6ea):アガペー,ｱｶﾞﾍﾟ- |1|0|0|※半角長音はハイフン「-」で同一視&br;「ー」を半角化した「ｰ」は不可| |BGCOLOR(#d6d6ea):アガペー,ｱｶﾞﾍﾟｰ |0|0|0|~| **compare / compare_head / compare_tail [#compare] （compare,文字列,比較文字列） （compare_head,文字列,比較文字列） （compare_tail,文字列,比較文字列） 文字列と比較文字列が一致していれば1（真）、そうでないなら0（偽）を返します。~ この関数による比較は、大文字・小文字、半角・全角を同一と見なす特性があります。~ （compare,ABC,ABC） （compare,ABC,ＡＢＣ） （compare,ABC,abc） （compare,ＡBCﾀﾞ,ＡbＣダ） 上記の実行結果はいずれも1となります。~ compare_headは「文字列の''先頭に''比較文字列が含まれているか」~ compare_tailは「文字列の''末尾に''比較文字列が含まれているか」~ をそれぞれ判定します。~ **compare_case / compare_head_case / compare_tail_case [#compare_case] （compare_case,文字列,比較文字列） （compare_head_case,文字列,比較文字列） （compare_tail_case,文字列,比較文字列） 半角と全角を同一視しますが、大文字・小文字を同一視しない[[compare>#compare]]関数です。~ compare_head_case、compare_tail_caseもそれぞれ準じます。~ **equal [#equal] （equal,文字列,比較文字列） より正確な比較。~ 半角・全角も、大文字・小文字も同一視せず、完全に一致した場合のみ1（真）、そうでないなら0（偽）を返します。 **count [#count] （count,文字列,検索文字列） 文字列の中に、検索文字列がいくつ含まれているかを返します。~ 条件式に使えば、単純に「検索文字列が存在するかどうか」の判定としても使えます。~ 「なまむぎなまごめなまたまご」の中に 「なま」は（count,なまむぎなまごめなまたまご,なま）個入っています。 ↓ 「なまむぎなまごめなまたまご」の中に 「なま」は3個入っています。 **length [#length] （length,文字列） 文字列の文字数を返します。バイト数ではないので注意。~ （length,台風99号） ↓ 5 **is_empty [#is_empty] （is_empty,文字列） 文字列が空文字列であるかを判定。空文字列なら1（真）、そうでないなら0（偽）を返します。~ たぶん想定される使い方は下。~ [[（変数「○○」の存在）>情報取得変数#jc763ebc]]と同じ？ （is_empty,（確認したい変数名）） **is_digit [#is_digit] （is_digit,文字列[,integer又は整数]） 文字列が数値であるかを判定し、数値なら1（真）、そうでないなら0（偽）を返します。~ 小数点一つまでは数値だと判定されます。~ また、下記のどちらかの記述で、引数が整数の場合のみ1（真）を返すようになります。~ （is_digit,引数,integer） （is_digit,引数,[整数]） **is_alpha [#is_alpha] （is_alpha,文字列） アルファベットの文字列であれば1（真）、そうでないなら0（偽）を返します。~ *未分類 [#r2a0d898] **choice [#choice] （choice,引数１[,引数n…]） 指定した全ての引数からランダムに１つを選んで返します。~ ＊ ：何が釣れた？ ：（choice,鯛,イワシ,鮫,くじら,長靴）が釣れたよ。 **lsimg [#lsimg] （lsimg,絶対パス） 指定パスのフォルダ内にある画像ファイルの数を調べる？~ **mkdir [#mkdir] （mkdir,絶対パスorベースウェアからの相対パス） フォルダを作成し、成功したら1、失敗したら0を返します。~ ＊フォルダ作成 ＞成功【タブ】（mkdir,ghost\satori\ghost\master\新規フォルダ）==1 ：失敗したみたい…。 ＊成功 ：新規フォルダをつくったよ。 **remember [#remember] （remember,参照値） 過去に話したランダムトークの内容を取得？~ 参照値は0スタートで、（remember,0）で直前になります。~ **sync [#sync] （sync,関数名[,引数n…]） 処理をしゃべりと同期します。SAORIを任意のタイミングで発動させたい時に。~ **sprintf [#sprintf] （sprintf,フォーマット[,引数n…]） 引数１～ｎをフォーマットに従って変換したものを返します。~ フォーマットは下記のように、「%」から始まる「フォーマット指定子」を含む文字列で、フォーマット指定子の出現順と対応する順序の引数がフォーマット指定子の出力の元となります。~ （sprintf,%02d月%02d日,１２,３） **フォーマット指定子 [#sprintf_doc] ''基本の書きかた''~ %[フラグ指定][最小幅指定][.精度指定][出力指定] 出力指定以外は省略可能 出力指定以外は省略可能。 ''フラグ指定''~ |指定|説明|h |+|常に正負符号を表示する| |-|最小幅に足りない分だけ末尾を半角スペースで埋める（左詰）| | ((半角スペース。))|最小幅に足りない分だけ先頭を半角スペースで埋める| |0|最小幅に足りない分だけ先頭を0で埋める| |#|代替形式。後述| 複数続けて指定できる（競合する場合は後に書いた方優先）~ 「0」「 」の「先頭」は、正負符号がある場合はその後ろ~ 全角文字は2幅分と数える~ ＃出力結果：ユーザ 様 （sprintf,%-10s様,ユーザ） ＃出力結果：1234年05月06日 （sprintf,%04d年%02d月%02d日,１２３４,５,６） ＃出力結果：-1+3は？ （sprintf,%+d%+dは？,－１,＋３） ＃出力結果：- 12 （sprintf,% 5d,-１２） ''最小幅指定''~ 文字列の最小幅（最小文字数）を指定できる~ 数字を入れる場合、正負符号や小数点「.」も数えることに注意~ フラグ指定と合わせて用いる~ ＃出力結果： -12 ＃フラグ「 」を指定した場合と異なり空白は符合よりも前 （sprintf,%6d,－１２） ＃出力結果：-012 （sprintf,%04d,－１２） ''精度指定''~ 「.」に続けて実数の有効桁数が指定できる~ ＃出力結果：3.142 （sprintf,%1.3f,３．１４１５２９） ''出力指定'' |指定|対応する引数|説明|引数「６３」の出力例|h |s,S|全て|文字列をそのまま表示（sもSも同じ）|６３| |c,C|整数|指定した10進整数に対応する文字を表示（cもCも同じ）|?| |d,u|実数|10進整数で表示（dは符号なし、uは符号付き）|63| |o,i|実数|8進整数で表示（oもiも同じ）|77| |x,X|実数|16進符号なし整数で表示（xは小文字表記、Xは大文字表記）|3f| |f|実数|実数を少数形式（固定小数点による標準記法）で表示|63.000000| |e,E|実数|実数を指数形式（科学的記法）で表示（eは小文字表記、Eは大文字表記）|6.300000+e001| |g,G|実数|f,eのうち適した方の形式で表示（gは小文字表記、Gは大文字表記）|63.000000| ''フラグ「#」の代替形式について''~ 変換指定に応じて意味が変わる~ ''o,x,Xの場合''：基数を明確にする~ ''f,e,E,g,Gの場合''：常に小数点を表示~ ''他''：無視される~ ＃出力結果：0XA （sprintf,%#X,１０） ''補足''~ 引数の番号指定はできない~ **バイト値 [#bytes] （バイト値、１） こう書くとバイト値1が簡単に得られます。~ バイト値1が得られます。主に引数の区切りなどで利用します。~ ほかにバイト値３なども同じ書き方で得ることができます。~ １だとメールを処理する時の分割子がバイト１なので、リプレイスとかでバグる可能性あり。~ １ではないものを推奨する、が、０とか入れると大変なことになるらしい。~ １だとメールを処理する時の分割子がバイト１なので、リプレイスとかでバグる可能性に注意して下さい。~ １ではないものを推奨する、が、０とか入れると大変なことになるらしい？~ 分割子は自分でも設定できるので、使わない記号が一番安全かも。~ ''&color(#ff0000){[注意]when,times,while,forについて};''~ これらの関数は、引数内の括弧を展開するタイミングを遅らせる仕様の関係から、~ （バイト値、１）などの関数が実行されるタイミングも遅れてしまうので、~ （バイト値、１）で引数を区切ろうとしても、正しく認識されないようです。~ whenはifと同じ処理になり、ループ系の関数は（C0）が常に空になります。~ [[⇒対処法>関数#ebbcd3ea]] **単語の追加 [#s_word_ad] （単語の追加,単語群名,単語） ＠単語群名に「単語」を追加する。該当する単語群名が無ければ新規に作成する。~ 追加された単語の情報はsatori_savedata.txtに保存される。~ ＠単語群名に「単語」を追加します。該当する単語群名が無ければ新規に作成します。~ 追加された単語の情報はsatori_savedata.txtに保存されます。~ （単語の追加、果物、バナナ） ＠果物 りんご 単語群「果物」に「バナナ」を追加する。 単語群「果物」に「バナナ」を追加します。 **追加単語の削除 [#j6416b0b] （追加単語の削除、単語群名、単語） [[単語の追加>#s_word_ad]]で追加した単語を削除する。 [[単語の追加>#s_word_ad]]で追加した単語を削除します。 **追加単語の全削除 [#s_word_dl] （追加単語の全削除、単語群名） [[単語の追加>#s_word_ad]]で追加した単語を全て削除する。 [[単語の追加>#s_word_ad]]で追加した単語を全て削除します。 **合成単語群 [#s_word_mc] （合成単語群,単語群名１[,単語群名n…]） 指定した単語群名を全部候補としてランダムに一つ選ぶ。 指定した単語群名を全部候補として、その中からランダムに一つ選んで返します。 （合成単語群、果物、野菜、海産物） ＠果物 りんご みかん ＠野菜 にんじん じゃがいも ＠海産物 いか たこ 「りんご」「みかん」「にんじん」「じゃがいも」「いか」「たこ」のどれか一つが選ばれる。 上の例では「りんご」「みかん」「にんじん」「じゃがいも」「いか」「たこ」のどれか一つが選ばれます。 **load_saori [#load_saori] （load_saori,呼び出し名,モジュールパス[,引数n…]） satori_conf.txt に書いていないSAORIを関数実行時にロードすることができる。~ satori_conf.txt に書いていないSAORIを関数実行時にロードすることができます。~ 引数はsatori_conf.txt に記載の順番で記述。~ ロードするタイミングがロードするかどうかを制御したい場合に使用するとよい。~ 一度ロードしたSAORIは、satori_conf.txt に書かれているSAORIと同じタイミングでアンロードされる。 ロードするタイミングがロードするかどうかを制御したい場合に。~ 一度ロードしたSAORIは、satori_conf.txt に書かれているSAORIと同じタイミングでアンロードされます。
