1berry/ruby
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

[DOC] More about line number (#6582)

Browse Source
This commit is contained in:
Burdette Lamar 2022-10-19 10:34:51 -05:00 committed by GitHub
parent c32180d5ce
commit bc939d2937
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
Notes: git 2022-10-19 15:35:11 +00:00 
Merged-By: BurdetteLamar <BurdetteLamar@Yahoo.com>
2 changed files with 16 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/io_streams.rdoc
View File

@ -113,8 +113,11 @@ You can perform basic stream \IO with these methods:
==== Position ==== Position
An \IO stream has a nonnegative integer _position_, An \IO stream has a nonnegative integer _position_,
which is the byte offset at which the next read or write is to occur; which is the byte offset at which the next read or write is to occur.
the relevant methods: A new stream has position zero (and line number zero);
method +rewind+ resets the position (and line number) to zero.
The relevant methods:
- IO#tell (aliased as +#pos+): - IO#tell (aliased as +#pos+):
Returns the current position (in bytes) in the stream: Returns the current position (in bytes) in the stream:
@ -171,7 +174,7 @@ the relevant methods:
f.tell # => 40 f.tell # => 40
f.close f.close
- IO#rewind: Positions the stream to the beginning: - IO#rewind: Positions the stream to the beginning (also resetting the line number):
f = File.new('t.txt') f = File.new('t.txt')
f.tell # => 0 f.tell # => 0
@ -179,6 +182,7 @@ the relevant methods:
f.tell # => 12 f.tell # => 12
f.rewind # => 0 f.rewind # => 0
f.tell # => 0 f.tell # => 0
f.lineno # => 0
f.close f.close
==== Open and Closed Streams ==== Open and Closed Streams
@ -363,7 +367,12 @@ A readable \IO stream has a _line_ _number_,
which is the non-negative integer line number which is the non-negative integer line number
in the stream where the next read will occur. in the stream where the next read will occur.
A new stream is initially has line number +0+. The line number is the number of lines read by certain line-oriented methods
(IO.foreach, IO#each_line, IO#gets, IO#readline, and IO#readlines)
according to the given (or default) line separator +sep+.
A new stream is initially has line number zero (and position zero);
method +rewind+ resets the line number (and position) to zero.
\Method IO#lineno returns the line number. \Method IO#lineno returns the line number.

6
file.c
View File

@ -7037,7 +7037,7 @@ const char ruby_null_device[] =
* f.pos = 800 * f.pos = 800
* f.read # => "" * f.read # => ""
* *
* ==== Data Mode * ==== \Data Mode
* *
* To specify whether data is to be treated as text or as binary data, * To specify whether data is to be treated as text or as binary data,
* either of the following may be suffixed to any of the string read/write modes * either of the following may be suffixed to any of the string read/write modes
@ -7106,7 +7106,7 @@ const char ruby_null_device[] =
* - +File::CREAT+: Create file if it does not exist. * - +File::CREAT+: Create file if it does not exist.
* - +File::EXCL+: Raise an exception if +File::CREAT+ is given and the file exists. * - +File::EXCL+: Raise an exception if +File::CREAT+ is given and the file exists.
* *
* === Data Mode Specified as an \Integer * === \Data Mode Specified as an \Integer
* *
* Data mode cannot be specified as an integer. * Data mode cannot be specified as an integer.
* When the stream access mode is given as an integer, * When the stream access mode is given as an integer,
@ -7211,7 +7211,7 @@ const char ruby_null_device[] =
* f.chmod(0644) * f.chmod(0644)
* f.chmod(0444) * f.chmod(0444)
* *
* == \File Constants * == \File \Constants
* *
* Various constants for use in \File and \IO methods * Various constants for use in \File and \IO methods
* may be found in module File::Constants; * may be found in module File::Constants;