Class: ARGF

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Instance Chain: self, ::Enumerable
Inherits:	Object
Defined in:	io.c, io.c

Overview

ARGF is a stream designed for use in scripts that process files given as command-line arguments or passed in via STDIN.

The arguments passed to your script are stored in the ARGV ::Array, one argument per element. ARGF assumes that any arguments that aren't filenames have been removed from ARGV. For example:

$ ruby argf.rb --verbose file1 file2

ARGV  #=> ["--verbose", "file1", "file2"]
option = ARGV.shift #=> "--verbose"
ARGV  #=> ["file1", "file2"]

You can now use ARGF to work with a concatenation of each of these named files. For instance, #read will return the contents of file1 followed by the contents of file2.

After a file in ARGV has been read ARGF removes it from the ::Array. Thus, after all files have been read ARGV will be empty.

You can manipulate ARGV yourself to control what ARGF operates on. If you remove a file from ARGV, it is ignored by ARGF; if you add files to ARGV, they are treated as if they were named on the command line. For example:

ARGV.replace ["file1"]
ARGF.readlines # Returns the contents of file1 as an Array
ARGV           #=> []
ARGV.replace ["file2", "file3"]
ARGF.read      # Returns the contents of file2 and file3

If ARGV is empty, ARGF acts as if it contained STDIN, i.e. the data piped to your script. For example:

$ echo "glark" | ruby -e 'p ARGF.read'
"glark\n"

Class Method Summary

.new(argv) constructor Internal use only

Instance Attribute Summary

#binmode ⇒ ARGF readonly

Puts ARGF into binary mode.
#binmode? ⇒ Boolean readonly

Returns true if ARGF is being read in binary mode; false otherwise.
#closed? ⇒ Boolean readonly

Returns true if the current file has been closed; false otherwise.
#eof? ⇒ Boolean (also: #eof?) readonly

Returns true if the current file in ARGF is at end of file, i.e. it has no data to read.
#eof? ⇒ Boolean readonly

Alias for #eof.
#inplace_mode ⇒ String rw

Returns the file extension appended to the names of modified files under in-place edit mode.
#inplace_mode=(ext) ⇒ ARGF rw

Sets the filename extension for in-place editing mode to the given ::String.
#lineno ⇒ Integer rw

Returns the current line number of ARGF as a whole.
#lineno=(integer) ⇒ Integer rw

Sets the line number of ARGF as a whole to the given ::Integer.
#pos ⇒ Integer (also: #tell) rw

Returns the current offset (in bytes) of the current file in ARGF.
#pos=(position) ⇒ Integer rw

Seeks to the position given by position (in bytes) in ARGF.
#tell ⇒ Integer readonly

Alias for #pos.

Instance Method Summary

#argv ⇒ ARGV

Returns the ARGV array, which contains the arguments passed to your script, one per element.
#bytes

This is a deprecated alias for #each_byte.
#chars

This is a deprecated alias for #each_char.
#close ⇒ ARGF

Closes the current file and skips to the next file in ARGV.
#codepoints

This is a deprecated alias for #each_codepoint.
#each(sep = $/) {|line| ... } ⇒ ARGF (also: #each_line)

ARGF.each_line(sep=$/) {|line| block } -> ARGF.
#bytes {|byte| ... } ⇒ ARGF

ARGF.each_byte {|byte| block } -> ARGF.
#each_char {|char| ... } ⇒ ARGF

Iterates over each character of each file in ARGF.
#each_codepoint {|codepoint| ... } ⇒ ARGF

Iterates over each codepoint of each file in ARGF.
#each(sep = $/) {|line| ... } ⇒ ARGF

Alias for #each.
#external_encoding ⇒ Encoding

Returns the external encoding for files read from ARGF as an ::Encoding object.
#file ⇒ IO, File object

Returns the current file as an ::IO or ::File object.
#filename ⇒ String

Alias for #path.
#fileno ⇒ Integer

Alias for #to_i.
#getbyte ⇒ Integer^?

Gets the next 8-bit byte (0..255) from ARGF.
#getc ⇒ String^?

Reads the next character from ARGF and returns it as a ::String.
#gets(sep=$/ [, getline_args]) ⇒ String^?

Returns the next line from the current file in ARGF.
#inspect ⇒ String

Alias for #to_s.
#internal_encoding ⇒ Encoding

Returns the internal encoding for strings read from ARGF as an ::Encoding object.
#lines(*args)

This is a deprecated alias for #each_line.
#path ⇒ String (also: #filename)

Returns the current filename.
#print ⇒ nil

Alias for IO#print.
#printf(format_string [, obj, ...]) ⇒ nil

Alias for IO#printf.
#putc(obj) ⇒ Object

Alias for IO#putc.
#puts(obj, ...) ⇒ nil

Alias for IO#puts.
#read([length [, outbuf]]) ⇒ String, ...

Reads length bytes from ARGF.
#read_nonblock(maxlen[, options]) ⇒ String

Reads at most maxlen bytes from the ARGF stream in non-blocking mode.
#readbyte ⇒ Integer

Reads the next 8-bit byte from ARGF and returns it as an ::Integer.
#readchar ⇒ String^?

Reads the next character from ARGF and returns it as a ::String.
#readline(sep = $/) ⇒ String

Returns the next line from the current file in ARGF.
#readlines(sep = $/) ⇒ Array

Alias for #to_a.
#readpartial(maxlen) ⇒ String

Reads at most maxlen bytes from the ARGF stream.
#rewind ⇒ 0

Positions the current file to the beginning of input, resetting #lineno to zero.
#seek(amount, whence = IO::SEEK_SET) ⇒ 0

Seeks to offset amount (an ::Integer) in the ARGF stream according to the value of whence.
#set_encoding(ext_enc) ⇒ ARGF

If single argument is specified, strings read from ARGF are tagged with the encoding specified.
#skip ⇒ ARGF

Sets the current file to the next file in ARGV.
#readlines(sep = $/) ⇒ Array (also: #readlines)

ARGF.to_a(sep=$/) -> array.
#to_i ⇒ Integer (also: #fileno)

Returns an integer representing the numeric file descriptor for the current file.
#to_io ⇒ IO

Returns an ::IO object representing the current file.
#to_s ⇒ String (also: #inspect)

Returns “ARGF”.
#to_write_io ⇒ IO

