/**@class java.io.LineNumberReader @extends java.io.BufferedReader A buffered character-input stream that keeps track of line numbers. This class defines methods {@link #setLineNumber}(int) and {@link #getLineNumber}() for setting and getting the current line number respectively. <p> By default, line numbering begins at 0. This number increments at every <a href="#lt">line terminator</a> as the data is read, and can be changed with a call to <tt>setLineNumber(int)</tt>. Note however, that <tt>setLineNumber(int)</tt> does not actually change the current position in the stream; it only changes the value that will be returned by <tt>getLineNumber()</tt>. <p> A line is considered to be <a name="lt">terminated</a> by any one of a line feed ('\n'), a carriage return ('\r'), or a carriage return followed immediately by a linefeed. @author Mark Reinhold @since JDK1.1 */ var LineNumberReader = { /**Set the current line number. @param {Number} lineNumber An int specifying the line number @see #getLineNumber */ setLineNumber : function( ) {}, /**Get the current line number. @return {Number} The current line number @see #setLineNumber */ getLineNumber : function( ) {}, /**Read a single character. <a href="#lt">Line terminators</a> are compressed into single newline ('\n') characters. Whenever a line terminator is read the current line number is incremented. @return {Number} The character read, or -1 if the end of the stream has been reached @throws IOException If an I/O error occurs */ read : function( ) {}, /**Read characters into a portion of an array. Whenever a <a href="#lt">line terminator</a> is read the current line number is incremented. @param {Object {char[]}} cbuf Destination buffer @param {Number} off Offset at which to start storing characters @param {Number} len Maximum number of characters to read @return {Number} The number of bytes read, or -1 if the end of the stream has already been reached @throws IOException If an I/O error occurs */ read : function( ) {}, /**Read a line of text. Whenever a <a href="#lt">line terminator</a> is read the current line number is incremented. @return {String} A String containing the contents of the line, not including any <a href="#lt">line termination characters</a>, or <tt>null</tt> if the end of the stream has been reached @throws IOException If an I/O error occurs */ readLine : function( ) {}, /**Skip characters. @param {Number} n The number of characters to skip @return {Number} The number of characters actually skipped @throws IOException If an I/O error occurs @throws IllegalArgumentException If <tt>n</tt> is negative */ skip : function( ) {}, /**Mark the present position in the stream. Subsequent calls to reset() will attempt to reposition the stream to this point, and will also reset the line number appropriately. @param {Number} readAheadLimit Limit on the number of characters that may be read while still preserving the mark. After reading this many characters, attempting to reset the stream may fail. @throws IOException If an I/O error occurs */ mark : function( ) {}, /**Reset the stream to the most recent mark. @throws IOException If the stream has not been marked, or if the mark has been invalidated */ reset : function( ) {}, };