rbCanvas/p5 API

Ruby basics

おもな条件分岐構文

構文	概要	参考情報 (Rubyリファレンス)
if ... end	条件が真の場合に処理を実行
unless ... end	条件が偽の場合に処理を実行
case ... end	１つの変数や式に対する一致判定によって処理を分岐

おもな繰り返し構文

構文	概要	参考情報 (Rubyリファレンス)
while ... end	条件が真の間、処理を繰り返して実行
until ... end	条件が真になるまで、処理を繰り返して実行
for ... end	列挙された要素に対して、処理を繰り返して実行
times do ... end	与えられた回数分だけ、処理を繰り返して実行
each do ... end	与えられた範囲に対して、処理を繰り返して実行
step do ... end	与えられた範囲と刻み幅に対して、処理を繰り返して実行
loop do ... end	中断されるまで、処理を繰り返して実行

おもな定義構文

構文	概要	備考
def メソッド名 ... end	メソッドを定義
class クラス名 ... end	クラスを定義	クラス名の先頭は大文字アルファベット
module モジュール名 ... end	モジュールを定義	モジュール名の先頭は大文字アルファベット

おもなクラスおよびモジュール

クラス / モジュール	概要	備考
String	文字列クラス	rbCanvas/p5では、Rubyの Stringクラスの各メソッドが使用できます。ただし、Opal(JavaScript)の制約により、「downcase!」や「gsub!」などのオブジェクト自身を破壊的に書き換えるメソッドは実行時にエラーとなります。なお、p5.jsにも文字列の操作に関するメソッド(関数)が用意されていますが、それらのメソッド(関数)は rbCanvas/p5では使用できません。　String Functions(p5.js) 　　join 　　match 　　matchAll 　　nf 　　nfc 　　nfp 　　nfs 　　split 　　splitTokens 　　trim
Array	配列クラス	rbCanvas/p5では、Rubyの Arrayクラスの各メソッドが使用できます。なお、p5.jsにも配列の操作に関するメソッド(関数)が用意されていますが、それらのメソッド(関数)は rbCanvas/p5では使用できません。　Array Functions(p5.js) 　　append 　　arrayCopy 　　concat 　　reverse 　　shorten 　　shuffle 　　sort 　　splice 　　subset
Hash	ハッシュクラス	rbCanvas/p5では、Rubyの Hashクラスの各メソッドが使用できます。キーを指定してデータにアクセスする場合、 JavaScript(p5.js)でのハッシュのように「object.key」という記法ではエラーになりますので、「object[:key]」などのように Rubyの仕様に則した記法でアクセスしてください。
Math	数学関数モジュール	rbCanvas/p5では、Rubyの Mathモジュールの各メソッドが使用できます。ただし、p5.jsで提供されている諸々の数学関数が優先されますので Rubyで提供されている数学関数を使う際には「Math.cos」や「Math.log」のように明示的に「Math」モジュール名での修飾が必要です。
Date	日付クラス	rbCanvas/p5では、Rubyの Dateクラスの各メソッドが使用できます。なお、p5.jsにも日付の操作に関するメソッド(関数)が用意されていますが、それらのメソッド(関数)は rbCanvas/p5では使用できません。　Date Functions(p5.js) 　　day 　　month 　　year
Time	時刻クラス	rbCanvas/p5では、Rubyの Timeクラスの各メソッドが使用できます。なお、p5.jsにも時刻の操作に関するメソッド(関数)が用意されていますが、それらのメソッド(関数)は rbCanvas/p5では使用できません。　Time Functions(p5.js) 　　second 　　minute 　　hour
Regexp	正規表現クラス	rbCanvas/p5では、Rubyの Regexpクラスの各メソッドが使用できます。 JavaScript(p5.js)での正規表現とは仕様が異なる点がありますのでご留意ください。
Proc	手続きクラス	rbCanvas/p5では、Rubyの Procクラスの各メソッドが使用できます。 JavaScriptのように関数(メソッド)自体を引数として指定することができないため、コールバック処理などで一連の手続き(処理)を渡す必要がある場合などには Procオブジェクトを生成して利用してください。 (利用例: isLooping など)

おもな変換

	内容	例		備考
to_i	文字列 → 整数	"2".to_i	#=> 2
to_f	文字列 → 数値	"2.5".to_f	#=> 2.5
to_s	数値 → 文字列	100.to_s	#=> "100"
abs	絶対値を取得	-5.abs	#=> 5	p5.jsの abs(-5)と同じ
round	小数点以下の指定桁になるように四捨五入した値を取得	3.1415.round(2)	#=> 3.14	p5.jsの round(3.1415, 2)と同じ
ceil	小数点以下の指定桁になるように切り上げた値を取得	3.1415.ceil(1)	#=> 3.2	p5.jsの ceilでは桁数指定不可
floor	小数点以下の指定桁になるように切り捨てた値を取得	3.1415.floor(1)	#=> 3.1	p5.jsの floorでは桁数指定不可

おもな書式指定

	内容	備考
式展開	"#{式}" の形式で文字列中に式の値を埋め込み	JavaScriptの `${変数}`に相当
format sprintf	所定の書式指定子によって変数などの値の出力書式を制御	C言語での printの書式指定子と同じ
(書式文字列) %	同上	同上

おもな擬似変数

擬似変数	内容	備考
true	「真」をあらわす
false	「偽」をあらわす
nil	「存在しない状態」をあらわす	真偽値の判定では「偽」として扱われます
self	「オブジェクト自身」をあらわす	現在のメソッドの実行主体

おもな演算子

演算子	内容	例
算術演算子
a + b	加算	10 + 5	#=> 15
a - b	減算	10 - 5	#=> 5
a * b	乗算	10 * 5	#=> 50
a / b	除算	10 / 5	#=> 2
a % b	剰余(余り)演算	10 % 5	#=> 0
a ** b	べき乗	10 ** 5	#=> 100000
代入演算子
演算子	内容	例
a = b	aに bを代入	a = 5	#=> aに 5を代入
a += b	a = a + b と同じ	a += 5	#=> aに 5を足した値を再代入
a -= b	減算	a -= 5	#=> a から 5を引いた値を再代入
a *= b	乗算	a *= 5	#=> a に 5を掛けた値を再代入
a /= b	除算	a /= 5	#=> aを 5で割った値を再代入
a %= b	剰余(余り)演算	a %= 5	#=> aを 5で割った余りを再代入
a **= b	べき乗	a **= 5	#=> aを 5乗した値を再代入
比較演算子
演算子	内容	例
a == b	a とb が等しい	0 == 1	#=> false
a != b	a とb が等しくない	0 != 1	#=> true
a < b	a がb より小さい	0 < 1	#=> true
a > b	a とb より大きい	0 > 1	#=> false
a <= b	a とb以下である	0 <= 1	#=> true
a >= b	a とb以上である	0 >= 1	#=> false
論理演算子
演算子	内容	備考
! c	条件c が満たされていない
c1 && c2	条件c1, c2 がどちらも満たされている
c1 \|\| c2	条件c1, c2 のいずれかが満たされている
not c	条件c が満たされていない	! よりも結合の優先順位が低い
c1 and c2	条件c1, c2 がどちらも満たされている	&& よりも結合の優先順位が低い
c1 or c2	条件c1, c2 のいずれかが満たされている	\|\| よりも結合の優先順位が低い