std::basic_streambuf<CharT,Traits>:: showmanyc
|
protected
:
virtual std:: streamsize showmanyc ( ) ; |
||
Estima el número de caracteres disponibles para entrada en la secuencia de caracteres asociada. underflow() está garantizado que no retornará Traits :: eof ( ) ni lanzará una excepción hasta que al menos esa cantidad de caracteres sean extraídos.
Contenidos |
Parámetros
(ninguno)
Valor de retorno
El número de caracteres que ciertamente están disponibles en la secuencia de caracteres asociada, o
-
1
si
showmanyc
puede determinar, sin bloqueo, que no hay caracteres disponibles. Si
showmanyc
retorna
-
1
,
underflow()
y
uflow()
definitivamente retornarán
Traits
::
eof
o lanzarán una excepción.
La versión de la clase base retorna 0 , que tiene el significado de "no seguro si hay caracteres disponibles en la secuencia asociada".
Notas
El nombre de esta función significa "stream: how many characters?", por lo que se pronuncia "S how many C", en lugar de "show many C".
Ejemplo
|
Esta sección está incompleta
Razón: sin ejemplo |
Informes de defectos
Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.
| DR | Aplicado a | Comportamiento publicado | Comportamiento correcto |
|---|---|---|---|
| LWG 159 | C++98 |
underflow()
tiene garantizado no fallar hasta que
al menos
showmanyc()
caracteres sean suministrados
|
extendió la garantía para permitir al menos
showmanyc()
caracteres sean extraídos
|
Véase también
|
obtiene el número de caracteres inmediatamente disponibles en el área de obtención
(función miembro pública) |
|
|
[virtual]
|
opcionalmente proporciona el número de caracteres disponibles para entrada desde el archivo
(función miembro protegida virtual de
std::basic_filebuf<CharT,Traits>
)
|