[ruby-list:15321] Re: rubyfaq-990702.tar.gz

稲葉です．

遠藤さんの rubyfaq の修正案です．遠藤さんが最初にメモをMLに出された時
から書きたかったんですが，時間がとれなくて今になってしまいました．

#思った以上に長くなってしまいました...
------
追加したい項目:

Q. オブジェクトにメッセージを送った時に実行されるメソッドはどのように
   捜されますか？
A. (MLで話題になった事があるに違いないんだけど, 見つけられませんでした)
------
>  2.1 ローカル変数のスコープはどのように決められていますか
                :
>     ブロック内が特別になっているのは，Threadや手続きオブジェクトの中で局所
>     化するためです．

   「ローカル変数を局所化するため」と明確に書くべきだと思います. 正確に
は
「局所化できるようにするため」でしょうか.
------
>  2.4 変数や定数にメソッドを適用すると予期しないことが起こりますが

   「変数や定数の値が知らないうちに変化してしまう事がありますが」と
   した方がFAQを調べる人に回答内容がわかるのではないでしょうか．
------
>  3.2 ブロックはイテレータの中でどのように使われますか

   回答ではイテレータという単語を使っていないので，「ブロックはメソッ
   ドの中でどのように使われますか」の方がいいと思います．

>     メソッドの中からブロックを実行するには，

   yeild以外は直接の実行とは言えないと思うので．
   「ブロックを使用するには」としたいです．

>                                              yield制御構造，ブロック引数，
>     Proc.newの3種類の方法で行うことができます．

   この3種類の他にも, Cの拡張ライブラリで書けばできる気がします．「ス
   クリプトのみの場合」というただしがきを追加した方が正確だと思います．
------
>  3.4 ブロックに引数を渡すにはどうしますか

>     ブロックの先頭に，仮引数を||で囲って置くと，実引数が多重代入されます．

   この仮引数が，メソッドの仮引数とちがってブロック内スコープに新し
   く導入された変数とは限らない事を強調したいのですが...
------
>  4.1 +や-は演算子ですか

>     +や-などは演算子ではなくメソッド呼び出しです．したがってオーバーライド
>     することもできます．

   以下4.1の回答ではオーバーライドという語が使われています．自分はこ
   こでの説明では「オーバーライド」(上書き)ではなく，「オーバーロード」
   (多重定義)という語の方がしっくりきます．(もちろんオーバーライドも
   できるのですが)
------
>  4.2 関数はありますか

>     厳密に言えばRubyに関数はありません．Rubyにおける関数(みたいなもの)はす
> べてレシーバを省略した形のメソッドです．

   以下のようなruby-manの組込み関数と用語集の説明を混ぜあわせた追加説
   明はどうでしょう．

   「特に, クラスObject(またはObjectがインクルードしているモジュール)
   で定義されたメソッドは全ての通常のインスタンスをselfとする環境から
   関数形式で呼び出せます．これらのメソッドでselfの状態にかかわらず同じ
   値を返すものは一般の言語における関数のように用いられます」

> def writeln(str)
                :
> のように一見関数のように見えるものも，mainというオブジェクトのメソッド
> です．

   この説明だと，mainの特異メソッドになるように読めます.
   トップレベルでのdefはObjectクラスのメソッドになるのですよね？
------
>  4.9 引数は参照渡しですか

>     参照渡しです．したがって，参照されているオブジェクトが，自分の状態を変
>     更するメソッドを持っている時には，副作用(それが主作用かもしれません
>     が)に注意する必要があります．

   Pascal，Fortran等の言語で言う「参照渡し」の意味とは違うと思います．
   C++の「参照型」とも違いますし．「値渡しです. が，Rubyではほとんどの
   場合値そのものが参照なので，参照渡しの側面があります」という方がい
   いと思います. (初心者には難しい記述かもしれないけど..) Lispと同じな
   のは確かです.

   前田さんのFAQにあった以下の記述も取り入れた方がいいと思います．

   Q. 引数への代入をするとどうなりますか。
   A. 引数への代入を行ってもメソッドの呼び出し側には影響はありません

   Q. 引数にメッセージを送るとどうなりますか。
   A. 引数は呼び出し側のオブジェクトと同じオブジェクトなので，メッセー
      ジを送ることでオブジェクトの状態が変更される場合は呼び出し側にも影
      響があります。
------
>  4.14 破壊的メソッドとは何ですか

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

   「Array#filter等 !がつかない破壊的メソッドもあります.」を追加したい
   です．
------
>  6. 組込みライブラリ 

   この6節に集められている質問/回答を「組込みライブラリ」でまとめるの
   には違和感があります．
------
>  6.1 :exitというのは何ですか

   「:exit等の:のついたワードは何ですか？」の方がわかりやすいと思いま
す．

   それから, ここでString#internについて説明しても良いのではと思います．
------
>  6.2 シンボルから値を取り出すにはどうすればいいですか

   「シンボルと同名の変数の値を取り出すにはどうすればいいですか」
   の方が正確だと思います．
------
>  6.5 nilとfalseはどう違いますか
                :
>     ?のつくメソッドは，真偽を返す場合はtrue，falseを，そうでない時は値もし
>     くはnilを返します．

   正しくは「メソッドが真偽を返す場合はtrue，falseを，そうでない時は
   値もしくはnilを返す仕様にすることが好まれます．ただし言語とし
   て強制しているものではありません」だと思います．(でいいでしょうか？)

   「Ruby組込のメソッドはそのようになっているはずです」
   も加えてもいいかもしれません．

   ?のつくメソッドについては，
   「?のつくメソッドは真偽を返すメソッドにする事が期待されますが，
   歴史的事情からRuby組込のメソッドでそうなっていないものもあります」
------
>  6.6 ファイルを書き換えても変化しません
                :
>  io = open("example", "w+")

   "r+"の間違いだと思います．

>  ary = io.readlines
>  ary.each_with_index{|l, i| l[0,0] = (i+1).to_s + ": "}

   上2行は，以下でもいいですね.(Perl風?)
   
      ary = []
      ary.push "#$.: #$_" while io.gets

   この回答の中で-iオプションや$-i変数の説明をしても良いのではないでしょ
   うか？
------
>  6.9 ファイルを時間の新しい順にソートしたいのですが

>  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)}
------
>  6.10 ファイルの行数を数えたいのですが

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

   ruby-1.3.4-0531からできた UNDOCUMENTED なメソッドString#countを使え
   ば「open("file").read.count("\n")」がストレートでしょう．
   UNDOCUMENTED なので 8節に入れるべきかもしれません．
------
>  6.14 文字列から1文字ずつ文字列を取り出すにはどうしますか

   ASCIIのみならeach_byteで十分ですので，「日本語等マルチバイト文字を
   含む文字列から...」とした方がいいと思います．
------
>  6.16 タブをスペースに展開したいのですが

>     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)}

   gsub!とpackを使った以下の方法があります．

    a.gsub!(/([^\t]{8})|([^\t]*)\t/n){$+.pack("A8")}
--
			稲葉 浩人  <[e-mail]>