rubyfaq-jp/ 40755 23421 144 0 6773675606 11767 5ustar akendousersrubyfaq-jp/rubyfaq-jp.html100644 23421 144 30737 6773675606 15064 0ustar akendousers Ruby FAQ 前のページ 次のページ 目次

Ruby FAQ

September 27, 1999

1. 一般的な質問

2. 変数，定数，引数

3. イテレータ

4. 構文

5. メソッド

6. クラス，モジュール

7. 組込みライブラリ

8. 拡張ライブラリ

9. ドキュメントされていない機能

10.日本語の取り扱い

Originally written by Shugo Maeda shugo@netlab.co.jp
Transformed to SGML by Ozawa Sakuro crouton@duelists.org
Translated into English by gotoken gotoken@math.sci.hokudai.ac.jp
Revised by Akira Endo akendo@t3.rim.or.jp
since June 7, 1999 (original Sep 18, 1997)
Transformed to private XML on June 28, 1999, parsed with xmlparser by Yoshida Masato yoshidam@inse.co.jp, yoshidam@yoshidam.net.

前のページ 次のページ 目次 rubyfaq-jp/rubyfaq-jp-1.html100644 23421 144 21004 6773675606 15205 0ustar akendousers Ruby FAQ: 一般的な質問 前のページ 次のページ 目次

1. 一般的な質問

1.1 Rubyとは何ですか

一言で言えば，
シンプルかつ強力なオブジェクト指向スクリプト言語
です．

perlのようにテキスト処理の分野に威力を発揮します．もちろんそれだけでは なく，Rubyで実用的なサーバーアプリケーションを作成するなどということも 可能です．

Rubyにはたくさんの言語のよい部分が取り込まれており，その結果どの言語とも 異なる言語になっています．

Rubyは以下のような特長を持っています．

1.2 名前の由来を教えてください

まつもとさんの[ruby-talk:00394](June 11, 1999)での紹介の翻訳です．

まつもとさんは，自分の新しい言語の名前をPerlのように何か宝石の 名前からとろうとし，同僚の誕生石がRubyだったので，Rubyとした そうです．

その後，誕生石としては，pearl => 6月，ruby => 7月，活字の 大きさとしては，pearl => 5pt，ruby => 5.5ptなど，rubyが pearlの直後に来ている例があるのに気づき，Perlより新しく，できれば より良い言語の名前としてRubyが新しいスクリプト言語の名前として ふさわしいと思ったそうです．

まつもとさんは，RubyがPerlの代わりになる日を待っています(^~)．

1.3 Rubyの歴史を教えてください

まつもとさんの[ruby-talk:00382](June 4, 1999)での紹介の翻訳です． Rubyの誕生日は[ruby-list:15997]により修正されました．
Rubyは1993年2月24日に生まれました．その日同僚とオブジェクト指向 言語の可能性について話していました．Perl(Perl4で，Perl5ではありません．) は知っていましたが，おもちゃのにおいがして(今もありますが)好きになれ ませんでした．オブジェクト指向スクリプト言語は期待が持てました．

Pythonも知っていましたが，本当のオブジェクト指向言語とは思えません でした．オブジェクト指向がとってつけたもののように感じられたのです． 15年来言語マニアでオブジェクト指向のファンでしたので，真にオブジェクト 指向のスクリプト言語が心底欲しかったのですが，そのようなものは さがしてもさがしてもありませんでした．

そこで自分で作ろうと決心したのです．数ヶ月たってインタプリタが 動き始めました．イテレータ，例外処理，ガーベージコレクションなど 欲しかったものをいれこみました．

さらにPerlの特徴をクラスライブラリとして取り込みました． Ruby 0.95を日本国内のニューズグループに投稿したのは，1995年12月の ことでした．

すぐにメーリングリストを始め，ホームページを作りました．メーリング リストでは活発な意見の交換がなされました．最初からあるruby-listは 今では14789通のメールを数えています．

Ruby 1.0 は1996年12月に，1.1 は1997年8月に，安定バージョンとしての 1.2 と開発バージョンの 1.3 が1998年12月にリリースされています．

1.4 どこで手に入りますか

Rubyの最新版は ftp://ftp.netlab.co.jp/pub/lang/ruby/ で手に入ります．

ミラーサイトは次のとおりです． gnu-win32版とdjgpp版はpc/にバイナリがあります．

1.5 Rubyのホームページを教えてください

Rubyの公式ページは http://www.netlab.co.jp/ruby/jp/ (日本語)及び http://www.netlab.co.jp/ruby/ (英語)です．

1.6 Rubyのメーリングリストはありますか

現在Rubyの話題を扱うメーリングリストは四つあります． 詳しくは Rubyのホームページをご覧ください．

1.7 メイリングリストの過去メールを調べたいのですが

メイリングリスト検索用のフォームが， http://blade.nagaokaut.ac.jp/ruby/ruby-list/index.shtml や http://ruby.freak.ne.jp/にあります．

また， http://ruby.freak.ne.jp/ml-topics.htmlには， 過去メールの主な話題がピックアップされています．

1.8 rubyistとruby hackerの違いは

まつもとさんによると，rubyistとRuby hackerは次のような定義だそうです．
Rubyに対して単なるお客さん以上の気持を持っている人がrubyistです．たと えば 一方，Rubyに関して技術レベルの高さをあわらす人はRuby hackerと呼びましょ う．たとえば などはRuby hackerでしょう．
これらは称号は自称されるもので別に私が公式認定をするようなものではあり ませんが，上の例でほとんど名指しされている人は，まつもとがこの人たちを {rubyist，Ruby hacker}として尊敬を込めて認めていることを表します．

1.9 "Ruby"と"ruby"はどっちが正しいのですか

Rubyの正式な表記は"Ruby"です．ただし，コマンド名は"ruby"ですし， また並列して違和感がない限り，Rubyの代わりにrubyを使うことは 許容されます．

ただし，「RUBY」，「ルビー」，「るびー」は言語名としては許容 されていません．

歴史的には"ruby"が正式名称だった時代があります．

1.10 Rubyの参考書を教えてください

まつもとさんらによるRubyの解説書が1999年秋に刊行される予定です．