Returns IO instance tied to ARGF for writing if inplace mode is enabled.
#write(string) ⇒ Integer

Writes string if inplace mode.
#initialize_copy(orig) Internal use only

::Enumerable - Included

#all?	Passes each element of the collection to the given block.
#any?	Passes each element of the collection to the given block.
#chunk	Enumerates over the items, chunking them together based on the return value of the block.
#chunk_while	Creates an enumerator for each chunked elements.
#collect	Alias for Enumerable#map.
#collect_concat	Alias for Enumerable#flat_map.
#count	Returns the number of items in `enum` through enumeration.
#cycle	Calls block for each element of enum repeatedly n times or forever if none or `nil` is given.
#detect	Alias for Enumerable#find.
#drop	Drops first n elements from enum, and returns rest elements in an array.
#drop_while	Drops elements up to, but not including, the first element for which the block returns `nil` or `false` and returns an array containing the remaining elements.
#each_cons	Iterates the given block for each array of consecutive <n> elements.
#each_entry	Calls block once for each element in `self`, passing that element as a parameter, converting multiple values from yield to an array.
#each_slice	Iterates the given block for each slice of <n> elements.
#each_with_index	Calls block with two arguments, the item and its index, for each item in enum.
#each_with_object	Iterates the given block for each element with an arbitrary object given, and returns the initially given object.
#entries	Alias for Enumerable#to_a.
#find	Passes each entry in enum to block.
#find_all	Alias for Enumerable#select.
#find_index	Compares each entry in enum with value or passes to block.
#first	Returns the first element, or the first `n` elements, of the enumerable.
#flat_map	Returns a new array with the concatenated results of running block once for every element in enum.
#grep	Returns an array of every element in enum for which `Pattern === element`.
#grep_v	Inverted version of Enumerable#grep.
#group_by	Groups the collection by result of the block.
#include?	Alias for Enumerable#member?.
#inject	Combines all elements of enum by applying a binary operation, specified by a block or a symbol that names a method or operator.
#lazy	Returns a lazy enumerator, whose methods map/collect, flat_map/collect_concat, select/find_all, reject, grep, grep_v, zip, take, take_while, drop, and drop_while enumerate values only on an as-needed basis.
#map	Returns a new array with the results of running block once for every element in enum.
#max	Returns the object in enum with the maximum value.
#max_by	Returns the object in enum that gives the maximum value from the given block.
#member?	Returns `true` if any member of enum equals obj.
#min	Returns the object in enum with the minimum value.
#min_by	Returns the object in enum that gives the minimum value from the given block.
#minmax	Returns a two element array which contains the minimum and the maximum value in the enumerable.
#minmax_by	Returns a two element array containing the objects in enum that correspond to the minimum and maximum values respectively from the given block.
#none?	Passes each element of the collection to the given block.
#one?	Passes each element of the collection to the given block.
#partition	Returns two arrays, the first containing the elements of enum for which the block evaluates to true, the second containing the rest.
#reduce	Alias for Enumerable#inject.
#reject	Returns an array for all elements of `enum` for which the given `block` returns `false`.
#reverse_each	Builds a temporary array and traverses that array in reverse order.
#select	Returns an array containing all elements of `enum` for which the given `block` returns a true value.
#slice_after	Creates an enumerator for each chunked elements.
#slice_before	Creates an enumerator for each chunked elements.
#slice_when	Creates an enumerator for each chunked elements.
#sort	Returns an array containing the items in enum sorted.
#sort_by	Sorts enum using a set of keys generated by mapping the values in enum through the given block.
#sum	Returns the sum of elements in an ::Enumerable.
#take	Returns first n elements from enum.
#take_while	Passes elements to the block until the block returns `nil` or `false`, then stops iterating and returns an array of all prior elements.
#to_a	Returns an array containing the items in enum.
#to_h	Returns the result of interpreting enum as a list of `[key, value]` pairs.
#uniq	Returns a new array by removing duplicate values in `self`.
#zip	Takes one element from enum and merges corresponding elements from each args.

Constructor Details

.new(argv)

This method is for internal use only.

[ GitHub ]

# File 'io.c', line 8339


static VALUE
argf_initialize(VALUE argf, VALUE argv)
{
    memset(&ARGF, 0, sizeof(ARGF));
    argf_init(&ARGF, argv);

    return argf;
}

Instance Attribute Details

#binmode ⇒ `ARGF` (readonly)

Puts ARGF into binary mode. Once a stream is in binary mode, it cannot be reset to non-binary mode. This option has the following effects:

Newline conversion is disabled.
::Encoding conversion is disabled.
Content is treated as ASCII-8BIT.

[ GitHub ]

# File 'io.c', line 12429


static VALUE
argf_binmode_m(VALUE argf)
{
    ARGF.binmode = 1;
    next_argv();
    ARGF_FORWARD(0, 0);
    rb_io_ascii8bit_binmode(ARGF.current_file);
    return argf;
}

#binmode? ⇒ `Boolean` (readonly)

Returns true if ARGF is being read in binary mode; false otherwise. To enable binary mode use #binmode.

For example:

ARGF.binmode?  #=> false
ARGF.binmode
ARGF.binmode?  #=> true

[ GitHub ]

# File 'io.c', line 12452


static VALUE
argf_binmode_p(VALUE argf)
{
    return ARGF.binmode ? Qtrue : Qfalse;
}

#closed? ⇒ `Boolean` (readonly)

Returns true if the current file has been closed; false otherwise. Use #close to actually close the current file.

[ GitHub ]

# File 'io.c', line 12518


static VALUE
argf_closed(VALUE argf)
{
    next_argv();
    ARGF_FORWARD(0, 0);
    return rb_io_closed(ARGF.current_file);
}

#eof? ⇒ `Boolean` (readonly) #eof ⇒ `Boolean`
Also known as: #eof?

Returns true if the current file in ARGF is at end of file, i.e. it has no data to read. The stream must be opened for reading or an ::IOError will be raised.

$ echo "eof" | ruby argf.rb

ARGF.eof?                 #=> false
3.times { ARGF.readchar }
ARGF.eof?                 #=> false
ARGF.readchar             #=> "\n"
ARGF.eof?                 #=> true

[ GitHub ]

# File 'io.c', line 11761


