The Microsoft Input/Output Stream Classes (iostream.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
streambuf::sgetn
streambuf                                   Up Contents Index Back
──The Microsoft iostream Classes────────────────────────────────────────────
 
  int sgetn( char* pch, int nCount );
 
  Parameter   Description
 
  <pch>       A pointer to a buffer that will receive characters from the
              streambuf object.
 
  <nCount>    The number of characters to get.
 
  Remarks
 
  Gets the <nCount> characters that follow the get pointer and stores them
  in the area starting at <pch>. When fewer than <nCount> characters
  remain in the streambuf object, sgetn fetches whatever characters
  remain. The function repositions the get pointer to follow the fetched
  characters.
 
  Return Value
 
  The number of characters fetched.
 
  See Also
 
  streambuf::sbumpc, streambuf::sgetc, streambuf::snextc,
  streambuf::stossc
 
 
                                     -♦-