正規表現に関しては，Jeffrey E. F. Friedl著「詳説正規表現」(ISBN4-900900-45-1)が オライリージャパンから出ています．様々な正規表現の実装に触れており， Rubyの正規表現を理解するにも有用です．

1.11 マニュアルを読んでも理解できないところがあるのですが

Rubyは，基本的な構文はRuby1.0以来大きくは変わっていませんが，絶えず 拡張，修正が行われていますので，ドキュメントが最新バージョンに追い 付いていないところがあります．また，ソースがドキュメントだという説も あります．

分からなくなったら，遠慮なくruby-listで 質問すると，教祖まつもとさんをはじめ，尊師の方々や私もはまったという 人たちに分かりやすく教えていただけます．

質問をするには，ruby -vの結果と，はまったスクリプト (長い場合は本質的なところを切り出して)を示せばよいでしょう．

irbを使っている場合は，irb固有の問題もありますので， irb --single-irbで試してみるか，rubyで実行し直して 確認することをおすすめします．

MLを検索すれば，かなりの疑問が解決するとは思いますが，メールも 大量になってしまって，ありふれた検索では絞り込みにくくなっています． 最近のものくらいはチェックしておくのがネチケット(RFC1855の3.1.1，3.1.2参照) というものだとは 思いますが，言うは易く，行うは難しですし，新しい視点も生まれるかも しれません．思い切って質問してみましょう．
前のページ 次のページ 目次 rubyfaq-jp/rubyfaq-jp-2.html100644 23421 144 20454 6773675606 15216 0ustar akendousers Ruby FAQ: 変数，定数，引数 前のページ 次のページ 目次

2. 変数，定数，引数

2.1 変数や定数への代入によりオブジェクトはコピーされますか

変数や定数は，あるオブジェクトを指しています．何も代入しなくても nilオブジェクトを指しています．代入は，変数や定数が新しいオブジェクトを 指すようにします．

したがって，代入によりオブジェクトがコピーされて新しく作られることは なく，右辺の表現の表しているオブジェクトを左辺の変数や定数が指すように することが代入によって行われます．

という説明で満足していただければいいのですが，これでは満足できない という方もいらっしゃるかもしれません．このような理解で問題が 生じることはないのですが，実は，Fixnum，NilClass，TrueClass，FalseClass のインスタンスは，直接変数や定数が保持していますので，これらは 代入によってコピーされることになります．これら以外のクラスのインスタンスは メモリの別の場所にあり，それを変数や定数が参照することになります． 即値と参照を参照してください．

2.2 ローカル変数のスコープはどのように決められていますか

トップレベル，クラス(モジュール)定義，メソッド定義のそれぞれで 独立したスコープになっています．ブロック内では，新たなスコープが 導入されるとともに，外側のローカル変数を参照できます．

ブロック内が特別になっているのは，Threadや手続きオブジェクトの 中でローカル変数を局所化できるようにするためです．

while，until，forは制御構造であり，新しいスコープを 導入しません． loopはメソッドで，後ろについているのはブロックです．

2.3 ローカル変数はいつ参照可能になるのでしょうか

Rubyスクリプトは，Rubyインタプリタに実行させようとすると， まず最後まで一度読みこまれ，構文解析されます．構文上問題が生じなければ， 構文解析で作られた構文木が最初から実行に移されます．

ローカル変数が参照可能になるのは，この構文解析の時にローカル変数への 代入文が見つかった時です． 
for i in 1..2
  if i == 2
    print a
  else
    a = 1
  end
end
test.rbというファイルにいれて，このスクリプトを実行すると， 
test.rb:3: undefined local variable or method `a' for
   #<Object:0x40101f4c> (NameError)
      from test.rb:1:in `each'
      from test.rb:1
ということで，iが1の時は，エラーが起こらず，iが2になった時に エラーが起こります．構文解析の時には，最初のprint aが実際には aへの代入が行われてから実行されるというところまで解析されず， この文を構文解析する時までにaへの代入文が現われていないので， ローカル変数は参照されません．実行時にはaというメソッドが ないか探しますが，これも定義されていないのでエラーになります．

逆に，次のスクリプトは，エラーになりません． 
a = 1 if false; print a
# ->nil
ローカル変数のこのような振舞いに悩まされないためには，ローカル変数が 参照される文より前に，a = nil といった代入文を置くことがすすめられて います．こうすると，ローカル変数の参照が速くなるというおまけもついて います．

2.4 定数のスコープはどのように決められていますか

クラス/モジュールで定義された定数は，そのクラス/モジュールの中で 参照できます．

クラス/モジュール定義がネストしている場合には，内側のクラス/モジュール から外側の定数を参照できます．

またスーパークラス及びインクルードしたモジュールの定数を参照できます．

トップレベルで定義された定数は，Objectクラスに追加されますので， すべてのクラス/モジュールから参照できます．

直接参照できない定数は，::演算子を使って，クラス/モジュール名を 指定することにより参照できます．

2.5 実引数は仮引数にどのように渡されますか

実引数は，メソッド呼出しによって仮引数に代入されます．Rubyにおける 代入の意味は，変数への代入を 参照してください． 実引数が参照しているオブジェクトが，自分の状態を変更するメソッドを 持っている時には，副作用(それが主作用かもしれませんが)に注意する 必要があります．破壊的メソッド参照．

2.6 仮引数に代入すると実引数に影響を及ぼしますか

仮引数は，ローカル変数であり，仮引数に代入を行うと他のオブジェクトを 指すようになるだけで，元の実引数のオブジェクトには何の影響もありません．

2.7 仮引数の指すオブジェクトにメッセージを送るとどうなりますか

仮引数の指すオブジェクトは，実引数の指しているオブジェクトですから， そのメッセージによってオブジェクトの状態が変化する場合には，呼出し側に 影響が及ぶことになります．破壊的メソッド 参照．

2.8 *がついた引数は何ですか

Cウィザードのみなさん，これはポインタではありません．Rubyでは引数に *を付けることで，不定個の引数を配列に格納した形で受け取ることがで きます． 
def foo(*all)
  for e in all
    print e, " "
  end
end

