Collapse the table of content
Expand the table of content
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer


Illustrates how to use the string::getline Standard Template Library (STL) class in Visual C++.

template<class _E, class _TYPE, class _A> inline
   basic_istream<_E, _TYPE>& getline(
   basic_istream<_E, _TYPE>& Istream,
   basic_string<_E, _TYPE, _A>& Xstring,
   const _E _D=_TYPE::newline( )


The class/parameter names in the prototype do not match the version in the header file. Some have been modified to improve readability.

The getline function creates a string containing all of the characters from the input stream until one of the following situations occurs: - End of file. - The delimiter is encountered. - is.max_str elements have been extracted.

// string_getline_sample.cpp
// compile with: /EHsc
// Illustrates how to use the getline function to read a
// line of text from the keyboard.
// Functions:
//    getline       Returns a string from the input stream.

#pragma warning(disable:4786)
#include <string>
#include <iostream>

using namespace std ;

int main()
   string s1;
   cout << "Enter a sentence (use <space> as the delimiter): ";
   getline(cin,s1, ' ');
   cout << "You entered: " << s1 << endl;;


test this

Sample Output

Enter a sentence (use <space> as the delimiter): test this
You entered: test

Header: <string>

© 2015 Microsoft