ruby-104/ruby/io.c

127 #undef open
128 #define open	rb_w32_uopen
218     ret = open(pathname, flags, mode);
665  *     f = open("/tmp/zz.gz")       #=> #<File:/tmp/zz.gz>
666  *     z = Zlib::GzipReader.open(f) #=> #<Zlib::GzipReader:0x81d8744>
2675  *     open("file") {|f|
2681  *     open("fixed-record-file") {|f|
2689  *     open("variable-record-file") {|f|
3871  *     f = open("/dev/null")
3913  *     f = open("/dev/null")
6154  *  Document-method: File::open
6157  *     File.open(filename, mode="r" [, opt])                 -> file
6158  *     File.open(filename [, mode [, perm]] [, opt])         -> file
6159  *     File.open(filename, mode="r" [, opt]) {|file| block } -> obj
6160  *     File.open(filename [, mode [, perm]] [, opt]) {|file| block } -> obj
6162  *  With no associated block, <code>File.open</code> is a synonym for
6166  *  will be returned from <code>File.open</code>.
6175  *  Document-method: IO::open
6178  *     IO.open(fd, mode="r" [, opt])                -> io
6179  *     IO.open(fd, mode="r" [, opt]) { |io| block } -> obj
6181  *  With no associated block, <code>IO.open</code> is a synonym for IO.new.  If
6184  *  In this instance, IO.open returns the value of the block.
6256  *     open(path [, mode [, perm]] [, opt])                -> io or nil
6257  *     open(path [, mode [, perm]] [, opt]) {|io| block }  -> obj
6262  *  as the name of a file to open using the specified mode (defaulting to
6266  *  must be bitwise-or of open(2) flags, such as File::RDWR or File::EXCL.  If
6274  *  +perm+ parameter.  See File.new and the open(2) and chmod(2) man pages for
6291  *  When the subprocess is ruby (opened via <code>"|-"</code>), the +open+
6292  *  call returns +nil+.  If a block is associated with the open call, that
6303  *     open("testfile") do |f|
6313  *     cmd = open("|date")
6323  *     f = open("|-", "w+")
6337  *     open "|-" do |f|
7172  *  IO.new is called by various File and IO opening methods such as IO::open,
7173  *  Kernel#open, and File::open.
7179  *  open(2) man page for more information.
7188  *  +fmode+ is an IO open mode string, +ext_enc+ is the external encoding for
7193  *  Ruby allows the following open modes:
7222  *  When the open mode of original IO is read only, the mode cannot be
7223  *  changed to be writable.  Similarly, the open mode cannot be changed from
7242  *  UTF-16 encodings the file open mode must be binary.  When present, the BOM
7275  *    If the value is +false+, the +fd+ will be kept open after this IO
7382  *  open(2) and chmod(2) man pages for details.
7417 	rb_warn("%s::new() does not take block; use %s::open() instead",
7463  *     f = open("/dev/null")
7468  *     f = open("/dev/null")
8362  *  * :normal - No advice to give; the default assumption for an open file.
9173  *  there are any writers with the pipe still open. In the case of the
9339  *  If the last argument is a hash, it's the keyword argument to open.
9377  *  If the last argument is a hash, it's the keyword argument to open.
9424  *  open().  The key would be the following.  open_args: is exclusive
9436  *    specifies mode argument for open().  It should start with "r"
9441  *    specifies arguments for open() as an array.
9482  *  The open mode would be "rb:ASCII-8BIT".
9573  *  open().  The key would be the following.  open_args: is exclusive
9583  *    specifies mode argument for open().  it should start with "w" or "a" or "r+"
9588  *    specifies perm argument for open().
9592  *    specifies arguments for open() as an array.
11491  *    File.open("/etc/hosts") {|f| f << "example"}
11494  *    File.open("/etc/hosts") {|f| f.close; f.read }
11500  *    File.open("does/not/exist")
11515  *    file = File.open("/etc/hosts")
11572  *  The Kernel#open method can create an IO (or File) object for these types
11588  *  Kernel#open for details of the various command formats described above.
11673     rb_define_global_function("open", rb_f_open, -1);
11696     /* This is necessary only for forcing rdoc handle File::open */
11697     rb_define_singleton_method(rb_cFile, "open",  rb_io_s_open, -1);
11702     rb_define_singleton_method(rb_cIO, "open",  rb_io_s_open, -1);