foo(1, 2, 3)
# -> 1 2 3
またメソッド呼び出しで*を付けた配列を渡すと配列を展開して渡すこと ができます． 
a = [1, 2, 3]
foo(*a)
現在，*をつけることができるのは
  1. 多重代入の左辺
  2. 多重代入の右辺
  3. 引数リスト(定義側)
  4. 引数リスト(呼び出し側)
  5. caseのwhen節
の末尾だけです．(1)は 
x, *y = [7, 8, 9]
のような形式で，この場合 x = 7，y = [8, 9] になり ます． 
x, = [7, 8, 9]
のような記述もでき，この場合，x = 7 で 
x = [7, 8, 9]
なら，x = [7, 8, 9] になります．

2.9 &がついた引数は何ですか

手続きオブジェクトをブロックとして受け渡しするための引数です． 引数列の一番最後に置きます．

2.10 仮引数にデフォルト値を指定できますか

できます．

しかもこのデフォルト値は関数の呼び出し時に評価されます．Rubyのデフォル ト値は任意の式が可能で(C++はコンパイル時に決まる定数のみ)，評価はメソッ ドのスコープで呼び出し時に行われます．

2.11 ブロックに引数を渡すにはどうしますか

ブロックの先頭に，仮引数を||で囲って置くと，実引数が多重代入されます． この仮引数は，普通のローカル変数で，ブロックの外側ですでに使われて いる変数の場合は，そのスコープになりますので，注意が必要です．

2.12 変数や定数の値が知らないうちに変化することがありますが

次のような例でしょうか． 
A = a = b = "abc"; b << "d"; print a, " ", A
# ->abcd abcd
変数や定数への代入は，オブジェクトを後でその変数や定数で参照する ために用いられます．変数や定数にオブジェクトそのものが代入されて いるのではなく，オブジェクトの参照を保持しているだけです．変数は， この参照を変更して異なるオブジェクトを参照するようにすることが できますが，定数では一度保持した参照を変更することができません．

変数や定数にメソッドを適用すると，そのメソッドは，変数や定数が 指しているオブジェクトに適用されます．上の例では，<<というメソッドが オブジェクトの状態を変えてしまうために，「予期せぬ」結果が生まれて います．オブジェクトが数値の場合には，数値の状態を変えるメソッドが ないため，このような問題は生じません．数値にメソッドを適用した時には 新しいオブジェクトが返されます．

この例では，文字列で示しましたが，配列やハッシュなど，オブジェクトの 状態を変更するメソッドを持っているオブジェクトでも同様のことが起こり 得ます．

2.13 定数は変更されませんか

定数があるオブジェクトを指しているとき，別のオブジェクトを指すように すると，warningが出ます．

そのオブジェクトが破壊的メソッド を持っていれば，オブジェクトの内容は変更できます．
前のページ 次のページ 目次 rubyfaq-jp/rubyfaq-jp-3.html100644 23421 144 7236 6773675606 15202 0ustar akendousers Ruby FAQ: イテレータ 前のページ 次のページ 目次

3. イテレータ

3.1 イテレータとは何ですか

ブロックや手続きオブジェクトを活用するメソッドをイテレータと呼びます．

イテレータは制御構造(特にループ)の抽象化のために用いられるメソッド の一種です．

といってもよくわかりませんね．実際の例を見た方が早いかもしれません．イ テレータはコレクションの各要素に対して同じ処理を繰り返したいような場合 によく使われます．例えばこんな感じです． 
data = [1, 2, 3]
data.each do |i|
  print i, "\n"
end
このコードの出力はこのようになります． 
$ ruby test.rb
1
2
3
つまりdoとendで囲まれたブロックが配列dataの各要素に対して繰 り返されるわけです．

これをCで書くと次のようになります． 
int data[3] = {1, 2, 3};
int i;
for (i = 0; i < 3; i++) {
  printf("%d\n", data[i]);
}
このようにforを使って書く場合，境界条件の判定ミスでバグが生まれる 可能性がありますが(こんな単純な場合なら大丈夫でしょうが)，イテレータを 使えばそのような心配はありませんね:-)

また，do...endの代わりに{...}を使うこともできます． 
data = [1, 2, 3]
data.each { |i|
  print i, "\n"
}
このコードは先の例と全く同じ動作をします．ただし，do...endと {...}で動作が異なる場合があります． 
foobar a, b do .. end # foobar がイテレータとして呼び出されます
foobar a, b { .. }    # b がイテレータとして呼び出されます
これは{ }の方がdoブロックよりも結合強度が強いためです．

3.2 イテレータにブロックを渡すにはどうすればいいですか

イテレータにブロックを渡すには，メソッドの後ろにブロックを置く 方法の他に，手続きオブジェクト(を指す変数，定数)の前に&を つけて引数として渡す方法があります．

3.3 ブロックは呼び出したメソッドの中からどのように使われますか

メソッドの中からブロックを使用するには，yield制御構造，ブロック引数， Proc.newの3種類の方法で行うことができます．( Cで書かれた拡張ライブラリ の中では，rb_yieldが使われます．)

yieldの場合には，yieldの後ろに続く引数が，ブロック パラメータとしてブロックに渡され，ブロックが実行されます．

ブロック引数は，メソッド定義の引数の最後に&methodという形で 置かれ，メソッドの中で，method.call(args...)という形で呼ばれます．

Proc.newは，メソッドの中で使われたときには，引数としてそのメソッドに 渡されたブロックをとり，そのブロックを内容とする手続きオブジェクトを 生成します．procまたはlamdaも同様です． 
def a (&b)
  yield
  b.call
  Proc.new.call
  proc.call
  lambda.call
end
a{print "test\n"}

3.4 Proc.newでは手続きオブジェクトが作られませんが

Proc.newは，ブロックを与えられないと手続きオブジェクトを生成できず， エラーになります．メソッド定義の中で 使われるブロックなしのProc.newは，メソッド呼出しにブロックが与えられて いることを仮定しています．
前のページ 次のページ 目次 rubyfaq-jp/rubyfaq-jp-4.html100644 23421 144 6270 6773675606 15200 0ustar akendousers Ruby FAQ: 構文 前のページ 次のページ 目次

4. 構文

4.1 :exit等の:のついた識別子は何ですか

シンボルと呼ばれる，識別子と1対1対応する整数(Fixnum)です． "exit".internとしても求められます．catch, throw, autoloadなどでは， 引数として文字列もシンボルも使えます．

