<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Checks if there are documents that have not been sent yet from the database for this cursor</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="mongocursor.current.html">MongoCursor::current</a></div>
<div class="next" style="text-align: right; float: right;"><a href="mongocursor.doquery.html">MongoCursor::doQuery</a></div>
<div class="up"><a href="class.mongocursor.html">MongoCursor</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="mongocursor.dead" class="refentry">
<div class="refnamediv">
<h1 class="refname">MongoCursor::dead</h1>
<p class="verinfo">(PECL mongo >=0.9.6)</p><p class="refpurpose"><span class="refname">MongoCursor::dead</span> — <span class="dc-title">Checks if there are documents that have not been sent yet from the database for this cursor</span></p>
</div>
<div class="refsect1 description" id="refsect1-mongocursor.dead-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="modifier">public</span> <span class="type">bool</span> <span class="methodname"><strong>MongoCursor::dead</strong></span>
( <span class="methodparam">void</span>
)</div>
<p class="para rdfs-comment">
The database sends responses in batches of documents, up to 4MB of documents
per response. This method checks if the database has more batches or if the
result set has been exhausted.
</p>
<p class="para">
A cursor being "dead" does not mean that
<span class="function"><a href="mongocursor.hasnext.html" class="function">MongoCursor::hasNext()</a></span> will return <strong><code>FALSE</code></strong>, it only means
that the database is done sending results to the client. The client should
continue iterating through results until
<span class="function"><a href="mongocursor.hasnext.html" class="function">MongoCursor::hasNext()</a></span> is <strong><code>FALSE</code></strong>.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-mongocursor.dead-parameters">
<h3 class="title">Parameters</h3>
<p class="para">This function has no parameters.</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-mongocursor.dead-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns if there are more results that have not been sent to the client, yet.
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="mongocursor.current.html">MongoCursor::current</a></div>
<div class="next" style="text-align: right; float: right;"><a href="mongocursor.doquery.html">MongoCursor::doQuery</a></div>
<div class="up"><a href="class.mongocursor.html">MongoCursor</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
