「Thyme講座」の編集履歴（バックアップ）一覧はこちら
Thyme講座 - (2010/08/20 (金) 05:07:44) の１つ前との変更点
追加された行は緑色になります。
削除された行は赤色になります。
#contents(,option=word)
*&bold(){Thyme講座}
Thymeは初心者やプログラム経験のない方にとっては敷居が高い。思いつきではあるが、ここにThyme講座を書きなぐっていきたいと思う。&br;
尚思いつきかつ、筆者も独学にちかい部分があるため、不明瞭な部分や間違い等があると予想される。&br;
そのような部分を発見した場合、コメントにて指摘いただけるとありがたい。&br;
&br;
*なにはともあれ書き方と例文
まずスクリプトがどのようなものなのか、見ていただこう。&br;
&br;
物質のテキスト文章部分にシミュレーション開始からの経過時間を表示させるスクリプト
text = { "" + sim.time };
&br;
常に物質の色を変え続けるスクリプト
color = { [ sim.time % 1.0 , sim.time * 0.5 % 1.0 , sim.time * 0.3 % 1.0 , 1.0 ] };
このような１処理分の塊を「式」という。
式１つは「○○○ = ○○○」の形をとる。
ただし、スクリプトメニューをよく見ると「text =」や「color =」はすでに記述されている。(項目名の部分)&br;
つまり、１つ目を例を実際に使用したい場合は「{ "" + sim.time }」を「text =」項目の内容部分に記述すれば良い。
尚、各例文の最後についてある「；」は「式がここで終わり」という意味の記号である&br;
１つの式のみをスクリプトメニューに記載した場合、決定した時に「;」が消えてしまうが、これはPhunの仕様である。&br;
どうやら、「式の数にかかわらず、最後の；は省略する」というルールが存在しているようである。&br;
この解説においては、式の数にかかわらず；を表記すると、断りを入れておく。
&br;
*基礎的なあれこれ
**§いつどこでどのようにスクリプトが動くのか
Thymeスクリプトを実行出来る場所は2箇所ある。
+F11キーを押して現れるコンソール画面への直接入力
+物質を選択後、メニューの「スクリプトメニュー」内の各属性値への記述
[[スクリプト言語Thyme]]のページには、onCollide属性内以外への記述については特に述べられていないが&br;
書式さえ守ればどの属性内にも直接スクリプトを記述できる。
onCollide以外の属性へ書き込む場合の注意点としては以下の２つ。
+「{ (スクリプト内容) }」の形式で書き込むこと（{ }で囲む）
+各属性ごとに決められているデータ型と、スクリプトが出力する値の型を合わせる事
どちらかの条件が満たされていない場合、書き込んだあとに決定しても編集前の状態に戻ってしまう。
----
**§値と変数
式に用いる数値や文字のことを総称して値(あたい)と言う。値には定数と変数の2種がある。
-定数とは「値が固定されているもの」であり、明確に数値が表記されているものである。
-変数とは「名前の付けられた箱」であり、その中に入っている値を変更できるものである。
以下に例として4行の計算を示し、解説をする。
|CENTER:80|100|220|c
|行番号|CENTER:内容|CENTER:説明|
|1行目|x := 3;|ｘという変数を内容「 3 」で作成|
|2行目|x = x + 4 - 5;|ｘに『 x + 4 - 5 』の計算結果を入れる|
|3行目|y := x + x;|ｙという変数を内容『 x + x 』で作成|
|4行目|y = x + y;|ｙに『 x + y 』の計算結果を入れる|
&bold(){1行目}&br;
x := 3;
「ｘを３という内容で作成します」という意味の式。&br;
変数を始めに作成する演算子「:=」を用いている。&br;
変数には必ず初期値が必要であり、この場合は「3」である。&br;
&bold(){2行目}&br;
x = x + 4 - 5;
「ｘに『 x + 4 - 5 』の計算結果を入れる」という意味の式。&br;
変数の値を変更する演算子「=」を用いている。&br;
ｘの値は３であるため『x+4-5』は２となり、ｘの値が２に変更される。&br;
&bold(){3行目}&br;
y := x + x;
「ｙという変数を内容『 x + x 』で作成します」という意味の式。&br;
初期値に「すでに作成済みである変数を用いた計算式」を使用しても問題ない。&br;
つまりこの式は「 y := 2 + 2; 」と同義であり、ｙの初期値は４になる。&br;
&bold(){4行目}&br;
y = x + y;
「ｙに『 x + y 』の計算結果を入れる」という意味の式。&br;
ｘは２でありｙは４であるため、この式は「ｙ＝ 2 + 4;」と同義である。&br;
結果としてｙの値は６になる。&br;
-注意事項
実際に変数を作成し使用する際には、変数名の前に「Scene.my.」をつけなければならない。&br;
この決まりに従って上記の例を実際に使用する場合、以下のようになる&br;
Scene.my.x := 3;
Scene.my.x = Scene.my.x + 4 - 5;
Scene.my.y := Scene.my.x + Scene.my.x;
Scene.my.y = Scene.my.x + Scene.my.y;
&br;
----
***配列
変数の種類として「配列」がある。&br;
変数は１つに対して１つの値しか持てないが、配列は複数個の値を持つことが出来る。&br;
イメージとしては「１つの名前を共有する複数の箱があり、それは番号で区別される」といったものである。&br;
実際に配列を使用している例を以下に示す。&br;
Scene.my.x := [ 1 , 5 , 10 , 999 , 7 ];
Scene.my.y := Scene.my.x(0);
Scene.my.z := Scene.my.x(2) + Scene.my.x(3);
順を追って解説していこう。&br;
-1行目 ここでScene.my.xという配列を作成している。
--配列を作る際の書式は「 変数名 := [ 配列の内容 ]; 」である。&br;
-2行目 変数Scene.my.yを作成し、その内容としてScene.my.xの0番目を指定している。
--配列の内容を指定する書式は「 変数名(番号) 」である。&br;
--この際注意する点は「番号は0から始まる」ということである。つまり、Scene.my.xの中身は0～4番までの5つ存在する。&br;
-3行目 変数Scene.my.zを作成し、その内容として「Scene.my.xの2番目と3番目を加算した値」を指定している。
--Scene.my.xの2番目は10、3番目は999であるため、Scene.my.zの値は1009となる。&br;
&br;
----
**§データ型
面倒な話だが、これはどうしても避けて通れない
スクリプトで扱う値は４つに分類されている。
分類のされ方は以下のとおり
|CENTER:|||c
|型名|CENTER:内容|CENTER:例|
|文字列型|1文字以上の文字列| "" "A" "B" "AABB" "あいうえお" |
|浮動小数点型|小数点以下を含む数字| 0.0 1.5 1.0001 10000.0 |
|整数型|小数点以下がない数字| 0 1 100 10000|
|ブール型|正か偽を表現| true false |
-注意するべきは、整数型と浮動小数点型の違いである。
-「0」は整数だが「0.0」は浮動小数点となる。同様に「1」は整数だが「1.0」は浮動小数点である。
-文字列型の「""」は「0文字のテキストデータ」を表している。
以下に物質のスクリプトメニュー内の各項目について型を示す。
|CENTER:100|CENTER:200|c
|項目名|データ型|
|airFrictionrMult =|浮動小数点|
|attraction =|浮動小数点|
|collideSet =|整数|
|collideWater =|ブール|
|color =|浮動小数点(配列、要素数４)|
|controllerAcc =|浮動小数点|
|controllerInvertX =|ブール|
|controllerInvertY =|ブール|
|controllerReverseXY =|ブール|
|density =|浮動小数点|
|drawBorder =|ブール|
|friction =|浮動小数点|
|heteroCollide =|ブール|
|immortal =|ブール|
|killer =|ブール|
|onCollide =|関数|
|opaqueBorders =|ブール|
|restitution =|浮動小数点|
|ruler =|ブール|
|text =|文字列|
|textColor =|浮動小数点(配列、要素数４)|
|textScale|浮動小数点|
|texture|文字列|
|textureMatrix|浮動小数点(配列、要素数９)|
----
***式の処理順序、データ型の優先順位
式には細かな処理の順番がある。&br;
たとえば「 x = 1 + 2 + 3 + 4 + 5; 」という式は&br;
「 x = (((( 1 + 2) + 3 ) + 4 ) + 5 ); 」この括弧のもっとも内側から順に処理される。&br;
型にも優先順位があり、以下のようになっている。&br;
-文字列型 ＞ 浮動小数点型 ＞ 整数型&br;
-文字列型 ＞ ブール型&br;
これは、「異なる型の値同士を処理する際に、結果を何型にするか」というものであり&br;
下位のものと上位のものを同じ式で扱う場合、式の結果は上位の型になる。&br;
例として以下のさまざまな式について、計算結果を見ていこう。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
|式|xに入る値|結果のデータ型|
| x = 1 + 2 + 3; | 6 | 整数 |
| x = 1 + 2 + 3.0; | 6.0 | 浮動小数点 |
整数のみの式は結果も整数。浮動小数点型が１つでも含まれる場合、浮動小数点になる。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
|式|xに入る値|結果のデータ型|
| x = 1 + "A";| "1A" | 文字列 |
| x = 1.0 + "A"; | "1A" | 文字列 |
| x = "A" + 1.0; | "A1" | 文字列 |
文字列と整数、浮動小数点の演算は、結果文字列となる。&br;
尚この際に1.0や2.0などの小数点以下が0の浮動小数点については、小数点以下は省略される。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
|式|xに入る値|結果のデータ型|
| x = 1 + 2 + 3 + "A"; | "6A" | 文字列 |
| x = 1 + "A" + 2 + 3; | "1A23" | 文字列 |
上の式だと、「1+2+3」が処理されるまでは整数の足し算であり、「+"A"」で最後に文字列型になる。&br;
下の式では、最初の「1+"A"」の結果が「"1A"(文字列型)」となり、それ以降の演算も「文字列型＋整数型」となるため結果が「"1A23"」となる。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
|式|xに入る値|結果のデータ型|
| x = 1 + 2.2 + "A" + "B"; | "3.2AB" | 文字列 |
| x = 1 + 2.2 + "A" + true; | "3.2Atrue" | 文字列 |
上の式は特に解説の必要はないと思われる。&br;
下の式は、「1+2.2+"A"」が「"3.2A"」となり、その後「"3.2A"+ true」つまり「文字列型＋ブール型」の演算となる。&br;
ブール型の値「true」は文字列と演算する際には、そのままの文字「"true"」として扱われるため&br;
結果として「"3.2A" + "true"」と同義である。したがって結果は「"3.2Atrue"」となる。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
|式|xに入る値|結果のデータ型|
| x = 1 + true; | (演算不可) | - |
| x = 1 + "" + true; | "1ture" | 文字列 |
| x = true + 1.0; | (演算不可) | - |
| x = true + "" + 1.0; | "true1" | 文字列 |
整数型とブール型の演算については演算不可となりエラーが起きる。浮動小数点型も同じく。&br;
ただし、整数と文字列型、文字列型とブール型は演算できるため、途中に「""(空の文字列)」をはさめば演算が行える。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
| x = true + true + "" + 1 | (演算不可) | - |
| x = true + "" + true + 1 | "truetrue1" | 文字列 |
ブール型同士の四則演算も演算不可である。&br;
ただしこれも間に空文字列を挟むことにより演算は行える。&br;
----
**§演算子
演算に使用する記号を総称して「演算子」と呼ぶ。
-演算子の左辺と右辺には値がくる(三項演算子は除外)
-演算子は総じて演算結果である値を残す
要は「+」や「-」などといった計算記号のことである。&br;
以下に演算子を分類ごとに紹介する。&br;
***数値を扱う場合
-算術演算子
|CENTER:80|CENTER:80|CENTER:150|CENTER:150|c
|演算子|意味|例文|演算結果|
|+|加算|3 + 4|7|
|~|~|3 + 4.0|7.0|
|-|減算|5 - 2|3|
|~|~|5 - 2.0|3.0|
|*|乗算|4 * 5|20|
|~|~|4 * 5.0|20.0|
|/|除算|8 / 4|2|
|~|~|8 / 5|1|
|~|~|8 / 5.0|1.6|
|%|剰余|8 % 5|3|
|~|~|8 % 5.0|3.0|
|^|累乗|2 ^ 3|8|
|~|~|10 ^ 3|1000|
-基本的には浮動小数点と整数の演算は、結果が浮動小数点になることに気をつけておけばよい。&br;
-除算の場合は、割る数が整数ならば演算結果も整数だが、割る数が浮動小数点ならば小数点以下も計算される。&br;
-剰余とは割り算の余りのことである。浮動小数点を含む計算でも問題なく余りが求められる。&br;
&br;
-関係演算子
|CENTER:80|CENTER:80|CENTER:150|CENTER:150|c
|演算子|意味|例文|演算結果|
|==|等しい|1 == 1|true|
|~|~|1 == 2|false|
|!=|等しくない|1 != 1|false|
|~|~|1 != 2|true|
| >|大なり|1 > 2|false|
|~|~|2 > 1|true|
|<|小なり|1 < 2|true|
|~|~|2 < 1|false|
|>=|以上|1 >= 1|true|
|~|~|1 >= 2|false|
|<=|以下|1 <= 1|true|
|~|~|2 <= 1|false|
&br;
***文字列を扱う場合
|CENTER:80|CENTER:80|CENTER:150|CENTER:150|c
|演算子|意味|例文|演算結果|
|+|加算|"ABC" + "DE"|"ABCDE"|
|==|等しい|"AB" == "AB"|true|
|!=|等しくない|"AB" != "ab"|true|
-Thymeで文字列に対して行うことがある演算はこの３つしかないと思われる
-大なり小なりの比較演算なども行えるが、行うことはないであろう
-尚、加算以外の算術演算子は全てエラーとなる
&br;
***ブール限定の演算
細かい話は抜きにして「ブール型にのみ用いられる演算でありその結果もすべてブール型である」と覚えておけば良い。&br;
true＝真 か false＝偽 を判断する際に用いる。&br;
以下の表が、その演算内容のすべてである。&br;
-論理演算子
|CENTER:80|CENTER:80|CENTER:150|CENTER:150|c
|演算子|意味|例文|演算結果|
|&&|論理積(and)|true && true|true|
|~|~|true && false|false|
|~|~|false && true|false|
|~|~|false && false|false|
|｜｜|論理和(or)|true ｜｜ true|true|
|~|~|true ｜｜ false|true|
|~|~|false ｜｜ true|true|
|~|~|false｜｜false|false|
|!|否定(not)|!true|false|
|~|~|!false|true|
-wikiの書式上の問題で論理和の演算子を全角文字で表記している。実際には半角(||)である。&br;
-論理積(and)は「両辺共にtrueならばtrue、それ以外はfalse」
-論理和(or)は「両辺どちらかがtrueならばtrue、共にfalseの場合のみfalse」
-否定(not)は値を一つしか対象とせず「真偽値を逆転させる」
&br;
***配列に対する演算
-演算が要素ごとに行われるもの
|CENTER:80|CENTER:80|CENTER:280|CENTER:250|c
|演算子|意味|例文|演算結果|
|+|加算|[1,2,3] + [1,3,5]|[2,5,8]|
|-|減算|[4,5,6] - [1,2,3]|[3,3,3]|
|*|乗算|[1,2,3] * [2,3,4]|[2,6,12]|
|/|除算|[12,12,12] / [2,3,4]|[6,4,3]|
|&&|論理積|[true,true,false] && [true,false,true]|[true,false,false]|
|｜｜|論理和|[true,true,false]｜｜[true,false,false]|[true,true,false]|
-演算子の左辺の0番目と右辺の0番目、同様に1番と1番というように、それぞれの要素同士で演算が行われる。
-演算子の両辺が同じ要素数でなければエラーとなり、演算は行われない。
&br;
-演算は配列全体で行われるもの
|CENTER:80|CENTER:80|CENTER:280|CENTER:250|c
|演算子|意味|例文|演算結果|
|==|等しい|[1,2,3] == [1,2,3]|true|
|!=|等しくない|[1,2,3] != [1,2,3]|false|
|++|結合|[1,2,3] ++ [4,5,6]|[1,2,3,4,5,6]|
-等しいか等しくないかの判断は全体で行われる。ひとつでも要素の内容が違っていれば不等号扱いである。
-結合演算子は両辺の要素全てを左辺→右辺の順に持つひとつの配列を結果とする。
&br;
----
**§その他、覚えておくべきこと
----
***使用できる変数について
スクリプト内で使用できる変数は「そのスクリプトがどこに書かれているものか」によって変わる。&br;
それらを３つに分類し、それぞれについて使用可能な変数をまとめたものが以下。&br;
+F11キーで現れるコンソール画面に書き込んだ場合
--[[スクリプト言語Thyme>Thyme]]のページに記載のある「App.～Sim.」までの全て
---実際に使用する際には「FileInfo.author」や「math.pi」といった表記で用いる
---表の「変数型」の部分については英語表記なので以下の表を参照
|表記|意味|
|decimal|十進数|
|integer|整数|
|value|値|
|positive|正の(0より大きい)|
|true or false|真か偽|
|function|関数(※後述参照)|
|array of |配列である|
|string|文字列|
|constant|定数|
|sub-group|内部に変数や関数を持つグループ名|
|Read only|読み取りのみ可能(値を変更不可)|
---※説明文部分については、各自で翻訳してくださいな。
---※使用頻度の高そうなものについては、応用編にて紹介と解説を行うので、そちらを参照してください
+物質のスクリプトメニューに書き込んだ場合(onCollide以外)
--上記コンソール画面で使用できる変数全てを使用可能
--その物質自身のスクリプトメニュー内の全ての項目をそのまま変数として使用可能。
---表記は項目名をそのまま「density」や「text」と、項目名自体が変数名となる。
+物質のスクリプトメニュー内onCollide部分に書き込んだ場合
--上記の全ての変数を使用可能
--それに加えて、衝突した相手の変数を「読み取り」のみ可能
---表記は「e.other.text」や「e.other.color」など、項目名の前に「e.other.」を付け足したものである。
※[[スクリプト言語Thyme>Thyme]]ページの「衝突した相手の物質のタイプを得る」と「e.normalの解説」に興味深い話が載っている&br;
今は理解できないという方でも、講座を最後まで理解したあとで読んでみるべし&br;
&br;
----
*実用的なお話へ
**§条件分岐構造と三項演算子
&br;
----
***条件分岐構造
&br;
----
***三項演算子
&br;
----
**§関数
----
***関数とは何か
----
***作成と使用
----
***用意されている関数
&br;
----
**§配列の応用
(執筆中につき 現在はここまで)
----
#pcomment()
#contents(,option=word)
*&bold(){Thyme講座}
Thymeは初心者やプログラム経験のない方にとっては敷居が高い。思いつきではあるが、ここにThyme講座を書きなぐっていきたいと思う。&br;
尚思いつきかつ、筆者も独学にちかい部分があるため、不明瞭な部分や間違い等があると予想される。&br;
そのような部分を発見した場合、コメントにて指摘いただけるとありがたい。&br;
&br;
*なにはともあれ書き方と例文
まずスクリプトがどのようなものなのか、見ていただこう。&br;
&br;
物質のテキスト文章部分にシミュレーション開始からの経過時間を表示させるスクリプト
text = { "" + sim.time };
&br;
常に物質の色を変え続けるスクリプト
color = { [ sim.time % 1.0 , sim.time * 0.5 % 1.0 , sim.time * 0.3 % 1.0 , 1.0 ] };
このような１処理分の塊を「式」という。
式１つは「○○○ = ○○○」の形をとる。
ただし、スクリプトメニューをよく見ると「text =」や「color =」はすでに記述されている。(項目名の部分)&br;
つまり、１つ目を例を実際に使用したい場合は「{ "" + sim.time }」を「text =」項目の内容部分に記述すれば良い。
尚、各例文の最後についてある「；」は「式がここで終わり」という意味の記号である&br;
１つの式のみをスクリプトメニューに記載した場合、決定した時に「;」が消えてしまうが、これはPhunの仕様である。&br;
どうやら、「式の数にかかわらず、最後の；は省略する」というルールが存在しているようである。&br;
この解説においては、式の数にかかわらず；を表記すると、断りを入れておく。
&br;
*基礎的なあれこれ
**§いつどこでどのようにスクリプトが動くのか
Thymeスクリプトを実行出来る場所は2箇所ある。
+F11キーを押して現れるコンソール画面への直接入力
+物質を選択後、メニューの「スクリプトメニュー」内の各属性値への記述
[[スクリプト言語Thyme]]のページには、onCollide属性内以外への記述については特に述べられていないが&br;
書式さえ守ればどの属性内にも直接スクリプトを記述できる。
onCollide以外の属性へ書き込む場合の注意点としては以下の２つ。
+「{ (スクリプト内容) }」の形式で書き込むこと（{ }で囲む）
+各属性ごとに決められているデータ型と、スクリプトが出力する値の型を合わせる事
どちらかの条件が満たされていない場合、書き込んだあとに決定しても編集前の状態に戻ってしまう。
----
**§値と変数
式に用いる数値や文字のことを総称して値(あたい)と言う。値には定数と変数の2種がある。
-定数とは「値が固定されているもの」であり、明確に数値が表記されているものである。
-変数とは「名前の付けられた箱」であり、その中に入っている値を変更できるものである。
以下に例として4行の計算を示し、解説をする。
|CENTER:80|100|220|c
|行番号|CENTER:内容|CENTER:説明|
|1行目|x := 3;|ｘという変数を内容「 3 」で作成|
|2行目|x = x + 4 - 5;|ｘに『 x + 4 - 5 』の計算結果を入れる|
|3行目|y := x + x;|ｙという変数を内容『 x + x 』で作成|
|4行目|y = x + y;|ｙに『 x + y 』の計算結果を入れる|
&bold(){1行目}&br;
x := 3;
「ｘを３という内容で作成します」という意味の式。&br;
変数を始めに作成する演算子「:=」を用いている。&br;
変数には必ず初期値が必要であり、この場合は「3」である。&br;
&bold(){2行目}&br;
x = x + 4 - 5;
「ｘに『 x + 4 - 5 』の計算結果を入れる」という意味の式。&br;
変数の値を変更する演算子「=」を用いている。&br;
ｘの値は３であるため『x+4-5』は２となり、ｘの値が２に変更される。&br;
&bold(){3行目}&br;
y := x + x;
「ｙという変数を内容『 x + x 』で作成します」という意味の式。&br;
初期値に「すでに作成済みである変数を用いた計算式」を使用しても問題ない。&br;
つまりこの式は「 y := 2 + 2; 」と同義であり、ｙの初期値は４になる。&br;
&bold(){4行目}&br;
y = x + y;
「ｙに『 x + y 』の計算結果を入れる」という意味の式。&br;
ｘは２でありｙは４であるため、この式は「ｙ＝ 2 + 4;」と同義である。&br;
結果としてｙの値は６になる。&br;
-注意事項
実際に変数を作成し使用する際には、変数名の前に「Scene.my.」をつけなければならない。&br;
この決まりに従って上記の例を実際に使用する場合、以下のようになる&br;
Scene.my.x := 3;
Scene.my.x = Scene.my.x + 4 - 5;
Scene.my.y := Scene.my.x + Scene.my.x;
Scene.my.y = Scene.my.x + Scene.my.y;
&br;
----
***配列
変数の種類として「配列」がある。&br;
変数は１つに対して１つの値しか持てないが、配列は複数個の値を持つことが出来る。&br;
イメージとしては「１つの名前を共有する複数の箱があり、それは番号で区別される」といったものである。&br;
実際に配列を使用している例を以下に示す。&br;
Scene.my.x := [ 1 , 5 , 10 , 999 , 7 ];
Scene.my.y := Scene.my.x(0);
Scene.my.z := Scene.my.x(2) + Scene.my.x(3);
順を追って解説していこう。&br;
-1行目 ここでScene.my.xという配列を作成している。
--配列を作る際の書式は「 変数名 := [ 配列の内容 ]; 」である。&br;
-2行目 変数Scene.my.yを作成し、その内容としてScene.my.xの0番目を指定している。
--配列の内容を指定する書式は「 変数名(番号) 」である。&br;
--この際注意する点は「番号は0から始まる」ということである。つまり、Scene.my.xの中身は0～4番までの5つ存在する。&br;
-3行目 変数Scene.my.zを作成し、その内容として「Scene.my.xの2番目と3番目を加算した値」を指定している。
--Scene.my.xの2番目は10、3番目は999であるため、Scene.my.zの値は1009となる。&br;
&br;
----
**§データ型
面倒な話だが、これはどうしても避けて通れない
スクリプトで扱う値は４つに分類されている。
分類のされ方は以下のとおり
|CENTER:|||c
|型名|CENTER:内容|CENTER:例|
|文字列型|1文字以上の文字列| "" "A" "B" "AABB" "あいうえお" |
|浮動小数点型|小数点以下を含む数字| 0.0 1.5 1.0001 10000.0 |
|整数型|小数点以下がない数字| 0 1 100 10000|
|ブール型|正か偽を表現| true false |
-注意するべきは、整数型と浮動小数点型の違いである。
-「0」は整数だが「0.0」は浮動小数点となる。同様に「1」は整数だが「1.0」は浮動小数点である。
-文字列型の「""」は「0文字のテキストデータ」を表している。
以下に物質のスクリプトメニュー内の各項目について型を示す。
|CENTER:100|CENTER:200|c
|項目名|データ型|
|airFrictionrMult =|浮動小数点|
|attraction =|浮動小数点|
|collideSet =|整数|
|collideWater =|ブール|
|color =|浮動小数点(配列、要素数４)|
|controllerAcc =|浮動小数点|
|controllerInvertX =|ブール|
|controllerInvertY =|ブール|
|controllerReverseXY =|ブール|
|density =|浮動小数点|
|drawBorder =|ブール|
|friction =|浮動小数点|
|heteroCollide =|ブール|
|immortal =|ブール|
|killer =|ブール|
|onCollide =|関数|
|opaqueBorders =|ブール|
|restitution =|浮動小数点|
|ruler =|ブール|
|text =|文字列|
|textColor =|浮動小数点(配列、要素数４)|
|textScale|浮動小数点|
|texture|文字列|
|textureMatrix|浮動小数点(配列、要素数９)|
----
***式の処理順序、データ型の優先順位
式には細かな処理の順番がある。&br;
たとえば「 x = 1 + 2 + 3 + 4 + 5; 」という式は&br;
「 x = (((( 1 + 2) + 3 ) + 4 ) + 5 ); 」この括弧のもっとも内側から順に処理される。&br;
型にも優先順位があり、以下のようになっている。&br;
-文字列型 ＞ 浮動小数点型 ＞ 整数型&br;
-文字列型 ＞ ブール型&br;
これは、「異なる型の値同士を処理する際に、結果を何型にするか」というものであり&br;
下位のものと上位のものを同じ式で扱う場合、式の結果は上位の型になる。&br;
例として以下のさまざまな式について、計算結果を見ていこう。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
|式|xに入る値|結果のデータ型|
| x = 1 + 2 + 3; | 6 | 整数 |
| x = 1 + 2 + 3.0; | 6.0 | 浮動小数点 |
整数のみの式は結果も整数。浮動小数点型が１つでも含まれる場合、浮動小数点になる。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
|式|xに入る値|結果のデータ型|
| x = 1 + "A";| "1A" | 文字列 |
| x = 1.0 + "A"; | "1A" | 文字列 |
| x = "A" + 1.0; | "A1" | 文字列 |
文字列と整数、浮動小数点の演算は、結果文字列となる。&br;
尚この際に1.0や2.0などの小数点以下が0の浮動小数点については、小数点以下は省略される。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
|式|xに入る値|結果のデータ型|
| x = 1 + 2 + 3 + "A"; | "6A" | 文字列 |
| x = 1 + "A" + 2 + 3; | "1A23" | 文字列 |
上の式だと、「1+2+3」が処理されるまでは整数の足し算であり、「+"A"」で最後に文字列型になる。&br;
下の式では、最初の「1+"A"」の結果が「"1A"(文字列型)」となり、それ以降の演算も「文字列型＋整数型」となるため結果が「"1A23"」となる。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
|式|xに入る値|結果のデータ型|
| x = 1 + 2.2 + "A" + "B"; | "3.2AB" | 文字列 |
| x = 1 + 2.2 + "A" + true; | "3.2Atrue" | 文字列 |
上の式は特に解説の必要はないと思われる。&br;
下の式は、「1+2.2+"A"」が「"3.2A"」となり、その後「"3.2A"+ true」つまり「文字列型＋ブール型」の演算となる。&br;
ブール型の値「true」は文字列と演算する際には、そのままの文字「"true"」として扱われるため&br;
結果として「"3.2A" + "true"」と同義である。したがって結果は「"3.2Atrue"」となる。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
|式|xに入る値|結果のデータ型|
| x = 1 + true; | (演算不可) | - |
| x = 1 + "" + true; | "1ture" | 文字列 |
| x = true + 1.0; | (演算不可) | - |
| x = true + "" + 1.0; | "true1" | 文字列 |
整数型とブール型の演算については演算不可となりエラーが起きる。浮動小数点型も同じく。&br;
ただし、整数と文字列型、文字列型とブール型は演算できるため、途中に「""(空の文字列)」をはさめば演算が行える。&br;
&br;
|CENTER:200|CENTER:100|CENTER:100|c
| x = true + true + "" + 1 | (演算不可) | - |
| x = true + "" + true + 1 | "truetrue1" | 文字列 |
ブール型同士の四則演算も演算不可である。&br;
ただしこれも間に空文字列を挟むことにより演算は行える。&br;
----
**§演算子
演算に使用する記号を総称して「演算子」と呼ぶ。
-演算子の左辺と右辺には値がくる(三項演算子は除外)
-演算子は総じて演算結果である値を残す
要は「+」や「-」などといった計算記号のことである。&br;
以下に演算子を分類ごとに紹介する。&br;
***数値を扱う場合
-算術演算子
|CENTER:80|CENTER:80|CENTER:150|CENTER:150|c
|演算子|意味|例文|演算結果|
|+|加算|3 + 4|7|
|~|~|3 + 4.0|7.0|
|-|減算|5 - 2|3|
|~|~|5 - 2.0|3.0|
|*|乗算|4 * 5|20|
|~|~|4 * 5.0|20.0|
|/|除算|8 / 4|2|
|~|~|8 / 5|1|
|~|~|8 / 5.0|1.6|
|%|剰余|8 % 5|3|
|~|~|8 % 5.0|3.0|
|^|累乗|2 ^ 3|8|
|~|~|10 ^ 3|1000|
-基本的には浮動小数点と整数の演算は、結果が浮動小数点になることに気をつけておけばよい。&br;
-除算の場合は、割る数が整数ならば演算結果も整数だが、割る数が浮動小数点ならば小数点以下も計算される。&br;
-剰余とは割り算の余りのことである。浮動小数点を含む計算でも問題なく余りが求められる。&br;
&br;
-関係演算子
|CENTER:80|CENTER:80|CENTER:150|CENTER:150|c
|演算子|意味|例文|演算結果|
|==|等しい|1 == 1|true|
|~|~|1 == 2|false|
|!=|等しくない|1 != 1|false|
|~|~|1 != 2|true|
| >|大なり|1 > 2|false|
|~|~|2 > 1|true|
|<|小なり|1 < 2|true|
|~|~|2 < 1|false|
|>=|以上|1 >= 1|true|
|~|~|1 >= 2|false|
|<=|以下|1 <= 1|true|
|~|~|2 <= 1|false|
&br;
***文字列を扱う場合
|CENTER:80|CENTER:80|CENTER:150|CENTER:150|c
|演算子|意味|例文|演算結果|
|+|加算|"ABC" + "DE"|"ABCDE"|
|==|等しい|"AB" == "AB"|true|
|!=|等しくない|"AB" != "ab"|true|
-Thymeで文字列に対して行うことがある演算はこの３つしかないと思われる
-大なり小なりの比較演算なども行えるが、行うことはないであろう
-尚、加算以外の算術演算子は全てエラーとなる
&br;
***ブール限定の演算
細かい話は抜きにして「ブール型にのみ用いられる演算でありその結果もすべてブール型である」と覚えておけば良い。&br;
true＝真 か false＝偽 を判断する際に用いる。&br;
以下の表が、その演算内容のすべてである。&br;
-論理演算子
|CENTER:80|CENTER:80|CENTER:150|CENTER:150|c
|演算子|意味|例文|演算結果|
|&&|論理積(and)|true && true|true|
|~|~|true && false|false|
|~|~|false && true|false|
|~|~|false && false|false|
|｜｜|論理和(or)|true ｜｜ true|true|
|~|~|true ｜｜ false|true|
|~|~|false ｜｜ true|true|
|~|~|false｜｜false|false|
|!|否定(not)|!true|false|
|~|~|!false|true|
-wikiの書式上の問題で論理和の演算子を全角文字で表記している。実際には半角(||)である。&br;
-論理積(and)は「両辺共にtrueならばtrue、それ以外はfalse」
-論理和(or)は「両辺どちらかがtrueならばtrue、共にfalseの場合のみfalse」
-否定(not)は値を一つしか対象とせず「真偽値を逆転させる」
&br;
***配列に対する演算
-演算が要素ごとに行われるもの
|CENTER:80|CENTER:80|CENTER:280|CENTER:250|c
|演算子|意味|例文|演算結果|
|+|加算|[1,2,3] + [1,3,5]|[2,5,8]|
|-|減算|[4,5,6] - [1,2,3]|[3,3,3]|
|*|乗算|[1,2,3] * [2,3,4]|[2,6,12]|
|/|除算|[12,12,12] / [2,3,4]|[6,4,3]|
|&&|論理積|[true,true,false] && [true,false,true]|[true,false,false]|
|｜｜|論理和|[true,true,false]｜｜[true,false,false]|[true,true,false]|
-演算子の左辺の0番目と右辺の0番目、同様に1番と1番というように、それぞれの要素同士で演算が行われる。
-演算子の両辺が同じ要素数でなければエラーとなり、演算は行われない。
&br;
-演算は配列全体で行われるもの
|CENTER:80|CENTER:80|CENTER:280|CENTER:250|c
|演算子|意味|例文|演算結果|
|==|等しい|[1,2,3] == [1,2,3]|true|
|!=|等しくない|[1,2,3] != [1,2,3]|false|
|++|結合|[1,2,3] ++ [4,5,6]|[1,2,3,4,5,6]|
-等しいか等しくないかの判断は全体で行われる。ひとつでも要素の内容が違っていれば不等号扱いである。
-結合演算子は両辺の要素全てを左辺→右辺の順に持つひとつの配列を結果とする。
&br;
----
**§その他、覚えておくべきこと
----
***使用できる変数について
スクリプト内で使用できる変数は「そのスクリプトがどこに書かれているものか」によって変わる。&br;
それらを３つに分類し、それぞれについて使用可能な変数をまとめたものが以下。&br;
+F11キーで現れるコンソール画面に書き込んだ場合
--[[スクリプト言語Thyme>Thyme]]のページに記載のある「App.～Sim.」までの全て
---実際に使用する際には「FileInfo.author」や「math.pi」といった表記で用いる
---表の「変数型」の部分については英語表記なので以下の表を参照
|表記|意味|
|decimal|十進数|
|integer|整数|
|value|値|
|positive|正の(0より大きい)|
|true or false|真か偽|
|function|関数(※後述参照)|
|array of |配列である|
|string|文字列|
|constant|定数|
|sub-group|内部に変数や関数を持つグループ名|
|Read only|読み取りのみ可能(値を変更不可)|
---※説明文部分については、各自で翻訳してくださいな。
---※使用頻度の高そうなものについては、応用編にて紹介と解説を行うので、そちらを参照してください
+物質のスクリプトメニューに書き込んだ場合(onCollide以外)
--上記コンソール画面で使用できる変数全てを使用可能
--その物質自身のスクリプトメニュー内の全ての項目をそのまま変数として使用可能。
---表記は項目名をそのまま「density」や「text」と、項目名自体が変数名となる。
+物質のスクリプトメニュー内onCollide部分に書き込んだ場合
--上記の全ての変数を使用可能
--それに加えて、衝突した相手の変数を使用可能
---表記は「e.other.text」や「e.other.color」など、項目名の前に「e.other.」を付け足したものである。
※[[スクリプト言語Thyme>Thyme]]ページの「衝突した相手の物質のタイプを得る」と「e.normalの解説」に興味深い話が載っている&br;
今は理解できないという方でも、講座を最後まで理解したあとで読んでみるべし&br;
&br;
----
*実用的なお話へ
**§条件分岐構造と三項演算子
&br;
----
***条件分岐構造
&br;
----
***三項演算子
&br;
----
**§関数
----
***関数とは何か
----
***作成と使用
----
***用意されている関数
&br;
----
**§配列の応用
(執筆中につき 現在はここまで)
----
#pcomment()