method_missing，method_added，singleton_method_addedはシンボルを 要求します．

4.2 シンボルと同名の変数の値を取り出すにはどうすればいいですか

symbolのスコープでeval((:symbol).id2name)とすると， 値が取り出せます． 
a = 'This is the content of "a"'
b = eval(:a.id2name)
a.id == b.id

4.3 loopは制御構造ですか

メソッドです．ブロックは新しいローカル変数のスコープを導入します．

4.4 a +bがエラーになりますが

a(+b)と解析されています．+の両側の空白をなくすか，いれるか のどちらかにしてください．

4.5 s = "x"; puts s *10 がエラーになりますが

puts s *10 のところが，s(*10)というメソッド呼出しと解析されて しまいます．s*10にするか，s * 10にしてください．

4.6 p {}で何も表示されません

{}がハッシュのコンストラクタではなく，ブロックと解析されています． p({})としてください．

4.7 def pos= (val) print @pos,"\n"; @pos = val endと定義しても， pos = 1で参照できません

=のついたメソッドは，レシーバー形式で呼ぶ必要があります． self.pos = 1 という形で呼んでください．

4.8 '\1'と'\\1'はどう違いますか

同じです．シングルクォートの中では，\'と\\だけが 解釈され，それ以外は解釈されません．

4.9 p true or true and falseはtrueを表示するのに， a=true if true or true and falseでは，aにtrue が代入されません．

最初の式は，(p true) or true and falseと解釈されます． and/orは 文の構成要素として解釈され，pの引数を結ぶ演算子としては解釈され ません．

2番目のは，a=true if (true or true and false)と解釈されています． ifの方がand/orより優先順位が低いこと， orとandの優先順位が同じなので， 左から順に解釈されることによります．

4.10 p(nil || "")は""を返し，p(nil or "")はparse errorになります．

||は，引数を結ぶ演算子として用いることができます．orは文と文を結ぶこと しかできず，引数を結ぶことができません．p nil or ""とp((nil or ""))を 試してください．
前のページ 次のページ 目次 rubyfaq-jp/rubyfaq-jp-5.html100644 23421 144 22317 6773675606 15221 0ustar akendousers Ruby FAQ: メソッド 前のページ 次のページ 目次

5. メソッド

5.1 オブジェクトにメッセージを送った時に実行されるメソッドはどのように捜されますか

特異メソッド，自クラスで定義されたメソッド，スーパークラス(Mix-inされた モジュールを含む．クラス名.ancestorsで表示される．)で定義されたメソッドの順に 最初に見つかったメソッドが実行されます．メソッドが見つからなかった 場合には，method_missingが同じ順で捜されます． 
Module Indexed
  def [](n)
    to_a[n]
  end
end
Class String
  include Indexed
end
p String.ancestors # [String, Indexed, Enumerable, Comparable, Object, Kernel]
p "abcde".gsub!(/./, "\\&\n")[1]
は，残念ながら期待するように"b\n"を返してくれず，10を返してきます． []がStringクラスで捜され，Indexedで定義されたものを捜し出す前に マッチしてしまうからです．Class Stringで直接[]を再定義すれば， 期待どおりになります．

5.2 +や-は演算子ですか

+や-などは演算子ではなくメソッド呼び出しです．したがって オーバーロードすることもできます． 
class MyString < String
  def +(other)
    print super(other)
  end
end
ただし，以下のもの及びこれらを組み合わせたもの(!=，!~)は制御構造であり， オーバーロードできません． 
=, .., ..., !, not, &&, and, |, or, ~, ::
単項演算子をオーバーロード(もしくは定義)するには，メソッド名として +@や-@を使います．

=は，インスタンス変数へのアクセスメソッドとして, クラス定義の中で次のようにメソッドを定義することができます． また，+や-なども定義することにより，+= などの自己代入演算も可能になります． 
def attribute=(val)
  @attribute = val
end

5.3 関数はありますか

Rubyにおいて関数のように見えるものはすべてレシーバ(self)を省略した形の メソッドです．例えば 
def writeln(str)
  print(str, "\n")
end

writeln("Hello, World!")
のように一見関数のように見えるものも，Objectクラスに定義された メソッドであり，隠されたレシーバーselfに送られているというわけです． したがってRubyを純粋なオブジェクト指向言語と呼ぶことができます．

組込み関数のように，selfが何であっても同じ結果を返すメソッドは， レシーバーを意識する必要がありませんので，関数と考えてもいいという ことになります．

5.4 オブジェクトのインスタンス変数を参照できますか

インスタンス変数を参照するメソッドが定義されていれば，そのメソッドを 使って値を知ったり，値をセットしたりすることができます． Module#attr，attr_reader，attr_writer， attr_accessorを参照してください． もちろん，自分でメソッドを定義して参照することもできます．

method=の形のメソッド定義は，methodと=の間に 空白をいれることができませんが，メソッド呼出しの時には，空白をいれる ことが可能ですし，+，-などのメソッドが定義されていれば， +=，-=などの自己代入も行えます．

Object#instance_evalを使えば，直接参照することもできます．

5.5 privateとprotectedの違いが分かりません

privateの意味は，メソッドを関数形式でだけ呼び出せるようにし， レシーバー形式では呼び出せないようにするという意味です．したがって， 可視性がprivateなメソッドは，自クラス及びサブクラスからしか参照 できません．

protectedも同様に，自クラス及びサブクラスからしか参照できませんが， 関数形式でもレシーバー形式でも呼び出せます．

メソッドのカプセル化に必要な機能です．

5.6 インスタンス変数をpublicにしたいのですが

インスタンス変数をpublicにすることはデータのカプセル化という観点から見 て好ましくありませんので，Rubyではインスタンス変数へのアクセスはアクセス メソッドを使って行います．attrメソッドを使うことで外部からみると 変数にアクセスしているかのように振舞わせることが可能です． 
class Foo
  def initialize(str)
    @name = str
  end
  attr("name")
  # これはこういうことです．
  # def name
  #   return @name
  # end
end

