<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.memcached.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'it',
  ),
  'this' => 
  array (
    0 => 'memcached.deletebykey.php',
    1 => 'Memcached::deleteByKey',
    2 => 'Delete an item from a specific server',
  ),
  'up' => 
  array (
    0 => 'class.memcached.php',
    1 => 'Memcached',
  ),
  'prev' => 
  array (
    0 => 'memcached.delete.php',
    1 => 'Memcached::delete',
  ),
  'next' => 
  array (
    0 => 'memcached.deletemulti.php',
    1 => 'Memcached::deleteMulti',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/memcached/memcached/deletebykey.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="memcached.deletebykey" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">Memcached::deleteByKey</h1>
  <p class="verinfo">(PECL memcached &gt;= 0.1.0)</p><p class="refpurpose"><span class="refname">Memcached::deleteByKey</span> &mdash; <span class="dc-title">Delete an item from a specific server</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-memcached.deletebykey-description">
  <h3 class="title">Descrizione</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><strong>Memcached::deleteByKey</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$server_key</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$key</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$time</code><span class="initializer"> = 0</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>Memcached::deleteByKey()</strong></span> is functionally equivalent to
   <span class="methodname"><a href="memcached.delete.php" class="methodname">Memcached::delete()</a></span>, except that the free-form
   <code class="parameter">server_key</code> can be used to map the
   <code class="parameter">key</code> to a specific server.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-memcached.deletebykey-parameters">
  <h3 class="title">Elenco dei parametri</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">server_key</code></dt>
     <dd>
      <p class="para">
       La chiave che identifica il server su cui salvare il valore. Invece di effettuare li&#039;hashing sulla chiave dell&#039;elemento, si effettua l&#039;hashing della chiave del server al momento di decidere con quale server memcached comunicare. Questo permette di raggruppare gli elementi correlati ad un singolo server ottenendo maggiore efficienza nelle operazioni multiple.
      </p>
     </dd>
    
    
     <dt><code class="parameter">key</code></dt>
     <dd>
      <p class="para">
       The key to be deleted.
      </p>
     </dd>
    
    
     <dt><code class="parameter">time</code></dt>
     <dd>
      <p class="para">
       The amount of time the server will wait to delete the item.
      </p>
      <blockquote class="note"><p><strong class="note">Nota</strong>: <span class="simpara">
       As of memcached 1.3.0 (released 2009) this feature is no longer
       supported. Passing a non-zero <code class="parameter">time</code> will cause
       the deletion to fail. <span class="methodname"><a href="memcached.getresultcode.php" class="methodname">Memcached::getResultCode()</a></span>
       will return <strong><code>MEMCACHED_INVALID_ARGUMENTS</code></strong>.
      </span></p></blockquote>

     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-memcached.deletebykey-returnvalues">
  <h3 class="title">Valori restituiti</h3>
  <p class="para">
   Restituisce <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> in caso di successo, <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> in caso di fallimento.
   The <span class="methodname"><a href="memcached.getresultcode.php" class="methodname">Memcached::getResultCode()</a></span> will return
   <strong><code><a href="memcached.constants.php#memcached.constants.res-notfound">Memcached::RES_NOTFOUND</a></code></strong> if the key does not exist.
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-memcached.deletebykey-seealso">
  <h3 class="title">Vedere anche:</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="methodname"><a href="memcached.delete.php" class="methodname" rel="rdfs-seeAlso">Memcached::delete()</a> - Delete an item</span></li>
    <li><span class="methodname"><a href="memcached.deletemulti.php" class="methodname" rel="rdfs-seeAlso">Memcached::deleteMulti()</a> - Delete multiple items</span></li>
    <li><span class="methodname"><a href="memcached.deletemultibykey.php" class="methodname" rel="rdfs-seeAlso">Memcached::deleteMultiByKey()</a> - Delete multiple items from a specific server</span></li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>