<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.mhash">
  <title>Funciones Hash</title>
  <titleabbrev>mhash</titleabbrev>
  
  <partintro>
   <para>
    Estas funciones han sido realizadas para trabajar con <ulink url="&url.mhash;">mhash</ulink>.</para>  

   <para>
    Esta es una interfaz con al libreria mhash. mhash soporta una amplia variedad de algoritmos
    hash como MD5, SHA1, GOST, y muchos otros.</para>

   <para>
    Para usarla, hay que descargar la distribucion desde <ulink url="&url.mhash;"> su sitio web</ulink>  y seguir 
    las intrucciones de instalacion. Se necesita compilar PHP con el parametr <option role="configure">--with-mhash</option>
    para activar esta extension.</para>

   <para>
    mhash puede ser usado para crear checksums, message digests, y mas.</para>
   
   <para>
    <example>
     <title>Generar una clave SHA1 e imprimirla en hexadecimal</title>
     <programlisting role="php">
&lt;?php
$input = "Let us meet at 9 o' clock at the secret place.";
$hash = mhash(MHASH_SHA1, $input);

print "The hash is ".bin2hex($hash)."\n";

?&gt;
     </programlisting>
    </example>

    Esto generara:

    <programlisting>
The hash is d3b85d710d8f6e4e5efd4d5e67d041f9cecedafe
    </programlisting>
	  
    PAra una lista complera de hash soportados, refierase a la documentacion de
    mhash. La regla general es que se puede acceder a los algoritmos hash desde PHP
    con MHASH_HASHNAME. Como ejemplo, para acceder a HAVAL se debe usar la constante
    de PHP llamada MHASH_HAVAL.</para>

   <para>
    Aqui hay una lista de hashes que esta actualmente soportada por mhash. Si un hash
    no esta en dicha lista pero aparece como soportado por mhash, entonces se asume con 
    plena seguridad que esta documentacion esta desfasada.

    <itemizedlist>

     <listitem><simpara>
      MHASH_MD5</simpara></listitem>
     <listitem><simpara>
      MHASH_SHA1</simpara></listitem>
     <listitem><simpara>
      MHASH_HAVAL</simpara></listitem>
     <listitem><simpara>
      MHASH_RIPEMD160</simpara></listitem>
     <listitem><simpara>
      MHASH_RIPEMD128</simpara></listitem>
     <listitem><simpara>
      MHASH_SNEFRU</simpara></listitem>
     <listitem><simpara>
      MHASH_TIGER</simpara></listitem>
     <listitem><simpara>
      MHASH_GOST</simpara></listitem>
     <listitem><simpara>
      MHASH_CRC32</simpara></listitem>
     <listitem><simpara>
      MHASH_CRC32B</simpara></listitem>

    </itemizedlist></para>

  </partintro>
  
  <refentry id="function.mhash-get-hash-name">
   <refnamediv>
    <refname>mhash_get_hash_name</refname>
    <refpurpose>Conseguir el nombre de un hash especifico</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcion</title>
     <methodsynopsis>
     <type>string</type><methodname>mhash_get_hash_name</methodname>
     <methodparam><type>int</type><parameter>hash</parameter></methodparam>
     </methodsynopsis>
	
    <para>
     <function>mhash_get_hash_name</function> es usado para conseguir el nombre de
     el hash determinado.</para>

    <para>
     <function>mhash_get_hash_name</function> toma el id del hash como un argumento
     y devuelve el nombre de el hash o &false;, si el hash no existe.</para>
     
    <para>
     <example>
      <title>mhash_get_hash_name example</title>
      <programlisting>
&lt;?php
$hash = MHASH_MD5;

print mhash_get_hash_name($hash);
?&gt;
      </programlisting>
     </example>
	 
     El ejemplo anterior mostrara:
     <programlisting>
MD5
     </programlisting></para>
	
   </refsect1>
  </refentry>
  
  <refentry id="function.mhash-get-block-size">
   <refnamediv>
    <refname>mhash_get_block_size</refname>
    <refpurpose>Conseguir el tama&ntilde;o de bloque de el hash especificado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcion</title>
     <methodsynopsis>
     <type>int</type><methodname>mhash_get_block_size</methodname>
     <methodparam><type>int</type><parameter>hash</parameter></methodparam>
     </methodsynopsis>
	
    <para>
     <function>mhash_get_block_size</function> es usado para obtener el tama&ntilde;o de un
     bloque de el <parameter>hash</parameter> determinado.</para>

    <para>
     <function>mhash_get_block_size</function> toma un argumento, el
     <parameter>hash</parameter> y devuelve el tama&ntilde;o en bytes o &false;, si
     el <parameter>hash</parameter> no existe.</para>

   </refsect1>
  </refentry>
  
  <refentry id="function.mhash-count">
   <refnamediv>
    <refname>mhash_count</refname>
    <refpurpose>Obtener el valor mayor del id hash disponible</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcion</title>
     <methodsynopsis>
     <type>int</type><methodname>mhash_count</methodname>
     <void/>
     </methodsynopsis>
	
    <para>
     <function>mhash_count</function> devuelve el valor mas alto id hash disponible.
     Los hash estan numerados desde 0 hasta este valor.</para>

    <para>
     <example>
      <title>Recorriendo todos los hash</title>
      <programlisting>
&lt;?php

$nr = mhash_count();

for($i = 0; $i &lt;= $nr; $i++) {
    echo sprintf("The blocksize of %s is %d\n", 
            mhash_get_hash_name($i),
            mhash_get_block_size($i));
}
?&gt;
      </programlisting>
     </example></para>

   </refsect1>
  </refentry>
    
  <refentry id="function.mhash">
   <refnamediv>
    <refname>mhash</refname>
    <refpurpose>Calcular el hash</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcion</title>
     <methodsynopsis>
     <type>string</type><methodname>mhash</methodname>
     <methodparam><type>int</type><parameter>hash</parameter></methodparam>
     <methodparam><type>string</type><parameter>data</parameter></methodparam>
     </methodsynopsis>
	
    <para>
     <function>mhash</function> aplica una funcion hash especificada por
     <parameter>hash</parameter> a <parameter>data</parameter> y
     devuelve el valor hash resultante (tambien llamdo digest).</para>
    
   </refsect1>
  </refentry>

 </reference> 

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->