◄istream►                                     ◄Up► ◄Contents► ◄Index► ◄Back►
──The Microsoft iostream Classes────────────────────────────────────────────
 
  istream& getline( char* pch, int nCount, char delim = '\n' );
  istream& getline( unsigned char* puch, int nCount, char delim = '\n' );
  istream& getline( signed char* psch, int nCount, char delim = '\n' );
 
  Parameter         Description
 
  <pch>, <puch>, <psch>
                    A pointer to a character array.
 
  <nCount>          The maximum number of characters to store, including
                    the terminating NULL.
 
  <delim>           The delimiter character (defaults to newline).
 
  Remarks
 
  Extracts characters from the stream until either the delimiter <delim>
  is found, the limit <nCount>-1 is reached, or end of file is reached.
  The characters are stored in the specified array followed by a null
  terminator. If the delimiter is found, it is extracted but not stored.
 
  The get function, in contrast, neither extracts nor stores the
  delimiter.
 
  See Also
 
  ◄istream::get►, ◄istream::read►
 
 
                                     -♦-