Bug #73
File のクラスメソッドの,ファイルを表わす引数
| Status: | Closed | Start date: | 02/20/2008 | |
|---|---|---|---|---|
| Priority: | Low | Due date: | ||
| Assignee: | % 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