std::basic_stringbuf<CharT,Traits,Allocator>:: seekpos
|
protected
:
virtual
pos_type seekpos
(
pos_type sp,
|
||
Repositionne std::basic_streambuf::gptr et/ou std::basic_streambuf::pptr , si possible, à la position indiquée par sp .
Exécute efficacement seekoff ( off_type ( sp ) , std:: ios_base :: beg , which ) .
Table des matières |
Paramètres
| sp | - |
position du flux, telle qu'obtenue par
seekoff()
ou
seekpos()
|
||||||
| which | - |
définit si la séquence d'entrée, la séquence de sortie, ou les deux sont affectées. Il peut s'agir d'une ou d'une combinaison des constantes suivantes :
|
Valeur de retour
sp en cas de succès ou pos_type ( off_type ( - 1 ) ) en cas d'échec.
Notes
seekpos()
est appelée par
std::basic_streambuf::pubseekpos()
, qui est appelée par les versions à un seul argument de
std::basic_istream::seekg()
et
std::basic_ostream::seekp()
.
Exemple
#include <sstream> #include <iostream> struct mybuf : std::stringbuf { mybuf(const std::string& str) : std::stringbuf(str) {} pos_type seekpos(pos_type sp, std::ios_base::openmode which) { std::cout << "Before seekpos(" << sp << "), size of the get area is " << egptr() - eback() << " with " << egptr() - gptr() << " read positions available.\n"; pos_type rc = std::stringbuf::seekpos(sp, which); std::cout << "seekpos() returns " << rc << ".\nAfter the call, " << "size of the get area is " << egptr() - eback() << " with " << egptr() - gptr() << " read positions available.\n"; return rc; } }; int main() { mybuf buf("12345"); std::iostream stream(&buf); stream.seekg(2); }
Sortie :
Before seekpos(2), size of the get area is 5 with 5 read positions available. seekpos() returns 2. After the call, size of the get area is 5 with 3 read positions available.
Rapports de défauts
Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.
| DR | Appliqué à | Comportement publié | Comportement corrigé |
|---|---|---|---|
| LWG 375 | C++98 |
les membres constants statiques de
std::ios_base
étaient
mal spécifiés comme membres de std::basic_ios |
corrigé |
| LWG 564 | C++98 |
il n'était pas clair comment repositionner
gptr
et/ou
pptr
|
ils sont repositionnés par seekoff() |
Voir aussi
|
invoque
seekpos
(
)
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
|
[virtual]
|
repositionne le pointeur suivant dans la séquence d'entrée, la séquence de sortie, ou les deux, en utilisant l'adressage relatif
(fonction membre protégée virtuelle) |
|
[virtual]
|
repositionne la position du fichier, en utilisant l'adressage absolu
(fonction membre protégée virtuelle de
std::basic_filebuf<CharT,Traits>
)
|
|
[virtual]
|
repositionne le pointeur suivant dans la séquence d'entrée, la séquence de sortie, ou les deux en utilisant l'adressage absolu
(fonction membre protégée virtuelle de
std::strstreambuf
)
|