<!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>
ignore [C++ Reference]
</title>
<meta name="generator" content="DokuWiki Release 2009-12-25c "Lemming"" />
<meta name="robots" content="index,follow" />
<meta name="date" content="2009-03-09T12:13:28-0700" />
<meta name="keywords" content="io,ignore" />
<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/ignore?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="edit" title="Edit this page" href="/wiki/io/ignore?do=edit" />
<link rel="alternate" type="text/html" title="Plain HTML" href="/wiki/_export/xhtml/io/ignore" />
<link rel="alternate" type="text/plain" title="Wiki Markup" href="/wiki/_export/raw/io/ignore" />
<link rel="canonical" href="http://www.cppreference.com/wiki/io/ignore" />
<link rel="stylesheet" media="all" type="text/css" href="/wiki/lib/exe/css.php?s=all&t=custom1&tseed=1272971091" />
<link rel="stylesheet" media="screen" type="text/css" href="/wiki/lib/exe/css.php?t=custom1&tseed=1272971091" />
<link rel="stylesheet" media="print" type="text/css" href="/wiki/lib/exe/css.php?s=print&t=custom1&tseed=1272971091" />
<script type="text/javascript" charset="utf-8" ><!--//--><![CDATA[//><!--
var NS='io';var JSINFO = {"id":"io:ignore","namespace":"io"};
//--><!]]></script>
<script type="text/javascript" charset="utf-8" src="/wiki/lib/exe/js.php?tseed=1272971091" ></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/ignore.html" title="io:ignore">ignore</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="ignore" id="ignore">ignore</a></h2>
<div class="level2">
<p>
Syntax:
</p>
<pre class="c code c++" style="font-family:monospace;"> istream<span class="sy0">&</span> istream<span class="sy0">::</span><span class="me2">ignore</span><span class="br0">(</span> streamsize num<span class="sy0">=</span>1<span class="sy0">,</span> <span class="kw4">int</span> delim<span class="sy0">=</span>EOF <span class="br0">)</span><span class="sy0">;</span></pre>
<p>
The ignore() function is used with input streams. It reads and throws away
characters until num characters have been read (where num defaults to 1) or
until the character delim is read (where delim defaults to <acronym title="End of file">EOF</acronym>).
The ignore() function can sometimes be useful when using the getline() function
together with the » operator. For example, if you read some input that is
followed by a newline using the » operator, the newline will remain in the
input as the next thing to be read. Since getline() will by default stop
reading input when it reaches a newline, a subsequent call to getline() will
return an empty string. In this case, the ignore() function could be called
before getline() to “throw away” the newline.
</p>
<p>
Related Topics: <a href="../io/get.html" class="wikilink1" title="io:get">get</a>, <a href="../io/getline.html" class="wikilink1" title="io:getline">getline</a>
</p>
</div>
<!-- wikipage stop -->
</div>
<div class="clearer"> </div>
<div class="stylefoot">
<div class="meta">
<div class="user">
</div>
<!--
<div class="doc">
io/ignore.txt · Last modified: 03/09/2009 12:13 by 164.76.9.87 </div>
-->
</div>
</div></div></body>
</html>