<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.msql">
  <title>funciones mSQL</title>
  <titleabbrev>mSQL</titleabbrev>

  <refentry id="function.msql">
   <refnamediv>
    <refname>msql</refname>
    <refpurpose>ejecuta una consulta mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql</methodname>
     <methodparam><type>string</type><parameter>database</parameter></methodparam>
     <methodparam><type>string</type><parameter>query</parameter></methodparam>
     <methodparam><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Devuelve un identificador de consulta mSQL positivo en el resultado
     de la consulta, o &false; en caso de error.</para>       
    <para>
     <function>msql</function> selecciona una base de datos y ejecuta una
     consulta en ella. Si no se especifica el identificador de conexi&oacute;n (link
     identifier), la funci&oacute;n intentar&aacute; encontrar una conexi&oacute;n abierta en el  
     servidor mSQL y en el caso de que no se encontrase intentar&aacute; crear uno
     como si se llamase a <function>msql_connect</function> sin par&aacute;metros
     (v&eacute;ase <function>msql_connect</function>).</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-affected-rows">
   <refnamediv>
    <refname>msql_affected_rows</refname> 
    <refpurpose>devuelve el n&uacute;mero de filas involucradas</refpurpose>
    </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_affected_rows</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve el n&uacute;mero de filas involucradas ("tocadas") por una consulta
     espec&iacute;fica (i.e. el n&uacute;mero de filas devueltas por una SELECT, el n&uacute;mero
     de filas modificadas por una actualizaci&oacute;n (update), o el n&uacute;mero de filas
     suprimidas por una eliminaci&oacute;n (delete)).</para>
    <para>
     V&eacute;ase tambi&eacute;n:
     <function>msql_query</function></para>

   </refsect1>
  </refentry>
 
  <refentry id="function.msql-close">
   <refnamediv>
    <refname>msql_close</refname> 
    <refpurpose>cierra una conexi&oacute;n mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_close</methodname>
     <methodparam><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve &true; si tiene &eacute;xito, &false; en caso de error.</para>
    <para>
     msql_close() cierra la conexi&oacute;n con una base de datos mSQL que
     est&aacute; asociada con el identificador de conexi&oacute;n (link identifier)
     especificado. Si no se especifica el identificador de conexi&oacute;n, se 
     asume la &uacute;ltima conexi&oacute;n abierta.</para>
    <para>
     Advierta que &eacute;sto no es necesario habitualmente, las conexiones 
     abiertas no-persistentes son cerradas autom&aacute;ticamente a la conclusi&oacute;n
     de la ejecuci&oacute;n del script.</para>
    <para>
     msql_close() no cerrar&aacute; las conexiones permanentes creadas por
     <function>msql_pconnect</function>.</para>
    <para>
     V&eacute;ase tambi&eacute;n:
     <function>msql_connect</function> y
     <function>msql_pconnect</function>.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-connect">
   <refnamediv>
    <refname>msql_connect</refname>
    <refpurpose>abre una conexi&oacute;n mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_connect</methodname>
     <methodparam><type>string</type><parameter>hostname</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve un identificador de conexi&oacute;n mSQL positivo si tiene
     &eacute;xito, o &false; en caso de error.</para>
    <para>
     msql_connect() establece una conexi&oacute;n con un servidor mSQL. El 
     argumento hostname es opcional, y en caso de que falte, se asume
     localhost.</para>
    <para>
     En caso de que se haga una segunda llamada a msql_connect() con
     los mismos argumentos, no se establece una nueva conexi&oacute;n, en lugar
     de eso, se devuelve el identificador de conexi&oacute;n ya abierto.</para>
    <para>
     La conexi&oacute;n con el servidor se cerrar&aacute; tan pronto como la ejecuci&oacute;n
     del script finalice, a menos que sea cerrada antes expl&iacute;citamente por
     una llamada a <function>msql_close</function>.</para>
    <para>
     V&eacute;ase tambi&eacute;n: 
     <function>msql_pconnect</function>,
     <function>msql_close</function>.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-create-db">
   <refnamediv>
    <refname>msql_create_db</refname>
    <refpurpose>crea una base de datos mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_create_db</methodname>
     <methodparam><type>string</type><parameter>database name</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>link_identifier  
                   </parameter></methodparam>
     </methodsynopsis>
    <para>
     msql_create_db() intenta crear una base de datos nueva en el 
     servidor asociado con el identificador de conexi&oacute;n (link identifier) 
     especificado.</para>
    <para> 
     V&eacute;ase tambi&eacute;n: 
     <function>msql_drop_db</function>.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-createdb">
   <refnamediv>
    <refname>msql_createdb</refname>
    <refpurpose>crea una base de datos mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_createdb</methodname>
     <methodparam><type>string</type><parameter>database name</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>link_identifier  
                   </parameter></methodparam>
     </methodsynopsis>
    <para>
     Id&eacute;ntica a <function>msql_create_db</function>.</para>

   </refsect1>
  </refentry>


  <refentry id="function.msql-data-seek">
   <refnamediv>
    <refname>msql_data_seek</refname>
    <refpurpose>desplaza el puntero interno de fila</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_data_seek</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam><type>int</type><parameter>row_number</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve &true; si tiene &eacute;xito, &false; en caso de fallo.</para>
    <para>
     msql_data_seek() desplaza el puntero interno de fila del resultado
     mSQL asociado con el identificador de consulta (query identifier)
     especificado para que apunte al n&uacute;mero de fila (row number) 
     proporcionado. La llamada posterior a <function>msql_fetch_row</function> 
     devolver&aacute; esa fila.</para>
    <para> 
     V&eacute;ase tambi&eacute;n:
     <function>msql_fetch_row</function>.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-dbname">
   <refnamediv>
    <refname>msql_dbname</refname>
    <refpurpose>obtiene el nombre de la base de datos mSQL actual</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>string</type><methodname>msql_dbname</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para> 
     <function>msql_dbname</function> devuelve el nombre de base de datos
     almacenado en la posici&oacute;n <parameter>i</parameter> del puntero devuelto 
     desde la funci&oacute;n <function>msql_listdbs</function>. La funci&oacute;n
     <function>msql_numrows</function> puede utilizarse para determinar cuantos
     nombres de base de datos hay disponibles.</para>
   </refsect1>
  </refentry>

  <refentry id="function.msql-drop-db">
   <refnamediv>
    <refname>msql_drop_db</refname>
    <refpurpose>elimina (suprime) una base de datos mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_drop_db</methodname>
     <methodparam><type>string</type><parameter>database_name</parameter></methodparam>
     <methodparam><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve &true; si tiene &eacute;xito, &false; en caso de fallo.</para>
    <para>
     msql_drop_db() intenta eliminar (suprimir) una base de datos completa
     del servidor asociado con el identificador de conexi&oacute;n (link identifier)
     especificado.</para>
    <para>
     V&eacute;ase tambi&eacute;n: 
     <function>msql_create_db</function>.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-dropdb">
   <refnamediv>
    <refname>msql_dropdb</refname>
    <refpurpose>elimina (suprime) una base de datos mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
    <para>V&eacute;ase <function>msql_drop_db</function>.</para>
   </refsect1>
  </refentry>

  <refentry id="function.msql-error">
   <refnamediv>
    <refname>msql_error</refname>
    <refpurpose>devuelve el mensaje de error de la &uacute;ltima llamada msql</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>string</type><methodname>msql_error</methodname>
     <methodparam><type></type><parameter/></methodparam>
     </methodsynopsis>
    <para>
     Los errores que devuelve el servidor de base de datos mSQL no dan
     mucha informaci&oacute;n sobre el problema. Por este motivo, utilice estas 
     funciones para recuperar la cadena de car&aacute;cteres del error.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-fetch-array">
   <refnamediv>
    <refname>msql_fetch_array</refname>
    <refpurpose>recupera una fila como un array</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_fetch_array</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve un array que se corresponde con la fila recuperada, o &false;
     si no hay m&aacute;s filas.</para>
    <para>
     <function>msql_fetch_array</function> es una versi&oacute;n ampliada de 
     <function>msql_fetch_row</function>. Adem&aacute;s de almacenar los datos
     en los &iacute;ndices num&eacute;ricos del array resultado, tambi&eacute;n almacena los 
     datos en &iacute;ndices asociativos, utilizando los nombres de los campos 
     como claves.</para>
    <para>
     El segundo argumento opcional <parameter>result_type</parameter>
     en <function>msql_fetch_array</function> es una constante y puede
     tomar los valores siguientes: MSQL_ASSOC, MSQL_NUM, y MYSQL_BOTH.</para>
    <para>
     Sea precavido si est&aacute; recuperando resultados de una consulta que
     puede devolver un registro que contiene un &uacute;nico campo que tiene un 
     valor de 0 (o una cadena de car&aacute;cteres vac&iacute;a, o &null;).</para>  
    <para> 
     Un aspecto importante a tener en cuenta es que el uso de 
     <function>msql_fetch_array</function> NO es significativamente m&aacute;s lento
     que el uso de <function>msql_fetch_row</function>, mientras que proporciona
     un valor a&ntilde;adido significativo.</para>  
    <para> 
     Para detalles adicionales, v&eacute;ase tambi&eacute;n 
     <function>msql_fetch_row</function></para>
   </refsect1>
  </refentry>

  <refentry id="function.msql-fetch-field">
   <refnamediv>
    <refname>msql_fetch_field</refname>
    <refpurpose>obtiene informaci&oacute;n de campo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>object</type><methodname>msql_fetch_field</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve un objeto que contiene la informaci&oacute;n del campo</para>
    <para>  
     msql_fetch_field() puede utilizarse para obtener informaci&oacute;n sobre
     campos del resultado de una consulta. Si no se especifica el 
     desplazamiento del campo, se recupera el campo siguiente que no haya
     sido a&uacute;n recuperado por msql_fetch_field().</para>
    <para>  
     Las propiedades del objeto son:
     <itemizedlist>
      <listitem><simpara>name - nombre de la columna</simpara></listitem>
      <listitem><simpara>table - nombre de la tabla a la que pertenece la
      columna</simpara></listitem>
      <listitem><simpara>not_null - 1 si la columna no puede ser nula
	</simpara></listitem>
      <listitem><simpara>primary_key - 1 si la columna es una clave primaria
      </simpara></listitem>
      <listitem><simpara>unique - 1 si la columna es una clave &uacute;nica
      </simpara></listitem>
      <listitem><simpara>type - tipo de la columna
      </simpara></listitem>
     </itemizedlist></para>
    <para>  
     V&eacute;ase tambi&eacute;n
     <function>msql_field_seek</function>.</para>

   </refsect1>
  </refentry>


  <refentry id="function.msql-fetch-object">
   <refnamediv>
    <refname>msql_fetch_object</refname>
    <refpurpose>recupera una fila como un objeto</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_fetch_object</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve un objeto con las propiedades que corresponden a la fila
     recuperada, o &false; si no hay m&aacute;s filas.</para>  
    <para>
     <function>msql_fetch_object</function> es similar a
     <function>msql_fetch_array</function>, con una diferencia -
     se devuelve un objeto en vez de un array. Indirectamente esto
     significa que s&oacute;lo tiene acceso a los datos por los nombres de
     los campos, y no por sus desplazamientos (los n&uacute;meros son nombres
     de propiedad no v&aacute;lidos).</para>  
    <para>
     El segundo par&aacute;metro opcional <parameter>result_type</parameter>
     en <function>msql_fetch_array</function> es una constante y puede
     tomar los valores siguientes: MSQL_ASSOC, MSQL_NUM, y MSQL_BOTH.</para>
    <para>
     Resumiendo, la funci&oacute;n es ind&eacute;ntica a 
     <function>msql_fetch_array</function>, y casi tan r&aacute;pida como
     <function>msql_fetch_row</function> (la diferencia es insignificante).</para>  
    <para> V&eacute;ase tambi&eacute;n:
     <function>msql_fetch_array</function> y
     <function>msql_fetch_row</function>.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-fetch-row">
   <refnamediv>
    <refname>msql_fetch_row</refname>
    <refpurpose>obtiene una fila como un array enumerado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>array</type><methodname>msql_fetch_row</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve un array que se corresponde con la fila recuperada, o &false;
     si no hay m&aacute;s filas.</para>
    <para>
     msql_fetch_row() recupera una fila de datos del resultado asociado con 
     el identificador de consulta (query identifier) especificado. La fila
     se devuelve en un array. Cada columna devuelta se almacena en un 
     desplazamiento del array, comenzando en el desplazamiento 0.</para>  
    <para> 
     Una llamada posterior a msql_fetch_row() dever&iacute;a devolver la fila siguiente
     del conjunto resultado, o &false; si no hay m&aacute;s filas.</para>
    <para> V&eacute;ase tambi&eacute;n:
     <function>msql_fetch_array</function>,
     <function>msql_fetch_object</function>,
     <function>msql_data_seek</function>, y
     <function>msql_result</function>.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-fieldname">
   <refnamediv>
    <refname>msql_fieldname</refname>
    <refpurpose>obtiene el nombre del campo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>string</type><methodname>msql_fieldname</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam><type>int</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>
     msql_fieldname() devuelve el nombre del campo especificado.
     <parameter>query_identifier</parameter> es el identificador de consulta,
     y <parameter>field</parameter> es el &iacute;ndice del campo.
     <literal>msql_fieldname($result, 2);</literal> devolver&aacute; el nombre del
     segundo campo del resultado asociado con el identificador result.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-field-seek">
   <refnamediv>
    <refname>msql_field_seek</refname>
    <refpurpose>establece el desplazamiento del campo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_field_seek</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
     </methodsynopsis>
    <para>
     Se posiciona en el desplazamiento de campo (field offset) especificado. 
     Si la siguiente llamada a <function>msql_fetch_field</function> 
     no incluye un desplazamiento de campo, este campo ser&aacute; el que se devuelva.</para>
    <para>     
     V&eacute;ase tambi&eacute;n:
     <function>msql_fetch_field</function>.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-fieldtable">
   <refnamediv>
    <refname>msql_fieldtable</refname>
    <refpurpose>obtiene el nombre de la tabla de un campo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_fieldtable</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam><type>int</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve el nombre de la tabla desde la que se ha recuperado el 
     campo (<parameter>field</parameter>)</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-fieldtype">
   <refnamediv>
    <refname>msql_fieldtype</refname>
    <refpurpose>obtiene el tipo del campo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>string</type><methodname>msql_fieldtype</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para>
     msql_fieldtype() es similar a la funci&oacute;n <function>msql_fieldname</function>. 
     Los argumentos son id&eacute;nticos, pero se devuelve el tipo del campo. 
     Este ser&aacute; "int", "char" o "real".</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-fieldflags">
   <refnamediv>
    <refname>msql_fieldflags</refname>
    <refpurpose>obtiene los flags del campo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>string</type><methodname>msql_fieldflags</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para>
     msql_fieldflags() obtiene los flags del campo (field) especificado. 
     Actualmente pueden ser, "not &null;", "primary key", una combinaci&oacute;n
     de ambos, o "" (cadena vac&iacute;a).</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-fieldlen">
   <refnamediv>
    <refname>msql_fieldlen</refname>
    <refpurpose>obtiene la longitud del campo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_fieldlen</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para>
     msql_fieldlen() devuelve la longitud del campo especificado.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-free-result">
   <refnamediv>
    <refname>msql_free_result</refname>
    <refpurpose>libera la memoria del resultado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_free_result</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_free_result</function> libera la memoria asociada con
     <parameter>query_identifier</parameter>. Cuando PHP completa una 
     petici&oacute;n, esta memoria es liberada autom&aacute;ticamente, por este motivo
     solo es necesario llamar a esta funci&oacute;n cuando se desea estar
     seguro de que no se utiliza demasiada memoria mientras se est&aacute; 
     ejecutando el script.</para>

   </refsect1>
  </refentry>


  <refentry id="function.msql-freeresult">
   <refnamediv>
    <refname>msql_freeresult</refname>
    <refpurpose>libera la memoria del resultado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
    <para>V&eacute;ase <function>msql_free_result</function></para>
   </refsect1>
  </refentry>


  <refentry id="function.msql-list-fields">
   <refnamediv>
    <refname>msql_list_fields</refname>
    <refpurpose>lista los campos del resultado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_list_fields</methodname>
     <methodparam><type>string</type><parameter>database</parameter></methodparam>
     <methodparam><type>string</type><parameter>tablename</parameter></methodparam>
     </methodsynopsis>
    <para>
     msql_list_fields() recupera informaci&oacute;n sobre el nombre de tabla
     (tablename) dado. Los argumentos son el nombre de la base de datos
     (database name) y el nombre de la tabla (table name). Se devuelve un
     puntero al resultado que puede utilizarse con
     <function>msql_fieldflags</function>,
     <function>msql_fieldlen</function>,
     <function>msql_fieldname</function>, y
     <function>msql_fieldtype</function>.  
     Un indetificador de consulta (query identifier) es un entero positivo.
     La funci&oacute;n devuelve <literal>-1</literal> si ocurre un error. En 
     <literal>$phperrmsg</literal> se almacena una cadena de car&aacute;cteres 
     describiendo el error, y a menos que la funci&oacute;n sea llamada como
     <literal>@msql_list_fields()</literal> esta cadena de error puede ser
     impresa.</para>
    <para>
     V&eacute;ase tambi&eacute;n <function>msql_error</function>.</para>

   </refsect1>
  </refentry>


  <refentry id="function.msql-listfields">
   <refnamediv>
    <refname>msql_listfields</refname>
    <refpurpose>lista los campos del resultado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
    <para>V&eacute;ase <function>msql_list_fields</function>.</para>
   </refsect1>
  </refentry>


  <refentry id="function.msql-list-dbs">
   <refnamediv>
    <refname>msql_list_dbs</refname>
    <refpurpose>lista las bases de datos mSQL en el servidor</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_list_dbs</methodname>
     <void/>
     </methodsynopsis>
    <para>
     <function>msql_list_dbs</function> devolver&aacute; un puntero al resultado que
     contiene las bases de datos disponibles desde el daemon msql en uso.
     Utilice la funci&oacute;n <function>msql_dbname</function> para recorrer este
     puntero.</para>

   </refsect1>
  </refentry>


  <refentry id="function.msql-listdbs">
   <refnamediv>
    <refname>msql_listdbs</refname>
    <refpurpose>lista las bases de datos mSQL en el servidor</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
    <para>V&eacute;ase <function>msql_list_dbs</function>.</para>
   </refsect1>
  </refentry>


  <refentry id="function.msql-list-tables">
   <refnamediv>
    <refname>msql_list_tables</refname>
    <refpurpose>lista las tablas de una base de datos mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_list_tables</methodname>
     <methodparam><type>string</type><parameter>database</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_list_tables</function> toma un nombre de base de datos
     y devuelve un puntero similar al de la funci&oacute;n <function>msql</function>
     La funci&oacute;n <function>msql_tablename</function> deber&iacute;a utilizarse para
     obtener los nombres reales de las tablas del puntero devuelto.</para>

   </refsect1>
  </refentry>


  <refentry id="function.msql-listtables">
   <refnamediv>
    <refname>msql_listtables</refname>
    <refpurpose>lista las tablas de una base de datos mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
    <para>V&eacute;ase <function>msql_list_tables</function>.</para>
   </refsect1>
  </refentry>


  <refentry id="function.msql-num-fields">
   <refnamediv>
    <refname>msql_num_fields</refname>
    <refpurpose>obtiene el n&uacute;mero de campos de un resultado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_num_fields</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     msql_num_fields() devuelve el n&uacute;mero de campos de un conjunto resultado.</para>
    <para>
     V&eacute;ase tambi&eacute;n:  
     <function>msql</function>,
     <function>msql_query</function>,
     <function>msql_fetch_field</function>, y
     <function>msql_num_rows</function>.</para>

   </refsect1>
  </refentry>


  <refentry id="function.msql-num-rows">
   <refnamediv>
    <refname>msql_num_rows</refname>
    <refpurpose>obtiene el n&uacute;mero de filas de un resultado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_num_rows</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     msql_num_rows() devuelve el n&uacute;mero de filas de un conjunto resultado.</para>
    <para>
     V&eacute;ase tambi&eacute;n:
     <function>msql</function>,
     <function>msql_query</function>, y
     <function>msql_fetch_row</function>.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-numfields">
   <refnamediv>
    <refname>msql_numfields</refname>
    <refpurpose>obtiene el n&uacute;mero de campos de un resultado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_numfields</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>  
     Id&eacute;ntica a <function>msql_num_fields</function>.</para>

   </refsect1>
  </refentry>


  <refentry id="function.msql-numrows">
   <refnamediv>
    <refname>msql_numrows</refname>
    <refpurpose>obtiene el n&uacute;mero de filas en el resultado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_numrows</methodname>
     <void/>
     </methodsynopsis>
    <para>  
     Id&eacute;ntica a <function>msql_num_rows</function>.</para>

   </refsect1>
  </refentry>


  <refentry id="function.msql-pconnect">
   <refnamediv>
    <refname>msql_pconnect</refname>
    <refpurpose>abre una conexi&oacute;n mSQL persistente</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_pconnect</methodname>
     <methodparam><type>string</type><parameter>hostname</parameter></methodparam>
     </methodsynopsis>
    <para>
     En caso de &eacute;xito devuelve un identificador de conexi&oacute;n mSQL persistente
     positivo, o &false; en caso de error.</para>
    <para> 
     msql_pconnect() se comporta de forma similar a 
     <function>msql_connect</function> con dos diferencias importantes.</para>
    <para> 
     Primero, cuando se conecta, la funci&oacute;n debe intentar primero localizar una
     conexi&oacute;n (persistente) que ya est&eacute; abierta en el mismo host.
     Si se encuentra uno, se devuelve un identificador para el mismo en vez de
     abrir una conexi&oacute;n nueva.</para>
    <para> 
     Segundo, la conexi&oacute;n con el servidor SQL no se cerrar&aacute; cuando la ejecuci&oacute;n del
     script finalice. Al contrario, la conexi&oacute;n permanecer&aacute; abierta para un uso
     futuro (<function>msql_close</function> no cerrar&aacute; las conexiones abiertas
     por msql_pconnect()).</para>
    <para> 
     Este tipo de conexiones son por ello denominadas 'persistentes'.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-query">
   <refnamediv>
    <refname>msql_query</refname>
    <refpurpose>env&iacute;a una consulta mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_query</methodname>
     <methodparam><type>string</type><parameter>query</parameter></methodparam>
     <methodparam><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     msql_query() env&iacute;a una consulta a la base de datos activa actual
     en el servidor que est&aacute; asociada con el identificador de conexi&oacute;n
     (link identifier) especificado.  Si no se especifica el identificador 
     de conexi&oacute;n, se asume la &uacute;ltima conexi&oacute;n abierta. Si no hay ninguna
     conexi&oacute;n abierta, la funci&oacute;n intenta establecer una conexi&oacute;n como si
     se hubiera llamado a <function>msql_connect</function>, y la
     utiliza.</para>
    <para>
     En caso de &eacute;xito devuelve un identificador de consulta mSQL positivo, 
     o &false; en caso de error.</para>
    <para>
     V&eacute;ase tambi&eacute;n:  
     <function>msql</function>, 
     <function>msql_select_db</function>, y
     <function>msql_connect</function>.</para>
   </refsect1>
  </refentry>


  <refentry id="function.msql-regcase">
   <refnamediv>
    <refname>msql_regcase</refname>
    <refpurpose>construye una expresi&oacute;n regular para una b&uacute;squeda 
    que no distinga may&uacute;sculas/min&uacute;sculas</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
    <para>V&eacute;ase <function>sql_regcase</function>.</para>
   </refsect1>
  </refentry>


  <refentry id="function.msql-result">
   <refnamediv>
    <refname>msql_result</refname>
    <refpurpose>obtiene datos resultado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_result</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam><type>int</type><parameter>i</parameter></methodparam>
     <methodparam><type>mixed</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve el contenido de la celda en la fila y desplazamiento 
     del conjunto resultado mSQL especificado.</para>  
    <para> 
     msql_result() devuelve el contenido de una celda de un conjunto 
     resultado mSQL. El argumento campo (field) puede ser el desplazamiento
     del campo, el nombre del campo, o el nombre de la tabla punto nombre
     del campo (nombretabla.nombrecampo). Si el nombre de la columna 
     tiene un alias ('select foo as bar from...'), utilice el alias en vez
     del nombre de la columna.</para>
    <para> 
     Cuando se trabaja con conjuntos de resultados grandes, deber&iacute;a considerar
     el uso de las funciones que recuperen filas completas (especificadas m&aacute;s
     abajo). Como estas funciones recuperan el contenido de varias celdas
     en una &uacute;nica llamada de funci&oacute;n, son MUCHO m&aacute;s r&aacute;pidas que msql_result().
     Advierta tambi&eacute;n que especificar un desplazamiento num&eacute;rico para el 
     argumento campo (field) es mucho m&aacute;s r&aacute;pido que especificar un 
     argumento nombrecampo o nombretabla.nombrecampo.</para>
    <para> 
     Alternativas de alto-rendimiento recomendadas:
     <function>msql_fetch_row</function>,
     <function>msql_fetch_array</function>, y
     <function>msql_fetch_object</function>.</para>

   </refsect1>
  </refentry>

  <refentry id="function.msql-select-db">
   <refnamediv>
    <refname>msql_select_db</refname>
    <refpurpose>selecciona una base de datos mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_select_db</methodname>
     <methodparam><type>string</type><parameter>database_name</parameter></methodparam>
     <methodparam><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve &true; si tiene &eacute;xito, &false; en caso contrario.</para>
    <para>  
     msql_select_db() establece la base de datos activa actual en el servidor
     que est&aacute; asociada con el identificador de conexi&oacute;n (link identifier) 
     suministrado. Si no se especifica el identificador de conexi&oacute;n, se
     asumne la &uacute;ltima conexi&oacute;n abierta. Si no hay ninguna conexi&oacute;n abierta
     la funci&oacute;n intentar&aacute; establecer una conexi&oacute;n como si se hubiera llamado
     a sql_connect(), y la utiliza.</para>
    <para> 
     Cada llamada posterior a <function>msql_query</function> se har&aacute;
     en la base de datos activa.</para>
    <para>
     V&eacute;ase tambi&eacute;n:  
     <function>msql_connect</function>, 
     <function>msql_pconnect</function>, y
     <function>msql_query</function>.</para>

   </refsect1>
  </refentry>


  <refentry id="function.msql-selectdb">
   <refnamediv>
    <refname>msql_selectdb</refname>
    <refpurpose>selecciona una base de datos mSQL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
    <para>V&eacute;ase <function>msql_select_db</function>.</para>
   </refsect1>
  </refentry>


  <refentry id="function.msql-tablename">
   <refnamediv>
    <refname>msql_tablename</refname>
    <refpurpose>obtiene el nombre de la tabla de un campo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>string</type><methodname>msql_tablename</methodname>
     <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     <methodparam><type>int</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>    
     msql_tablename() toma un puntero resultado devuelto por la funci&oacute;n
     <function>msql_list_tables</function> como un &iacute;ndice entero y devuelve
     el nombre de una tabla. La funci&oacute;n <function>msql_numrows</function> puede
     utilizarse para determinar el n&uacute;mero de tablas del puntero resultado.

    <example>
     <title>msql_tablename() example</title>
      <programlisting role="php">
&lt;?php 
msql_connect ("localhost");
$result = msql_list_tables("wisconsin");
$i = 0;
while ($i &lt; msql_numrows($result)) {
    $tb_names[$i] = msql_tablename($result, $i);
    echo $tb_names[$i] . "&lt;BR>";
    $i++; 
}
?>
</programlisting>

    </example></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:
-->