static VALUE
argf_eof(VALUE argf)
{
    next_argv();
    if (RTEST(ARGF.current_file)) {
	if (ARGF.init_p == 0) return Qtrue;
	next_argv();
	ARGF_FORWARD(0, 0);
	if (rb_io_eof(ARGF.current_file)) {
	    return Qtrue;
	}
    }
    return Qfalse;
}

#eof? ⇒ `Boolean` (readonly) #eof ⇒ `Boolean`

Alias for #eof.

#inplace_mode ⇒ String (rw)

Returns the file extension appended to the names of modified files under in-place edit mode. This value can be set using #inplace_mode= or passing the -i switch to the Ruby binary.

[ GitHub ]

# File 'io.c', line 12546


static VALUE
argf_inplace_mode_get(VALUE argf)
{
    if (!ARGF.inplace) return Qnil;
    if (NIL_P(ARGF.inplace)) return rb_str_new(0, 0);
    return rb_str_dup(ARGF.inplace);
}

#inplace_mode=(ext) ⇒ `ARGF` (rw)

Sets the filename extension for in-place editing mode to the given ::String. Each file being edited has this value appended to its filename. The modified file is saved under this new name.

For example:

$ ruby argf.rb file.txt

ARGF.inplace_mode = '.bak'
ARGF.each_line do |line|
  print line.sub("foo","bar")
end

Each line of file.txt has the first occurrence of “foo” replaced with “bar”, then the new line is written out to file.txt.bak.

[ GitHub ]

# File 'io.c', line 12580


static VALUE
argf_inplace_mode_set(VALUE argf, VALUE val)
{
    if (rb_safe_level() >= 1 && OBJ_TAINTED(val))
	rb_insecure_operation();

    if (!RTEST(val)) {
	ARGF.inplace = Qfalse;
    }
    else if (StringValueCStr(val), !RSTRING_LEN(val)) {
	ARGF.inplace = Qnil;
    }
    else {
	ARGF.inplace = rb_str_new_frozen(val);
    }
    return argf;
}

#lineno ⇒ Integer (rw)

Returns the current line number of ARGF as a whole. This value can be set manually with #lineno=.

For example:

ARGF.lineno   #=> 0
ARGF.readline #=> "This is line 1\n"
ARGF.lineno   #=> 1

[ GitHub ]

# File 'io.c', line 8397


static VALUE
argf_lineno(VALUE argf)
{
    return INT2FIX(ARGF.lineno);
}

#lineno=(integer) ⇒ Integer (rw)

Sets the line number of ARGF as a whole to the given ::Integer.

ARGF sets the line number automatically as you read data, so normally you will not need to set it explicitly. To access the current line number use #lineno.

For example:

ARGF.lineno      #=> 0
ARGF.readline    #=> "This is line 1\n"
ARGF.lineno      #=> 1
ARGF.lineno = 0  #=> 0
ARGF.lineno      #=> 0

[ GitHub ]

# File 'io.c', line 8376


static VALUE
argf_set_lineno(VALUE argf, VALUE val)
{
    ARGF.lineno = NUM2INT(val);
    ARGF.last_lineno = ARGF.lineno;
    return Qnil;
}

#tell ⇒ Integer (rw) #pos ⇒ Integer
Also known as: #tell

Returns the current offset (in bytes) of the current file in ARGF.

ARGF.pos    #=> 0
ARGF.gets   #=> "This is line one\n"
ARGF.pos    #=> 17

[ GitHub ]

# File 'io.c', line 11625


static VALUE
argf_tell(VALUE argf)
{
    if (!next_argv()) {
	rb_raise(rb_eArgError, "no stream to tell");
    }
    ARGF_FORWARD(0, 0);
    return rb_io_tell(ARGF.current_file);
}

#pos=(position) ⇒ Integer (rw)

Seeks to the position given by position (in bytes) in ARGF.

For example:

ARGF.pos = 17
ARGF.gets   #=> "This is line two\n"

[ GitHub ]

# File 'io.c', line 11663


static VALUE
argf_set_pos(VALUE argf, VALUE offset)
{
    if (!next_argv()) {
	rb_raise(rb_eArgError, "no stream to set position");
    }
    ARGF_FORWARD(1, &offset);
    return rb_io_set_pos(ARGF.current_file, offset);
}

#tell ⇒ Integer (readonly) #pos ⇒ Integer

Alias for #pos.

Instance Method Details

#argv ⇒ ARGV

Returns the ARGV array, which contains the arguments passed to your script, one per element.

For example:

$ ruby argf.rb -v glark.txt

ARGF.argv   #=> ["-v", "glark.txt"]

[ GitHub ]

# File 'io.c', line 12630


static VALUE
argf_argv(VALUE argf)
{
    return ARGF.argv;
}

#bytes

This is a deprecated alias for #each_byte.

[ GitHub ]

# File 'io.c', line 12271


static VALUE
argf_bytes(VALUE argf)
{
    rb_warn("ARGF#bytes is deprecated; use #each_byte instead");
    if (!rb_block_given_p())
	return rb_enumeratorize(argf, ID2SYM(rb_intern("each_byte")), 0, 0);
    return argf_each_byte(argf);
}

#chars

This is a deprecated alias for #each_char.

[ GitHub ]

# File 'io.c', line 12310


static VALUE
argf_chars(VALUE argf)
{
    rb_warn("ARGF#chars is deprecated; use #each_char instead");
    if (!rb_block_given_p())
	return rb_enumeratorize(argf, ID2SYM(rb_intern("each_char")), 0, 0);
    return argf_each_char(argf);
}

#close ⇒ `ARGF`

Closes the current file and skips to the next file in ARGV. If there are no more files to open, just closes the current file. STDIN will not be closed.

For example:

$ ruby argf.rb foo bar

ARGF.filename  #=> "foo"
ARGF.close
ARGF.filename  #=> "bar"
ARGF.close

[ GitHub ]

# File 'io.c', line 12499


static VALUE
argf_close_m(VALUE argf)
{
    next_argv();
    argf_close(argf);
    if (ARGF.next_p != -1) {
	ARGF.next_p = 1;
    }
    ARGF.lineno = 0;
    return argf;
}

#codepoints

This is a deprecated alias for #each_codepoint.

[ GitHub ]

# File 'io.c', line 12349


