C++标准输入流相关函数

C++标准输入流相关函数 C++标准输入流相关函数 1.1 getline() c-string

• 定位：std::istream::getline，公有成员函数

• 函数原型：

  #include
  #include
  
  istream& getline (char* s, streamsize n );
  istream& getline (char* s, streamsize n, char delim );
  

  参数1：s，提取流来指定的目标缓冲。

  参数2：n，可写入缓冲的最大字节。

  [参数3：delim，划界字符。]

  说明：从流中读取一行可包括空白符的字符，当遇到划界字符（默认是’n’），则读取结束，划界符字符将会被抛弃（缓冲中也不保留），并在字符串尾部自动加上结束符‘’。

  If the delimiter is found, it is extracted and discarded (i.e. it is not stored and the next input operation will begin after it).

• 示例：

  	char s[10] = { 0 };
  	while (cin.getline(s, 6))	//不读取划界符,缓冲中也不保留划界符
  	{
  		cout << s;
  		char c;
  		cin.get(c);	
  		cout << c;
  	}
  

• 总结，用geline以c-string风格保存字符串，直到遇到划界符结束读取。划界符不作为内容读取也不保留在缓冲中。

1.2 getline() string

• 定位：std::getline (string)，普通函数

• 函数原型：

  #include
  #include
  
  istream& getline (istream&  is, string& str, char delim);
  istream& getline (istream&& is, string& str, char delim);
  istream& getline (istream&  is, string& str);
  istream& getline (istream&& is, string& str);
  
  

  参数1：is，从标准输入流is中提取。

  参数2：str，保存在目的string对象str中。

  [参数3：划界符]

  说明：

  1. 从标准输入中提取一行字符包括空白符，并保存到string对象str中，直到遇到划界符（默认’n’）完成读取。
  2. 提取过程中，当遇到eof标志或者遇到错误，将提取停止。
  3. 如果遇到划界符，它将不被作为提取的内容留在标准输入流中，下一次提取 *** 作将从该划界符的下一个位置开始读取。
  4. 调用getline()函数提取数据将会覆盖上一次保存在str中的数据。
  5. 每次提取的字符会追加在字符串的尾部。并在字符串尾部自动加上结束符‘’。

• 示例：

  	string str;
  	getline(cin, str);	//不读取划界符，缓冲中也不保留划界符
  	cout << str;
  	char c;
  	cin.get(c);
  	cout << c;
  

• 总结，geline以string类型保存字符串，直到遇到划界符结束读取。划界符不作为内容也不保留在缓冲中。与c-string风格的geline区别在于字符串的类型。

1.3 get()

• 定位：std::istream::get，成员方法

• 函数原型：

  #include
  //single character
  int get();
  istream& get(char& c);
  //c-string
  istream& get(char* s, streamsize n);
  istream& get(char* s, streamsize n, char delim);
  //stream buffer
  istream& get(streambuf& sb);
  istream& get(streambuf& sb, char delim);
  

  参数：c，保存一个字符。

  参数：s，保存以C-string风格的字符串。（如果缓冲中只有划界符并且参数n > 0，则s将设置为空字符串）。

  [参数：delim，划界符，（一旦要提取的字符为划界符，就停止从流中提取）。]

• 说明

  重点：c-string:

  从缓冲中读取n-1个字符并以c-string风格进行储存。当遇到划界符（一般为’n’）停止读取。划界符不作为读取的内容保存到s中，但保留在缓冲中作为下一个要读取的字符。每次读取完，结束符’’会追加到s的尾部作为结束标志。

• 示例：int get()

  	int n;
  	while ((n = cin.get()) != 'n')// 回车符也从缓冲中取走了
  	{
  		cout << n;
  	}
  	n = cin.get();	//缓冲中没数据
  	cout << n;
  

• 示例：istream& get(char& c)

  	char c;
  	while (cin.get(c))	//读取字符（包括换行）
  	{
  			cout << c;
  	}
  

上述两个示例都是字符 *** 作，对划界符进行读取。

• 示例 istream& get(char*s, streamsize n)

  	char s[10];
  	cin.get(s, 6);	// 不读取划界符
  	cout << s;
  	char c;
  	c = cin.get();	//从缓冲区中读取到'n'
  	cout << c;
  

上述示例是对c-string字符串的 *** 作，不对划界符进行读取，但保留在缓冲中作为下一个要读取的字符。

1.4 小结

字符串读取：

getgetline划界符字符串不读取划界符字符串不读取划界符缓冲保留划界符不保留划界符最大字符数需要指定读取字符的最大数量不用制定最大可读数量

c-string风格和string风格

getline() c-stringgetline() string字符串类型char*string调用方式cin.getline(s, 6)getline(cin, str);最大字符数需要指定读取字符的最大数量不用指定最大可读数量 2.1 ignore

• 定位：std::istream::ignore，成员方法

• 函数原型：

  #include
  istream& ignore (streamsize n = 1, int delim = EOF);
  

  参数1：n，提取字符数量的的最大值（然后抛弃）

  参数2：delim，划界符

• 说明：从输入缓冲队列中读取字符然后抛弃，直到读取了n个字符或读取到划界符则停止读取。注意，划界符也将被作为读取的内容，然后被抛弃。

• 示例：

  char s[10] = {0};
  cin.get(s, 6);	//可读5个字符 + ''
  cin.ignore(256, ' ');	
  char s2[10] = { 0 };
  string str;
  getline(cin, str);
  cout << s << str << endl;
  

  运行：输入hello world

  结果：

  helloworld
  

2.2 peek

• 定位：std::istream::peek，成员函数

• 函数原型：

  int peek();
  

• 说明：

  返回输入缓冲中下个要读取的字符，注意，该字符并没有从缓冲中提取出来。相当于只是拷贝了缓冲中的首个字符作为返回值。

  Returns the next character in the input sequence, without extracting it: The character is left as the next character to be extracted from the stream.

• 示例：

  	char buf1[256] = { 0 };
  	char buf2[256] = { 0 };
  	cin >> buf1;	//传入hello world，读取hello，空格+world+n 留在缓冲中
  	cout << "buf1: " << buf1 << endl;	//输出hello
  	cin.ignore(2);	//抛弃 空格+w
  	char ch = cin.peek();	//拷贝缓冲队列的一个字符
  	cout << ch << endl;	//输出 o
  	cin.getline(buf2, 256);	// 读入 orld，抛弃n
  	cout << "buf2: " << buf2;	//输出orld
  

2.3 putback

• 定位：std::istream::putback， 成员函数

• 函数原型：

  istream& putback (char c);
  

  参数：返回给缓冲的字符C

• 说明：

  缓冲当前位置往前移一个字符的位置，将c返回给缓冲中当前的位置。

• 示例：

  	cout << "请输入一个字符串或者数字:" << endl;
  	char ch = cin.get();//从缓冲区拿到第一个字符
  	if (ch >= '0' && ch <= '9') {
  		int number;
  		cin.putback(ch);	//把第一个字符返回给缓冲
  		cin >> number;
  		cout << "数字:" << number << endl;
  	}
  	else {
  		char buf[1024] = { 0 };
  		cin.putback(ch);
  		cin.getline(buf, 1024);
  		cout << "字符串:" << buf << endl;
  	}