文档章节

I/O: std::basic_streambuf

SHIHUAMarryMe
 SHIHUAMarryMe
发布于 2016/09/18 20:06
字数 1716
阅读 145
收藏 0

template class std::basic_streambuf控制输入,输出字符序列.

之前几篇博客介绍各个stream并不负责实际的读写,而是委托给stream buffer完成.

处理stream buffer的一般性接口十分简单:

stream::rdbuf() 取得一个buffer的指针指向某个stream的buffer.

stream::rdbuf(buffer* ptr) 给某个stream设置一个buffer,并返回之前的buffer的指针.

 

stream buffer即负责Input,也负责Output.

因此在buffer内其实可以想象成2个数组一个负责Input(read缓冲区中的内容),一个负责Output(write入缓冲区).

Output缓冲区(向stream的buffer中写入数据):

output缓冲区由3个pointer维护,这三个pointer分别由函数pbase(),pptr()和epptr()取得

1,pbase()返回output stream缓冲区的开始.

2,pptr()获得一个指向当前output stream buffer 可以写入的位置.

3,epptr()返回的是output缓冲区的尾端,类似尾后迭代器.

 

Input缓冲区(从stream的buffer读取数据):

Input缓冲区也由3个pointer维护,这三个pointer可由eback(),gptr(),egptr().

1,eback()返回input缓冲区的起点.

2,gptr()返回一个指向当前input stream buffer 可以读取的位置.

3,egptr()返回的是input缓冲区的尾端,类似尾后迭代器.

 

Constructor:

protected:
basic_streambuf();
 	
protected:
basic_streambuf(const basic_streambuf& rhs);

1, 默认构造函数为protected,意味着只有继承了该class的其他class才能使用.

2,拷贝构造函数也为protected,意味着只有继承了该class的其他class才能使用.

 

protected:

std::basic_streambuf::operator=

basic_streambuf& operator=( const basic_streambuf& other );
	

protected的拷贝复制运算符,同样也是只有继承了该class的其他class才能使用.

 

Output stream所使用的buffer接口:

std::basic_streambuf::setp

void setp( char_type* pbeg, char_type* pend );
	

前面我们介绍了pbase(), pptr(), epptr()函数用来返回指向缓冲区pointer,这些指针的开始位置,尾后位置都是通过该函数设置的:

pbeg:用来设置指向buffer开始的位置的指针.

pend: 用来设置指向buffer尾后位置的指针.

 

std::basic_streambuf::sputc

int_type sputc( char_type ch );
	

将字符ch拷贝进去缓冲区.

 

std::basic_streambuf::sputn

std::streamsize sputn( const char_type* s, std::streamsize count );
		
protected:
virtual std::streamsize xsputn( const char_type* s, std::streamsize count );

将字符序列s中的前count个字符拷贝到缓冲区,一般情况下是对std::basic_streambuf::sputc()调用count次,因此我们可以通过优化std::basic_streambuf::sputc来优化.

 

std::basic_streambuf::overflow

virtual int_type overflow( int_type ch = traits::eof() );
	

该函数是一个很特别的函数,根据标准由2种实现:

1,用来判断当前buffer区是否还有足够的空间存放字符,如果有足够的空间则拷贝字符进去buffer,否则返回 typename std::char_traits<charT>::eof();

2,仅仅用来返回typename std::char_traits<charT>::eof();缓存区空间的大小留给std::basic_streambuf::sputc()或者是std::basic_streambuf::xsputn()来判断.

 

Demo 1(未重写overflow):

#include <iostream>     // std::cin, std::cout
#include <string>
#include <streambuf>
#include <array>

template<typename charT, typename traits = std::char_traits<charT>>
class StreamBuffer : public std::basic_streambuf<charT> {
public:

	using char_type = typename traits::char_type;

	StreamBuffer();
	~StreamBuffer() = default;

	StreamBuffer(const StreamBuffer<charT>& other) = delete;
	StreamBuffer& operator=(const StreamBuffer<charT>& other) = delete;

	void printBuffer()const;

private:
	std::array<char_type, 10> buffer;
};

template<typename charT, typename tratis>
StreamBuffer<charT, tratis>::StreamBuffer()
{
	//注意这里这里设置的是缓冲区的开始位置和最末位置
	//可以通过pbase(), pptr(), epptr()来进行访问.
	this->std::basic_streambuf<charT>::setp((this->buffer).data(), (this->buffer).data()+9);
}

template<typename charT, typename traits>
void StreamBuffer<charT, traits>::printBuffer()const
{
	for (const char_type& value : (this->buffer)) {
		std::cout << value << " ";
	}
	std::cout << std::endl;
}