static VALUE
argf_codepoints(VALUE argf)
{
    rb_warn("ARGF#codepoints is deprecated; use #each_codepoint instead");
    if (!rb_block_given_p())
	return rb_enumeratorize(argf, ID2SYM(rb_intern("each_codepoint")), 0, 0);
    return argf_each_codepoint(argf);
}

#each(sep = $/) {|line| ... } ⇒ `ARGF` #each(sep = $/, limit) {|line| ... } ⇒ `ARGF` #each(...) ⇒ Enumerator
Also known as: #each_line

ARGF.each_line(sep=$/) {|line| block } -> ARGF

ARGF.each_line(sep=$/, limit) {|line| block }  -> ARGF
ARGF.each_line(...)                            -> an_enumerator

Returns an enumerator which iterates over each line (separated by sep, which defaults to your platform's newline character) of each file in ARGV. If a block is supplied, each line in turn will be yielded to the block, otherwise an enumerator is returned. The optional limit argument is an ::Integer specifying the maximum length of each line; longer lines will be split according to this limit.

This method allows you to treat the files supplied on the command line as a single file consisting of the concatenation of each named file. After the last line of the first file has been returned, the first line of the second file is returned. The #filename and #lineno methods can be used to determine the filename of the current line and line number of the whole input, respectively.

For example, the following code prints out each line of each named file prefixed with its line number, displaying the filename once per file:

ARGF.each_line do |line|
  puts ARGF.filename if ARGF.file.lineno == 1
  puts "#{ARGF.file.lineno}: #{line}"
end

While the following code prints only the first file's name at first, and the contents with line number counted through all named files.

ARGF.each_line do |line|
  puts ARGF.filename if ARGF.lineno == 1
  puts "#{ARGF.lineno}: #{line}"
end

[ GitHub ]

# File 'io.c', line 12210


static VALUE
argf_each_line(int argc, VALUE *argv, VALUE argf)
{
    RETURN_ENUMERATOR(argf, argc, argv);
    FOREACH_ARGF() {
	argf_block_call_line(rb_intern("each_line"), argc, argv, argf);
    }
    return argf;
}

#bytes {|byte| ... } ⇒ `ARGF` #bytes ⇒ Enumerator

ARGF.each_byte {|byte| block } -> ARGF

ARGF.each_byte                  -> an_enumerator

Iterates over each byte of each file in ARGV. A byte is returned as an ::Integer in the range 0..255.

This method allows you to treat the files supplied on the command line as a single file consisting of the concatenation of each named file. After the last byte of the first file has been returned, the first byte of the second file is returned. The #filename method can be used to determine the filename of the current byte.

If no block is given, an enumerator is returned instead.

For example:

ARGF.bytes.to_a  #=> [35, 32, ... 95, 10]

[ GitHub ]

# File 'io.c', line 12257


static VALUE
argf_each_byte(VALUE argf)
{
    RETURN_ENUMERATOR(argf, 0, 0);
    FOREACH_ARGF() {
	argf_block_call(rb_intern("each_byte"), 0, 0, argf);
    }
    return argf;
}

#each_char {|char| ... } ⇒ `ARGF` #each_char ⇒ Enumerator

Iterates over each character of each file in ARGF.

This method allows you to treat the files supplied on the command line as a single file consisting of the concatenation of each named file. After the last character of the first file has been returned, the first character of the second file is returned. The #filename method can be used to determine the name of the file in which the current character appears.

If no block is given, an enumerator is returned instead.

[ GitHub ]

# File 'io.c', line 12296


static VALUE
argf_each_char(VALUE argf)
{
    RETURN_ENUMERATOR(argf, 0, 0);
    FOREACH_ARGF() {
	argf_block_call(rb_intern("each_char"), 0, 0, argf);
    }
    return argf;
}

#each_codepoint {|codepoint| ... } ⇒ `ARGF` #each_codepoint ⇒ Enumerator

Iterates over each codepoint of each file in ARGF.

This method allows you to treat the files supplied on the command line as a single file consisting of the concatenation of each named file. After the last codepoint of the first file has been returned, the first codepoint of the second file is returned. The #filename method can be used to determine the name of the file in which the current codepoint appears.

If no block is given, an enumerator is returned instead.

[ GitHub ]

# File 'io.c', line 12335


static VALUE
argf_each_codepoint(VALUE argf)
{
    RETURN_ENUMERATOR(argf, 0, 0);
    FOREACH_ARGF() {
	argf_block_call(rb_intern("each_codepoint"), 0, 0, argf);
    }
    return argf;
}

#each(sep = $/) {|line| ... } ⇒ `ARGF` #each(sep = $/, limit) {|line| ... } ⇒ `ARGF` #each(...) ⇒ Enumerator

Alias for #each.

#external_encoding ⇒ Encoding

Returns the external encoding for files read from ARGF as an ::Encoding object. The external encoding is the encoding of the text as stored in a file. Contrast with #internal_encoding, which is the encoding used to represent this text within Ruby.

To set the external encoding use #set_encoding.

For example:

ARGF.external_encoding  #=>  #<Encoding:UTF-8>

[ GitHub ]

# File 'io.c', line 11537


static VALUE
argf_external_encoding(VALUE argf)
{
    if (!RTEST(ARGF.current_file)) {
	return rb_enc_from_encoding(rb_default_external_encoding());
    }
    return rb_io_external_encoding(rb_io_check_io(ARGF.current_file));
}

#file ⇒ IO, File `object`

Returns the current file as an ::IO or ::File object. $stdin is returned when the current file is STDIN.

For example:

$ echo "foo" > foo
$ echo "bar" > bar

$ ruby argf.rb foo bar

ARGF.file      #=> #<File:foo>
ARGF.read(5)   #=> "foo\nb"
ARGF.file      #=> #<File:bar>

[ GitHub ]

# File 'io.c', line 12411


static VALUE
argf_file(VALUE argf)
{
    next_argv();
    return ARGF.current_file;
}

#filename ⇒ String #path ⇒ String

Alias for #path.

#fileno ⇒ Integer #to_i ⇒ Integer

Alias for #to_i.

#getbyte ⇒ Integer^?

Gets the next 8-bit byte (0..255) from ARGF. Returns nil if called at the end of the stream.

For example:

$ echo "foo" > file
$ ruby argf.rb file

ARGF.getbyte #=> 102
ARGF.getbyte #=> 111
ARGF.getbyte #=> 111
ARGF.getbyte #=> 10
ARGF.getbyte #=> nil

[ GitHub ]

# File 'io.c', line 12041


static VALUE
argf_getbyte(VALUE argf)
{
    VALUE ch;

  retry:
    if (!next_argv()) return Qnil;
    if (!RB_TYPE_P(ARGF.current_file, T_FILE)) {
	ch = rb_funcall3(ARGF.current_file, rb_intern("getbyte"), 0, 0);
    }
    else {
	ch = rb_io_getbyte(ARGF.current_file);
    }
    if (NIL_P(ch) && ARGF.next_p != -1) {
	argf_close(argf);
	ARGF.next_p = 1;
	goto retry;
    }

    return ch;
}

#getc ⇒ String^?

Reads the next character from ARGF and returns it as a ::String. Returns nil at the end of the stream.

ARGF treats the files named on the command line as a single file created by concatenating their contents. After returning the last character of the first file, it returns the first character of the second file, and so on.

For example:

$ echo "foo" > file
$ ruby argf.rb file

ARGF.getc  #=> "f"
ARGF.getc  #=> "o"
ARGF.getc  #=> "o"
ARGF.getc  #=> "\n"
ARGF.getc  #=> nil
ARGF.getc  #=> nil

[ GitHub ]

# File 'io.c', line 12001


static VALUE
argf_getc(VALUE argf)
{
    VALUE ch;

  retry:
    if (!next_argv()) return Qnil;
    if (ARGF_GENERIC_INPUT_P()) {
	ch = rb_funcall3(ARGF.current_file, rb_intern("getc"), 0, 0);
    }
    else {
	ch = rb_io_getc(ARGF.current_file);
    }
    if (NIL_P(ch) && ARGF.next_p != -1) {
	argf_close(argf);
	ARGF.next_p = 1;
	goto retry;
    }

    return ch;
}

#gets(sep=$/ [, getline_args]) ⇒ String^? #gets(limit [, getline_args]) ⇒ String^? #gets(sep, limit [, getline_args]) ⇒ String^?

Returns the next line from the current file in ARGF.

By default lines are assumed to be separated by $/; to use a different character as a separator, supply it as a ::String for the sep argument.

The optional limit argument specifies how many characters of each line to return. By default all characters are returned.

See IO.readlines for details about getline_args.

[ GitHub ]

# File 'io.c', line 8716


static VALUE
argf_gets(int argc, VALUE *argv, VALUE argf)
{
    VALUE line;

    line = argf_getline(argc, argv, argf);
    rb_lastline_set(line);

    return line;
}

#initialize_copy(orig)

This method is for internal use only.

[ GitHub ]

# File 'io.c', line 8349


static VALUE
argf_initialize_copy(VALUE argf, VALUE orig)
{
    if (!OBJ_INIT_COPY(argf, orig)) return argf;
    ARGF = argf_of(orig);
    ARGF.argv = rb_obj_dup(ARGF.argv);
    return argf;
}

#to_s ⇒ String #inspect ⇒ String

Alias for #to_s.

#internal_encoding ⇒ Encoding

Returns the internal encoding for strings read from ARGF as an ::Encoding object.

If #set_encoding has been called with two encoding names, the second is returned. Otherwise, if Encoding.default_external has been set, that value is returned. Failing that, if a default external encoding was specified on the command-line, that value is used. If the encoding is unknown, nil is returned.

[ GitHub ]

# File 'io.c', line 11559


static VALUE
argf_internal_encoding(VALUE argf)
{
    if (!RTEST(ARGF.current_file)) {
	return rb_enc_from_encoding(rb_default_external_encoding());
    }
    return rb_io_internal_encoding(rb_io_check_io(ARGF.current_file));
}

#lines(*args)

This is a deprecated alias for #each_line.

[ GitHub ]

# File 'io.c', line 12224


static VALUE
argf_lines(int argc, VALUE *argv, VALUE argf)
{
    rb_warn("ARGF#lines is deprecated; use #each_line instead");
    if (!rb_block_given_p())
	return rb_enumeratorize(argf, ID2SYM(rb_intern("each_line")), argc, argv);
    return argf_each_line(argc, argv, argf);
}

#filename ⇒ String #path ⇒ String
Also known as: #filename

Returns the current filename. “-” is returned when the current file is STDIN.

For example:

$ echo "foo" > foo
$ echo "bar" > bar
$ echo "glark" > glark

$ ruby argf.rb foo bar glark

ARGF.filename  #=> "foo"
ARGF.read(5)   #=> "foo\nb"
ARGF.filename  #=> "bar"
ARGF.skip
ARGF.filename  #=> "glark"

[ GitHub ]

# File 'io.c', line 12380


static VALUE
argf_filename(VALUE argf)
{
    next_argv();
    return ARGF.filename;
}

#print ⇒ `nil` #print(obj, ...) ⇒ `nil`

Alias for IO#print.

#printf(format_string [, obj, ...]) ⇒ `nil`

Alias for IO#printf.

#putc(obj) ⇒ Object

Alias for IO#putc.

#puts(obj, ...) ⇒ `nil`

Alias for IO#puts.

#read([length [, outbuf]]) ⇒ String, ...

Reads length bytes from ARGF. The files named on the command line are concatenated and treated as a single file by this method, so when called without arguments the contents of this pseudo file are returned in their entirety.

length must be a non-negative integer or nil.

If length is a positive integer, read tries to read length bytes without any conversion (binary mode). It returns nil if an EOF is encountered before anything can be read. Fewer than length bytes are returned if an EOF is encountered during the read. In the case of an integer length, the resulting string is always in ASCII-8BIT encoding.

If length is omitted or is nil, it reads until EOF and the encoding conversion is applied, if applicable. A string is returned even if EOF is encountered before any data is read.

If length is zero, it returns an empty string ("").

If the optional outbuf argument is present, it must reference a ::String, which will receive the data. The outbuf will contain only the received data after the method call even if it is not empty at the beginning.

For example:

$ echo "small" > small.txt
$ echo "large" > large.txt
$ ./glark.rb small.txt large.txt

ARGF.read      #=> "small\nlarge"
ARGF.read(200) #=> "small\nlarge"
ARGF.read(2)   #=> "sm"
ARGF.read(0)   #=> ""

Note that this method behaves like the fread() function in C. This means it retries to invoke read(2) system calls to read data with the specified length. If you need the behavior like a single read(2) system call, consider #readpartial or #read_nonblock.

[ GitHub ]

# File 'io.c', line 11824


static VALUE
argf_read(int argc, VALUE *argv, VALUE argf)
{
    VALUE tmp, str, length;
    long len = 0;

    rb_scan_args(argc, argv, "02", &length, &str);
    if (!NIL_P(length)) {
	len = NUM2LONG(argv[0]);
    }
    if (!NIL_P(str)) {
	StringValue(str);
	rb_str_resize(str,0);
	argv[1] = Qnil;
    }

  retry:
    if (!next_argv()) {
	return str;
    }
    if (ARGF_GENERIC_INPUT_P()) {
	tmp = argf_forward(argc, argv, argf);
    }
    else {
	tmp = io_read(argc, argv, ARGF.current_file);
    }
    if (NIL_P(str)) str = tmp;
    else if (!NIL_P(tmp)) rb_str_append(str, tmp);
    if (NIL_P(tmp) || NIL_P(length)) {
	if (ARGF.next_p != -1) {
	    argf_close(argf);
	    ARGF.next_p = 1;
	    goto retry;
	}
    }
    else if (argc >= 1) {
	long slen = RSTRING_LEN(str);
	if (slen < len) {
	    len -= slen;
	    argv[0] = INT2NUM(len);
	    goto retry;
	}
    }
    return str;
}

#read_nonblock(maxlen[, options]) ⇒ String #read_nonblock(maxlen, outbuf[, options]) ⇒ `outbuf`

Reads at most maxlen bytes from the ARGF stream in non-blocking mode.

[ GitHub ]

# File 'io.c', line 11921


static VALUE
argf_read_nonblock(int argc, VALUE *argv, VALUE argf)
{
    VALUE opts;

    rb_scan_args(argc, argv, "11:", NULL, NULL, &opts);

    if (!NIL_P(opts))
        argc--;

    return argf_getpartial(argc, argv, argf, opts, 1);
}

#readbyte ⇒ Integer

Reads the next 8-bit byte from ARGF and returns it as an ::Integer. Raises an ::EOFError after the last byte of the last file has been read.

For example:

$ echo "foo" > file
$ ruby argf.rb file

ARGF.readbyte  #=> 102
ARGF.readbyte  #=> 111
ARGF.readbyte  #=> 111
ARGF.readbyte  #=> 10
ARGF.readbyte  #=> end of file reached (EOFError)

[ GitHub ]

# File 'io.c', line 12121


static VALUE
argf_readbyte(VALUE argf)
{
    VALUE c;

    NEXT_ARGF_FORWARD(0, 0);
    c = argf_getbyte(argf);
    if (NIL_P(c)) {
	rb_eof_error();
    }
    return c;
}

#readchar ⇒ String^?

Reads the next character from ARGF and returns it as a ::String. Raises an ::EOFError after the last character of the last file has been read.

For example:

$ echo "foo" > file
$ ruby argf.rb file

ARGF.readchar  #=> "f"
ARGF.readchar  #=> "o"
ARGF.readchar  #=> "o"
ARGF.readchar  #=> "\n"
ARGF.readchar  #=> end of file reached (EOFError)

[ GitHub ]

# File 'io.c', line 12081


static VALUE
argf_readchar(VALUE argf)
{
    VALUE ch;

  retry:
    if (!next_argv()) rb_eof_error();
    if (!RB_TYPE_P(ARGF.current_file, T_FILE)) {
	ch = rb_funcall3(ARGF.current_file, rb_intern("getc"), 0, 0);
    }
    else {
	ch = rb_io_getc(ARGF.current_file);
    }
    if (NIL_P(ch) && ARGF.next_p != -1) {
	argf_close(argf);
	ARGF.next_p = 1;
	goto retry;
    }

    return ch;
}

#readline(sep = $/) ⇒ String #readline(limit) ⇒ String #readline(sep, limit) ⇒ String

Returns the next line from the current file in ARGF.

By default lines are assumed to be separated by $/; to use a different character as a separator, supply it as a ::String for the sep argument.

The optional limit argument specifies how many characters of each line to return. By default all characters are returned.

An ::EOFError is raised at the end of the file.

[ GitHub ]

# File 'io.c', line 8792


static VALUE
argf_readline(int argc, VALUE *argv, VALUE argf)
{
    VALUE line;

    if (!next_argv()) rb_eof_error();
    ARGF_FORWARD(argc, argv);
    line = argf_gets(argc, argv, argf);
    if (NIL_P(line)) {
	rb_eof_error();
    }

    return line;
}

#readlines(sep = $/) ⇒ Array #readlines(limit) ⇒ Array #readlines(sep, limit) ⇒ Array

Alias for #to_a.

#readpartial(maxlen) ⇒ String #readpartial(maxlen, outbuf) ⇒ `outbuf`

Reads at most maxlen bytes from the ARGF stream.

It raises ::EOFError on end of ARGF stream. Since ARGF stream is a concatenation of multiple files, internally EOF is occur for each file. #readpartial returns empty strings for EOFs except the last one and raises ::EOFError for the last one.

[ GitHub ]

# File 'io.c', line 11907


static VALUE
argf_readpartial(int argc, VALUE *argv, VALUE argf)
{
    return argf_getpartial(argc, argv, argf, Qnil, 0);
}

#rewind ⇒ `0`

Positions the current file to the beginning of input, resetting #lineno to zero.

ARGF.readline   #=> "This is line one\n"
ARGF.rewind     #=> 0
ARGF.lineno     #=> 0
ARGF.readline   #=> "This is line one\n"

[ GitHub ]

# File 'io.c', line 11685


static VALUE
argf_rewind(VALUE argf)
{
    VALUE ret;
    int old_lineno;

    if (!next_argv()) {
	rb_raise(rb_eArgError, "no stream to rewind");
    }
    ARGF_FORWARD(0, 0);
    old_lineno = RFILE(ARGF.current_file)->fptr->lineno;
    ret = rb_io_rewind(ARGF.current_file);
    if (!global_argf_p(argf)) {
	ARGF.last_lineno = ARGF.lineno -= old_lineno;
    }
    return ret;
}

#seek(amount, whence = IO::SEEK_SET) ⇒ `0`

Seeks to offset amount (an ::Integer) in the ARGF stream according to the value of whence. See IO#seek for further details.

[ GitHub ]

# File 'io.c', line 11642


static VALUE
argf_seek_m(int argc, VALUE *argv, VALUE argf)
{
    if (!next_argv()) {
	rb_raise(rb_eArgError, "no stream to seek");
    }
    ARGF_FORWARD(argc, argv);
    return rb_io_seek_m(argc, argv, ARGF.current_file);
}

#set_encoding(ext_enc) ⇒ `ARGF` #set_encoding("ext_enc:int_enc") ⇒ `ARGF` #set_encoding(ext_enc, int_enc) ⇒ `ARGF` #set_encoding("ext_enc:int_enc", opt) ⇒ `ARGF` #set_encoding(ext_enc, int_enc, opt) ⇒ `ARGF`

If single argument is specified, strings read from ARGF are tagged with the encoding specified.

If two encoding names separated by a colon are given, e.g. “ascii:utf-8”, the read string is converted from the first encoding (external encoding) to the second encoding (internal encoding), then tagged with the second encoding.

If two arguments are specified, they must be encoding objects or encoding names. Again, the first specifies the external encoding; the second specifies the internal encoding.

If the external encoding and the internal encoding are specified, the optional ::Hash argument can be used to adjust the conversion process. The structure of this hash is explained in the String#encode documentation.

For example:

ARGF.set_encoding('ascii')         # Tag the input as US-ASCII text
ARGF.set_encoding(Encoding::UTF_8) # Tag the input as UTF-8 text
ARGF.set_encoding('utf-8','ascii') # Transcode the input from US-ASCII
                                   # to UTF-8.

[ GitHub ]

# File 'io.c', line 11599


static VALUE
argf_set_encoding(int argc, VALUE *argv, VALUE argf)
{
    rb_io_t *fptr;

    if (!next_argv()) {
	rb_raise(rb_eArgError, "no stream to set encoding");
    }
    rb_io_set_encoding(argc, argv, ARGF.current_file);
    GetOpenFile(ARGF.current_file, fptr);
    ARGF.encs = fptr->encs;
    return argf;
}

#skip ⇒ `ARGF`

Sets the current file to the next file in ARGV. If there aren't any more files it has no effect.

For example:

$ ruby argf.rb foo bar
ARGF.filename  #=> "foo"
ARGF.skip
ARGF.filename  #=> "bar"

[ GitHub ]

# File 'io.c', line 12472


static VALUE
argf_skip(VALUE argf)
{
    if (ARGF.init_p && ARGF.next_p == 0) {
	argf_close(argf);
	ARGF.next_p = 1;
    }
    return argf;
}

#readlines(sep = $/) ⇒ Array #readlines(limit) ⇒ Array #readlines(sep, limit) ⇒ Array
Also known as: #readlines

ARGF.to_a(sep=$/) -> array

ARGF.to_a(limit)      -> array
ARGF.to_a(sep, limit) -> array

Reads ARGF's current file in its entirety, returning an ::Array of its lines, one line per element. Lines are assumed to be separated by sep.

lines = ARGF.readlines
lines[0]                #=> "This is line one\n"

[ GitHub ]

# File 'io.c', line 8844


static VALUE
argf_readlines(int argc, VALUE *argv, VALUE argf)
{
    long lineno = ARGF.lineno;
    VALUE lines, ary;

    ary = rb_ary_new();
    while (next_argv()) {
	if (ARGF_GENERIC_INPUT_P()) {
	    lines = rb_funcall3(ARGF.current_file, rb_intern("readlines"), argc, argv);
	}
	else {
	    lines = rb_io_readlines(argc, argv, ARGF.current_file);
	    argf_close(argf);
	}
	ARGF.next_p = 1;
	rb_ary_concat(ary, lines);
	ARGF.lineno = lineno + RARRAY_LEN(ary);
	ARGF.last_lineno = ARGF.lineno;
    }
    ARGF.init_p = 0;
    return ary;
}

#fileno ⇒ Integer #to_i ⇒ Integer
Also known as: #fileno

Returns an integer representing the numeric file descriptor for the current file. Raises an ::ArgumentError if there isn't a current file.

ARGF.fileno    #=> 3

[ GitHub ]

# File 'io.c', line 11713


static VALUE
argf_fileno(VALUE argf)
{
    if (!next_argv()) {
	rb_raise(rb_eArgError, "no stream");
    }
    ARGF_FORWARD(0, 0);
    return rb_io_fileno(ARGF.current_file);
}

#to_io ⇒ IO

Returns an ::IO object representing the current file. This will be a ::File object unless the current file is a stream such as STDIN.

For example:

ARGF.to_io    #=> #<File:glark.txt>
ARGF.to_io    #=> #<IO:<STDIN>>

[ GitHub ]

# File 'io.c', line 11735


static VALUE
argf_to_io(VALUE argf)
{
    next_argv();
    ARGF_FORWARD(0, 0);
    return ARGF.current_file;
}

#to_s ⇒ String Also known as: #inspect

Returns “ARGF”.

[ GitHub ]

# File 'io.c', line 12532


static VALUE
argf_to_s(VALUE argf)
{
    return rb_str_new2("ARGF");
}

#to_write_io ⇒ IO

Returns IO instance tied to ARGF for writing if inplace mode is enabled.

[ GitHub ]

# File 'io.c', line 12655


static VALUE
argf_write_io(VALUE argf)
{
    if (!RTEST(ARGF.current_file)) {
	rb_raise(rb_eIOError, "not opened for writing");
    }
    return GetWriteIO(ARGF.current_file);
}

#write(string) ⇒ Integer

Writes string if inplace mode.

[ GitHub ]

# File 'io.c', line 12670


static VALUE
argf_write(VALUE argf, VALUE str)
{
    return rb_io_write(argf_write_io(argf), str);
}

Class: ARGF

Overview

Class Method Summary

Instance Attribute Summary

Instance Method Summary

::Enumerable - Included

Constructor Details

.new(argv)

Instance Attribute Details

#binmode ⇒ ARGF (readonly)

#binmode? ⇒ Boolean (readonly)

#closed? ⇒ Boolean (readonly)

#eof? ⇒ Boolean (readonly) #eof ⇒ Boolean Also known as: #eof?

#eof? ⇒ Boolean (readonly) #eof ⇒ Boolean

#inplace_mode ⇒ String (rw)

#inplace_mode=(ext) ⇒ ARGF (rw)

#lineno ⇒ Integer (rw)

#lineno=(integer) ⇒ Integer (rw)

#tell ⇒ Integer (rw) #pos ⇒ Integer Also known as: #tell

#pos=(position) ⇒ Integer (rw)

#tell ⇒ Integer (readonly) #pos ⇒ Integer

Instance Method Details

#argv ⇒ ARGV

#bytes

#chars

#close ⇒ ARGF

#codepoints

#each(sep = $/) {|line| ... } ⇒ ARGF #each(sep = $/, limit) {|line| ... } ⇒ ARGF #each(...) ⇒ Enumerator Also known as: #each_line

#bytes {|byte| ... } ⇒ ARGF #bytes ⇒ Enumerator

#each_char {|char| ... } ⇒ ARGF #each_char ⇒ Enumerator

#each_codepoint {|codepoint| ... } ⇒ ARGF #each_codepoint ⇒ Enumerator

#each(sep = $/) {|line| ... } ⇒ ARGF #each(sep = $/, limit) {|line| ... } ⇒ ARGF #each(...) ⇒ Enumerator

#external_encoding ⇒ Encoding

#file ⇒ IO, File object

#filename ⇒ String #path ⇒ String

#fileno ⇒ Integer #to_i ⇒ Integer

#getbyte ⇒ Integer?

#getc ⇒ String?

#gets(sep=$/ [, getline_args]) ⇒ String? #gets(limit [, getline_args]) ⇒ String? #gets(sep, limit [, getline_args]) ⇒ String?

#initialize_copy(orig)

#to_s ⇒ String #inspect ⇒ String

#internal_encoding ⇒ Encoding

#lines(*args)

#filename ⇒ String #path ⇒ String Also known as: #filename

#print ⇒ nil #print(obj, ...) ⇒ nil

#printf(format_string [, obj, ...]) ⇒ nil

#putc(obj) ⇒ Object

#puts(obj, ...) ⇒ nil

#read([length [, outbuf]]) ⇒ String, ...

#read_nonblock(maxlen[, options]) ⇒ String #read_nonblock(maxlen, outbuf[, options]) ⇒ outbuf

#readbyte ⇒ Integer

#readchar ⇒ String?

#readline(sep = $/) ⇒ String #readline(limit) ⇒ String #readline(sep, limit) ⇒ String

#readlines(sep = $/) ⇒ Array #readlines(limit) ⇒ Array #readlines(sep, limit) ⇒ Array

#readpartial(maxlen) ⇒ String #readpartial(maxlen, outbuf) ⇒ outbuf

#rewind ⇒ 0

#seek(amount, whence = IO::SEEK_SET) ⇒ 0

#set_encoding(ext_enc) ⇒ ARGF #set_encoding("ext_enc:int_enc") ⇒ ARGF #set_encoding(ext_enc, int_enc) ⇒ ARGF #set_encoding("ext_enc:int_enc", opt) ⇒ ARGF #set_encoding(ext_enc, int_enc, opt) ⇒ ARGF

#skip ⇒ ARGF

#readlines(sep = $/) ⇒ Array #readlines(limit) ⇒ Array #readlines(sep, limit) ⇒ Array Also known as: #readlines

#fileno ⇒ Integer #to_i ⇒ Integer Also known as: #fileno

#to_io ⇒ IO

#to_s ⇒ String Also known as: #inspect

#to_write_io ⇒ IO

#write(string) ⇒ Integer

#binmode ⇒ `ARGF` (readonly)

#binmode? ⇒ `Boolean` (readonly)

#closed? ⇒ `Boolean` (readonly)

#eof? ⇒ `Boolean` (readonly) #eof ⇒ `Boolean`
Also known as: #eof?

#eof? ⇒ `Boolean` (readonly) #eof ⇒ `Boolean`

#inplace_mode=(ext) ⇒ `ARGF` (rw)

#tell ⇒ Integer (rw) #pos ⇒ Integer
Also known as: #tell

#close ⇒ `ARGF`

#each(sep = $/) {|line| ... } ⇒ `ARGF` #each(sep = $/, limit) {|line| ... } ⇒ `ARGF` #each(...) ⇒ Enumerator
Also known as: #each_line

#bytes {|byte| ... } ⇒ `ARGF` #bytes ⇒ Enumerator

#each_char {|char| ... } ⇒ `ARGF` #each_char ⇒ Enumerator

#each_codepoint {|codepoint| ... } ⇒ `ARGF` #each_codepoint ⇒ Enumerator

#each(sep = $/) {|line| ... } ⇒ `ARGF` #each(sep = $/, limit) {|line| ... } ⇒ `ARGF` #each(...) ⇒ Enumerator

#file ⇒ IO, File `object`

#getbyte ⇒ Integer^?

#getc ⇒ String^?

#gets(sep=$/ [, getline_args]) ⇒ String^? #gets(limit [, getline_args]) ⇒ String^? #gets(sep, limit [, getline_args]) ⇒ String^?

#filename ⇒ String #path ⇒ String
Also known as: #filename

#print ⇒ `nil` #print(obj, ...) ⇒ `nil`

#printf(format_string [, obj, ...]) ⇒ `nil`

#puts(obj, ...) ⇒ `nil`

#read_nonblock(maxlen[, options]) ⇒ String #read_nonblock(maxlen, outbuf[, options]) ⇒ `outbuf`

#readchar ⇒ String^?

#readpartial(maxlen) ⇒ String #readpartial(maxlen, outbuf) ⇒ `outbuf`

#rewind ⇒ `0`

#seek(amount, whence = IO::SEEK_SET) ⇒ `0`

#set_encoding(ext_enc) ⇒ `ARGF` #set_encoding("ext_enc:int_enc") ⇒ `ARGF` #set_encoding(ext_enc, int_enc) ⇒ `ARGF` #set_encoding("ext_enc:int_enc", opt) ⇒ `ARGF` #set_encoding(ext_enc, int_enc, opt) ⇒ `ARGF`

#skip ⇒ `ARGF`

#readlines(sep = $/) ⇒ Array #readlines(limit) ⇒ Array #readlines(sep, limit) ⇒ Array
Also known as: #readlines

#fileno ⇒ Integer #to_i ⇒ Integer
Also known as: #fileno