1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00

* dir.c: [DOC] add docs for :encoding option.

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@42058 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
ktsj 2013-07-19 04:40:07 +00:00
parent e9c0450960
commit 8dd4a3c604

21
dir.c
View file

@ -416,8 +416,12 @@ dir_s_alloc(VALUE klass)
/* /*
* call-seq: * call-seq:
* Dir.new( string ) -> aDir * Dir.new( string ) -> aDir
* Dir.new( string, encoding: enc ) -> aDir
* *
* Returns a new directory object for the named directory. * Returns a new directory object for the named directory.
*
* The optional <i>enc</i> argument specifies the encoding of the directory.
* If not specified, the filesystem encoding is used.
*/ */
static VALUE static VALUE
dir_initialize(int argc, VALUE *argv, VALUE dir) dir_initialize(int argc, VALUE *argv, VALUE dir)
@ -469,7 +473,12 @@ dir_initialize(int argc, VALUE *argv, VALUE dir)
/* /*
* call-seq: * call-seq:
* Dir.open( string ) -> aDir * Dir.open( string ) -> aDir
* Dir.open( string, encoding: enc ) -> aDir
* Dir.open( string ) {| aDir | block } -> anObject * Dir.open( string ) {| aDir | block } -> anObject
* Dir.open( string, encoding: enc ) {| aDir | block } -> anObject
*
* The optional <i>enc</i> argument specifies the encoding of the directory.
* If not specified, the filesystem encoding is used.
* *
* With no block, <code>open</code> is a synonym for * With no block, <code>open</code> is a synonym for
* <code>Dir::new</code>. If a block is present, it is passed * <code>Dir::new</code>. If a block is present, it is passed
@ -1900,8 +1909,10 @@ dir_open_dir(int argc, VALUE *argv)
/* /*
* call-seq: * call-seq:
* Dir.foreach( dirname ) {| filename | block } -> nil * Dir.foreach( dirname ) {| filename | block } -> nil
* Dir.foreach( dirname ) -> an_enumerator * Dir.foreach( dirname, encoding: enc ) {| filename | block } -> nil
* Dir.foreach( dirname ) -> an_enumerator
* Dir.foreach( dirname, encoding: enc ) -> an_enumerator
* *
* Calls the block once for each entry in the named directory, passing * Calls the block once for each entry in the named directory, passing
* the filename of each entry as a parameter to the block. * the filename of each entry as a parameter to the block.
@ -1931,12 +1942,16 @@ dir_foreach(int argc, VALUE *argv, VALUE io)
/* /*
* call-seq: * call-seq:
* Dir.entries( dirname ) -> array * Dir.entries( dirname ) -> array
* Dir.entries( dirname, encoding: enc ) -> array
* *
* Returns an array containing all of the filenames in the given * Returns an array containing all of the filenames in the given
* directory. Will raise a <code>SystemCallError</code> if the named * directory. Will raise a <code>SystemCallError</code> if the named
* directory doesn't exist. * directory doesn't exist.
* *
* The optional <i>enc</i> argument specifies the encoding of the directory.
* If not specified, the filesystem encoding is used.
*
* Dir.entries("testdir") #=> [".", "..", "config.h", "main.rb"] * Dir.entries("testdir") #=> [".", "..", "config.h", "main.rb"]
* *
*/ */