DOC: strstream Constructor Documented Incorrectly (93591)



The information in this article applies to:

  • Microsoft Visual C++ 1.0
  • Microsoft Visual C++ 1.5
  • Microsoft Visual C++ 1.51
  • Microsoft Visual C++ 1.52
  • Microsoft Visual C++ 2.0
  • Microsoft Visual C++ 2.1
  • Microsoft Visual C++ 4.0
  • Microsoft Visual C++ 4.1
  • Microsoft Visual C++, 32-bit Enterprise Edition 5.0
  • Microsoft Visual C++, 32-bit Enterprise Edition 6.0
  • Microsoft Visual C++, 32-bit Professional Edition 5.0
  • Microsoft Visual C++, 32-bit Professional Edition 6.0
  • Microsoft Visual C++, 32-bit Learning Edition 6.0

This article was previously published under Q93591

SUMMARY

The online help for all versions of Microsoft Visual C++ contains the following, incorrect statement in the strstream class constructor description:

The second constructor makes an strstream object out of the first nLength characters of the psc buffer.

The reference to the "psc" buffer should be to the "pch" buffer, which is listed as the first parameter to the second strstream constructor (shown below).
   strstream( char* pch, int nLength, int nMode );
		
The incorrect statement also appears in the Microsoft C/C++ "Class Libraries Reference" manual for version 7.0 and in the the Microsoft Visual C++ "Reference Volume III" manual for Visual C++ version 1.0.

MORE INFORMATION

The strstream object is defined with two constructors. The first constructor creates a strstream object that uses an internal, dynamic buffer which is initially empty. This is the default. The second constructor accepts three parameters: pch, nLength, and nMode. Based on the stream creation mode, nMode, it creates a strstream object from the first "nLength" characters of the "pch" buffer.

For more information on the strstream object, consult the "iostream Reference" in the Visual C++ version 4.0 Books Online.

Modification Type:MinorLast Reviewed:7/5/2005
Keywords:kbdocerr kbLangC kbLangCPP kbOLDocs KB93591