foo = Foo.new("Tom")
print foo.name, "\n"         # Tom
attr(name, public)で省略可能な二番目の引数にTRUEを指定するこ とで書き込みメソッドを提供することも可能です． 
class Foo
  def initialize(str)
    @name = str
  end
  attr("name", true)
  # これはこういうことです．
  # def name
  #   return @name
  # end
  # def name=(str)
  #   @name = str
  # end
end

foo = Foo.new("Tom")
foo.name = "Jim"
print foo.name, "\n"    # Jim
Module#attr_reader, attr_writer, attr_accessorも 参照してください．

5.7 メソッドの可視性を指定したいのですが

最初に断わっておくと，Rubyでは関数形式(レシーバを省略した形)でしか呼び 出すことのできないメソッドのことをprivateなメソッドと呼びます．ちょっ と変ってますね．

クラスのメソッドをprivateにすれば外部から呼び出すことができなくなりま す(ただしそのクラスのサブクラスからは呼び出すことができます)．クラス 内でしか呼び出すことのないメソッドはprivateにしておくとよいでしょう．

次のようにすればメソッドをprivateにすることができます． 
class Foo
  def test
    print "hello\n"
  end
  private :test
end

foo = Foo.new
foo.test
# -> test.rb:9: private method `test' called for #<Foo:0x400f3eec>(Foo)
クラスメソッドをprivateにするにはprivate_class_methodを使います． 
class Foo
  def Foo.test
    print "hello\n"
  end
  private_class_method :test
end

Foo.test
# -> test.rb:8: private method `test' called for Foo(Class)
同様にpublic，public_class_methodを用いることでメソッドを publicにすることができます．

デフォルトでは，クラス内でのメソッド定義はinitializeを除いてpublic， トップレベルではprivateになっています．

5.8 メソッド名に大文字で始まる識別子は使えますか

使えます．ただし，メソッド呼出しの時に引数を括る()を省略できません．

5.9 superがArgumentErrorになりますが

メソッド定義中でsuperと呼び出すと，引数がすべて渡されますので， 引数の数が合わないとArgumentErrorになります．異なる数の引数を 指定するには，super()に引数を指定してやります．

5.10 2段階上の同名のメソッドを呼びたいのですが

superは，1段上の同名のメソッドを呼び出します．それより上の同名の メソッドを呼び出すには，あらかじめそのメソッドをaliasしておきます．

5.11 組込み関数を再定義した時に，元の関数を呼びたい時はどうしますか

メソッド定義の中ではsuperが使えます．再定義する前にalias しておくと，元の定義が保たれます． Kernelの特異メソッドとしても呼べます．

5.12 破壊的メソッドとは何ですか

オブジェクトの内容を変更してしまうメソッドで，文字列や配列，ハッシュ などにあります．同名のメソッドがあって，一方はオブジェクトのコピーを 作って返し，もう一方は変更されたオブジェクトを返すようになっている場合， !のついた方が破壊的メソッドです．Array#filterのように!がつかない メソッドでも破壊的なものはあります．

5.13 副作用が起こるのはどんな時ですか

実引数であるオブジェクトに対して，メソッドの中から破壊的メソッドを 適用した場合です. 
def foo(str)
  str.sub!(/foo/, "baz")
end

obj = "foo"
foo(obj)
print obj
# -> "baz"
この場合，引数となったオブジェクトが変更されています．でも，これは，プログラム の中で必要があって副作用のあるメッセージをオブジェクトに対し て送っているので当たり前です．

5.14 メソッドから複数の戻り値を返すことはできますか

Rubyでは，メソッドの戻り値は一つしか指定できませんが， 配列を使うことによって，複数の戻り値を返すことができます． 
return 1, 2, 3
とすると配列が返されます．つまり， 
return [1, 2, 3]
とするのと同じです．

さらに多重代入を利用すると，複数の戻り値を戻すのとほとんど同じことがで きます．たとえば， 
def foo
  return 20, 4, 17
end

a, b, c = foo
print "a:", a, "\n" # -> a:20
print "b:", b, "\n" # -> b:4
print "c:", c, "\n" # -> c:17
こんなことができるわけです．
前のページ 次のページ 目次 rubyfaq-jp/rubyfaq-jp-6.html100644 23421 144 15234 6773675606 15222 0ustar akendousers Ruby FAQ: クラス，モジュール 前のページ 次のページ 目次

6. クラス，モジュール

6.1 クラス定義は，一度に行わなければなりませんか

同じクラスを再定義すると，前のクラス定義に追加されていきます． メソッドを再定義した場合には後のものが上書きしますので，前のものは 失われます．

6.2 クラス変数はありますか

Rubyにはクラス変数に相当するものはありません．コンテナクラス (Array，Hashなど)をクラス定数にして代りに使ってください． 
class Foo
  F = [0]
  def foo
    F[0] += 1
    print F[0], "\n"
  end
end

6.3 クラスのインスタンス変数とは何ですか 

class Foo
  @a = 123 # (1)
  def foo
    p @a  # (2) ... 123でなくnilになる．
  end
end
(1)がクラスのインスタンス変数，(2)が通常のインスタンス変数です．(2)は クラスFooのインスタンスに属するのに対し，(1)はFooというクラ スオブジェクト(Classのインスタンス)に属します．

インスタンスメソッドからクラスのインスタンス変数に直接アクセスすること はできません．

上のように初期化されていないインスタンス変数とみなされ，nilになり ます．

6.4 特異メソッドとは何ですか

特異メソッドは特定のインスタンスに固有のメソッドです．

こんな感じで使います． 
foo = Foo.new
def foo.hello
  print "Hello\n"
end
foo.hello
クラスにあるメソッドを追加したいが，わざわざサブクラスを作るほどのこと でもない，といった場合に有効です．

Javaをやってる人は匿名のインナークラスに似てると思うかもしれませんね．

6.5 クラスメソッドはありますか

クラスの特異メソッドをクラスメソッドと呼びます．特異メソッドは オブジェクトの固有のメソッドだと説明したばかりですが，Rubyには， メタクラスという概念があり，すべてのクラスは，同名のメタクラスと いうものを持っていて，これは，Classクラスのインスタンスになって います．ここにクラスメソッドが定義されます．

形式的にはクラス名をレシーバーとして呼べるメソッドということに なります．

