<!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>Moves objects</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.hw-modifyobject.html">hw_Modifyobject</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.hw-new-document.html">hw_New_Document</a></div>
<div class="up"><a href="ref.hw.html">Hyperwave Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.hw-mv" class="refentry">
<div class="refnamediv">
<h1 class="refname">hw_mv</h1>
<p class="verinfo">(PHP 4)</p><p class="refpurpose"><span class="refname">hw_mv</span> — <span class="dc-title">Moves objects</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.hw-mv-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">int</span> <span class="methodname"><strong>hw_mv</strong></span>
( <span class="methodparam"><span class="type">int</span> <code class="parameter">$connection</code></span>
, <span class="methodparam"><span class="type">array</span> <code class="parameter">$object_id_array</code></span>
, <span class="methodparam"><span class="type">int</span> <code class="parameter">$source_id</code></span>
, <span class="methodparam"><span class="type">int</span> <code class="parameter">$destination_id</code></span>
)</div>
<p class="para rdfs-comment">
Moves the specified objects from a collection to another.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.hw-mv-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">connection</code></em></span>
<dd>
<p class="para">
The connection identifier.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">object_id_array</code></em></span>
<dd>
<p class="para">
An array of object ids.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">source_id</code></em></span>
<dd>
<p class="para">
The source collection id.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">destination_id</code></em></span>
<dd>
<p class="para">
The target collection id. If set to 0 the objects will be unlinked
from the source collection. If this is the last instance of that
object it will be deleted. If you want to delete all instances at
once, use <span class="function"><a href="function.hw-deleteobject.html" class="function">hw_deleteobject()</a></span>.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.hw-mv-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns the number of moved objects.
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.hw-mv-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.hw-cp.html" class="function" rel="rdfs-seeAlso">hw_cp()</a> - Copies objects</span></li>
<li class="member"> <span class="function"><a href="function.hw-deleteobject.html" class="function" rel="rdfs-seeAlso">hw_deleteobject()</a> - Deletes object</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.hw-modifyobject.html">hw_Modifyobject</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.hw-new-document.html">hw_New_Document</a></div>
<div class="up"><a href="ref.hw.html">Hyperwave Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
