We recommend using Visual Studio 2017
This documentation is archived and is not being maintained.


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 thistest thisEnter a sentence (use <space> as the delimiter): test this You entered: test

Header: <string>