ClassのインスタンスであるFooの特異メソッドを考えてみま しょう． 
class Foo
  def Foo.test
    print "this is foo\n"
  end
end
呼び出す時はこうです． 
Foo.test
何か気付きませんか？

そう，これはいわゆるクラスメソッドですね．

もちろんClassで定義されているメソッドもクラスメソッドとして使えま す．

6.6 特異クラスとは何ですか

すでに特異メソッドについては 触れました．

簡単におさらいするとRubyではオブジェクト(インスタンス)に対してメソッド を追加することができるわけです．

この考えをもう少し進めるとクラスに対する他の操作をオブジェクトに対して も行えるようにしたくなってきませんか？

なってこないよ，と言わないで(^^;

これを可能にするのが特異クラスという機構です． 
class Foo
  def hello
    print "hello.\n"
  end
end

foo = Foo.new
foo.hello

# -> hello.

class << foo
  attr :name, TRUE
  def hello
    print "hello. I'm ", @name, ".\n"
  end
end

foo.name = "Tom"
foo.hello

# -> hello. I'm Tom.
なんかすごいですよね．

ではここで問題．

Q. private_class_methodを使わずにクラスメソッドをprivateにす るにはどうすればよいでしょう？

ヒント: クラスメソッドはクラスの特異メソッドでしたね．

ちょっとトリッキーですが，こんなふうにできます． 
class Foo
  ...
end

class << Foo
  def class_method
    print "class method\n"
  end
  private :class_method
end
Foo.class_method " # -> Error
特異メソッドを定義するには，このように特異クラスで定義する方法と 直接 def obj.method という風に定義してしまう方法があります．

ちょっと性格は違いますが，モジュールでは，モジュール関数にする ことにより，特異メソッド(と同時にprivateメソッド)を定義する ことができます．

6.7 モジュール関数とは何ですか

モジュールの特異メソッドとして，また同時にprivateメソッドして定義されて いるメソッドをRubyではモジュール関数と呼びます．例えば 
Math.sqrt(2)
のように用いることも， 
include Math
sqrt(2)
のようにincludeして用いることもでき，とても便利です．

あるメソッドをモジュール関数にするには，モジュール定義の中で 
module_function :method_name
とします．

6.8 クラスとモジュールの違いは何ですか

モジュールはインスタンスを作れません． クラスはincludeすることができません．

6.9 モジュールはサブクラスを作りますか

モジュールは，クラス(モジュール)にincludeされることにより，多重継承に 相当するMix-inを実現します．これは直接の継承であるサブクラスとは 異なりますが，includeされたクラスは，モジュールとis_a?の関係を 持ちます．

6.10 クラス定義の中でクラスメソッドを定義するのと，トップレベルでクラスメソッドを定義する違いは何ですか

前者では定数を直接参照することができます．後者ではクラス名をつけて参照 しなければなりません．

6.11 loadとrequireはどう違いますか

loadはRubyで書かれたソース(*.rb)のみロードします．

requireは*.oファイルもロードします．さらに一度 requireしたファイルは2度requireしてもロードしません．

ロードパスも違います．

6.12 includeとextendはどう違いますか

includeはmoduleをクラス(モジュール)にインクルードして， メソッドを関数形式で呼べるようにし，extendは moduleをオブジェクト(インスタンス)にインクルードして，メソッドを 特異メソッドとして追加します．

6.13 self というのは何ですか

selfは，メソッドが適用されるオブジェクトそれ自身を表わします． 関数形式のメソッドは，selfをレシーバーとします．
前のページ 次のページ 目次 rubyfaq-jp/rubyfaq-jp-7.html100644 23421 144 31113 6773675606 15215 0ustar akendousers Ruby FAQ: 組込みライブラリ 前のページ 次のページ 目次

7. 組込みライブラリ

7.1 instance_methods(nil)は何を返しますか

instance_methodsは，あるクラスのオブジェクトが持つメソッドを 返しますが，instance_methods(nil)は，スーパークラスから引き継いだ ものではなく，そのクラスで初めて定義されたメソッドを返します．

7.2 randがいつも同じ乱数列を出しますが

randは，プログラムが実行される度に同じ乱数列を生成します． 異なる乱数列を生成させるためには，srandで毎回異なる乱数の 種を与えてやる必要があります．srandを引数なしで呼ぶと，その時の 時間を種にしますので，異なる乱数列を生成させることができます．

7.3 0から51の中から重複のない5つをランダムに選ぶにはどうしますか

次のメソッドは，0からnまでの数の中からm個をランダムに選んだ配列を返します． 
def sample(n, m)
  if m.zero?
    []
  else
    s = sample(n-1, m-1)
    t = rand(n+1)
    s.concat s.include?(t) ? n : t
  end
end
再帰形でなく書けば，次のとおりです． 
def sample(n, m)
  s = []
  ((n-m)...n).each do |j|
    t = rand(j+2)
    s.concat s.include?(t) ? j+1 : t
  end
  s
end

7.4 Fixnum，true，nil，falseが 即値だということですが，参照との違いは何ですか

特異メソッドを定義できないという制限があります．また，同じ数を 表わすFixnumのインスタンスは常に同じものになりますので， インスタンス変数を定義した場合には，それも同じものを示すことに なります．

7.5 nilとfalseはどう違いますか

持っているメソッドの違いは，nil.methods - false.methodsと false.methods - nil.methodsを表示してください．

ハッシュでは，nilを値として持つことができませんが， falseを持つことはできます．

メソッドが真偽を返す時は，true，falseを，そうでない 時は値かnilを返すようにすることが好まれます．

?のつくメソッドは，真偽を返すのが一般的ですが， そうでないものもあります．

7.6 ファイルを読み込んで書き換えても変化しません 

open("example", "r+").readlines.each_with_index{|l, i|
  l[0,0] = (i+1).to_s + ": "}
とやっても，exampleに行番号がつきません． ファイルを書き換えているのではなく，readlinesで読み込んだ文字列を 変えているだけです．ファイルに書き戻してやらなければいけません． 
io = open("example", "r+")
ary = io.readlines
ary.each_with_index{|l, i| l[0,0] = (i+1).to_s + ": "}
io.rewind
io.print ary
io.close

7.7 同じ名前のファイルに書き戻したいのですが

コマンドラインオプションの-i，もしくは，組込み変数$-i に""を指定することにより，同じ名前のファイルに書き戻すことができます．

上の問題は，次のように書くことができます． 
$ ruby -i -ne 'print "#$.: #$_"' example
元のファイルを残しておきたければ，-i.bakなどとしてください．

7.8 ファイルに書き込んでそのファイルをコピーしましたが，全部コピーされません 

open('file', 'w').print "This is a file.\n"
system 'cp file copy'
とやったのでは，コピーする時にfileに内容がフラッシュされて いません．きちんとcloseしてからコピーしましょう． 
f = open('file', 'w')
f.print "This is a file.\n"
f.close
system "cp file copy"

7.9 パイプでlessに文字列を渡したのですが，表示されません 

f = open '|less', 'w'
f.print "abc\n"
とやっても，直ちに終了してしまい，lessで眺めることができません． closeしてやると，そこでlessの終了を待ちます． 
f = open '|less', 'w'
f.print "abc\n"
f.close
最初の行は，f = IO.popen 'less', 'w'としても同じ結果となります．

7.10 参照されないFileオブジェクトはどうなりますか

open("file").readというように参照されないFile オブジェクトは，次のガーベッジコレクションでcloseされて 捨てられます．

7.11 ファイルをcloseしないのは気持ちが悪いのですが

参照されなくなったFileオブジェクトは，GCで自動的にクローズ されますが，明示的にクローズするには，次の3つの構文から選んで下さい． 
(1)
a = open "file"
begin
  a.each {|l| print l}
ensure
  a.close
end
(2)
IO.foreach("file") {|l| print l}
(3)
IO.readlines("file").each {|l| print l}

7.12 ファイルを時間の新しい順にソートしたいのですが 

Dir.glob("*").filter{|f| [File.mtime(f), f]}.
  sort{|a,b| b[0]<=>a[0]}.filter{|e| e[1]}
とすると，カレントディレクトリの"."，".."以外のファイルを更新時間の 新しい順にソートした配列を返します．更新時間の古い順にソートする なら，sortの後ろのブロックはなしにしても，いいですね． 
Dir.glob("*").sort{|a,b| File.mtime(b)<=>File.mtime(a)}
でもソートすることができますが，比較する度にファイルにアクセスして 更新時間を調べますので，ソートするのに時間がかかります．

7.13 ファイル中の単語の出現頻度を調べたいのですが

ハッシュのデフォルト値に0を指定して，次のようにすることができます． 
freq = Hash.new(0)
open("file").read.scan(/\w+/){|w| freq[w] += 1}
freq.keys.sort.each {|k| print k, "--", freq[k], "\n"}

7.14 条件に文字列を使ったとき，文字列が空("")の時にもtrueになります

Rubyでは，nilとfalseだけが偽で，それ以外はすべて真に なります．文字列が空かどうかを知るには，""と比較，empty?を使う， lengthを0と比較するなどの方法があります．

7.15 英語文字列の配列を辞書順にソートしたいのですが 

ary.filter{|f| [f.downcase, f]}.sort.filter{|e| e[1]}
とします．downcaseで等しくなった場合に，元の文字列で比較を行うのが tipsです．

7.16 "abcd"[0]は，何を返しますか

文字aのコード97(Fixnum)を返します．これが文字aと一致するかどうか 調べるには，?aと比較します．

7.17 タブをスペースに展開したいのですが

aに展開したい文字列があるとして，次のどれかを使えばいいでしょう． 
1 while a.sub!(/(^[^\t]*)\t(\t*)/){$1+' '*(8-$1.size%8+8*$2.size)}
1 while a.sub!(/\t(\t*)/){' '*(8-$~.begin(0)%8+8*$1.size)}
a.gsub!(/([^\t]{8})|([^\t]*)\t/n){[$+].pack("A8")}

7.18 バックスラッシュをエスケープするにはどうしますか

Regexp.quote('\\')で，エスケープされます．

gsubを使う場合には，gsub(/\\/, '\\\\')では，置換文字列が 構文解析で一度'\\'に変換され，実際に置き換えるときにもう一度'\'と 解釈されるので， gsub(/\\/, '\\\\\\')とする必要があります．\&がマッチ文字列を あらわすことを使えば，gsub(/\\/,'\&\&')と書けます．

gsub(/\\/){'\\\\'}とブロックを使う形にすれば，エスケープが1回しか 解釈されませんので，求める結果が得られます．

7.19 subとsub!はどう違うのですか

subの場合はレシーバの状態は変化しません．文字列のコピーが 作られ，それに置換がほどこされて(置換が必要なければそのまま)返されます．

sub!ではレシーバそのものが変更されます．変更がない時には nilが返されます．

sub!のようにレシーバの状態を変化させるメソッドを 破壊的メソッドと 呼びます．Rubyでは同名のメソッドで破壊的なものとそうでないものがある場 合，破壊的なメソッドには慣例的に!をつけます． 
def foo(str)
    str = str.sub(/foo/, "baz")
end

obj = "foo"
foo(obj)
print obj
# -> "foo"

def foo(str)
    str = str.sub!(/foo/, "baz")
end

foo(obj)
print obj
# -> "baz"
sub!のように破壊的なメソッドは予期しない効果をもたらすことがある ので，使用する場合は十分注意してください．

7.20 \Zのマッチする場所はどこですか

\Zは，文字列の最後の文字が\nでない時は文字列の末尾に， \nのときはこの改行の前にマッチします．

7.21 範囲オブジェクトのコンストラクタ..と...はどう違いますか

..は終端を含み，...は終端を含みません．

7.22 関数ポインタはありますか

Proc.new，proc，lambdaでProcオブジェクトを作れば， 関数ポインタのような働きをさせることができます．

7.23 threadとforkはどう使い分けるのですか

thread，forkはそれぞれ以下のような特徴を持っています． 一般にforkとthreadを混ぜるのはよくないようです．

あと，Rubyのthreadはタイムシェアリング方式なので，threadを使 うことによって処理が速くなることはありません．

7.24 Marshalの使い方を教えてください

オブジェクトをファイルや文字列に格納しておき，後で再生できる ようにするものです．格納は 
Marshal.dump obj, io, lev
という形式で行います．ioには書き込み可能なIOオブジェクト，levは オブジェクトが内容として他のオブジェクトを持っている時に，どこ までオブジェクトの内容を格納するかを決めます．lev段までオブジェクト をdumpしてもまだオブジェクトがある時には，そのオブジェクトのdumpは オブジェクトの参照になりますので，再生した時には，参照が変わって いるでしょうから，再生できないことになります．levのデフォルトは 100になっています．ioを省略した時には，文字列でdumpされます．

再生は 
obj = Marshal.load io
または， 
obj = Marshal.load str
という形式で，ioはdumpしたファイルを読み込み可能でopenしたもの， strはdumpした文字列を指定します．

7.25 例外処理はありますか

他の先進的な言語と同様にRubyも例外処理をサポートします． 
begin
  (例外が発生しそうな処理)
rescue (例外クラス)
  (例外が発生した場合の処理)
ensure
  (必ず実行したい処理)
end
begin節で例外が発生するとrescue節が実行されます． ensure節は例外が発生してもしなくても必ず実行されます．rescue やensureは省略できます．rescureの後ろに例外クラスが 指定されなかった場合は StandardErrorが指定されたものとみなされ，StandardErrorの サブクラスである例外が捕捉されます．

この式の値は，begin節の値です．

もっとも最近起った例外はグローバル変数$!により参照できます． 発生した例外の種類は$!.typeにより調べることができます．

7.26 trapはどのように使いますか 

trap("PIPE") {raise "SIGPIPE"}
前のページ 次のページ 目次 rubyfaq-jp/rubyfaq-jp-8.html100644 23421 144 5107 6773675606 15202 0ustar akendousers Ruby FAQ: 拡張ライブラリ 前のページ 次のページ 目次

8. 拡張ライブラリ

8.1 Rubyを対話型で使いたいのですが

ftpサイトのcontrib/から，irb-x.x.x.tgzをgetし，README-installに したがってinstallしてください．使い方はREADMEにあります．

8.2 デバッガはありますか

あります．Rubyを次のように起動してください． 
  ruby -r debug your_script

8.3 C言語で書かれたライブラリをRubyで使いたいのですが

RubyはCで書かれています．さらに，Cで書かれたライブラリを Rubyで利用できるようにするための部品もととのっていますので， Cで書かれたライブラリとRubyとの間のインターフェースを書くことに より，Rubyから使えるライブラリができます．

まず，Rubyのソースを展開したディレクトリにある，README.EXT.jp を読んでみましょう．この文書はRubyそのものについて知るためにも よいドキュメントになっています．

次にext/ディレクトリの下にあるサブディレクトリを覗いてみると 実例が出てきます．ftpサイトのcontribにあるものも参考になる ことでしょう．

8.4 Tcl/Tkのインターフェースはありますか

標準で添付されている拡張ライブラリに，Tcl/Tkのインターフェースが あります．一つは，ext/tcltk/以下のrequire "tcltk"で ロードされるインタ ーフェースで，TclスクリプトをRubyスクリプト中に埋め込むよ うな記述になります。

もう一つはext/tk/以下のrequire "tk"でロードされるインターフェースで、 こちらはよりRubyらしい記述でTkのGUIを実現することができます。

8.5 Tkが動かないのですが

お使いのTkのバージョンが古い可能性があります．新しいものと交換してみて ください．

8.6 gtk+，xformsのインターフェースはありますか

ftpサイトのcontrib/に，ruby-gtk-x.xx.tar.gz， ruby-forms-x.x.tar.gzとして置かれています．

8.7 日付の計算をしたいのですが

Timeオブジェクトは，1970年1月1日から2038年1月19日までしか 表せません．標準添付ライブラリを使って，require "date" もしくはrequire "date2"としてください． date.rbはイギリス歴に固定されていますが，date2.rbは 汎用になっています．sample/cal.rbも参照してください．
前のページ 次のページ 目次 rubyfaq-jp/rubyfaq-jp-9.html100644 23421 144 1755 6773675606 15210 0ustar akendousers Ruby FAQ: ドキュメントされていない機能 前のページ 次のページ 目次

9. ドキュメントされていない機能

9.1 a ? b : cというのは何ですか

if a then b else c endと同値です．

9.2 ファイルの行数を数えたいのですが

ファイルの最後にも改行があるものと仮定して，次のが一番速いでしょう． open("file").read.count("\n")

9.3 MatchingDataのbegin，endは何を返しますか

$~に作用して，$0，$1などの元の文字列での開始位置，終了位置を 返します．タブ展開の例を参照してください．
前のページ 次のページ 目次 rubyfaq-jp/rubyfaq-jp-10.html100644 23421 144 3271 6773675606 15253 0ustar akendousers Ruby FAQ: 日本語の取り扱い 前のページ 次のページ 目次

10. 日本語の取り扱い

10.1 日本語の識別子は使えますか

デフォルトのEUCでは，英小文字に相当するものとして使えます． ポータビリティが低いのでおすすめできません．識別子では ありませんが，Hashのキーには当然使えますね．

10.2 日本語を含む文字列から1文字ずつ文字列を取り出すにはどうしますか

split(//)やscan(/./)を使います．

10.3 tr("あ","a")がうまく動きません

組込みのtrは，バイトごとに変換します．require "jcode"とすると， 日本語を文字ごとに扱えます．

10.4 ひらがなをソートするにはどうしますか

require "jcode"
a = "ぁぃぅぇぉがぎぐげござじずぜぞだぢづでど"
a.concat "ばびぶべぼぱぴぷぺぽゃゅょっゎ"
b = "あいうえおかきくけこさしすせそたちつてと"
b.concat "はひふへほはひふへほやゆよつわ"
ary.filter{|l| [l.tr(a,b), l]}.sort.filter{|e| e[1]}

10.5 SJISの機種依存コード84BF から 889Fまでを空白に置き換えたいのですが

正規表現で[あ-ん]というような範囲表現が使えますが，機種依存コードを直接 ここにいれてしまうのは，プログラムの可読性を損ないます． 
gsub(/#{"[\x84\xbf-\x88\x9f]"}/s, '　')
とすると，2バイトコードの範囲をうまく表現して，空白に置き換えることが できます．
前のページ 次のページ 目次