<!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>Sets the file where blobs are read from</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.px-retrieve-record.html">px_retrieve_record</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.px-set-parameter.html">px_set_parameter</a></div>
<div class="up"><a href="ref.paradox.html">Paradox Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.px-set-blob-file" class="refentry">
<div class="refnamediv">
<h1 class="refname">px_set_blob_file</h1>
<p class="verinfo">(PECL paradox >= 1.3.0)</p><p class="refpurpose"><span class="refname">px_set_blob_file</span> — <span class="dc-title">Sets the file where blobs are read from</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.px-set-blob-file-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">bool</span> <span class="methodname"><strong>px_set_blob_file</strong></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$pxdoc</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$filename</code></span>
)</div>
<p class="para rdfs-comment">
Sets the name of the file where blobs are going to be read from or written
into. Without
calling this function, <span class="function"><a href="function.px-get-record.html" class="function">px_get_record()</a></span> or
<span class="function"><a href="function.px-retrieve-record.html" class="function">px_retrieve_record()</a></span> will only return
data in blob fields if the data is part of the record and not stored in the
blob file. Blob data is stored in the record if it is small enough to fit
in the size of the blob field.</p>
<p class="para">
Calling <span class="function"><a href="function.px-put-record.html" class="function">px_put_record()</a></span>,
<span class="function"><a href="function.px-insert-record.html" class="function">px_insert_record()</a></span>, or
<span class="function"><a href="function.px-update-record.html" class="function">px_update_record()</a></span> without calling
<span class="function"><strong>px_set_blob_file()</strong></span> will result in truncated blob fields
unless the data fits into the database file.
</p>
<p class="para">
Calling this function twice will close the first blob file and open the new
one.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.px-set-blob-file-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">pxdoc</code></em></span>
<dd>
<p class="para">
Resource identifier of the paradox database
as returned by <span class="function"><a href="function.px-new.html" class="function">px_new()</a></span>.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">filename</code></em></span>
<dd>
<p class="para">
The name of the file. Its extension should be <em>.MB</em>.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.px-set-blob-file-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns <strong><code>TRUE</code></strong> on success or <strong><code>FALSE</code></strong> on failure.
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.px-retrieve-record.html">px_retrieve_record</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.px-set-parameter.html">px_set_parameter</a></div>
<div class="up"><a href="ref.paradox.html">Paradox Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