int main()
{
	StreamBuffer<char> buffer;
	std::basic_ostream<char> ostream(&buffer);

	ostream << "shihua";

	buffer.printBuffer();

	return 0;
}

 

Demo 2(重写overflow):

#include <iostream>
#include <streambuf>
#include <array>
#include <locale>

template<typename charT, typename traits = std::char_traits<charT>>
class StreamBuffer :public std::basic_streambuf<charT>
{
public:

	using charType = typename traits::char_type;
	using intType = typename traits::int_type;

	StreamBuffer();
	virtual ~StreamBuffer() = default;

	StreamBuffer(const StreamBuffer<charT>& other) = delete;
	StreamBuffer& operator=(const StreamBuffer<charT>& other) = delete;

	void printBuffer()const;

protected:
	virtual intType overflow(intType ch)override;
	virtual std::streamsize xsputn(const charT* s, std::streamsize count)override;

private:
	std::array<charType, 10> buffer;
	unsigned long counter;
};


template<typename charT, typename traits>
StreamBuffer<charT, traits>::StreamBuffer()
	:std::basic_streambuf<charT>(),
	 counter(buffer.size())
{
	this->std::basic_streambuf<charT>::setp((this->buffer).data(), (this->buffer).data(), (this->buffer).data() + 10);
}

template<typename charT, typename traits>
void StreamBuffer<charT, traits>::printBuffer()const
{
	for (const charType& value : (this->buffer)) {
		if ( !typename traits::eq(value, traits::eof())) {
			std::cout << value << " ";
		}
	}

	std::cout << std::endl;
}

template<typename charT, typename traits>
typename StreamBuffer<charT, traits>::intType StreamBuffer<charT, traits>::overflow(typename StreamBuffer<charT, traits>::intType ch)
{
	return (typename traits::eof());
}

template<typename charT, typename traits>
std::streamsize StreamBuffer<charT, traits>::xsputn(const charT* s, std::streamsize count)
{
	if (count > 0) {
		if (count < (this->buffer).size()) {
			typename traits::copy(this->pptr(), s, count);
			return count;

		}else {
			return (this->epptr() - this->pptr());
		}
	}
	return (this->overflow(*(this->pptr())));
}



int main()
{
	StreamBuffer<char> buffer;
	std::basic_ostream<char> cout(&buffer);

	cout << "shihua";

	buffer.printBuffer();

	return 0;
}

 

Input stream所用的buffer的接口:

std::basic_streambuf::in_avail

std::streamsize in_avail();
	

该函数返回当前buffer内还有多少有效字符未被读(read)出来.

 

std::basic_streambuf::uflow

virtual int_type uflow();
	

该函数的默认行为是: 调用std::basic_streambuf::underflow()并移动(前进)read pointer。但是一般情况下标准库对于std::basic_streambuf::underflow()的做法是令它返回EOF.

 

std::basic_streambuf::showmanyc

protected:
virtual std::streamsize showmanyc();
	

返回并估计当前缓冲区中还有多少个字符可以读.

其中需要注意的是 std::streamsize一般的实现是: typedef unsigned long long std::streamsize;

 

std::basic_streambuf::underflow

virtual int_type underflow();
	

默认被实现为返回EOF(typename std::char_traits<charType>::eof()).

 

std::basic_streambuf::sgetc

int_type sgetc();
	

读取一个字符(*gptr()),不会向前移动当前可读取位置.

 

std::basic_streambuf::sgetn

std::basic_streambuf::xsgetn

std::streamsize sgetn( char_type* s, std::streamsize count );

protected:
virtual std::streamsize xsgetn( char_type* s, std::streamsize count );

std::basic_streambuf::sgetn()其实是调用std::basic_streambuf::xsgetn().

从input stream buffer中读取count个字符存储到s指向的数组中去.

同时会调用std::basic_streambuf::gbump(count)使当前当前可读位置增加count.

 

std::basic_streambuf::gbump

void gbump( int count );
	

使得当前可读位置向前移动count个位置.

 

std::basic_streambuf::gset

void setg( char_type* pbeg, char_type* pend );
	

设置input stream buffer维护的3个pointer的初始化位置,该函数一般在构造函数中被调用.

eback() = pbeg; gptr()=pbeg; egptr()=pend;

 

Locales:

std::basic_streambuf::pubimbue

std::basic_streambuf::imbue

std::locale pubimbue( const std::locale& loc );
		
protected:
virtual void imbue( const std::locale& loc );

给当前stream buffer设置std::locale.

 

std::basic_streambuf::getloc

std::locale getloc() const;

返回当前std::basic_streambuf设置的std::locale.

 

Positioning:

std::basic_streambuf::pubsetbuf

std::basic_streambuf::setbuf

