/
fail.html
130 lines (100 loc) · 4.75 KB
/
fail.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>
fail [C++ Reference]
</title>
<meta name="generator" content="DokuWiki Release 2009-02-14b" />
<meta name="robots" content="index,follow" />
<meta name="date" content="2009-03-09T12:15:21-0700" />
<meta name="keywords" content="io,fail" />
<link rel="search" type="application/opensearchdescription+xml" href="/wiki/lib/exe/opensearch.php" title="C++ Reference" />
<link rel="start" href="/wiki/" />
<link rel="contents" href="/wiki/io/fail?do=index" title="Index" />
<link rel="alternate" type="application/rss+xml" title="Recent Changes" href="/wiki/feed.php" />
<link rel="alternate" type="application/rss+xml" title="Current Namespace" href="/wiki/feed.php?mode=list&ns=io" />
<link rel="alternate" type="application/wiki" title="Edit this page" href="/wiki/io/fail?do=edit" />
<link rel="alternate" type="text/html" title="Plain HTML" href="/wiki/_export/xhtml/io/fail" />
<link rel="alternate" type="text/plain" title="Wiki Markup" href="/wiki/_export/raw/io/fail" />
<link rel="stylesheet" media="all" type="text/css" href="/wiki/lib/exe/css.php?s=all&t=custom1" />
<link rel="stylesheet" media="screen" type="text/css" href="/wiki/lib/exe/css.php?t=custom1" />
<link rel="stylesheet" media="print" type="text/css" href="/wiki/lib/exe/css.php?s=print&t=custom1" />
<script type="text/javascript" charset="utf-8" src="/wiki/lib/exe/js.php?edit=0&write=1" ></script>
<link rel="shortcut icon" href="/wiki/lib/tpl/custom1/images/favicon.png" />
</head>
<body>
<div class="dokuwiki">
<div class="stylehead">
<div class="breadcrumbs">
<span class="bchead">You are here: </span><a href="../start.html" title="start">C++ Reference</a> » <a href="../io/start.html" title="io:start">C++ I/O</a> » <a href="../io/fail.html" title="io:fail">fail</a> </div>
</div>
<div class="page">
<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</script>
<script type="text/javascript">
_uacct = "UA-2828341-1";
urchinTracker();
</script>
<!-- wikipage start -->
<h2><a name="fail" id="fail">fail</a></h2>
<div class="level2">
<p>
Syntax:
</p>
<pre class="c code c++" style="font-family:monospace;"> bool stream<span class="sy0">::</span><span class="me2">fail</span><span class="br0">(</span><span class="br0">)</span>;</pre>
<p>
The fail() function returns true if an error has occurred with the current
stream, false otherwise. This can be used for checking whether the previous operation has failed.
</p>
<p>
Examples of failures that cause fail to be set:
</p>
<ul>
<li class="level1"><div class="li">file not found (when opening for reading).</div>
</li>
<li class="level1"><div class="li">file cannot be created (when opening for writing).</div>
</li>
<li class="level1"><div class="li">end of file is reached before the requested data could be read.</div>
</li>
<li class="level1"><div class="li">invalid formatting of data (e.g. letters when expecting numbers).</div>
</li>
</ul>
<p>
Once set, the fail state will make all other operations on the stream fail instantly, until the error state is cleared with the clear function.
</p>
<p>
Related Topics: <a href="../io/bad.html" class="wikilink1" title="io:bad">bad</a>, <a href="../io/clear.html" class="wikilink1" title="io:clear">clear</a>, <a href="../io/eof.html" class="wikilink1" title="io:eof">eof</a>, <a href="../io/exceptions.html" class="wikilink1" title="io:exceptions">exceptions</a>, <a href="../io/good.html" class="wikilink1" title="io:good">good</a>, <a href="../io/rdstate.html" class="wikilink1" title="io:rdstate">rdstate</a>
</p>
<p>
Stream states:
</p>
<ul>
<li class="level1"><div class="li">if (s): The previous operation was successful (a shorthand for !s.fail()).</div>
</li>
<li class="level1"><div class="li">if (s.fail()): The previous operation failed.</div>
</li>
<li class="level1"><div class="li">if (s.eof()): Reading past the end has been attempted.</div>
</li>
<li class="level1"><div class="li">if (s.bad()): Stream state is undefined; the stream can no longer be used.</div>
</li>
<li class="level1"><div class="li">if (s.good()): None of bad/eof/fail are set.</div>
</li>
</ul>
</div>
<!-- wikipage stop -->
</div>
<div class="clearer"> </div>
<div class="stylefoot">
<div class="meta">
<div class="user">
</div>
<!--
<div class="doc">
io/fail.txt · Last modified: 03/09/2009 12:15 by 164.76.9.87 </div>
-->
</div>
</div></div></body>
</html>