public static member function
<string>
static constexpr int_type eof() noexcept;
End-of-File character
Returns the End-of-File value.
The End-of-File value is a special value used by many standard functions to represent an invalid character; Its value shall not compare equal to any of the values representable with char_type (as if transformed with member int_type and compared with member eq_int_type).
For the standard specializations of char_traits it returns:
specialization | value returned by eof() |
char | EOF |
wchar_t | WEOF |
char16_t | A value that is not a valid UTF-16 code unit. |
char32_t | A value that is not a valid Unicode code point. |
Return Value
The End-of-File value.
Member type int_type is an integral type that can represent this value or any valid character value.
Example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
|
// char_traits::eof
#include <iostream> // std::wcin, std::wcout
#include <string> // std::wstring, std::char_traits
int main () {
std::wcout << "Please enter some text: ";
if (std::wcin.peek() == std::char_traits<wchar_t>::eof()) {
std::wcout << "Reading error";
}
else {
std::wstring ws;
std::getline (std::wcin,ws);
std::wcout << "You entered a word: " << ws << '\n';
}
return 0;
}
| |
Exception safety
No-throw guarantee: this member function never throws exceptions.