<?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 => 'es',
  ),
  'this' => 
  array (
    0 => 'memcached.deletebykey.php',
    1 => 'Memcached::deleteByKey',
    2 => 'Elimina un elemento de un servidor espec&iacute;fico',
  ),
  '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' => 'es',
    '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">Elimina un elemento de un servidor específico</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-memcached.deletebykey-description">
  <h3 class="title">Descripción</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> es funcionalmente equivalente a
   <span class="methodname"><a href="memcached.delete.php" class="methodname">Memcached::delete()</a></span>, excepto por la variable libre
   <code class="parameter">server_key</code> que puede ser utilizada para dirigir la variable
   <code class="parameter">key</code> a un servidor específico.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-memcached.deletebykey-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">server_key</code></dt>
     <dd>
      <p class="para">
       La clave que identifica el servidor donde almacenar o recuperar el valor. En lugar de calcular el hash sobre la clave real del elemento, se calcula el hash sobre la clave del servidor al decidir con qué servidor memcached comunicarse. Esto permite agrupar elementos relacionados en un solo servidor para mayor eficiencia con operaciones múltiples.
      </p>
     </dd>
    
    
     <dt><code class="parameter">key</code></dt>
     <dd>
      <p class="para">
       La clave a eliminar.
      </p>
     </dd>
    
    
     <dt><code class="parameter">time</code></dt>
     <dd>
      <p class="para">
       La duración de espera para la eliminación.
      </p>
      <blockquote class="note"><p><strong class="note">Nota</strong>: <span class="simpara">
       A partir de memcached 1.3.0 (publicado en 2009) esta funcionalidad ya no está
       soportada. Pasar un valor distinto de cero para <code class="parameter">time</code> causará
       que la eliminación falle. <span class="methodname"><a href="memcached.getresultcode.php" class="methodname">Memcached::getResultCode()</a></span>
       devolverá <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">Valores devueltos</h3>
  <p class="para">
   Esta función retorna <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> en caso de éxito o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si ocurre un error.
   El método <span class="methodname"><a href="memcached.getresultcode.php" class="methodname">Memcached::getResultCode()</a></span> devuelve
   <strong><code><a href="memcached.constants.php#memcached.constants.res-notfound">Memcached::RES_NOTFOUND</a></code></strong> si la clave no existe.
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-memcached.deletebykey-seealso">
  <h3 class="title">Ver también</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="methodname"><a href="memcached.delete.php" class="methodname" rel="rdfs-seeAlso">Memcached::delete()</a> - Elimina un elemento</span></li>
    <li><span class="methodname"><a href="memcached.deletemulti.php" class="methodname" rel="rdfs-seeAlso">Memcached::deleteMulti()</a> - Elimina varios elementos</span></li>
    <li><span class="methodname"><a href="memcached.deletemultibykey.php" class="methodname" rel="rdfs-seeAlso">Memcached::deleteMultiByKey()</a> - Elimina varios elementos de un servidor espec&iacute;fico</span></li>
   </ul>
  </p>
 </div>


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