basic_streambuf<CharT, Traits>* pubsetbuf( char_type* s, std::streamsize n )
	
protected:
virtual basic_streambuf<CharT, Traits>* setbuf( char_type* s, std::streamsize n )

用我们给定的字符数组s的前n个作为缓冲区的存储介质.

 

std::basic_streambuf::pubseekoff

std::basic_streambuf::seekoff

pos_type pubseekoff( off_type off, ios_base::seekdir dir,
                     ios_base::openmode which = ios_base::in | ios_base::out );
	
protected:
virtual pos_type seekoff( off_type off, ios_base::seekdir dir,
                          ios_base::openmode which = ios_base::in | ios_base::out );

off:是偏移量.

dir:是定位到当前stream buffer的位置.

which:指定当前stream buffer的I/O方向.

通过dir定位到stream buffer的一个位置,然后通过offset指定的量偏移一定位置.

返回当前坐标位于buffer中的绝对位置.

 

std::basic_streambuf::pubseekpos

std::basic_streambuf::seekpos

pos_type pubseekpos( pos_type pos,
                     ios_base::openmode which = ios_base::in | ios_base::out );

protected:
virtual pos_type seekpos( pos_type pos,
                          ios_base::openmode which = ios_base::in | ios_base::out);

pos: 绝对位置.

which: I/O方向.

设置当前stream buffer中指向可读位置或者可写的位置到pos指定的绝对位置.

© 著作权归作者所有

SHIHUAMarryMe
粉丝 13
博文 162
码字总数 138435
作品 0
武汉
程序员
私信 提问
I/O: 概览.

C++ I/O由Stream完成。 所谓Stream就是一条数据流(stream of data). 正如不同类型的I/O(例如输入, 输出, 文件访问),对应不同的Stream Class, 其中最为重要的是: Class istream 定义 input ...

SHIHUAMarryMe
2016/09/11
24
0
I/O: std::basic_ostream

需要#include<ostream>: template class std::basic_ostream提供高水平的字符输出操作,支持格式化的和非格式化的输出操作. 我们一般看到的: std::ostream其实是 typedef std::basic_ostream...

SHIHUAMarryMe
2016/09/12
36
0
I/O: std::basic_ios

class temlate std::basicios继承自std::iosbase,定义出与字符类型以及其相应之char_traits相依赖的stream class的共同属性,其中包括stream所用的缓冲器. 构造函数: 默认构造函数: 是prote...

SHIHUAMarryMe
2016/09/11
41
0
I/O:std::basic_istream

Notice: 提取 和 读取 在该篇博客里面是完全不同的意思. template class std::basic_istream提供高水平的格式化输入操作,支持格式化和未格式化的输入。 我们经常使用的std::cin,std::wcin...

SHIHUAMarryMe
2016/09/17
40
0
win32平台关于“pure virtual function call”的解释

本博客(http://blog.csdn.net/livelylittlefish )贴出作者(三二一@小鱼)相关研究、学习内容所做的笔记,欢迎广大朋友指正! Explanation about “pure virtual function call” on Win32...

晨曦之光
2012/03/09
1.4K
0

没有更多内容

加载失败,请刷新页面

加载更多

聊聊artemis的maxDeliveryAttempts

序 本文主要研究一下artemis的maxDeliveryAttempts maxDeliveryAttempts activemq-artemis-2.11.0/artemis-server/src/main/java/org/apache/activemq/artemis/core/settings/impl/AddressSe......

go4it
42分钟前
37
0
heroku - 如何查看所有日志

我在heroku上有一个小应用程序。 每当我想看日志时,我都会去命令行做 heroku logs 这只能让我看到大约100行。 有没有办法在heroku上查看我们的应用程序的完整日志? #1楼 对于雪松堆栈,请...

javail
49分钟前
37
0
Spring AOP 创建增强类

AOP联盟为增强定义了org.aopalliance.aop.Advice接口,Spring支持5种类型的增强: 1)前置增强:org.springframework.aop.BeforeAdvice 代表前置增强,因为Spring 只支持方法级的增强,所有M...

onedotdot
51分钟前
41
0
将.apply()与'new'运算符配合使用。 这可能吗?

在JavaScript中,我想创建一个对象实例(通过new运算符),但是将任意数量的参数传递给构造函数。 这可能吗? 我想做的是这样的(但是下面的代码不起作用): function Something(){ //...

技术盛宴
今天
74
0
世界最大双发客机 波音777X成功首飞

  据外媒报道,美国当地时间 1 月 25 日, 世界上最大的双引擎喷气客机波音 777X 完成首飞,全程 3 小时 51 分钟,从西雅图艾弗雷特佩恩机场起飞,降落在波音机场。   本次飞行将检验飞机...

水果黄瓜
今天
114
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部