不是个抽象类
,
但是他是
C++
流的基类
.
它提供了基本的缓冲区管理
.
它包含六个缓存区指针
,
三个分别是读指针
(
开头
,
结尾
,
当前
),
另外三个是写指针
(
开头
,
结尾
,
当前
)
读开始指针
当前读指针
读结尾指针
_M_gbegin _M_gnext _M_gend
=========================================================
^ ^ ^
_M_pbegin _M_pnext _M_pend
写开始指针
当前写指针
写结尾指针
template
<
class
_CharT
,
class
_Traits
>
class
basic_streambuf
{
friend
class
basic_istream
<
_CharT
,
_Traits
>;
friend
class
basic_ostream
<
_CharT
,
_Traits
>;
public
:
// Typedefs.
typedef
_CharT
char_type
;
typedef
typename
_Traits
::
int_type int_type
;
typedef
typename
_Traits
::
pos_type
pos_type
;
typedef
typename
_Traits
::
off_type
off_type
;
typedef
_Traits
traits_type
;
public
:
// Destructor.
virtual
~
basic_streambuf
() {}
public
:
// Locale-related functions.
locale
pubimbue
(
const
locale
&
__loc
) {
this
->
imbue
(
__loc
);
locale
__tmp
=
_M_locale
;
_M_locale
=
__loc
;
return
__tmp
;
}
locale
getloc
()
const
{
return
_M_locale
; }
public
:
// Buffer management.
//
设置缓冲区和长度
basic_streambuf
*
pubsetbuf
(
char_type
*
__s
,
streamsize
__n
)
{
return
this
->
setbuf
(
__s
,
__n
); }
//
设置缓冲区偏移量
,
简单调用
seekoff()
函数
pos_type
pubseekoff
(
off_type
__offset
,
ios_base
::
seekdir
__way
,
ios_base
::
openmode
__mod
=
ios_base
::
in
|
ios_base
::
out
)
{
return
this
->
seekoff
(
__offset
,
__way
,
__mod
); }
//
设置缓冲区位置
,
简单调用
seekpos()
函数
pos_type
pubseekpos
(
pos_type
__sp
,
ios_base
::
openmode
__mod
=
ios_base
::
in
|
ios_base
::
out
)
{
return
this
->
seekpos
(
__sp
,
__mod
); }
//
放置缓冲区同步
,
简单调用
sync()
函数
int
pubsync
() {
return
this
->
sync
(); }
public
:
//
读取字符的公共成员函数
//
比较当前指针和结尾指针
,
如果在结尾之前返回剩下的缓冲区大小
.
否则调用
showmanyc()
函数
streamsize
in_avail
() {
return
_M_gnext
<
_M_gend
?
_M_gend
-
_M_gnext
:
this
->
showmanyc
();
}
//
移动到下一个字符
,
并返回下一字符
int_type
snextc
() {
return
_M_gend
-
_M_gnext
> 1 ?
_Traits
::
to_int_type
(*++
_M_gnext
)
:
this
->
_M_snextc_aux
();
}
//
移动到下一个字符
,
并返回当前字符
int_type
sbumpc
() {
return
_M_gnext
<
_M_gend
?
_Traits
::
to_int_type
(*
_M_gnext
++)
:
this
->
uflow
();
}
//
并返回当前字符
,
指针不移动到
int_type
sgetc
() {
return
_M_gnext
<
_M_gend
?
_Traits
::
to_int_type
(*
_M_gnext
)
:
this
->
underflow
();
}
//
获取
n
个字符串到参数
__s
streamsize
sgetn
(
char_type
*
__s
,
streamsize
__n
)
{
return
this
->
xsgetn
(
__s
,
__n
); }
//
比较当前前一个字符是否与参数
__c
相等
,
相等则返回
,
移动当前指针
当前前一个字符并返回
int_type
sputbackc
(
char_type
__c
) {
return
_M_gbegin
<
_M_gnext
&&
_Traits
::
eq
(
__c
, *(
_M_gnext
- 1))
?
_Traits
::
to_int_type
(*--
_M_gnext
)
:
this
->
pbackfail
(
_Traits
::
to_int_type
(
__c
));
}
//
移动当前指针
当前前一个字符并返回
int_type
sungetc
() {
return
_M_gbegin
<
_M_gnext
?
_Traits
::
to_int_type
(*--
_M_gnext
)
:
this
->
pbackfail
();
}
public
:
//
公共写字符成员函数
//
写入一个字符
,
int_type
sputc
(
char_type
__c
) {
return
_M_pnext
<
_M_pend
?
_Traits
::
to_int_type
(*
_M_pnext
++ =
__c
)
:
this
->
overflow
(
_Traits
::
to_int_type
(
__c
));
}
//
写入长度为
n
的字串
streamsize
sputn
(
const
char_type
*
__s
,
streamsize
__n
)
{
return
this
->
xsputn
(
__s
,
__n
); }
//
扩展写
n
个字符函数
streamsize
_M_sputnc
(
char_type
__c
,
streamsize
__n
)
{
return
this
->
_M_xsputnc
(
__c
,
__n
); }
public
:
//
线程安全的锁
_STL_mutex_lock
_M_lock
;
protected
:
//
缺省构造函数
basic_streambuf
()
:
_M_gbegin
(0),
_M_gnext
(0),
_M_gend
(0),
_M_pbegin
(0),
_M_pnext
(0),
_M_pend
(0),
_M_locale
()
{
_M_lock
._M_initialize();
}
protected
:
//
保护的获取读指针的成员函数
char_type
*
eback
()
const
{
return
_M_gbegin
; }
//
开头读指针
char_type
*
gptr
()
const
{
return
_M_gnext
; }
//
当前读指针
char_type
*
egptr
()
const
{
return
_M_gend
; }
//
结尾读指针
//
将读指针向移动
n
个字符
void
gbump
(
int
__n
) {
_M_gnext
+=
__n
; }
//
从新设置读的三个指针
void
setg
(
char_type
*
__gbegin
,
char_type
*
__gnext
,
char_type
*
__gend
) {
_M_gbegin
=
__gbegin
;
_M_gnext
=
__gnext
;
_M_gend
=
__gend
;
}
protected
:
//
保护的获取写指针的成员函数
char_type
*
pbase
()
const
{
return
_M_pbegin
; }
//
开头读指针
char_type
*
pptr
()
const
{
return
_M_pnext
; }
//
当前读指针
char_type
*
epptr
()
const
{
return
_M_pend
; }
//
结尾读指针
//
将写指针向移动
n
个字符
void
pbump
(
int
__n
) {
_M_pnext
+=
__n
; }
//
从新设置读的三个指针
void
setp
(
char_type
*
__pbegin
,
char_type
*
__pend
) {
_M_pbegin
=
__pbegin
;
_M_pnext
=
__pbegin
;
_M_pend
=
__pend
;
}
protected
:
//
本地化虚函数
virtual
void
imbue
(
const
locale
&) {}
protected
:
//
内存管理
虚函数
,
当前置返回自己
this
virtual
basic_streambuf
*
setbuf
(
char_type
*,
streamsize
)
{
return
this
; }
//
通过一个整型偏移值
,
改变流的位置
.
该函数这里什么读没作
,
只返回
-1,
在子类中重载
virtual
pos_type
seekoff
(
off_type
,
ios_base
::
seekdir
,
ios_base
::
openmode
=
ios_base
::
in
|
ios_base
::
out
)
{
return
pos_type
(-1); }
//
通过前面获取流位置
,
改变流的位置
.
该函数这里什么读没作
,
只返回
-1,
在子类中重载
virtual
pos_type
seekpos
(
pos_type
,
ios_base
::
openmode
=
ios_base
::
in
|
ios_base
::
out
)
{
return
pos_type
(-1); }
//
同步
(
刷新
).
缓冲区
.
所有的子类中重载
virtual
int
sync
() {
return
0; }
protected
:
//
返回在在抵达文件结尾更低级可以读取字符数
. (-1
是特定值
,
意味着
underflow
将失败
.)
//
函数在子类中重载
virtual
streamsize
showmanyc
()
{
return
0; }
//
读取
n
的字符
.
返回可读取的字符数
virtual
streamsize
xsgetn
(
char_type
*
__s
,
streamsize
__n
);
//
当没有读取的位置时调用
.
如
: gptr()
返回为空时或者
gptr() >= egptr().
virtual
int_type
underflow
()
{
return
_Traits
::
eof
(); }
//
类似
underflow(),
但是使用在
unbuffered
输入
.
virtual
int_type
uflow
() {
return
_Traits
::
eq_int_type
(
this
->
underflow
(),
_Traits
::
eof
())
?
_Traits
::
eof
()
:
_Traits
::
to_int_type
(*
_M_gnext
++);
}
//
当没有放置的位置时调用
.
如
: gptr()
返回为空时或者
gptr() == eback().
virtual
int_type
pbackfail
(
int_type
__c
=
_Traits
::
eof
())
{
return
_Traits
::
eof
(); }
protected
:
//
写
n
字符
,
返回写的字符数
virtual
streamsize
xsputn
(
const
char_type
*
__s
,
streamsize
__n
);
//
当没有写位置时调用
virtual
int_type
overflow
(
int_type
=
_Traits
::
eof
())
{
return
_Traits
::
eof
(); }
private
:
char_type
*
_M_gbegin
;
// get
区的开始指针
char_type
*
_M_gnext
;
// get
区的当前指针
char_type
*
_M_gend
;
// get
区的结尾指针
char_type
*
_M_pbegin
;
// put
区的开始指针
char_type
*
_M_pnext
;
// put
区的当前指针
char_type
*
_M_pend
;
// put
区的结尾指针
locale
_M_locale
;
// The streambuf's locale object
};
转载请注明原文地址: https://ibbs.8miu.com/read-900326.html