Bug #73

File のクラスメソッドの,ファイルを表わす引数

Added by Ken DATE over 3 years ago. Updated 9 months ago.

[ruby-reference-manual:851]
Status:Closed Start date:02/20/2008
Priority:Low Due date:
Assignee:Takashi Tamura % Done:

0%

Category:doc
Target version:-
reporter:rock ruby_version:1.8,1.9

Description

File のクラスメソッドで,ファイルのパス(文字列)を渡しても,
IO オブジェクトを渡してもよいものがいくつかあります。ここの記述に若干気になる点があります。

たとえば,File.atime は呼び出し形式が atime(filename) となっているのに,File.file? の場合は
file?(path) です。同じ位置づけの引数が filename / path と一貫していません。
[PARAM] の説明にきちんと書いてあるとはいえ,引数名から,ファイル名やパスを渡さないといけないかと勘違いしそうです。

また,パスを渡すには Pathname オブジェクトなど to_str できるものなら何でもいいわけですが,
[PARAM] の説明だと文字列でなければならないと誤解しそうです。(私はしばらく勘違いしてました)

History

Updated by Ken DATE over 3 years ago

sheepman (2008-02-21 (木) 08:14:09)

> to_str できるものなら何でもいい

暗黙の型変換に関しては、メソッド毎でなくどこかで統一的に説明すべきだと思います。 

Updated by Takashi Tamura over 3 years ago

  • Status changed from Open to Closed

Also available in: Atom PDF