How to use the string::operator << Standard Template Library (STL) function in Visual C++ (158202)


The information in this article applies to:

  • The Standard C++ Library, when used with:
    • Microsoft Visual C++, 32-bit Enterprise Edition 4.2
    • 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 4.2
    • 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
    • Microsoft Visual C++ .NET (2002)
    • Microsoft Visual C++ .NET (2003)
This article was previously published under Q158202
NOTE: Microsoft Visual C++ NET (2002) supported both the managed code model that is provided by the .NET Framework and the unmanaged native Windows code model. The information in this article applies to unmanaged Visual C++ code only.

SUMMARY

The sample code below illustrates how to use the string::operator<< STL function in Visual C++.

MORE INFORMATION

Required Header

   <string>

Prototype

   template<class _E, class _TYPE, class _A> inline
   basic_ostream<_E, _TYPE>&
   operator<<( basic_ostream<_E, _TYPE>& OStream,

               const basic_string<_E, _TYPE, _A>& XString);
NOTE: The class/parameter names in the prototype may not match the version in the header file. Some have been modified to improve readability.

Description

The operator<< is used to insert a string into an output stream.

Sample Code

////////////////////////////////////////////////////////////////////// 
// 
// Compile options needed: /GX
// 
// StringInsertion.cpp : Illustrates how to use the insertion operator
//                       (operator<<) to insert a string into an output
//                       stream.
// 
// Functions:
// 
//    operator<<   Inserts a string into an output stream.
// 
// Written by Derek Jamison
// of Microsoft Product Support Services,
// Copyright (c) 1996 Microsoft Corporation. All rights reserved.
////////////////////////////////////////////////////////////////////// 

#pragma warning(disable:4786)

#include <string>
#include <iostream>
using namespace std;

#if _MSC_VER > 1020   // if VC++ version is > 4.2
   using namespace std;  // std c++ libs implemented in std
   #endif

void main()

{
    string msg="Hello!  This is the insertion operator.";
    cout << msg << endl;

}
Program Output is: 
Hello!  This is the insertion operator.

REFERENCES

For the same information about string::operator <<, visit the following MSDN Web site:
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vcstdlib/html/vcsampsamplestringccoperatorllstlsample.asp
Modification Type:MajorLast Reviewed:8/11/2005
Keywords:kbfunctions kbhowto kbcode kbinfo kbSTL kbtemplate KB158202 kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.