| CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Fri, 25 Jul 2025 17:22:39 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/fstream/basic_filebuf/showmanyc/
HTTP/1.1 200 OK
Server: nginx
Date: Fri, 25 Jul 2025 17:22:39 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"773f-5yNqD8brLpJ25SRd0Tit5qr/bg0"
Content-Encoding: gzip
Returns an estimate on the number of characters available in the associated file.
This function is expected to return zero (providing no information), but library implementations may instead provide information on the possible behavior of future calls to the protected member functions underflow and uflow:
This virtual member function overrides the inherited member basic_streambuf::showmanyc, called by member in_avail when there are no read positions available at the get pointer (gptr).
Library implementations may return a different value to provide additional information.
streamsize is a signed integral type.
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
<fstream>
class templates
classes
basic_filebuf
- basic_filebuf::~basic_filebuf
- basic_filebuf::basic_filebuf
public members
protected virtual members
non-member overloads
-
swap (basic_filebuf)C++11
-
- Reference
- <fstream>
- basic_filebuf
- showmanyc
public member function
<fstream>
std::basic_filebuf::showmanyc
streamsize showmanyc();
Get number of characters available
This function is expected to return zero (providing no information), but library implementations may instead provide information on the possible behavior of future calls to the protected member functions underflow and uflow:
| return value | description | expected behavior for underflow and uflow |
|---|---|---|
>0 | characters known to be available | Successive calls will succeed in retrieving characters until at least as many characters as the value returned have been extracted. |
0 | no information | Further calls may either retrieve more characters or return traits_type::eof(). |
-1 | sequence unavailable | Further calls will fail (either throwing or returning "immediately"). |
This virtual member function overrides the inherited member basic_streambuf::showmanyc, called by member in_avail when there are no read positions available at the get pointer (gptr).
Parameters
noneReturn Value
Returns zero (if no information is provided).Library implementations may return a different value to provide additional information.
streamsize is a signed integral type.
Data races
Unspecified.Exception safety
Basic guarantee: if an exception is thrown, the file stream buffer is in a valid state.See also
- basic_filebuf::underflow
- Get character on underflow (protected virtual member function)
- basic_filebuf::uflow
- Get character on overflow and advance position (protected virtual member function)
- basic_streambuf::showmanyc
- Get number of characters available (protected virtual member function)
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us