<?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.getbykey.php',
    1 => 'Memcached::getByKey',
    2 => 'Lee un elemento en un servidor espec&iacute;fico',
  ),
  'up' => 
  array (
    0 => 'class.memcached.php',
    1 => 'Memcached',
  ),
  'prev' => 
  array (
    0 => 'memcached.getallkeys.php',
    1 => 'Memcached::getAllKeys',
  ),
  'next' => 
  array (
    0 => 'memcached.getdelayed.php',
    1 => 'Memcached::getDelayed',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/memcached/memcached/getbykey.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="memcached.getbykey" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">Memcached::getByKey</h1>
  <p class="verinfo">(PECL memcached &gt;= 0.1.0)</p><p class="refpurpose"><span class="refname">Memcached::getByKey</span> &mdash; <span class="dc-title">Lee un elemento en un servidor específico</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-memcached.getbykey-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><strong>Memcached::getByKey</strong></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<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>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$key</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.callable.php" class="type callable">callable</a></span></span> <code class="parameter">$cache_cb</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$get_flags</code><span class="initializer"> = 0</span></span><br>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>Memcached::getByKey()</strong></span> es funcionalmente equivalente a
   <span class="methodname"><a href="memcached.get.php" class="methodname">Memcached::get()</a></span>, excepto que la variable libre
   <code class="parameter">server_key</code> puede ser utilizada para dirigir la clave
   <code class="parameter">key</code> a un servidor específico.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-memcached.getbykey-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 del elemento a leer.
      </p>
     </dd>
    
    
     <dt><code class="parameter">cache_cb</code></dt>
     <dd>
      <p class="para">
       Función de retrollamada en caso de ausencia, o <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>
      </p>
     </dd>
    
    
     <dt><code class="parameter">get_flags</code></dt>
     <dd>
      <p class="para">
       Bandera para controlar el resultado devuelto.
       Cuando <strong><code><a href="memcached.constants.php#memcached.constants.get-extended">Memcached::GET_EXTENDED</a></code></strong>
       es proporcionada, la función devolverá también el token CAS.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-memcached.getbykey-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Devuelve el valor almacenado en la caché, o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> en caso contrario.
   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 changelog" id="refsect1-memcached.getbykey-changelog">
  <h3 class="title">Historial de cambios</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versión</th>
      <th>Descripción</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>PECL memcached 3.0.0</td>
      <td>
       El parámetro <code class="parameter reference">&cas_tokens</code> ha sido eliminado.
       <strong><code><a href="memcached.constants.php#memcached.constants.get-extended">Memcached::GET_EXTENDED</a></code></strong> ha sido añadida y cuando se pasa
       como bandera asegura que los tokens CAS sean recuperados.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 seealso" id="refsect1-memcached.getbykey-seealso">
  <h3 class="title">Ver también</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="methodname"><a href="memcached.get.php" class="methodname" rel="rdfs-seeAlso">Memcached::get()</a> - Lee un elemento</span></li>
    <li><span class="methodname"><a href="memcached.getmulti.php" class="methodname" rel="rdfs-seeAlso">Memcached::getMulti()</a> - Lee varios elementos</span></li>
    <li><span class="methodname"><a href="memcached.getdelayed.php" class="methodname" rel="rdfs-seeAlso">Memcached::getDelayed()</a> - Lee varios elementos</span></li>
   </ul>
  </p>
 </div>


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