# php_manual

id: db2_cursor_type
type: function
doc:
<comment>Description:</comment>
  Determinar el tipo de cursor utilizado en una consulta
    
  
  Devuelve el tipo de cursor utilizado en una consulta. Se puede utilizar para determinar  si se
  está trabajando con un curso de tipo "forward-only" (sin recorrido) o "scrollable" (con
  recorrido).

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>  Un recurso de sentencia válido.

<comment>Return:</comment>
  <info>int</info>  Devuelve <return>DB2_FORWARD_ONLY</return> si la consulta utiliza  un cursor de tipo "forward-only" (sin
       recorrido) o <return>DB2_SCROLLABLE</return> si  utiliza un cursor de tipo "scrollable" (con recorrido).

<comment>See Also:</comment>
   * <strong>db2_prepare()</strong>


id: db2_escape_string
type: function
doc:
<comment>Description:</comment>
  Escapar ciertos caracteres especiales
    
  
  Agrega un caracter de escape (barra invertida) antes de cada caracter especial de la cadena
  enviada como parámetro.

<comment>Param:</comment>
  <info>string</info>  <strong>$string_literal</strong>  La cadena que contiene los caracteres especiales y que necesita ser
                           escapada.  Los carecteres especiales a los que se les agrega el caracter
                           de escape son <return>\x00</return>,  <return>\n</return>, <return>\r</return>, <return>\</return>,  <return>'</return>, <return>"</return> y <return>\x1a</return>.

<comment>Return:</comment>
  <info>string</info>  Devuelve <strong>$string_literal</strong> con todos los caracteres especiales ya escapados.

<comment>See Also:</comment>
   * <strong>db2_prepare()</strong>


id: db2_exec
type: function
doc:
<comment>Description:</comment>
  Ejecutar directamente una sentencia SQL
    
  
  Ejecuta directamente una sentencia SQL.
  
  Si se planea utilizar variables de PHP en una sentencia SQL, hay que considerar  que este es uno
  de los risgos de seguridad más comunes. Hay que considerar el uso de  <strong>db2_prepare()</strong> para agregar
  marcadores de parámetros a los valores de entrada  que serán utilizados en una sentencia an SQL.
  Después se puede llamar a <strong>db2_execute()</strong> para pasar los valores de entrada ya marcados y evitar
  ataques por inyección SQL.
  
  Si se planea ejecutar repetidamente la misma sentencia SQL pero con diferentes  parámetros, hay
  que considerar el uso de <strong>db2_prepare()</strong> y  <strong>db2_execute()</strong> para habilitar en el servidor la
  reutilización del plan  de acceso e incrementar la eficiencia de los accesos a la base de datos.

<comment>Param:</comment>
  <info>resource</info>  <strong>$connection</strong>  Una conexión válida a la base de datos devuelta por  <strong>db2_connect()</strong> o
                         <strong>db2_pconnect()</strong>.
  <info>string</info>    <strong>$statement</strong>   Una sentencia SQL. La sentencia no puede contener ningún marcador de
                         parámetros.
  <info>array</info>     <strong>$options</strong>     Un arreglo asociativo que contiene opciones para la sentencia. Se puede
                         utilizar este  parámetro para solicitar un cursor de tipo SCROLLABLE en una
                         base de datos que soporte  esta funcionalidad.
                         
                         Para una descripción válida de las opciones para la sentencia está
                         <strong>db2_set_option()</strong>.

<comment>Return:</comment>
  <info>resource</info>  Devuelve un recurso de sentencia si la sentencia SQL fue ejecutada correctamente, o
            <info>false</info> si hubo un error al ejecutar la sentencia SQL.

<comment>See Also:</comment>
   * <strong>db2_execute()</strong>
   * <strong>db2_prepare()</strong>


id: db2_execute
type: function
doc:
<comment>Description:</comment>
  Ejecutar una sentencia SQL preparada
    
  
  <strong>db2_execute()</strong> ejecuta una sentencia SQL que ha sido  preparada por <strong>db2_prepare()</strong>.
  
  Si la sentencia SQL devuelve un bloque de resultados, por ejemplo, una sentencia SELECT o una
  llamada  a un procedimiento que devuelve bloques de resultados, se puede extraer una fila como
  arreglo a partir del recurso <return>stmt</return>  usando <strong>db2_fetch_assoc()</strong>, <strong>db2_fetch_both()</strong>, o
  <strong>db2_fetch_array()</strong>. Alternativamente, se puede usar  <strong>db2_fetch_row()</strong> para mover el apuntador del
  resultado a la  siguiente fila y extraer una columna de esa fila con  <strong>db2_result()</strong>.
  
  En la función <strong>db2_prepare()</strong> se discuten brevementen las ventajas de  utilizar <strong>db2_prepare()</strong> y
  <strong>db2_execute()</strong> en lugar de <strong>db2_exec()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>        La sentencia preparada devuelta por <strong>db2_prepare()</strong>.
  <info>array</info>     <strong>$parameters</strong>  Un arreglo de parámetros de entrada que reemplazarán a los marcadores
                         contenidos en  la sentencia preparada.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>db2_exec()</strong>
   * <strong>db2_fetch_array()</strong>
   * <strong>db2_fetch_assoc()</strong>
   * <strong>db2_fetch_both()</strong>
   * <strong>db2_fetch_row()</strong>
   * <strong>db2_prepare()</strong>
   * <strong>db2_result()</strong>


id: db2_fetch_array
type: function
doc:
<comment>Description:</comment>
  Devolver un arreglo, indexado por la posición de las columnas, que represanta una fila de un
  bloque de resultados
    
  
  Devuelve un arreglo, indexado por la posición de las columnas, que representa una fila en un
  bloque de resultados.  El primer índice es cero.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>        Un resurso <return>stmt</return> válido que contenga el resultado de la consulta.
  <info>int</info>       <strong>$row_number</strong>  Extrae una fila específica del bloque de resultados indexada a partir de
                         uno. Este argumento puede  provocar una advertencia en PHP si el resultado
                         utiliza un cursor de no-recorrido (sólo hacia adelante).

<comment>Return:</comment>
  <info>array</info>  Devuelve un arreglo, indexado a partir de cero de acuerdo a la posición de la columna,  que
         representa la fila solicitada en un bloque de resultados. Devuelve <info>false</info> si  no quedan más
         filas en el bloque de resultados o si la fila solicitada por  <strong>$row_number</strong> no existe en el
         bloque.

<comment>See Also:</comment>
   * <strong>db2_fetch_assoc()</strong>
   * <strong>db2_fetch_both()</strong>
   * <strong>db2_fetch_object()</strong>
   * <strong>db2_fetch_row()</strong>
   * <strong>db2_result()</strong>


id: db2_fetch_assoc
type: function
doc:
<comment>Description:</comment>
  Devolver un arreglo, indexado por el nombre de las columnas, representando una fila del bloque de
  resultados
    
  
  Devuelve un arreglo, indexado por el nombre de las columnas, representando una fila del bloque de
  resultados.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>        Un recurso <return>stmt</return> válido que contenga el bloque de resultados.
  <info>int</info>       <strong>$row_number</strong>  Solicita una fila específica, indexada a partir de uno, del bloque de
                         resultados. Este parámetro provoca una  advertencia de PHP si el bloque de
                         resultados utiliza cursor de no-recorrido (sólo hacia adelante).

<comment>Return:</comment>
  <info>array</info>  Devuelve un arreglo asociativo con los valores de las columnas indexados por  el nombre de
         las mismas, representando la fila siguiente o la fila solicitada  en el bloque de
         resultados. Devuelve <info>false</info> si no hay más filas en el resultado o si la fila solicitada por
         <strong>$row_number</strong> no existe en el bloque de resultados.

<comment>See Also:</comment>
   * <strong>db2_fetch_array()</strong>
   * <strong>db2_fetch_both()</strong>
   * <strong>db2_fetch_object()</strong>
   * <strong>db2_fetch_row()</strong>
   * <strong>db2_result()</strong>


id: db2_fetch_both
type: function
doc:
<comment>Description:</comment>
  Devolver un arreglo, indexado por el nombre y por la posición de la columna, representando una
  fila de un bloque de resultados
    
  
  Devuelve un arreglo, indexado por el nombre y por la posición de la columna, representando una
  fila de un bloque de resultados. Hay que considerar que la fila devuelta por  <strong>db2_fetch_both()</strong>
  requiere más memoria que las filas  devueltas por <strong>db2_fetch_assoc()</strong> o <strong>db2_fetch_array()</strong>, ya que
  estas últimas sólo devuelven un índice.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>        Un recurso <return>stmt</return> válido que contenga los resultados.
  <info>int</info>       <strong>$row_number</strong>  Solicita una fila específica, indexada a partir de uno, del bloque de
                         resultados. Este parámetro provoca   una advertencia de PHP si el resultado
                         utiliza cursor de no-recorrido (sólo hacia adelante).

<comment>Return:</comment>
  <info>array</info>  Devuelve un arreglo asociativo con las columnas indexadas por el nombre y también por el
         número de  columna (indexada a partir de cero). El arreglo representa la siguiente fila o
         la fila específica solicitada  del bloque de resultados. Devuelve <info>false</info> si no hay más filas
         en los resultados o si la fila  solicitada por <strong>$row_number</strong> no existe entre los resultados.

<comment>See Also:</comment>
   * <strong>db2_fetch_array()</strong>
   * <strong>db2_fetch_assoc()</strong>
   * <strong>db2_fetch_object()</strong>
   * <strong>db2_fetch_row()</strong>
   * <strong>db2_result()</strong>


id: db2_fetch_object
type: function
doc:
<comment>Description:</comment>
  Devolver un objeto con atributos que representan a las columnas de una fila extraida
    
  
  Devuelve un objeto en el que cada atributo representa una columna devuelta de una  fila extraida
  del bloque de resultados.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>        Un recurso <return>stmt</return> válido que contenga el bloque de resultados.
  <info>int</info>       <strong>$row_number</strong>  Solicita una fila específica, indexada a partir de uno, del bloque de
                         resultados. Este parámetro provoca  una advertencia de PHP si los
                         resultados utilizan cursor de no-recorrido.

<comment>Return:</comment>
  <info>object</info>  Devuelve un objeto que representa una fila del bloque de resultados. Los  atributos del
          objeto son creados a partir de los nombres de las columnas del resultado.
          
          Los servidores de base de datos como IBM DB2, Cloudscape, y Apache Derby usualmente
          convierten a  mayúsculas los nombres de las columnas por lo que esto se verá reflejado en
          los atributos del objeto.
          
          Si una sentencia SELECT a su vez llama a una función escalar para modificar el valor  de
          una columna, los servidores de base de datos devuelven el número de la columna como si
          fuera el nombre de la misma para ser usada como atributo. Si se quiere un nombre de
          columna más  descriptivo, se puede usar la clausula AS para asignar un alias a la columna
          del resultado.
          
          Devuelve <info>false</info> si no hay fila devuelta.

<comment>See Also:</comment>
   * <strong>db2_fetch_array()</strong>
   * <strong>db2_fetch_assoc()</strong>
   * <strong>db2_fetch_both()</strong>
   * <strong>db2_fetch_row()</strong>
   * <strong>db2_result()</strong>


id: db2_fetch_row
type: function
doc:
<comment>Description:</comment>
  Establecer el apuntador de los resultados hacia la siguiente fila o a la fila solicitada
    
  
  <strong>db2_fetch_row()</strong> se utiliza para iterar a través de un bloque de resultados o  para apuntar a una
  fila específica del resultado si se utiliza un cursor de recorrido.
  
  Para extraer campos individuales del resultado hay que llamar a la  función <strong>db2_result()</strong>.
  
  En lugar de llamar a <strong>db2_fetch_row()</strong> y  <strong>db2_result()</strong>, la mayoría de las aplicaciones utilizan las
  funciones  <strong>db2_fetch_assoc()</strong>, <strong>db2_fetch_both()</strong>  o <strong>db2_fetch_array()</strong> para avanzar el apuntador del
  bloque de resultados y  devolver una fila completa como arreglo.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>        Un recurso <return>stmt</return> válido.
  <info>int</info>       <strong>$row_number</strong>  Con cursores de recorrido, se puede solicitar un número de fila específica
                         del  bloque de resultados. Las filas se indexan a partir de uno.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> si la fila solicitada existe dentro de los resultados. Devuelve  <info>false</info> si la
        fila solicitada no existe entre los resultados.

<comment>See Also:</comment>
   * <strong>db2_fetch_array()</strong>
   * <strong>db2_fetch_assoc()</strong>
   * <strong>db2_fetch_both()</strong>
   * <strong>db2_fetch_object()</strong>
   * <strong>db2_result()</strong>


id: db2_field_display_size
type: function
doc:
<comment>Description:</comment>
  Devolver el número máximo de bytes requeridos para mostrar una columna
    
  
  Devuelve el número máximo de bytes requeridos para mostrar una columna de un bloque de resultados.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>    Especifica un recurso válido que contiene los resultados.
  <info>mixed</info>     <strong>$column</strong>  Especifica la columna del resultado. Puede ser tanto un número entero que
                     represente  la posición de la columna (indexada a partir de cero) como una
                     cadena con el nombre  de la columna.

<comment>Return:</comment>
  <info>int</info>  Devuelve un valor entero con el número máximo de bytes requeridos para  mostrar una columna
       específica. Si la columna no existe en el resultado,  <strong>db2_field_display_size()</strong> devuelve
       <info>false</info>.

<comment>See Also:</comment>
   * <strong>db2_field_name()</strong>
   * <strong>db2_field_num()</strong>
   * <strong>db2_field_precision()</strong>
   * <strong>db2_field_scale()</strong>
   * <strong>db2_field_type()</strong>
   * <strong>db2_field_width()</strong>


id: db2_field_name
type: function
doc:
<comment>Description:</comment>
  Devolver el nombre de la columna indicada del resultado
    
  
  Devuelve el nombre de la columna especificada del resultado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>    Especifica un recurso válido que contiene los resultados.
  <info>mixed</info>     <strong>$column</strong>  Especifica la columna en el resultado. Puede ser tanto un entero  que
                     represente la posición de la columna (indexadas a partir de cero) o una cadena
                     que contenga el nombre de la columna.

<comment>Return:</comment>
  <info>string</info>  Devuelve una cadena con el nombre de la columna especificada. Si la columna  especificada
          no existe en el resultado, <strong>db2_field_name()</strong>  devuelve <info>false</info>.

<comment>See Also:</comment>
   * <strong>db2_field_display_size()</strong>
   * <strong>db2_field_num()</strong>
   * <strong>db2_field_precision()</strong>
   * <strong>db2_field_scale()</strong>
   * <strong>db2_field_type()</strong>
   * <strong>db2_field_width()</strong>


id: db2_field_num
type: function
doc:
<comment>Description:</comment>
  Devolver la posición de la columna indicada en un resultado
    
  
  Devuelve la posición de la columna especificada en un resultado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>    Especifica un recurso válido que contiene los resultados.
  <info>mixed</info>     <strong>$column</strong>  Especifica la columna en el resultado. Puede ser tanto un entero  que
                     represente la posición de la columna (indexada a partir de cero), o una cadena
                     que contenga el nombre de la columna.

<comment>Return:</comment>
  <info>int</info>  Devuelve un entero que contiene la posición de la columna (indexada a partir de cero) en  el
       resultado. Si la columna especificada no existe en el resultado,  <strong>db2_field_num()</strong> devuelve
       <info>false</info>.

<comment>See Also:</comment>
   * <strong>db2_field_display_size()</strong>
   * <strong>db2_field_name()</strong>
   * <strong>db2_field_precision()</strong>
   * <strong>db2_field_scale()</strong>
   * <strong>db2_field_type()</strong>
   * <strong>db2_field_width()</strong>


id: db2_field_precision
type: function
doc:
<comment>Description:</comment>
  Devolver la precisión de la columna indicada en el resultado
    
  
  Devuelve la precisión de la columna especificada en el resultado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>    Especifica un recurso válido que contiene los resultados.
  <info>mixed</info>     <strong>$column</strong>  Especifica la columna en el resultado. Puede ser tanto un entero  que
                     represente la posición de la columna (indexada a partir de cero), o una cadena
                     que contenga el nombre de la columna.

<comment>Return:</comment>
  <info>int</info>  Devuelve un entero que contiene la precisión de la columna especificada. Si la columna
       especifida no existe el el resultado, <strong>db2_field_precision()</strong> devuelve <info>false</info>.

<comment>See Also:</comment>
   * <strong>db2_field_display_size()</strong>
   * <strong>db2_field_name()</strong>
   * <strong>db2_field_num()</strong>
   * <strong>db2_field_scale()</strong>
   * <strong>db2_field_type()</strong>
   * <strong>db2_field_width()</strong>


id: db2_field_scale
type: function
doc:
<comment>Description:</comment>
  Devolver la escala de la columna indicada en el resultado
    
  
  Devuelve la escala de la columna especificada en el resultado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>    Especifica un recurso válido que contiene el resultado.
  <info>mixed</info>     <strong>$column</strong>  Especifica la columna en el resultado. Puede ser tanto un entero  representando
                     la posición de la columna (indexada a partir de cero), o una cadena que
                     contenga el nombre de la columna.

<comment>Return:</comment>
  <info>int</info>  Devuelve un entero que contiene la escala de la columna especificada. Si la  columna
       especificada no existe en el resultado,  <strong>db2_field_scale()</strong> devuelve <info>false</info>.

<comment>See Also:</comment>
   * <strong>db2_field_display_size()</strong>
   * <strong>db2_field_name()</strong>
   * <strong>db2_field_num()</strong>
   * <strong>db2_field_precision()</strong>
   * <strong>db2_field_type()</strong>
   * <strong>db2_field_width()</strong>


id: db2_field_type
type: function
doc:
<comment>Description:</comment>
  Devolver el tipo de dato de la columna indicada en un resultado
    
  
  Devuelve el tipo de dato de la columna especificada en el resultado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>    Especifica un recurso válido que contenga los resultados.
  <info>mixed</info>     <strong>$column</strong>  Especifica la columna en el resultado. Puede ser tanto un entero  representando
                     la posición de la columna (indexada a partir de cero), o una cadena  que
                     contenga el nombre de la columna.

<comment>Return:</comment>
  <info>string</info>  Devuelve una cadena que contiene el tipo de dato de la columna especificada.  Si la
          columna especificada no existe en el resultado, <strong>db2_field_type()</strong> devuelve <info>false</info>.

<comment>See Also:</comment>
   * <strong>db2_field_display_size()</strong>
   * <strong>db2_field_name()</strong>
   * <strong>db2_field_num()</strong>
   * <strong>db2_field_precision()</strong>
   * <strong>db2_field_scale()</strong>
   * <strong>db2_field_width()</strong>


id: db2_field_width
type: function
doc:
<comment>Description:</comment>
  Devolver el tamaño del valor contenido en la columna indicada
    
  
  Devuelve el tamaño del valor contenido en la columna especificada en el resultado.  Este valor es
  el tamaño máximo de la columna para tipos de dato con tamaños fijos o el  tamaño actual de la
  columna para tipos de dato con tamaños variables.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>    Especifica un recurso válido que contiene los resultados.
  <info>mixed</info>     <strong>$column</strong>  Especifica la columna en el resultado. Puede ser tanto un entero  representando
                     la posición de la columna (indexada a partir de cero), o una cadena  que
                     contenga el nombre de la columna.

<comment>Return:</comment>
  <info>int</info>  Devuelve un entero que contiene el tamaño de la columna indicada, ya sea de tipo de dato
       binario  o de caracter, en el resultado. Si la columna especificada no existe en el
       resultado,  <strong>db2_field_width()</strong> devuelve <info>false</info>.

<comment>See Also:</comment>
   * <strong>db2_field_display_size()</strong>
   * <strong>db2_field_name()</strong>
   * <strong>db2_field_num()</strong>
   * <strong>db2_field_precision()</strong>
   * <strong>db2_field_scale()</strong>
   * <strong>db2_field_type()</strong>


id: db2_foreign_keys
type: function
doc:
<comment>Description:</comment>
  Devolver un resultado que contenga las llaves foraneas de una tabla
    
  
  Devuelve un resultado que contiene las llaves foraneas de una tabla.

<comment>Param:</comment>
  <info>resource</info>  <strong>$connection</strong>  Una conexión válida a una base de datos IBM DB2, Cloudscape o Apache Derby.
  <info>string</info>    <strong>$qualifier</strong>   Un indice para bases de datos en DB2 ejecutándose en servidores OS/390 o
                         z/OS. Para  otras bases de datos se puede pasar <info>null</info> o una cadena vacia.
  <info>string</info>    <strong>$schema</strong>      El esquema que contiene las tablas. Si <strong>$schema</strong> es <info>null</info>, <strong>db2_foreign_keys()</strong>
                         busca en el esquema de la  conexión actual.
  <info>string</info>    <strong>$table-name</strong>  El nombre de la tabla.

<comment>Return:</comment>
  <info>resource</info>  Devuelve un recurso con el resultado que contiene las filas con la información  de las
            llaves foraneas de la tabla especificada. El resultado se compone de las siguientes
            columnas: Nombre de la columnaDescripciónPKTABLE_CAT Nombre del catálogo de la tabla que
            contiene la llave primaria. El  valor es nulo si esta tabla no tiene catálogos.
            PKTABLE_SCHEM Nombre del esquema de la tabla que contiene la llave primaria.
            PKTABLE_NAMENombre de la tabla que contiene la llave primaria.PKCOLUMN_NAMENombre de la
            columna que contiene la llave primaria.FKTABLE_CAT Nombre del catálogo de la tabla que
            contiene la llave foranea. El  valor es nulo si esta tala no tiene catálogos.
            FKTABLE_SCHEM Nombre del esquema que contiene la llave foranea. FKTABLE_NAMENombre de la
            tabla que contiene la llave foranea.FKCOLUMN_NAMENombre de la columna que contiene la
            llave foranea.KEY_SEQPosición de la columna en la llave (indexada a partir de
            uno).UPDATE_RULE Valor entero que representa la acción a aplicarse en la llave foranea
            cuando ocurre alguna operación UPDATE. DELETE_RULE Valor entero que representa la acción
            a aplicarse en la llave foranea  cuando ocurre alguna operación DELETE. FK_NAMEEl nombre
            de la llave foranea.PK_NAMEEl nombre de la llave primaria.DEFERRABILITY Valor entero que
            representa cuándo se checa que la llave foranea se cumpla, puede ser
            SQL_INITIALLY_DEFERRED, SQL_INITIALLY_IMMEDIATE o  SQL_NOT_DEFERRABLE.

<comment>See Also:</comment>
   * <strong>db2_column_privileges()</strong>
   * <strong>db2_columns()</strong>
   * <strong>db2_primary_keys()</strong>
   * <strong>db2_procedure_columns()</strong>
   * <strong>db2_procedures()</strong>
   * <strong>db2_special_columns()</strong>
   * <strong>db2_statistics()</strong>
   * <strong>db2_table_privileges()</strong>
   * <strong>db2_tables()</strong>


id: db2_free_result
type: function
doc:
<comment>Description:</comment>
  Liberar los recursos asociados con un resultado
    
  
  Libera los recursos del Sistema y de la Base de Datos que están asociados con un resultado.  Los
  recursos se liberan automáticamente cuando un script finaliza, pero se puede  llamar a
  <strong>db2_free_result()</strong> para liberarlos en ese momento  y no hasta que el script finalice.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>  Un recurso válido.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>db2_free_stmt()</strong>


id: db2_free_stmt
type: function
doc:
<comment>Description:</comment>
  Liberar un recurso indicado
    
  
  Libera los recursos del Sistema y de la Base de Datos que están asociados con un  determinado
  recurso (de sentencias). Los recursos son liberados automáticamente cuando  un script finaliza,
  pero se puede llamar a <strong>db2_free_stmt()</strong> para liberarlos  en ese momento y no hasta que el script
  finalice.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>  Un recurso (de sentencias) válido.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>db2_free_result()</strong>


id: db2_get_option
type: function
doc:
<comment>Description:</comment>
  Devolver el valor de la opción correpondiente a una conexión o sentencia
  
  Devuelve el valor de la opción especificada para una conexión o sentencia.

<comment>Param:</comment>
  <info>resource</info>  <strong>$resource</strong>    Un recurso válido devuelto por  <strong>db2_prepare()</strong> o devuelto por  <strong>db2_connect()</strong>
                         o <strong>db2_pconnect()</strong>.
  <info>string</info>    <strong>$option</strong>      Opciones válidas para la sentencia o conexión. Las nuevas opciones
                         siguientes están disponibles   a partir de la versión 1.6.0 de ibm_db2.
                         Proveen información de rastreo útil que puede ser   establecida durante la
                         ejecución con <strong>db2_get_option()</strong>.  Las versiones anteriores de ibm_db2 no
                         soportan estas nuevas opciones.  Cuando el valor de cada opción se
                         establece, es posible que algunos servidores no  manejen toda la longitud
                         especificada y puede que el valor sea truncado.  Para asegurar que la
                         información especificada en cada opción sea convertida correctamente
                         cuando se transmita a un Host utilice únicamente caracteres de la A a la Z,
                         0 a 9, guiones bajos (_) y puntos (.).  <strong>$userid</strong><return>SQL_ATTR_INFO_USERID</return> - Un
                         apuntador a una cadena   que representa el identificador del cliente
                         enviado al servidor cuando se conecta al servidor usando <strong>db2_connect()</strong>.
                         Los servidores z/OS y OS/390 soportan longitudes hasta 16 caracteres.  Este
                         identificador de usuario no debe ser confundido con el usuario de
                         autenticación, sólo es  para propósitos de identificación y no se usa para
                         autorización.  <strong>$acctstr</strong><return>SQL_ATTR_INFO_ACCTSTR</return> - Un apuntador a una cadena
                         utilizada para identificar la cuenta del cliente enviada al Host cuando se
                         conecta al servidor usando <strong>db2_connect()</strong>.  Los servidores z/OS y OS/390
                         soportan longitudes de hasta 200 caracteres.
                         <strong>$applname</strong><return>SQL_ATTR_INFO_APPLNAME</return> - Un apuntador a una cadena   utilizada
                         para identificar el nombre de la aplicación del cliente enviado al Host
                         cuando se conecta al servidor usando <strong>db2_connect()</strong>.  Los servidores z/OS y
                         OS/390 soportan longitudes de hasta 32 caracteres.
                         <strong>$wrkstnname</strong><return>SQL_ATTR_INFO_WRKSTNNAME</return> - Un apuntador a una cadena   utilizada
                         para identificar el nombre de la estación de trabajo del cliente enviado al
                         Host   cuando se conecta al servidor usando <strong>db2_connect()</strong>.  Los servidores
                         z/OS y OS/390 soportan longitudes de hasta 18 caracteres.
                         
                         Las versiones anteriores de ibm_db2 no soportan estas nuevas opciones.
                         
                         Cuando el valor de cada opción se establece, es posible que algunos
                         servidores no  manejen toda la longitud especificada y puede que el valor
                         sea truncado.
                         
                         Para asegurar que la información especificada en cada opción sea convertida
                         correctamente   cuando se transmita a un Host utilice únicamente caracteres
                         de la A a la Z,  0 a 9, guiones bajos (_) y puntos (.).
                         
                         <return>SQL_ATTR_INFO_USERID</return> - Un apuntador a una cadena   que representa el
                         identificador del cliente enviado al servidor cuando se conecta al servidor
                         usando <strong>db2_connect()</strong>.  Los servidores z/OS y OS/390 soportan longitudes
                         hasta 16 caracteres.  Este identificador de usuario no debe ser confundido
                         con el usuario de autenticación, sólo es  para propósitos de identificación
                         y no se usa para autorización.
                         
                         Los servidores z/OS y OS/390 soportan longitudes hasta 16 caracteres.  Este
                         identificador de usuario no debe ser confundido con el usuario de
                         autenticación, sólo es  para propósitos de identificación y no se usa para
                         autorización.
                         
                         <return>SQL_ATTR_INFO_ACCTSTR</return> - Un apuntador a una cadena   utilizada para
                         identificar la cuenta del cliente enviada al Host cuando se   conecta al
                         servidor usando <strong>db2_connect()</strong>.  Los servidores z/OS y OS/390 soportan
                         longitudes de hasta 200 caracteres.
                         
                         Los servidores z/OS y OS/390 soportan longitudes de hasta 200 caracteres.
                         
                         <return>SQL_ATTR_INFO_APPLNAME</return> - Un apuntador a una cadena   utilizada para
                         identificar el nombre de la aplicación del cliente enviado al Host  cuando
                         se conecta al servidor usando <strong>db2_connect()</strong>.  Los servidores z/OS y OS/390
                         soportan longitudes de hasta 32 caracteres.
                         
                         Los servidores z/OS y OS/390 soportan longitudes de hasta 32 caracteres.
                         
                         <return>SQL_ATTR_INFO_WRKSTNNAME</return> - Un apuntador a una cadena   utilizada para
                         identificar el nombre de la estación de trabajo del cliente enviado al Host
                         cuando se conecta al servidor usando <strong>db2_connect()</strong>.  Los servidores z/OS y
                         OS/390 soportan longitudes de hasta 18 caracteres.
                         
                         Los servidores z/OS y OS/390 soportan longitudes de hasta 18 caracteres.
  <info></info>          <strong>$userid</strong>      <return>SQL_ATTR_INFO_USERID</return> - Un apuntador a una cadena   que representa el
                         identificador del cliente enviado al servidor cuando se conecta al servidor
                         usando <strong>db2_connect()</strong>.  Los servidores z/OS y OS/390 soportan longitudes
                         hasta 16 caracteres.  Este identificador de usuario no debe ser confundido
                         con el usuario de autenticación, sólo es  para propósitos de identificación
                         y no se usa para autorización.
                         
                         Los servidores z/OS y OS/390 soportan longitudes hasta 16 caracteres.  Este
                         identificador de usuario no debe ser confundido con el usuario de
                         autenticación, sólo es  para propósitos de identificación y no se usa para
                         autorización.
  <info></info>          <strong>$acctstr</strong>     <return>SQL_ATTR_INFO_ACCTSTR</return> - Un apuntador a una cadena   utilizada para
                         identificar la cuenta del cliente enviada al Host cuando se   conecta al
                         servidor usando <strong>db2_connect()</strong>.  Los servidores z/OS y OS/390 soportan
                         longitudes de hasta 200 caracteres.
                         
                         Los servidores z/OS y OS/390 soportan longitudes de hasta 200 caracteres.
  <info></info>          <strong>$applname</strong>    <return>SQL_ATTR_INFO_APPLNAME</return> - Un apuntador a una cadena   utilizada para
                         identificar el nombre de la aplicación del cliente enviado al Host  cuando
                         se conecta al servidor usando <strong>db2_connect()</strong>.  Los servidores z/OS y OS/390
                         soportan longitudes de hasta 32 caracteres.
                         
                         Los servidores z/OS y OS/390 soportan longitudes de hasta 32 caracteres.
  <info></info>          <strong>$wrkstnname</strong>  <return>SQL_ATTR_INFO_WRKSTNNAME</return> - Un apuntador a una cadena   utilizada para
                         identificar el nombre de la estación de trabajo del cliente enviado al Host
                         cuando se conecta al servidor usando <strong>db2_connect()</strong>.  Los servidores z/OS y
                         OS/390 soportan longitudes de hasta 18 caracteres.
                         
                         Los servidores z/OS y OS/390 soportan longitudes de hasta 18 caracteres.

<comment>Return:</comment>
  <info>string</info>  Devuelve la configuración actual del atributo especificado en la conexión en caso de éxito
          o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>db2_connect()</strong>
   * <strong>db2_cursor_type()</strong>
   * <strong>db2_exec()</strong>
   * <strong>db2_set_option()</strong>
   * <strong>db2_pconnect()</strong>
   * <strong>db2_prepare()</strong>


id: db2_last_insert_id
type: function
doc:
<comment>Description:</comment>
  Devolver el ID autogenerado el la última sentencia INSERT ejecutada correctamente  
    en la conexión
  
  Devuelve el ID autogenerado de la última sentencia INSERT ejecutada correctamente   en la
  conexión.
  
  El resultado de esta función no se ve afectado por lo siguiente:  Una sentencia INSERT sencilla
  con la cláusula VALUES para una tabla sin una columna de identidad.  Una sentencia INSERT múltiple
  con la claúsula VALUES.  Una sentencia INSERT con FULLSELECT.  Una sentencia ROLLBACK.
  
  Una sentencia INSERT sencilla con la cláusula VALUES para una tabla sin una columna de identidad.
  
  Una sentencia INSERT múltiple con la claúsula VALUES.
  
  Una sentencia INSERT con FULLSELECT.
  
  Una sentencia ROLLBACK.

<comment>Param:</comment>
  <info>resource</info>  <strong>$resource</strong>  Una conexión válida devuelta por <strong>db2_connect()</strong>   o <strong>db2_pconnect()</strong>. El valor
                       de este parámetro no puede ser   un recurso de sentencia o de resultado.

<comment>Return:</comment>
  <info>string</info>  Devuelve el ID autogenerado de la última sentencia INSERT que se ejecutó correctamente
          en esta conexión.


id: db2_lob_read
type: function
doc:
<comment>Description:</comment>
  Obtener un segmento, de tamaño definido por el usuario, de un archivo LOB
    
  
  <strong>db2_lob_read()</strong> se usa para iterar a través de una columna específica dentro de un   resultado y
  extraer un segmento de datos LOB de tamaño definido por el usuario.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>    Un recurso <return>stmt</return> válido que contenga datos LOB.
  <info>int</info>       <strong>$colnum</strong>  Un número de columna válido en el resultado del recurso <return>stmt</return>.
  <info>int</info>       <strong>$length</strong>  El tamaño del segmento de datos LOB que se va a extraer del recurso <return>stmt</return>.

<comment>Return:</comment>
  <info>string</info>  Devuelve la cantidad de datos que el usuario especifica. Devuelve  <info>false</info> si los datos no
          pueden ser extraidos.

<comment>See Also:</comment>
   * <strong>db2_bind_param()</strong>
   * <strong>db2_exec()</strong>
   * <strong>db2_execute()</strong>
   * <strong>db2_fetch_row()</strong>
   * <strong>db2_prepare()</strong>
   * <strong>db2_result()</strong>


id: db2_next_result
type: function
doc:
<comment>Description:</comment>
  Solicitar el siguiente resultado de un procedimiento almacendo
    
  
  Un procedimiento almacenado puede o no devolver bloques de resultados. El primer resultado
  devuelto   se maneja de la misma manera que se manejan los resultados devueltos por una sentencia
  SELECT normal,  en cambio, para extraer el segundo y los siguientes bloques de un procedimiento
  almacenado  se debe llamar a <strong>db2_next_result()</strong> y almacenar el resultado en una variable de PHP.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>  Una sentencia preparada devuelta por <strong>db2_exec()</strong> o <strong>db2_execute()</strong>.

<comment>Return:</comment>
  <info>resource</info>  La función devuelve un nuevo recurso de sentencia que contiene el siguiente bloque de
            resultados si el  procedimiento almacenado regresa otro bloque de resultados. La función
            devuelve <info>false</info> si el procedimiento  almacenado no regresa otro resultado.


id: db2_num_fields
type: function
doc:
<comment>Description:</comment>
  Devolver el número de campos que contiene un resultado
    
  
  Devuelve el número de campos que contiene un resultado. Esta función es muy útil  cuando se
  manejan resultados devueltos por consultas generadas dinámicamente o  para resultados devueltos
  por procedimientos almacenados, donde la aplicación no puede  determinar de otro modo cómo extraer
  y utilizar los resultados.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>  Un recurso válido que contenga el resultado.

<comment>Return:</comment>
  <info>int</info>  Devuelve un valor entero que representa el número de campos de un resultado  asociado con el
       recurso especificado. Devuelve <info>false</info> si  el recurso no es válido.

<comment>See Also:</comment>
   * <strong>db2_execute()</strong>
   * <strong>db2_field_display_size()</strong>
   * <strong>db2_field_name()</strong>
   * <strong>db2_field_num()</strong>
   * <strong>db2_field_precision()</strong>
   * <strong>db2_field_scale()</strong>
   * <strong>db2_field_type()</strong>
   * <strong>db2_field_width()</strong>


id: db2_num_rows
type: function
doc:
<comment>Description:</comment>
  Devolver el número de filas afectadas por una sentencia SQL
    
  
  Devuelve el número de filas eliminadas, insertadas o actualizadas por una sentencia SQL.
  
  Para determinar el número de filas que serán devueltas por una sentencia SELECT  se puede utilizar
  una consulta de tipo SELECT COUNT(*) con los mismos predicados que la  consulta original.
  
  Si la aplicación revisa el número de filas devueltas por una sentencia SELECT  comparando si el
  número de filas es cero, es mejor considerar modificar la aplicación  intentando extraer la primer
  fila con <strong>db2_fetch_assoc()</strong>,  <strong>db2_fetch_both()</strong>, <strong>db2_fetch_array()</strong>,  o <strong>db2_fetch_row()</strong>  y comparar
  si la función devuelve <info>false</info>.
  
  Si se utiliza una sentencia SELECT con un cursor de recorrido, <strong>db2_num_rows()</strong> devuelve el número
  de filas devueltas por  la sentencia SELECT. Sin embargo, lo anterior requiere significativamente
  de  mayores recursos para la aplicación, por lo tanto, si ésta es la única  razón por la que se
  utilizan cursores de recorrido en la aplicación, es mejor utilizar cursores de no-recorrido así
  como una consulta SELECT COUNT(*) o utilizar el valor <info>boolean</info> devuelto por las funciones de
  extracción  con el objetivo de lograr una mayor optimización.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>  Un recurso <return>stmt</return> válido que contenga el resultado.

<comment>Return:</comment>
  <info>int</info>  Devuelve el número de filas afectadas por la última sentencia SQL asociada con el  recurso
       indicado.


id: db2_pclose
type: function
doc:
<comment>Description:</comment>
  Cerrar una conexión persistente a la base de datos
  
  Cierra una conexión cliente de DB2 creada con   <strong>db2_pconnect()</strong> y devuelve los recursos
  correspondientes   al servidor de la base de datos.    Esta función solo está disponible en i5/OS
  es respuesta al  sistema de administración de i5/OS.
  
  Esta función solo está disponible en i5/OS es respuesta al  sistema de administración de i5/OS.
  
  Si se tiene una conexión persistente a DB2 creda con   <strong>db2_pconnect()</strong>, se puede usar esta función
  para cerrar   la conexión. Para evitar reducciones en el rendimiento de las conexiones,  esta
  función solo debería usarse en casos especiales donde la conexión  persistente no responda o la
  conexión no se necesite por mucho tiempo.

<comment>Param:</comment>
  <info></info>  <strong>$connection</strong>  Especifica una conexión cliente activa de DB2.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>db2_close()</strong>
   * <strong>db2_pconnect()</strong>


id: db2_pconnect
type: function
doc:
<comment>Description:</comment>
  Devolver una conexión persistente a la base de datos
    
  
  Devuelve una conexión persistente a una base de datos IBM DB2 Universal Database, IBM Cloudscape o
  Apache Derby.
  
  Más información acerca de conexiones persistentes se puede encontrar en: .
  
  Si se llama a <strong>db2_close()</strong> en una conexión persistente, siempre  se devolverá <info>true</info>, sin embargo la
  conexión permenecerá abierta en modo de espera para utilizarse en la siguiente solicitud de
  <strong>db2_pconnect()</strong>.
  
  Para las versiones 1.9.0 y superiores de ibm_db2, hay que considerar que  al final de la solicitud
  siempre se ejecutará una cancelación ("rollback") de la transacción en la  conexión persistente
  para terminar la transacción. Lo anterior evita que el bloqueo de información  permanezca en la
  siguiente solicitud que utilice esa conexión.

<comment>Param:</comment>
  <info>string</info>  <strong>$database</strong>           El álias de la base de datos en al catálogo del cliente DB2.
  <info>string</info>  <strong>$username</strong>           El usuario con el se conecta a la base de datos.
  <info>string</info>  <strong>$password</strong>           La contraseña con la que se conecta a la base de datos.
  <info>array</info>   <strong>$options</strong>            Un arreglo asociativo de opciones que afectan el comportamiento de  la
                              conexión, entre las claves válidas están: <strong>$autocommit</strong> Si se pasa el
                              valor  <return>DB2_AUTOCOMMIT_ON</return> se   confirmarán automáticamente las
                              transacciones de la conexión.  Si se pasa el valor <return>DB2_AUTOCOMMIT_OFF</return>
                              no se  confirmarán automáticamente las transacciones de la conexión.
                              <strong>$DB2_ATTR_CASE</strong> Si se pasa el valor <return>DB2_CASE_NATURAL</return> los nombres  de
                              las columnas serán devueltos con sus mayúsculas y minúsculas
                              originales.  Si se pasa el valor <return>DB2_CASE_LOWER</return> los nombres  de las
                              columnas serán devueltos en minúsculas.  Si se pasa el valor
                              <return>DB2_CASE_UPPER</return> los nombres  de las columnas serán devueltos en
                              mayúsculas. <strong>$CURSOR</strong> Si se pasa el valor <return>DB2_FORWARD_ONLY</return> se establece
                              un cursor de no-recorrido (sólo hacia adelante). Este cursor es
                              predeterminado  y soportado por todos los servidores de base de datos.
                              Si se pasa el valor <return>DB2_SCROLLABLE</return> se establece  un cursor de
                              recorrido. Con este modo es posible acceder de manera  aleatoria a las
                              filas del resultado pero actualmente sólo es soportado  por IBM DB2
                              Universal Database.
                              
                              Si se pasa el valor  <return>DB2_AUTOCOMMIT_ON</return> se   confirmarán
                              automáticamente las transacciones de la conexión.
                              
                              Si se pasa el valor <return>DB2_AUTOCOMMIT_OFF</return> no se  confirmarán
                              automáticamente las transacciones de la conexión.
                              
                              Si se pasa el valor <return>DB2_CASE_NATURAL</return> los nombres  de las columnas
                              serán devueltos con sus mayúsculas y minúsculas originales.
                              
                              Si se pasa el valor <return>DB2_CASE_LOWER</return> los nombres  de las columnas serán
                              devueltos en minúsculas.
                              
                              Si se pasa el valor <return>DB2_CASE_UPPER</return> los nombres  de las columnas serán
                              devueltos en mayúsculas.
                              
                              Si se pasa el valor <return>DB2_FORWARD_ONLY</return> se establece  un cursor de
                              no-recorrido (sólo hacia adelante). Este cursor es predeterminado  y
                              soportado por todos los servidores de base de datos.
                              
                              Si se pasa el valor <return>DB2_SCROLLABLE</return> se establece  un cursor de
                              recorrido. Con este modo es posible acceder de manera  aleatoria a las
                              filas del resultado pero actualmente sólo es soportado  por IBM DB2
                              Universal Database.
                              
                              Las siguientes opciones están disponibles en las versiones 1.7.0 y
                              superiores de  ibm_db2.  <strong>$trustedcontext</strong> Si se pasa el valor
                              DB2_TRUSTED_CONTEXT_ENABLE se establece una conexión  de confianza.
                              Este parámetro no puede ser establecido mediante   <strong>db2_set_option()</strong>.
                              Esta clave solo funciona si la base de datos está catalogada (aún
                              cuando   la base de datos sea local), o si se especifica un DSN
                              completo cuando se    crea la conexión.  Para catalogar la base de
                              datos se usan los siguientes comandos: db2 catalog tcpip node loopback
                              remote \<SERVERNAME&gt; server \<SERVICENAME&gt;
                              db2 catalog database \<LOCALDBNAME&gt; as \<REMOTEDBNAME&gt; at node loopback
                              db2 "update dbm cfg using svcename \<SERVICENAME&gt;"
                              db2set DB2COMM=TCPIP
                              
                              Si se pasa el valor DB2_TRUSTED_CONTEXT_ENABLE se establece una
                              conexión  de confianza. Este parámetro no puede ser establecido
                              mediante   <strong>db2_set_option()</strong>.
                              
                              Esta clave solo funciona si la base de datos está catalogada (aún
                              cuando   la base de datos sea local), o si se especifica un DSN
                              completo cuando se    crea la conexión.
                              
                              Para catalogar la base de datos se usan los siguientes comandos:
                              
                              db2 catalog tcpip node loopback remote \<SERVERNAME&gt; server \<SERVICENAME&gt;
                              db2 catalog database \<LOCALDBNAME&gt; as \<REMOTEDBNAME&gt; at node loopback
                              db2 "update dbm cfg using svcename \<SERVICENAME&gt;"
                              db2set DB2COMM=TCPIP
                              
                              Las siguientes opciones i5/OS están disponibles en las versiones 1.5.1
                              y superiores de ibm_db2. Si se utilizan atributos de conexión
                              conflictivos en conexiones persistentes   se pueden provocar
                              resultados indeterminados en i5/OS. Las políticas de sitio deberían
                              establecer el uso de perfiles con conexiones persistentes para todas
                              las aplicacioneses. Se sugiere el uso de DB2_AUTOCOMMIT_ON en
                              conexiones persistentes.  <strong>$i5_lib</strong> Una cadena que indica la lista de
                              bibliotecas que se utilizará por default para resolver  referencias no
                              evaluadas a archivos. Este parámetro no es válido   si en la conexión
                              se utiliza el modo de nombrado de sistema. <strong>$i5_naming</strong><return>DB2_I5_NAMING_ON</return>
                              habilita el modo de nombrado de sistema DB2 UDB CLI iSeries. Los
                              archivos son evaluados utilizando una diagonal (/) como delimitador.
                              Los archivos que no pueden ser evaluados son resueltos utilizando la
                              lista de bibliotecas. <return>DB2_I5_NAMING_OFF</return> esta valor predeterminado
                              habilita el modo de nombrado DB2 UDB CLI,   que es el sistema de
                              nombrado de SQL. Los archivos son evaluados utilizando un punto (.)
                              como delimitador. Los archivos que no se pueden evaluar son resueltos
                              utilizando tanto la biblioteca predeterminada  como el identificador
                              del usuario actual. <strong>$i5_commit</strong> Se recomienda establecer el parámetro
                              <strong>$i5_commit</strong> antes que   <strong>db2_pconnect()</strong>. Si el valor es modificado
                              después de que la conexión ha   sido establecida y la conexión es
                              hacia una fuente remota, el cambio no tendrá efecto hasta la siguiente
                              llamada exitosa a <strong>db2_pconnect()</strong> para el manejo de conexión.  El
                              parámetro <strong>$ibm_db2.i5_allow_commit</strong>==0 en php.ini o
                              <return>DB2_I5_TXN_NO_COMMIT</return> son opciones predeterminadas pero pueden ser
                              remplazadas   con la opción <strong>$i5_commit</strong>.
                              <return>DB2_I5_TXN_NO_COMMIT</return> - No se utiliza ningún control de transacciones.
                              <return>DB2_I5_TXN_READ_UNCOMMITTED</return> - Se permiten lecturas sucias, lecturas no
                              repetibles,   y lecturas fantasma. <return>DB2_I5_TXN_READ_COMMITTED</return> - No se
                              permiten lecturas sucias. Se permiten   lecturas no repetibles y
                              lecturas fantasma. <return>DB2_I5_TXN_REPEATABLE_READ</return> - No se permiten
                              lecturas sucias ni lecturas   no repetibles. Se permiten lecturas
                              fantasma. <return>DB2_I5_TXN_SERIALIZABLE</return> - Las transacciones son
                              serializables.  No se permiten lecturas sucias, lecturas no repetibles
                              ni lecturas fantasma. <strong>$i5_query_optimize</strong><return>DB2_FIRST_IO</return> - Todas las
                              consultas son optimazadas con el objetivo de   devolver la primera
                              página de resultados lo más rápido posible. Esta opción se recomienda
                              cuando el resultado     es controlado por un usuario que puede
                              cancelar la consulta después de   visualizar la primera página de
                              resultados. Esta funcionalidad también se puede lograr utilizando
                              OPTIMIZE FOR nnn ROWS  en una consulta. <return>DB2_ALL_IO</return> - Todas las
                              consultas son optimizadas con el objetivo de ejecutar   la consulta
                              completa en el menor tiempo posible. Esta opción predeterminada se
                              recomienda cuando el resultado de  una consulta es escrito en un
                              archivo o reporte. Esta funcionalidad tambien se puede lograr
                              utilizando OPTIMIZE FOR nnn ROWS  en una consulta.
                              <strong>$i5_dbcs_alloc</strong><return>DB2_I5_DBCS_ALLOC_ON</return> habilita el esquema de alojamiento
                              DB2 6X para   incremento de tamaño en columnas de traducción DBCS.
                              <return>DB2_I5_DBCS_ALLOC_OFF</return> deshabilita el esquema de alojamiento DB2 6X
                              para   incremento de tamaño en columnas de traducción DBCS.   El
                              parámetro <strong>$ibm_db2.i5_dbcs_alloc</strong>==0 en php.ini o
                              <return>DB2_I5_DBCS_ALLOC_OFF</return> son opciones predeterminadas pero pueden ser
                              remplazadas con   la opción <strong>$i5_dbcs_alloc</strong>.
                              <strong>$i5_date_fmt</strong><return>DB2_I5_FMT_ISO</return> - Se utiliza el formato de fechas estandar
                              (ISO) yyyy-mm-dd.  Esta opción es predeterminada. <return>DB2_I5_FMT_USA</return> - Se
                              utiliza el formato de fechas de Estados Unidos mm/dd/yyyy.
                              <return>DB2_I5_FMT_EUR</return> - Se utiliza el formato de fechas Europeo dd.mm.yyyy.
                              <return>DB2_I5_FMT_JIS</return> - Se utiliza el formato de fechas Japonés yyyy-mm-dd.
                              <return>DB2_I5_FMT_MDY</return> - Se utiliza el formato de fechas mm/dd/yyyy.
                              <return>DB2_I5_FMT_DMY</return> - Se utiliza el formato de fechas dd/mm/yyyy.
                              <return>DB2_I5_FMT_YMD</return> - Se utiliza el formato de fechas yy/mm/dd.
                              <return>DB2_I5_FMT_JUL</return> - Se utiliza el formato de fechas Juliano yy/ddd.
                              <return>DB2_I5_FMT_JOB</return> - El formato de trabajo es utilizado.
                              <strong>$i5_date_sep</strong><return>DB2_I5_SEP_SLASH</return> - Se utiliza una diagonal ( / ) como
                              separador de fechas.  Esta opción es predeterminada. <return>DB2_I5_SEP_DASH</return> -
                              Se utiliza un guión medio ( - ) como separador de fechas.
                              <return>DB2_I5_SEP_PERIOD</return> - Se utiliza un punto ( . ) como separador de
                              fechas. <return>DB2_I5_SEP_COMMA</return> - Se utiliza una coma ( , ) como separador de
                              fechas. <return>DB2_I5_SEP_BLANK</return> - Se utiliza un espacio como separador de
                              fechas. <return>DB2_I5_SEP_JOB</return> - Se utiliza el separador de fechas de trabajo.
                              <strong>$i5_time_fmt</strong><return>DB2_I5_FMT_ISO</return> - Se utiliza el formato de tiempo estandar
                              (ISO) hh.mm.ss.  Esta opción es predeterminada. <return>DB2_I5_FMT_USA</return> - Se
                              utiliza el formato de tiempo de Estados Unidos hh:mmxx, donde xx es AM
                              o PM. <return>DB2_I5_FMT_EUR</return> - Se utiliza el formato de tiempo Europeo
                              hh.mm.ss. <return>DB2_I5_FMT_JIS</return> - Se utiliza el formato de tiempo Japonés
                              hh:mm:ss. <return>DB2_I5_FMT_HMS</return> - Se utiliza el formato de tiempo hh:mm:ss.
                              <strong>$i5_time_sep</strong><return>DB2_I5_SEP_COLON</return> - Se utiliza el signo de dos puntos ( : )
                              como separador de tiempo. Esta opción es predeterminada.
                              <return>DB2_I5_SEP_PERIOD</return> - Se utiliza un punto ( . ) como separador de
                              tiempo. <return>DB2_I5_SEP_COMMA</return> - Se utiliza una coma ( , ) como separador de
                              tiempo. <return>DB2_I5_SEP_BLANK</return> - Se utiliza un espacio como separador de
                              tiempo. <return>DB2_I5_SEP_JOB</return> - Se utiliza el separador de tiempo de trabajo.
                              <strong>$i5_decimal_sep</strong><return>DB2_I5_SEP_PERIOD</return> - Se utiliza un punto ( . ) como
                              separador decimal. Esta opción es predeterminada. <return>DB2_I5_SEP_COMMA</return> -
                              Se utiliza una coma ( , ) como separador decimal. <return>DB2_I5_SEP_JOB</return> - Se
                              utiliza el separador decimal de trabajo.
                              
                              Si se utilizan atributos de conexión conflictivos en conexiones
                              persistentes   se pueden provocar resultados indeterminados en i5/OS.
                              Las políticas de sitio deberían establecer el uso de perfiles con
                              conexiones persistentes para todas las aplicacioneses. Se sugiere el
                              uso de DB2_AUTOCOMMIT_ON en conexiones persistentes.
                              
                              Una cadena que indica la lista de bibliotecas que se utilizará por
                              default para resolver  referencias no evaluadas a archivos. Este
                              parámetro no es válido   si en la conexión se utiliza el modo de
                              nombrado de sistema.
                              
                              <return>DB2_I5_NAMING_ON</return> habilita el modo de nombrado de sistema DB2 UDB CLI
                              iSeries. Los archivos son evaluados utilizando una diagonal (/) como
                              delimitador.  Los archivos que no pueden ser evaluados son resueltos
                              utilizando la lista de bibliotecas.
                              
                              <return>DB2_I5_NAMING_OFF</return> esta valor predeterminado habilita el modo de
                              nombrado DB2 UDB CLI,   que es el sistema de nombrado de SQL. Los
                              archivos son evaluados utilizando un punto (.)  como delimitador. Los
                              archivos que no se pueden evaluar son resueltos utilizando tanto la
                              biblioteca predeterminada  como el identificador del usuario actual.
                              
                              Se recomienda establecer el parámetro <strong>$i5_commit</strong> antes que
                              <strong>db2_pconnect()</strong>. Si el valor es modificado después de que la conexión
                              ha   sido establecida y la conexión es hacia una fuente remota, el
                              cambio no tendrá efecto hasta la siguiente llamada exitosa a
                              <strong>db2_pconnect()</strong> para el manejo de conexión.  El parámetro
                              <strong>$ibm_db2.i5_allow_commit</strong>==0 en php.ini o  <return>DB2_I5_TXN_NO_COMMIT</return> son
                              opciones predeterminadas pero pueden ser remplazadas   con la opción
                              <strong>$i5_commit</strong>.
                              
                              El parámetro <strong>$ibm_db2.i5_allow_commit</strong>==0 en php.ini o
                              <return>DB2_I5_TXN_NO_COMMIT</return> son opciones predeterminadas pero pueden ser
                              remplazadas   con la opción <strong>$i5_commit</strong>.
                              
                              <return>DB2_I5_TXN_NO_COMMIT</return> - No se utiliza ningún control de transacciones.
                              
                              <return>DB2_I5_TXN_READ_UNCOMMITTED</return> - Se permiten lecturas sucias, lecturas no
                              repetibles,   y lecturas fantasma.
                              
                              <return>DB2_I5_TXN_READ_COMMITTED</return> - No se permiten lecturas sucias. Se
                              permiten   lecturas no repetibles y lecturas fantasma.
                              
                              <return>DB2_I5_TXN_REPEATABLE_READ</return> - No se permiten lecturas sucias ni
                              lecturas   no repetibles. Se permiten lecturas fantasma.
                              
                              <return>DB2_I5_TXN_SERIALIZABLE</return> - Las transacciones son serializables.  No se
                              permiten lecturas sucias, lecturas no repetibles ni lecturas fantasma.
                              
                              <return>DB2_FIRST_IO</return> - Todas las consultas son optimazadas con el objetivo de
                              devolver la primera página de resultados lo más rápido posible. Esta
                              opción se recomienda cuando el resultado     es controlado por un
                              usuario que puede cancelar la consulta después de   visualizar la
                              primera página de resultados. Esta funcionalidad también se puede
                              lograr utilizando OPTIMIZE FOR nnn ROWS  en una consulta.
                              
                              <return>DB2_ALL_IO</return> - Todas las consultas son optimizadas con el objetivo de
                              ejecutar   la consulta completa en el menor tiempo posible. Esta
                              opción predeterminada se recomienda cuando el resultado de  una
                              consulta es escrito en un archivo o reporte. Esta funcionalidad
                              tambien se puede lograr utilizando OPTIMIZE FOR nnn ROWS  en una
                              consulta.
                              
                              <return>DB2_I5_DBCS_ALLOC_ON</return> habilita el esquema de alojamiento DB2 6X para
                              incremento de tamaño en columnas de traducción DBCS.
                              
                              <return>DB2_I5_DBCS_ALLOC_OFF</return> deshabilita el esquema de alojamiento DB2 6X
                              para   incremento de tamaño en columnas de traducción DBCS.   El
                              parámetro <strong>$ibm_db2.i5_dbcs_alloc</strong>==0 en php.ini o
                              <return>DB2_I5_DBCS_ALLOC_OFF</return> son opciones predeterminadas pero pueden ser
                              remplazadas con   la opción <strong>$i5_dbcs_alloc</strong>.
                              
                              El parámetro <strong>$ibm_db2.i5_dbcs_alloc</strong>==0 en php.ini o
                              <return>DB2_I5_DBCS_ALLOC_OFF</return> son opciones predeterminadas pero pueden ser
                              remplazadas con   la opción <strong>$i5_dbcs_alloc</strong>.
                              
                              <return>DB2_I5_FMT_ISO</return> - Se utiliza el formato de fechas estandar (ISO)
                              yyyy-mm-dd.  Esta opción es predeterminada.
                              
                              <return>DB2_I5_FMT_USA</return> - Se utiliza el formato de fechas de Estados Unidos
                              mm/dd/yyyy.
                              
                              <return>DB2_I5_FMT_EUR</return> - Se utiliza el formato de fechas Europeo dd.mm.yyyy.
                              
                              <return>DB2_I5_FMT_JIS</return> - Se utiliza el formato de fechas Japonés yyyy-mm-dd.
                              
                              <return>DB2_I5_FMT_MDY</return> - Se utiliza el formato de fechas mm/dd/yyyy.
                              
                              <return>DB2_I5_FMT_DMY</return> - Se utiliza el formato de fechas dd/mm/yyyy.
                              
                              <return>DB2_I5_FMT_YMD</return> - Se utiliza el formato de fechas yy/mm/dd.
                              
                              <return>DB2_I5_FMT_JUL</return> - Se utiliza el formato de fechas Juliano yy/ddd.
                              
                              <return>DB2_I5_FMT_JOB</return> - El formato de trabajo es utilizado.
                              
                              <return>DB2_I5_SEP_SLASH</return> - Se utiliza una diagonal ( / ) como separador de
                              fechas.  Esta opción es predeterminada.
                              
                              <return>DB2_I5_SEP_DASH</return> - Se utiliza un guión medio ( - ) como separador de
                              fechas.
                              
                              <return>DB2_I5_SEP_PERIOD</return> - Se utiliza un punto ( . ) como separador de
                              fechas.
                              
                              <return>DB2_I5_SEP_COMMA</return> - Se utiliza una coma ( , ) como separador de fechas.
                              
                              <return>DB2_I5_SEP_BLANK</return> - Se utiliza un espacio como separador de fechas.
                              
                              <return>DB2_I5_SEP_JOB</return> - Se utiliza el separador de fechas de trabajo.
                              
                              <return>DB2_I5_FMT_ISO</return> - Se utiliza el formato de tiempo estandar (ISO)
                              hh.mm.ss.  Esta opción es predeterminada.
                              
                              <return>DB2_I5_FMT_USA</return> - Se utiliza el formato de tiempo de Estados Unidos
                              hh:mmxx, donde xx es AM o PM.
                              
                              <return>DB2_I5_FMT_EUR</return> - Se utiliza el formato de tiempo Europeo hh.mm.ss.
                              
                              <return>DB2_I5_FMT_JIS</return> - Se utiliza el formato de tiempo Japonés hh:mm:ss.
                              
                              <return>DB2_I5_FMT_HMS</return> - Se utiliza el formato de tiempo hh:mm:ss.
                              
                              <return>DB2_I5_SEP_COLON</return> - Se utiliza el signo de dos puntos ( : ) como
                              separador de tiempo. Esta opción es predeterminada.
                              
                              <return>DB2_I5_SEP_PERIOD</return> - Se utiliza un punto ( . ) como separador de
                              tiempo.
                              
                              <return>DB2_I5_SEP_COMMA</return> - Se utiliza una coma ( , ) como separador de tiempo.
                              
                              <return>DB2_I5_SEP_BLANK</return> - Se utiliza un espacio como separador de tiempo.
                              
                              <return>DB2_I5_SEP_JOB</return> - Se utiliza el separador de tiempo de trabajo.
                              
                              <return>DB2_I5_SEP_PERIOD</return> - Se utiliza un punto ( . ) como separador decimal.
                              Esta opción es predeterminada.
                              
                              <return>DB2_I5_SEP_COMMA</return> - Se utiliza una coma ( , ) como separador decimal.
                              
                              <return>DB2_I5_SEP_JOB</return> - Se utiliza el separador decimal de trabajo.
                              
                              La siguiente opción i5/OS está disponible en las versiones 1.8.0 y
                              superiores de ibm_db2.   <strong>$i5_libl</strong> Un cadena que indica la lista de
                              bibliotecas que se utilizará para resolver   referencias no evaluadas
                              a archivos. Se especifican los elementos de la lista   separados por
                              espacios 'i5_libl'=&gt;"LIBRERIA1 LIBRERIA2 LIBRERIA3".   i5_libl
                              llama a qsys2/qcmdexc('cmd',cmdlen), que sólo está disponible en
                              i5/OS V5R4 y versiones superiores.
                              
                              Un cadena que indica la lista de bibliotecas que se utilizará para
                              resolver   referencias no evaluadas a archivos. Se especifican los
                              elementos de la lista   separados por espacios
                              'i5_libl'=&gt;"LIBRERIA1 LIBRERIA2 LIBRERIA3".   i5_libl llama a
                              qsys2/qcmdexc('cmd',cmdlen), que sólo está disponible en   i5/OS V5R4
                              y versiones superiores.
                              
                              i5_libl llama a qsys2/qcmdexc('cmd',cmdlen), que sólo está disponible
                              en   i5/OS V5R4 y versiones superiores.
  <info></info>        <strong>$autocommit</strong>         Si se pasa el valor  <return>DB2_AUTOCOMMIT_ON</return> se   confirmarán
                              automáticamente las transacciones de la conexión.
                              
                              Si se pasa el valor <return>DB2_AUTOCOMMIT_OFF</return> no se  confirmarán
                              automáticamente las transacciones de la conexión.
  <info></info>        <strong>$DB2_ATTR_CASE</strong>      Si se pasa el valor <return>DB2_CASE_NATURAL</return> los nombres  de las columnas
                              serán devueltos con sus mayúsculas y minúsculas originales.
                              
                              Si se pasa el valor <return>DB2_CASE_LOWER</return> los nombres  de las columnas serán
                              devueltos en minúsculas.
                              
                              Si se pasa el valor <return>DB2_CASE_UPPER</return> los nombres  de las columnas serán
                              devueltos en mayúsculas.
  <info></info>        <strong>$CURSOR</strong>             Si se pasa el valor <return>DB2_FORWARD_ONLY</return> se establece  un cursor de
                              no-recorrido (sólo hacia adelante). Este cursor es predeterminado  y
                              soportado por todos los servidores de base de datos.
                              
                              Si se pasa el valor <return>DB2_SCROLLABLE</return> se establece  un cursor de
                              recorrido. Con este modo es posible acceder de manera  aleatoria a las
                              filas del resultado pero actualmente sólo es soportado  por IBM DB2
                              Universal Database.
  <info></info>        <strong>$trustedcontext</strong>     Si se pasa el valor DB2_TRUSTED_CONTEXT_ENABLE se establece una
                              conexión  de confianza. Este parámetro no puede ser establecido
                              mediante   <strong>db2_set_option()</strong>.
                              
                              Esta clave solo funciona si la base de datos está catalogada (aún
                              cuando   la base de datos sea local), o si se especifica un DSN
                              completo cuando se    crea la conexión.
                              
                              Para catalogar la base de datos se usan los siguientes comandos:
                              
                              db2 catalog tcpip node loopback remote \<SERVERNAME&gt; server \<SERVICENAME&gt;
                              db2 catalog database \<LOCALDBNAME&gt; as \<REMOTEDBNAME&gt; at node loopback
                              db2 "update dbm cfg using svcename \<SERVICENAME&gt;"
                              db2set DB2COMM=TCPIP
  <info></info>        <strong>$i5_lib</strong>             Una cadena que indica la lista de bibliotecas que se utilizará por
                              default para resolver  referencias no evaluadas a archivos. Este
                              parámetro no es válido   si en la conexión se utiliza el modo de
                              nombrado de sistema.
  <info></info>        <strong>$i5_naming</strong>          <return>DB2_I5_NAMING_ON</return> habilita el modo de nombrado de sistema DB2 UDB CLI
                              iSeries. Los archivos son evaluados utilizando una diagonal (/) como
                              delimitador.  Los archivos que no pueden ser evaluados son resueltos
                              utilizando la lista de bibliotecas.
                              
                              <return>DB2_I5_NAMING_OFF</return> esta valor predeterminado habilita el modo de
                              nombrado DB2 UDB CLI,   que es el sistema de nombrado de SQL. Los
                              archivos son evaluados utilizando un punto (.)  como delimitador. Los
                              archivos que no se pueden evaluar son resueltos utilizando tanto la
                              biblioteca predeterminada  como el identificador del usuario actual.
  <info></info>        <strong>$i5_commit</strong>          Se recomienda establecer el parámetro <strong>$i5_commit</strong> antes que
                              <strong>db2_pconnect()</strong>. Si el valor es modificado después de que la conexión
                              ha   sido establecida y la conexión es hacia una fuente remota, el
                              cambio no tendrá efecto hasta la siguiente llamada exitosa a
                              <strong>db2_pconnect()</strong> para el manejo de conexión.  El parámetro
                              <strong>$ibm_db2.i5_allow_commit</strong>==0 en php.ini o  <return>DB2_I5_TXN_NO_COMMIT</return> son
                              opciones predeterminadas pero pueden ser remplazadas   con la opción
                              <strong>$i5_commit</strong>.
                              
                              El parámetro <strong>$ibm_db2.i5_allow_commit</strong>==0 en php.ini o
                              <return>DB2_I5_TXN_NO_COMMIT</return> son opciones predeterminadas pero pueden ser
                              remplazadas   con la opción <strong>$i5_commit</strong>.
                              
                              <return>DB2_I5_TXN_NO_COMMIT</return> - No se utiliza ningún control de transacciones.
                              
                              <return>DB2_I5_TXN_READ_UNCOMMITTED</return> - Se permiten lecturas sucias, lecturas no
                              repetibles,   y lecturas fantasma.
                              
                              <return>DB2_I5_TXN_READ_COMMITTED</return> - No se permiten lecturas sucias. Se
                              permiten   lecturas no repetibles y lecturas fantasma.
                              
                              <return>DB2_I5_TXN_REPEATABLE_READ</return> - No se permiten lecturas sucias ni
                              lecturas   no repetibles. Se permiten lecturas fantasma.
                              
                              <return>DB2_I5_TXN_SERIALIZABLE</return> - Las transacciones son serializables.  No se
                              permiten lecturas sucias, lecturas no repetibles ni lecturas fantasma.
  <info></info>        <strong>$i5_query_optimize</strong>  <return>DB2_FIRST_IO</return> - Todas las consultas son optimazadas con el objetivo de
                              devolver la primera página de resultados lo más rápido posible. Esta
                              opción se recomienda cuando el resultado     es controlado por un
                              usuario que puede cancelar la consulta después de   visualizar la
                              primera página de resultados. Esta funcionalidad también se puede
                              lograr utilizando OPTIMIZE FOR nnn ROWS  en una consulta.
                              
                              <return>DB2_ALL_IO</return> - Todas las consultas son optimizadas con el objetivo de
                              ejecutar   la consulta completa en el menor tiempo posible. Esta
                              opción predeterminada se recomienda cuando el resultado de  una
                              consulta es escrito en un archivo o reporte. Esta funcionalidad
                              tambien se puede lograr utilizando OPTIMIZE FOR nnn ROWS  en una
                              consulta.
  <info></info>        <strong>$i5_dbcs_alloc</strong>      <return>DB2_I5_DBCS_ALLOC_ON</return> habilita el esquema de alojamiento DB2 6X para
                              incremento de tamaño en columnas de traducción DBCS.
                              
                              <return>DB2_I5_DBCS_ALLOC_OFF</return> deshabilita el esquema de alojamiento DB2 6X
                              para   incremento de tamaño en columnas de traducción DBCS.   El
                              parámetro <strong>$ibm_db2.i5_dbcs_alloc</strong>==0 en php.ini o
                              <return>DB2_I5_DBCS_ALLOC_OFF</return> son opciones predeterminadas pero pueden ser
                              remplazadas con   la opción <strong>$i5_dbcs_alloc</strong>.
                              
                              El parámetro <strong>$ibm_db2.i5_dbcs_alloc</strong>==0 en php.ini o
                              <return>DB2_I5_DBCS_ALLOC_OFF</return> son opciones predeterminadas pero pueden ser
                              remplazadas con   la opción <strong>$i5_dbcs_alloc</strong>.
  <info></info>        <strong>$i5_date_fmt</strong>        <return>DB2_I5_FMT_ISO</return> - Se utiliza el formato de fechas estandar (ISO)
                              yyyy-mm-dd.  Esta opción es predeterminada.
                              
                              <return>DB2_I5_FMT_USA</return> - Se utiliza el formato de fechas de Estados Unidos
                              mm/dd/yyyy.
                              
                              <return>DB2_I5_FMT_EUR</return> - Se utiliza el formato de fechas Europeo dd.mm.yyyy.
                              
                              <return>DB2_I5_FMT_JIS</return> - Se utiliza el formato de fechas Japonés yyyy-mm-dd.
                              
                              <return>DB2_I5_FMT_MDY</return> - Se utiliza el formato de fechas mm/dd/yyyy.
                              
                              <return>DB2_I5_FMT_DMY</return> - Se utiliza el formato de fechas dd/mm/yyyy.
                              
                              <return>DB2_I5_FMT_YMD</return> - Se utiliza el formato de fechas yy/mm/dd.
                              
                              <return>DB2_I5_FMT_JUL</return> - Se utiliza el formato de fechas Juliano yy/ddd.
                              
                              <return>DB2_I5_FMT_JOB</return> - El formato de trabajo es utilizado.
  <info></info>        <strong>$i5_date_sep</strong>        <return>DB2_I5_SEP_SLASH</return> - Se utiliza una diagonal ( / ) como separador de
                              fechas.  Esta opción es predeterminada.
                              
                              <return>DB2_I5_SEP_DASH</return> - Se utiliza un guión medio ( - ) como separador de
                              fechas.
                              
                              <return>DB2_I5_SEP_PERIOD</return> - Se utiliza un punto ( . ) como separador de
                              fechas.
                              
                              <return>DB2_I5_SEP_COMMA</return> - Se utiliza una coma ( , ) como separador de fechas.
                              
                              <return>DB2_I5_SEP_BLANK</return> - Se utiliza un espacio como separador de fechas.
                              
                              <return>DB2_I5_SEP_JOB</return> - Se utiliza el separador de fechas de trabajo.
  <info></info>        <strong>$i5_time_fmt</strong>        <return>DB2_I5_FMT_ISO</return> - Se utiliza el formato de tiempo estandar (ISO)
                              hh.mm.ss.  Esta opción es predeterminada.
                              
                              <return>DB2_I5_FMT_USA</return> - Se utiliza el formato de tiempo de Estados Unidos
                              hh:mmxx, donde xx es AM o PM.
                              
                              <return>DB2_I5_FMT_EUR</return> - Se utiliza el formato de tiempo Europeo hh.mm.ss.
                              
                              <return>DB2_I5_FMT_JIS</return> - Se utiliza el formato de tiempo Japonés hh:mm:ss.
                              
                              <return>DB2_I5_FMT_HMS</return> - Se utiliza el formato de tiempo hh:mm:ss.
  <info></info>        <strong>$i5_time_sep</strong>        <return>DB2_I5_SEP_COLON</return> - Se utiliza el signo de dos puntos ( : ) como
                              separador de tiempo. Esta opción es predeterminada.
                              
                              <return>DB2_I5_SEP_PERIOD</return> - Se utiliza un punto ( . ) como separador de
                              tiempo.
                              
                              <return>DB2_I5_SEP_COMMA</return> - Se utiliza una coma ( , ) como separador de tiempo.
                              
                              <return>DB2_I5_SEP_BLANK</return> - Se utiliza un espacio como separador de tiempo.
                              
                              <return>DB2_I5_SEP_JOB</return> - Se utiliza el separador de tiempo de trabajo.
  <info></info>        <strong>$i5_decimal_sep</strong>     <return>DB2_I5_SEP_PERIOD</return> - Se utiliza un punto ( . ) como separador decimal.
                              Esta opción es predeterminada.
                              
                              <return>DB2_I5_SEP_COMMA</return> - Se utiliza una coma ( , ) como separador decimal.
                              
                              <return>DB2_I5_SEP_JOB</return> - Se utiliza el separador decimal de trabajo.
  <info></info>        <strong>$i5_libl</strong>            Un cadena que indica la lista de bibliotecas que se utilizará para
                              resolver   referencias no evaluadas a archivos. Se especifican los
                              elementos de la lista   separados por espacios
                              'i5_libl'=&gt;"LIBRERIA1 LIBRERIA2 LIBRERIA3".   i5_libl llama a
                              qsys2/qcmdexc('cmd',cmdlen), que sólo está disponible en   i5/OS V5R4
                              y versiones superiores.
                              
                              i5_libl llama a qsys2/qcmdexc('cmd',cmdlen), que sólo está disponible
                              en   i5/OS V5R4 y versiones superiores.

<comment>Return:</comment>
  <info>resource</info>  Devuelve un recurso de conexión si el intento de conexión es exitoso.  <strong>db2_pconnect()</strong>
            intenta reutilizar recursos de conexión existentes que coinciden  exactamente con los
            parámetros <strong>$database</strong>, <strong>$username</strong>, y  <strong>$password</strong>. Si el intento de conexión falla
            <strong>db2_pconnect()</strong> devuelve <info>false</info>.

<comment>See Also:</comment>
   * <strong>db2_connect()</strong>


id: db2_prepare
type: function
doc:
<comment>Description:</comment>
  Prepara un comando SQL para su ejecución
    
  
  <strong>db2_prepare()</strong> Crea un comando SQL preparado que puede incluir 0 o más marcadores de parámetro (con
  el carácter <return>?</return>) los cuales representan parámetros de entrada, salida o entrada/salida. Se pueden
  pasar parámetros al comando SQL preparado usando <strong>db2_bind_param()</strong>, o sólo para valores de entrada,
  como un arreglo enviado a <strong>db2_execute()</strong>.
  
  Hay tres ventajas principales al usar comandos SQL preparados en una aplicación: Rendimiento:
  Cuando se prepara un comando SQL, el servidor  de base de datos crea un plan de acceso optimizado
  para devolver datos con ese comando SQL.   Posteriormente al enviar el comando SQL preparado a
  través de <strong>db2_execute()</strong> se podrá reutilizar el plan de acceso y así se evitará  la sobrecarga que
  se produce cuando éste debe crearse nuevamente. Seguridad: Cuando se prepara un comando SQL, se
  pueden incluir marcadores de parámetros para valores de entrada.   Cuando se ejecuta ese comando
  usando los marcadores con valores de entrada, la base de datos puede chequear cada  valor de
  entrada para asegurar que el tipo de dato enviado coincide con la definición del campo o del
  parámetro. Funcionalidad avanzada: Los marcadores de parámetros no solo permiten pasar valores de
  entrada, además permiten obtener datos OUT e INOUT desde procedimientos almacenados usando
  <strong>db2_bind_param()</strong>.
  
  Rendimiento: Cuando se prepara un comando SQL, el servidor  de base de datos crea un plan de
  acceso optimizado para devolver datos con ese comando SQL.   Posteriormente al enviar el comando
  SQL preparado a través de <strong>db2_execute()</strong> se podrá reutilizar el plan de acceso y así se evitará  la
  sobrecarga que se produce cuando éste debe crearse nuevamente.
  
  Seguridad: Cuando se prepara un comando SQL, se pueden incluir marcadores de parámetros para
  valores de entrada.   Cuando se ejecuta ese comando usando los marcadores con valores de entrada,
  la base de datos puede chequear cada  valor de entrada para asegurar que el tipo de dato enviado
  coincide con la definición del campo o del parámetro.
  
  Funcionalidad avanzada: Los marcadores de parámetros no solo permiten pasar valores de entrada,
  además permiten obtener datos OUT e INOUT desde procedimientos almacenados usando
  <strong>db2_bind_param()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$connection</strong>  Una variable de conexión obtenida con <strong>db2_connect()</strong> o con <strong>db2_pconnect()</strong>.
  <info>string</info>    <strong>$statement</strong>   Un comando SQL, que puede contener opcionalmente uno o más marcadores de
                         parámetros.
  <info>array</info>     <strong>$options</strong>     Un arreglo asociativo que contiene opciones para el comando.  Se puede usar
                         para solicitar un cursor desplazable en servidores que lo permitan.
                         
                         Se pueden revisar las opciones en <strong>db2_set_option()</strong>.

<comment>Return:</comment>
  <info>resource</info>  Si el comando SQL fue parseado y preparado exitosamente devuelve un <info>resource</info>, o <info>false</info> en
            caso de producirse un error.   Se puede determinar qué error ocurrió utilizando
            <strong>db2_stmt_error()</strong> o <strong>db2_stmt_errormsg()</strong>.

<comment>See Also:</comment>
   * <strong>db2_bind_param()</strong>
   * <strong>db2_execute()</strong>
   * <strong>db2_stmt_error()</strong>
   * <strong>db2_stmt_errormsg()</strong>


id: db2_primary_keys
type: function
doc:
<comment>Description:</comment>
  Devolver un resultado con las llaves primarias de una tabla
    
  
  Devuelve un resultado con las llaves primarias de una tabla.

<comment>Param:</comment>
  <info>resource</info>  <strong>$connection</strong>  Una conexión válida a la base de datos IBM DB2, Cloudscape, o Apache Derby.
  <info>string</info>    <strong>$qualifier</strong>   Un índice para bases de datos DB2 ejecutándose en servidores OS/390 o z/OS.
                         Para  otras bases de datos se debe pasar <info>null</info> o una cadena vacía.
  <info>string</info>    <strong>$schema</strong>      El esquema que contiene las tablas. Si <strong>$schema</strong> es <info>null</info>, <strong>db2_primary_keys()</strong>
                         revisa el esquema de la conexión  actual.
  <info>string</info>    <strong>$table-name</strong>  El nombre de la tabla.

<comment>Return:</comment>
  <info>resource</info>  Devuelve un recurso de sentencia con el resultado que contiene las llaves primarias  de
            la tabla especificada. El resultado se compone de las siguientes columnas:
            ColumnaDescripciónTABLE_CAT Nombre del catálogo de la tabla que contiene la llave
            primaria. Este  valor es nulo si la tabla no tiene catálogos. TABLE_SCHEM Nombre del
            esquema de la tabla que contiene la llave primaria. TABLE_NAMENombre de la tabla que
            contiene la llave primaria.COLUMN_NAMENombre de la columna que contiene la llave
            primaria.KEY_SEQPosición (indexada a partir de uno) de la columna en la llave
            primaria.PK_NAMENombre de la llave primaria.

<comment>See Also:</comment>
   * <strong>db2_column_privileges()</strong>
   * <strong>db2_columns()</strong>
   * <strong>db2_foreign_keys()</strong>
   * <strong>db2_procedure_columns()</strong>
   * <strong>db2_procedures()</strong>
   * <strong>db2_special_columns()</strong>
   * <strong>db2_statistics()</strong>
   * <strong>db2_table_privileges()</strong>
   * <strong>db2_tables()</strong>


id: db2_procedure_columns
type: function
doc:
<comment>Description:</comment>
  Devolver un resultado con los parámetros de los procedimientos almacenados
    
  
  Devuelve un resultado con los parámetros de uno o más procedimientos almacenados.

<comment>Param:</comment>
  <info>resource</info>  <strong>$connection</strong>  Una conexión válida a una base de datos IBM DB2, Cloudscape, o Apache
                         Derby.
  <info>string</info>    <strong>$qualifier</strong>   Un calificador para bases de datos ejecutándose en servidores OS/390 o
                         z/OS. Para otras  bases de datos se debe pasar <info>null</info> o una cadena vacia.
  <info>string</info>    <strong>$schema</strong>      El esquema que contiene los procedimientos. Este perámetro acepta las
                         etiquetas <return>_</return> y <return>%</return> para búsquedas de cadena.
  <info>string</info>    <strong>$procedure</strong>   El nombre del procedimiento. Este parámetro acepta las etiquetas  <return>_</return> y <return>%</return>
                         para búsquedas de cadena.
  <info>string</info>    <strong>$parameter</strong>   El nombre del parámetro. Este parámetro acepta las etiquetas  <return>_</return> y <return>%</return> para
                         búsquedas de cadena. Si el parámetro es <info>null</info>, todos los parámetros para el
                         procedimiento almacenado  serán devueltos.

<comment>Return:</comment>
  <info>resource</info>  Devuelve un recurso de sentencia con un bloque de resultados que contienen los
            parámetros de los procedimientos almacenados que coinciden con los criterios de
            búsqueda. Las filas devueltas se componen de las siguientes columnas:
            ColumnaDescripciónPROCEDURE_CATEl catálogo que contiene el procedimiento. El valor es
            <info>null</info> si  esta tabla no tiene catálogos.PROCEDURE_SCHEMNombre del esquema que contiene el
            procedimiento almacenado.PROCEDURE_NAMENombre del procedimiento.COLUMN_NAMENombre del
            parámetro.COLUMN_TYPE Un valor entero que representa el tipo de parámetro: Valor
            devueltoTipo de parámetro1 (SQL_PARAM_INPUT)Parámetro de entrada (IN).2
            (SQL_PARAM_INPUT_OUTPUT)Parámetro de entrada/salida (INOUT).3
            (SQL_PARAM_OUTPUT)Parámetro de salida (OUT). DATA_TYPEEl tipo de dato SQL para el
            parámetro representado como un valor entero.TYPE_NAMEEl tipo de dato SQL para el
            parámetro en forma de cadena.COLUMN_SIZEUn valor entero que representa el tamaño del
            parámetro.BUFFER_LENGTH Número máximo de bytes necesarios para almacenar información del
            parámetro. DECIMAL_DIGITS La escala del parámetro o <info>null</info> si la escala no es aplicable.
            NUM_PREC_RADIX Un valor entero de <return>10</return> (que representa un tipo de dato numérico exacto),
            <return>2</return> (que representa un tipo de dato número aproximado), o <info>null</info> (que representa  un tipo de
            dato sin base aplicable). NULLABLEUn valor entero que representa si un parámetro puede
            ser nulo o no.REMARKSDescripción del parámetro.COLUMN_DEFValor predeterminado del
            parámetro.SQL_DATA_TYPEUn valor entero que representa el tamaño del
            parámetro.SQL_DATETIME_SUB Devuelve un valor entero que representa el código de un
            subtipo de dato fecha, o <info>null</info> para tipos de dato SQL donde esto no aplica.
            CHAR_OCTET_LENGTH Longitud máxima en octetos para parámetros con tipo de dato caracter,
            en cual  coincide con COLUMN_SIZE para datos de caracter de un solo byte, o <info>null</info> para
            tipos de dato que no son caracter. ORDINAL_POSITIONLa posición (indexada a partir de
            uno) del parámetro en la sentencia.IS_NULLABLE Una cadena donde 'YES' significa que el
            parámetro acepta o devuelve valores <info>null</info> y  donde 'NO' significa que el parámetro no
            acepta o devuelve valores <info>null</info>.
            
            Un valor entero que representa el tipo de parámetro: Valor devueltoTipo de parámetro1
            (SQL_PARAM_INPUT)Parámetro de entrada (IN).2 (SQL_PARAM_INPUT_OUTPUT)Parámetro de
            entrada/salida (INOUT).3 (SQL_PARAM_OUTPUT)Parámetro de salida (OUT).

<comment>See Also:</comment>
   * <strong>db2_column_privileges()</strong>
   * <strong>db2_columns()</strong>
   * <strong>db2_foreign_keys()</strong>
   * <strong>db2_primary_keys()</strong>
   * <strong>db2_procedures()</strong>
   * <strong>db2_special_columns()</strong>
   * <strong>db2_statistics()</strong>
   * <strong>db2_table_privileges()</strong>
   * <strong>db2_tables()</strong>


id: db2_procedures
type: function
doc:
<comment>Description:</comment>
  Devolver un resultado con los procedimientos almacenados registrados en la base de datos
    
  
  Devuelve un resultado con los procedimientos almacenados registrados en una base de datos.

<comment>Param:</comment>
  <info>resource</info>  <strong>$connection</strong>  Una conexión válida a una base de datos IBM DB2, Cloudscape, o Apache
                         Derby.
  <info>string</info>    <strong>$qualifier</strong>   Un calificador para bases de datos DB2 ejecutándose sobre servidores OS/390
                         o z/OS. Para  otras bases de datos se puede pasar <info>null</info> o una cadena vacia.
  <info>string</info>    <strong>$schema</strong>      El esquema que contiene los procedimientos. Este parámetro acepta las
                         etiquetas <return>_</return> y <return>%</return> para realizar búsquedas  de cadena.
  <info>string</info>    <strong>$procedure</strong>   El nombre del procedimiento. Este parámetro acepta las  etiquetas <return>_</return> y <return>%</return>
                         para realizar búsquedas  de cadena.

<comment>Return:</comment>
  <info>resource</info>  Devuelve un recurso de sentencia con un resultado que contiene las filas que representan
            a los procedimientos almacenados que coinciden con el criterio de búsqueda. Las filas
            se componen de las siguientes columnas: ColumnaDescripciónPROCEDURE_CATEl catálogo que
            contiene el procedimiento. El valor es <info>null</info> si  la tabla no tiene
            catálogos.PROCEDURE_SCHEMNombre del esquema que contiene el procediento
            almacenado.PROCEDURE_NAMENombre del procedimiento.NUM_INPUT_PARAMSNúmero de parámetros
            de entrada (IN) para el procedimiento almacenado.NUM_OUTPUT_PARAMSNúmero de parámetros
            de salida (OUT) para el procedimiento almacenado.NUM_RESULT_SETSNúmero de resultados
            devueltos por el procedimiento almacenado.REMARKSDescripción del procedimiento
            almacenido.PROCEDURE_TYPESiempre devuelve <return>1</return>, indicando que el procedimiento  almacenado
            no devuelve un valor.

<comment>See Also:</comment>
   * <strong>db2_column_privileges()</strong>
   * <strong>db2_columns()</strong>
   * <strong>db2_foreign_keys()</strong>
   * <strong>db2_primary_keys()</strong>
   * <strong>db2_procedure_columns()</strong>
   * <strong>db2_special_columns()</strong>
   * <strong>db2_statistics()</strong>
   * <strong>db2_table_privileges()</strong>
   * <strong>db2_tables()</strong>


id: db2_result
type: function
doc:
<comment>Description:</comment>
  Devolver una columna específica del resultado
    
  
  <strong>db2_result()</strong> devuelve el valor de una columna especificada  en la fila actual del resultado. Se
  debe llamar primero a  <strong>db2_fetch_row()</strong> antes de  <strong>db2_result()</strong> para establecer el apuntador del
  resultado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stmt</strong>    Un recurso <return>stmt</return> válido.
  <info>mixed</info>     <strong>$column</strong>  Tanto un entero que representa el campo del resultado (indexado a partir de
                     cero) como  una cadena con el nombre de la columna.

<comment>Return:</comment>
  <info>mixed</info>  Devuelve el valor del campo solicitado si el campo existe en el resultado.  Devuelve NULL y
         lanza una advertencia si el campo no existe.

<comment>See Also:</comment>
   * <strong>db2_fetch_array()</strong>
   * <strong>db2_fetch_assoc()</strong>
   * <strong>db2_fetch_both()</strong>
   * <strong>db2_fetch_object()</strong>
   * <strong>db2_fetch_row()</strong>


id: db2_rollback
type: function
doc:
<comment>Description:</comment>
  Cancelar una transacción
    
  
  Cancela una transacción en progreso en el recurso de conexión especificado y comienza una nueva
  transacción. Comunmente las aplicaciones de PHP confirman las  transacciones de manera automática
  por lo que la función <strong>db2_rollback()</strong>  no tendría efecto a menos que este modo haya sido
  desactivado para este recurso.

<comment>Param:</comment>
  <info>resource</info>  <strong>$connection</strong>  Un recurso de conexión válido devuelto por  <strong>db2_connect()</strong> o <strong>db2_pconnect()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>db2_autocommit()</strong>
   * <strong>db2_commit()</strong>


id: db2_server_info
type: function
doc:
<comment>Description:</comment>
  Returns an object with properties that describe the DB2 database server
  
  This function returns an object with read-only properties that return information about the IBM
  DB2, Cloudscape, or Apache Derby database server. The following table lists the database server
  properties: Database server propertiesProperty nameReturn typeDescriptionDBMS_NAMEstringThe name
  of the database server to which you are connected. For DB2 servers this is a combination of <return>DB2</return>
  followed by the operating system on which the database server is running.DBMS_VERstringThe version
  of the database server, in the form of a string "MM.mm.uuuu" where MM is the major version,  mm is
  the minor version, and uuuu is the update. For example, "08.02.0001" represents major version 8,
  minor version 2, update 1. DB_CODEPAGEintThe code page of the database to which you are
  connected.DB_NAMEstringThe name of the database to which you are connected.DFT_ISOLATIONstringThe
  default transaction isolation level supported by the server: UR Uncommitted read: changes are
  immediately visible by all concurrent transactions. CS Cursor stability: a row read by one
  transaction can be altered and committed by a second concurrent transaction. RS Read stability: a
  transaction can add or remove rows matching a search condition or a pending transaction. RR
  Repeatable read: data affected by pending transaction is not available to other transactions. NC
  No commit: any changes are visible at the end of a successful operation. Explicit commits and
  rollbacks are not allowed.  IDENTIFIER_QUOTE_CHARstringThe character used to delimit an
  identifier.INST_NAMEstringThe instance on the database server that contains the
  database.ISOLATION_OPTIONarrayAn array of the isolation options supported by the database server.
  The isolation options are described in the DFT_ISOLATION property.KEYWORDSarrayAn array of the
  keywords reserved by the database server.LIKE_ESCAPE_CLAUSEbool<info>true</info> if the database server
  supports the use of <return>%</return> and <return>_</return> wildcard characters. <info>false</info> if the database server does not support
  these wildcard characters.MAX_COL_NAME_LENintMaximum length of a column name supported by the
  database server, expressed in bytes.MAX_IDENTIFIER_LENintMaximum length of an SQL identifier
  supported by the database server, expressed in characters.MAX_INDEX_SIZEintMaximum size of columns
  combined in an index supported by the database server, expressed in
  bytes.MAX_PROC_NAME_LENintMaximum length of a procedure name supported by the database server,
  expressed in bytes.MAX_ROW_SIZEintMaximum length of a row in a base table supported by the
  database server, expressed in bytes.MAX_SCHEMA_NAME_LENintMaximum length of a schema name
  supported by the database server, expressed in bytes.MAX_STATEMENT_LENintMaximum length of an SQL
  statement supported by the database server, expressed in bytes.MAX_TABLE_NAME_LENintMaximum length
  of a table name supported by the database server, expressed in bytes.NON_NULLABLE_COLUMNSbool<info>true</info>
  if the database server supports columns that can be defined as NOT NULL, <info>false</info> if the database
  server does not support columns defined as NOT NULL.PROCEDURESbool<info>true</info> if the database server
  supports the use of the CALL statement to call stored procedures, <info>false</info> if the database server
  does not support the CALL statement.SPECIAL_CHARSstringA string containing all of the characters
  other than a-Z, 0-9, and underscore that can be used in an identifier
  name.SQL_CONFORMANCEstringThe level of conformance to the ANSI/ISO SQL-92 specification offered by
  the database server: ENTRY Entry-level SQL-92 compliance. FIPS127 FIPS-127-2 transitional
  compliance. FULL Full level SQL-92 compliance. INTERMEDIATE Intermediate level SQL-92 compliance.
  
  The default transaction isolation level supported by the server: UR Uncommitted read: changes are
  immediately visible by all concurrent transactions. CS Cursor stability: a row read by one
  transaction can be altered and committed by a second concurrent transaction. RS Read stability: a
  transaction can add or remove rows matching a search condition or a pending transaction. RR
  Repeatable read: data affected by pending transaction is not available to other transactions. NC
  No commit: any changes are visible at the end of a successful operation. Explicit commits and
  rollbacks are not allowed.
  
  Uncommitted read: changes are immediately visible by all concurrent transactions.
  
  Cursor stability: a row read by one transaction can be altered and committed by a second
  concurrent transaction.
  
  Read stability: a transaction can add or remove rows matching a search condition or a pending
  transaction.
  
  Repeatable read: data affected by pending transaction is not available to other transactions.
  
  No commit: any changes are visible at the end of a successful operation. Explicit commits and
  rollbacks are not allowed.
  
  The level of conformance to the ANSI/ISO SQL-92 specification offered by the database server:
  ENTRY Entry-level SQL-92 compliance. FIPS127 FIPS-127-2 transitional compliance. FULL Full level
  SQL-92 compliance. INTERMEDIATE Intermediate level SQL-92 compliance.
  
  Entry-level SQL-92 compliance.
  
  FIPS-127-2 transitional compliance.
  
  Full level SQL-92 compliance.
  
  Intermediate level SQL-92 compliance.

<comment>Param:</comment>
  <info>resource</info>  <strong>$connection</strong>  Specifies an active DB2 client connection.

<comment>Return:</comment>
  <info>stdClass|false</info>  Returns an object on a successful call, o <info>false</info> en caso de error

<comment>See Also:</comment>
   * <strong>db2_client_info()</strong>


id: db2_set_option
type: function
doc:
<comment>Description:</comment>
  Set options for connection or statement resources
  
  Sets options for a statement resource or a connection resource. You cannot set options for result
  set resources.

<comment>Param:</comment>
  <info>resource</info>  <strong>$resource</strong>          A valid statement resource as returned from <strong>db2_prepare()</strong> or a valid
                               connection resource as returned from <strong>db2_connect()</strong> or <strong>db2_pconnect()</strong>.
  <info>array</info>     <strong>$options</strong>           An associative array containing valid statement or connection
                               options. This parameter can be used to change autocommit values,
                               cursor types (scrollable or forward), and to specify the case of the
                               column names (lower, upper, or natural) that will appear in a result
                               set. <strong>$autocommit</strong> Passing <return>DB2_AUTOCOMMIT_ON</return> turns autocommit on for
                               the specified connection resource.  Passing <return>DB2_AUTOCOMMIT_OFF</return> turns
                               autocommit off for the specified connection resource. <strong>$cursor</strong> Passing
                               <return>DB2_FORWARD_ONLY</return> specifies a forward-only cursor for a statement
                               resource. This is the default cursor type, and is supported by all
                               database servers.  Passing <return>DB2_SCROLLABLE</return> specifies a scrollable
                               cursor for a statement resource. Scrollable cursors enable result set
                               rows to be accessed in non-sequential order, but are only supported
                               by IBM DB2 Universal Database databases. <strong>$binmode</strong> Passing <return>DB2_BINARY</return>
                               specifies that binary data will be returned as is. This is the
                               default mode. This is the equivalent of setting <return>ibm_db2.binmode=1</return> in
                               php.ini.  Passing <return>DB2_CONVERT</return> specifies that binary data will be
                               converted to hexadecimal encoding, and will be returned as such. This
                               is the equivalent of setting <return>ibm_db2.binmode=2</return> in php.ini.  Passing
                               <return>DB2_PASSTHRU</return> specifies that binary data will be converted to <info>null</info>.
                               This is the equivalent of setting <return>ibm_db2.binmode=3</return> in php.ini.
                               <strong>$db2_attr_case</strong> Passing <return>DB2_CASE_LOWER</return> specifies that column names of
                               the result set are returned in lower case.  Passing <return>DB2_CASE_UPPER</return>
                               specifies that column names of the result set are returned in upper
                               case.  Passing <return>DB2_CASE_NATURAL</return> specifies that column names of the
                               result set are returned in natural case. <strong>$deferred_prepare</strong> Passing
                               <return>DB2_DEFERRED_PREPARE_ON</return> turns deferred  prepare on for the specified
                               statement resource.  Passing <return>DB2_DEFERRED_PREPARE_OFF</return> turns deferred
                               prepare off for the specified statement resource.
                               
                               Passing <return>DB2_AUTOCOMMIT_ON</return> turns autocommit on for the specified
                               connection resource.
                               
                               Passing <return>DB2_AUTOCOMMIT_OFF</return> turns autocommit off for the specified
                               connection resource.
                               
                               Passing <return>DB2_FORWARD_ONLY</return> specifies a forward-only cursor for a
                               statement resource. This is the default cursor type, and is supported
                               by all database servers.
                               
                               Passing <return>DB2_SCROLLABLE</return> specifies a scrollable cursor for a statement
                               resource. Scrollable cursors enable result set rows to be accessed in
                               non-sequential order, but are only supported by IBM DB2 Universal
                               Database databases.
                               
                               Passing <return>DB2_BINARY</return> specifies that binary data will be returned as is.
                               This is the default mode. This is the equivalent of setting
                               <return>ibm_db2.binmode=1</return> in php.ini.
                               
                               Passing <return>DB2_CONVERT</return> specifies that binary data will be converted to
                               hexadecimal encoding, and will be returned as such. This is the
                               equivalent of setting <return>ibm_db2.binmode=2</return> in php.ini.
                               
                               Passing <return>DB2_PASSTHRU</return> specifies that binary data will be converted to
                               <info>null</info>. This is the equivalent of setting <return>ibm_db2.binmode=3</return> in php.ini.
                               
                               Passing <return>DB2_CASE_LOWER</return> specifies that column names of the result set
                               are returned in lower case.
                               
                               Passing <return>DB2_CASE_UPPER</return> specifies that column names of the result set
                               are returned in upper case.
                               
                               Passing <return>DB2_CASE_NATURAL</return> specifies that column names of the result
                               set are returned in natural case.
                               
                               Passing <return>DB2_DEFERRED_PREPARE_ON</return> turns deferred  prepare on for the
                               specified statement resource.
                               
                               Passing <return>DB2_DEFERRED_PREPARE_OFF</return> turns deferred  prepare off for the
                               specified statement resource.
                               
                               The following new i5/OS options are available in ibm_db2 version
                               1.5.1  and later. These options apply only when running PHP and
                               ibm_db2 natively on i5 systems. <strong>$i5_fetch_only</strong><return>DB2_I5_FETCH_ON</return> -
                               Cursors are read-only  and cannot be used for positioned updates or
                               deletes. This  is the default unless <return>SQL_ATTR_FOR_FETCH_ONLY</return>
                               environment has been set to <return>SQL_FALSE</return>. <return>DB2_I5_FETCH_OFF</return> - Cursors can
                               be used  for positioned updates and deletes.
                               
                               <return>DB2_I5_FETCH_ON</return> - Cursors are read-only  and cannot be used for
                               positioned updates or deletes. This  is the default unless
                               <return>SQL_ATTR_FOR_FETCH_ONLY</return>  environment has been set to <return>SQL_FALSE</return>.
                               
                               <return>DB2_I5_FETCH_OFF</return> - Cursors can be used  for positioned updates and
                               deletes.
                               
                               The following new option is available in ibm_db2 version 1.8.0 and
                               later. <strong>$rowcount</strong><return>DB2_ROWCOUNT_PREFETCH_ON</return> - Client can request  the
                               full row count prior to fetching, which means that  <strong>db2_num_rows()</strong>
                               returns the number of rows selected  even when a <return>ROLLFORWARD_ONLY</return>
                               cursor is used. <return>DB2_ROWCOUNT_PREFETCH_OFF</return> - Client cannot request the
                               full row count prior to fetching.
                               
                               <return>DB2_ROWCOUNT_PREFETCH_ON</return> - Client can request  the full row count
                               prior to fetching, which means that  <strong>db2_num_rows()</strong> returns the
                               number of rows selected  even when a <return>ROLLFORWARD_ONLY</return> cursor is used.
                               
                               <return>DB2_ROWCOUNT_PREFETCH_OFF</return> - Client cannot request the full row count
                               prior to fetching.
                               
                               The following new options are available in ibm_db2 version 1.7.0 and
                               later. <strong>$trusted_user</strong> To switch the user to a trusted user, pass the
                               User ID (String)  of the trusted user as the value of this key. This
                               option can  be set on a connection resource only. To use this option,
                               trusted context must be enabled on the connection resource.
                               <strong>$trusted_password</strong> The password (String) that corresponds to the user
                               specified by the trusted_user key.
                               
                               To switch the user to a trusted user, pass the User ID (String)  of
                               the trusted user as the value of this key. This option can  be set on
                               a connection resource only. To use this option, trusted context must
                               be enabled on the connection resource.
                               
                               The password (String) that corresponds to the user specified by the
                               trusted_user key.
                               
                               The following new options are available in ibm_db2 version 1.6.0 and
                               later.  These options provide useful tracking information that can be
                               accessed during  execution with <strong>db2_get_option()</strong>.  When the value in
                               each option is being set, some servers might not handle  the entire
                               length provided and might truncate the value.  To ensure that the
                               data specified in each option is converted correctly  when
                               transmitted to a host system, use only the characters A through Z,  0
                               through 9, and the underscore (_) or period (.).
                               <strong>$userid</strong><return>SQL_ATTR_INFO_USERID</return> - A pointer to a null-terminated
                               character string used to identify the client user ID sent to the host
                               database server when using DB2 Connect.  DB2 for z/OS and OS/390
                               servers support up to a length of 16 characters.  This user-id is not
                               to be confused with the authentication user-id, it is for
                               identification purposes only and is not used for any authorization.
                               <strong>$acctstr</strong><return>SQL_ATTR_INFO_ACCTSTR</return> - A pointer to a null-terminated
                               character string used to identify the client accounting string sent
                               to the  host database server when using DB2 Connect.  DB2 for z/OS
                               and OS/390 servers support up to a length of 200 characters.
                               <strong>$applname</strong><return>SQL_ATTR_INFO_APPLNAME</return> - A pointer to a null-terminated
                               character string used to identify the client application name sent to
                               the  host database server when using DB2 Connect.  DB2 for z/OS and
                               OS/390 servers support up to a length of 32 characters.
                               <strong>$wrkstnname</strong><return>SQL_ATTR_INFO_WRKSTNNAME</return> - A pointer to a null-terminated
                               character string used to identify the client workstation name sent to
                               the  host database server when using DB2 Connect.  DB2 for z/OS and
                               OS/390 servers support up to a length of 18 characters.
                               
                               When the value in each option is being set, some servers might not
                               handle  the entire length provided and might truncate the value.
                               
                               To ensure that the data specified in each option is converted
                               correctly  when transmitted to a host system, use only the characters
                               A through Z,  0 through 9, and the underscore (_) or period (.).
                               
                               <return>SQL_ATTR_INFO_USERID</return> - A pointer to a null-terminated  character
                               string used to identify the client user ID sent to the host  database
                               server when using DB2 Connect.  DB2 for z/OS and OS/390 servers
                               support up to a length of 16 characters.  This user-id is not to be
                               confused with the authentication user-id, it is for  identification
                               purposes only and is not used for any authorization.
                               
                               DB2 for z/OS and OS/390 servers support up to a length of 16
                               characters.  This user-id is not to be confused with the
                               authentication user-id, it is for  identification purposes only and
                               is not used for any authorization.
                               
                               <return>SQL_ATTR_INFO_ACCTSTR</return> - A pointer to a null-terminated  character
                               string used to identify the client accounting string sent to the
                               host database server when using DB2 Connect.  DB2 for z/OS and OS/390
                               servers support up to a length of 200 characters.
                               
                               DB2 for z/OS and OS/390 servers support up to a length of 200
                               characters.
                               
                               <return>SQL_ATTR_INFO_APPLNAME</return> - A pointer to a null-terminated  character
                               string used to identify the client application name sent to the  host
                               database server when using DB2 Connect.  DB2 for z/OS and OS/390
                               servers support up to a length of 32 characters.
                               
                               DB2 for z/OS and OS/390 servers support up to a length of 32
                               characters.
                               
                               <return>SQL_ATTR_INFO_WRKSTNNAME</return> - A pointer to a null-terminated  character
                               string used to identify the client workstation name sent to the  host
                               database server when using DB2 Connect.  DB2 for z/OS and OS/390
                               servers support up to a length of 18 characters.
                               
                               DB2 for z/OS and OS/390 servers support up to a length of 18
                               characters.
  <info></info>          <strong>$autocommit</strong>        Passing <return>DB2_AUTOCOMMIT_ON</return> turns autocommit on for the specified
                               connection resource.
                               
                               Passing <return>DB2_AUTOCOMMIT_OFF</return> turns autocommit off for the specified
                               connection resource.
  <info></info>          <strong>$cursor</strong>            Passing <return>DB2_FORWARD_ONLY</return> specifies a forward-only cursor for a
                               statement resource. This is the default cursor type, and is supported
                               by all database servers.
                               
                               Passing <return>DB2_SCROLLABLE</return> specifies a scrollable cursor for a statement
                               resource. Scrollable cursors enable result set rows to be accessed in
                               non-sequential order, but are only supported by IBM DB2 Universal
                               Database databases.
  <info></info>          <strong>$binmode</strong>           Passing <return>DB2_BINARY</return> specifies that binary data will be returned as is.
                               This is the default mode. This is the equivalent of setting
                               <return>ibm_db2.binmode=1</return> in php.ini.
                               
                               Passing <return>DB2_CONVERT</return> specifies that binary data will be converted to
                               hexadecimal encoding, and will be returned as such. This is the
                               equivalent of setting <return>ibm_db2.binmode=2</return> in php.ini.
                               
                               Passing <return>DB2_PASSTHRU</return> specifies that binary data will be converted to
                               <info>null</info>. This is the equivalent of setting <return>ibm_db2.binmode=3</return> in php.ini.
  <info></info>          <strong>$db2_attr_case</strong>     Passing <return>DB2_CASE_LOWER</return> specifies that column names of the result set
                               are returned in lower case.
                               
                               Passing <return>DB2_CASE_UPPER</return> specifies that column names of the result set
                               are returned in upper case.
                               
                               Passing <return>DB2_CASE_NATURAL</return> specifies that column names of the result
                               set are returned in natural case.
  <info></info>          <strong>$deferred_prepare</strong>  Passing <return>DB2_DEFERRED_PREPARE_ON</return> turns deferred  prepare on for the
                               specified statement resource.
                               
                               Passing <return>DB2_DEFERRED_PREPARE_OFF</return> turns deferred  prepare off for the
                               specified statement resource.
  <info></info>          <strong>$i5_fetch_only</strong>     <return>DB2_I5_FETCH_ON</return> - Cursors are read-only  and cannot be used for
                               positioned updates or deletes. This  is the default unless
                               <return>SQL_ATTR_FOR_FETCH_ONLY</return>  environment has been set to <return>SQL_FALSE</return>.
                               
                               <return>DB2_I5_FETCH_OFF</return> - Cursors can be used  for positioned updates and
                               deletes.
  <info></info>          <strong>$rowcount</strong>          <return>DB2_ROWCOUNT_PREFETCH_ON</return> - Client can request  the full row count
                               prior to fetching, which means that  <strong>db2_num_rows()</strong> returns the
                               number of rows selected  even when a <return>ROLLFORWARD_ONLY</return> cursor is used.
                               
                               <return>DB2_ROWCOUNT_PREFETCH_OFF</return> - Client cannot request the full row count
                               prior to fetching.
  <info></info>          <strong>$trusted_user</strong>      To switch the user to a trusted user, pass the User ID (String)  of
                               the trusted user as the value of this key. This option can  be set on
                               a connection resource only. To use this option, trusted context must
                               be enabled on the connection resource.
  <info></info>          <strong>$trusted_password</strong>  The password (String) that corresponds to the user specified by the
                               trusted_user key.
  <info></info>          <strong>$userid</strong>            <return>SQL_ATTR_INFO_USERID</return> - A pointer to a null-terminated  character
                               string used to identify the client user ID sent to the host  database
                               server when using DB2 Connect.  DB2 for z/OS and OS/390 servers
                               support up to a length of 16 characters.  This user-id is not to be
                               confused with the authentication user-id, it is for  identification
                               purposes only and is not used for any authorization.
                               
                               DB2 for z/OS and OS/390 servers support up to a length of 16
                               characters.  This user-id is not to be confused with the
                               authentication user-id, it is for  identification purposes only and
                               is not used for any authorization.
  <info></info>          <strong>$acctstr</strong>           <return>SQL_ATTR_INFO_ACCTSTR</return> - A pointer to a null-terminated  character
                               string used to identify the client accounting string sent to the
                               host database server when using DB2 Connect.  DB2 for z/OS and OS/390
                               servers support up to a length of 200 characters.
                               
                               DB2 for z/OS and OS/390 servers support up to a length of 200
                               characters.
  <info></info>          <strong>$applname</strong>          <return>SQL_ATTR_INFO_APPLNAME</return> - A pointer to a null-terminated  character
                               string used to identify the client application name sent to the  host
                               database server when using DB2 Connect.  DB2 for z/OS and OS/390
                               servers support up to a length of 32 characters.
                               
                               DB2 for z/OS and OS/390 servers support up to a length of 32
                               characters.
  <info></info>          <strong>$wrkstnname</strong>        <return>SQL_ATTR_INFO_WRKSTNNAME</return> - A pointer to a null-terminated  character
                               string used to identify the client workstation name sent to the  host
                               database server when using DB2 Connect.  DB2 for z/OS and OS/390
                               servers support up to a length of 18 characters.
                               
                               DB2 for z/OS and OS/390 servers support up to a length of 18
                               characters.
  <info>int</info>       <strong>$type</strong>              An integer value that specifies the type of resource that was passed
                               into the function. The type of resource and this value must
                               correspond.
                               
                               Passing <return>1</return> as the value specifies that a connection resource has been
                               passed into the function.
                               
                               Passing any integer not equal to <return>1</return> as the value specifies that a
                               statement resource has been passed into the function.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>db2_connect()</strong>
   * <strong>db2_pconnect()</strong>
   * <strong>db2_exec()</strong>
   * <strong>db2_prepare()</strong>
   * <strong>db2_cursor_type()</strong>


id: db2_special_columns
type: function
doc:
<comment>Description:</comment>
  Returns a result set listing the unique row identifier columns for a table
    
  
  Returns a result set listing the unique row identifier columns for a table.

<comment>Param:</comment>
  <info>resource</info>     <strong>$connection</strong>  A valid connection to an IBM DB2, Cloudscape, or Apache Derby database.
  <info>string|null</info>  <strong>$qualifier</strong>   A qualifier for DB2 databases running on OS/390 or z/OS servers. For
                            other databases, pass <info>null</info> or an empty string.
  <info>string</info>       <strong>$schema</strong>      The schema which contains the tables.
  <info>string</info>       <strong>$table_name</strong>  The name of the table.
  <info>int</info>          <strong>$scope</strong>       Integer value representing the minimum duration for which the unique row
                            identifier is valid. This can be one of the following values: Integer
                            valueSQL constantDescription0SQL_SCOPE_CURROWRow identifier is valid
                            only while the cursor is positioned on the row.1SQL_SCOPE_TRANSACTIONRow
                            identifier is valid for the duration of the
                            transaction.2SQL_SCOPE_SESSIONRow identifier is valid for the duration
                            of the connection.

<comment>Return:</comment>
  <info>resource</info>  Returns a statement resource with a result set containing rows with unique row
            identifier information for a table. The rows are composed of the following columns:
            Column nameDescriptionSCOPEInteger valueSQL constantDescription0SQL_SCOPE_CURROWRow
            identifier is valid only while the cursor is positioned on the
            row.1SQL_SCOPE_TRANSACTIONRow identifier is valid for the duration of the
            transaction.2SQL_SCOPE_SESSIONRow identifier is valid for the duration of the
            connection.COLUMN_NAMEName of the unique column.DATA_TYPESQL data type for the
            column.TYPE_NAMECharacter string representation of the SQL data type for the
            column.COLUMN_SIZEAn integer value representing the size of the column.BUFFER_LENGTH
            Maximum number of bytes necessary to store data from this column. DECIMAL_DIGITS The
            scale of the column, or <info>null</info> where scale is not applicable. NUM_PREC_RADIX An integer
            value of either <return>10</return> (representing an exact numeric data type), <return>2</return> (representing an
            approximate numeric data type), or <info>null</info> (representing a data type for which radix is not
            applicable). PSEUDO_COLUMNAlways returns 1.
            
            Integer valueSQL constantDescription0SQL_SCOPE_CURROWRow identifier is valid only while
            the cursor is positioned on the row.1SQL_SCOPE_TRANSACTIONRow identifier is valid for
            the duration of the transaction.2SQL_SCOPE_SESSIONRow identifier is valid for the
            duration of the connection.

<comment>See Also:</comment>
   * <strong>db2_column_privileges()</strong>
   * <strong>db2_columns()</strong>
   * <strong>db2_foreign_keys()</strong>
   * <strong>db2_primary_keys()</strong>
   * <strong>db2_procedure_columns()</strong>
   * <strong>db2_procedures()</strong>
   * <strong>db2_statistics()</strong>
   * <strong>db2_table_privileges()</strong>
   * <strong>db2_tables()</strong>


id: db2_statistics
type: function
doc:
<comment>Description:</comment>
  Returns a result set listing the index and statistics for a table
    
  
  Returns a result set listing the index and statistics for a table.

<comment>Param:</comment>
  <info>resource</info>     <strong>$connection</strong>  A valid connection to an IBM DB2, Cloudscape, or Apache Derby database.
  <info>string|null</info>  <strong>$qualifier</strong>   A qualifier for DB2 databases running on OS/390 or z/OS servers. For
                            other databases, pass <info>null</info> or an empty string.
  <info>string|null</info>  <strong>$schema</strong>      The schema that contains the targeted table. If this parameter is <info>null</info>,
                            the statistics and indexes are returned for the schema of the current
                            user.
  <info>string</info>       <strong>$table_name</strong>  The name of the table.
  <info>bool</info>         <strong>$unique</strong>      When <strong>$unique</strong> is <info>true</info>, the information for all indexes in the table are
                            returned. Otherwise, only the information for unique indexes in the
                            table are returned.

<comment>Return:</comment>
  <info>resource</info>  Returns a statement resource with a result set containing rows describing the statistics
            and indexes for the base tables matching the specified parameters. The rows are composed
            of the following columns: Column nameDescriptionTABLE_CATThe catalog that contains the
            table. The value is <info>null</info> if this table does not have catalogs.TABLE_SCHEMName of the
            schema that contains the table.TABLE_NAMEName of the table.NON_UNIQUE An integer value
            representing whether the index prohibits unique values, or whether the row represents
            statistics on the table itself: Return valueParameter type0 (SQL_FALSE)The index allows
            duplicate values.1 (SQL_TRUE)The index values must be unique.<info>null</info>This row is statistics
            information for the table itself. INDEX_QUALIFIERA string value representing the
            qualifier that would have to be prepended to INDEX_NAME to fully qualify the
            index.INDEX_NAMEA string representing the name of the index.TYPE An integer value
            representing the type of information contained in this row of the result set: Return
            valueParameter type0 (SQL_TABLE_STAT)The row contains statistics about the table
            itself.1 (SQL_INDEX_CLUSTERED)The row contains information about a clustered index.2
            (SQL_INDEX_HASH)The row contains information about a hashed index.3 (SQL_INDEX_OTHER)The
            row contains information about a type of index that is neither clustered nor hashed.
            ORDINAL_POSITIONThe 1-indexed position of the column in the index. <info>null</info> if the row
            contains statistics information about the table itself.COLUMN_NAMEThe name of the column
            in the index. <info>null</info> if the row contains statistics information about the table
            itself.ASC_OR_DESC<return>A</return> if the column is sorted in ascending order, <return>D</return> if the column is
            sorted in descending order, <info>null</info> if the row contains statistics information about the
            table itself. CARDINALITY If the row contains information about an index, this column
            contains an integer value representing the number of unique values in the index.  If the
            row contains information about the table itself, this column contains an integer value
            representing the number of rows in the table. PAGES If the row contains information
            about an index, this column contains an integer value representing the number of pages
            used to store the index.  If the row contains information about the table itself, this
            column contains an integer value representing the number of pages used to store the
            table. FILTER_CONDITIONAlways returns <info>null</info>.
            
            An integer value representing whether the index prohibits unique values, or whether the
            row represents statistics on the table itself: Return valueParameter type0
            (SQL_FALSE)The index allows duplicate values.1 (SQL_TRUE)The index values must be
            unique.<info>null</info>This row is statistics information for the table itself.
            
            An integer value representing the type of information contained in this row of the
            result set: Return valueParameter type0 (SQL_TABLE_STAT)The row contains statistics
            about the table itself.1 (SQL_INDEX_CLUSTERED)The row contains information about a
            clustered index.2 (SQL_INDEX_HASH)The row contains information about a hashed index.3
            (SQL_INDEX_OTHER)The row contains information about a type of index that is neither
            clustered nor hashed.
            
            If the row contains information about an index, this column contains an integer value
            representing the number of unique values in the index.
            
            If the row contains information about the table itself, this column contains an integer
            value representing the number of rows in the table.
            
            If the row contains information about an index, this column contains an integer value
            representing the number of pages used to store the index.
            
            If the row contains information about the table itself, this column contains an integer
            value representing the number of pages used to store the table.

<comment>See Also:</comment>
   * <strong>db2_column_privileges()</strong>
   * <strong>db2_columns()</strong>
   * <strong>db2_foreign_keys()</strong>
   * <strong>db2_primary_keys()</strong>
   * <strong>db2_procedure_columns()</strong>
   * <strong>db2_procedures()</strong>
   * <strong>db2_special_columns()</strong>
   * <strong>db2_table_privileges()</strong>
   * <strong>db2_tables()</strong>


id: db2_stmt_error
type: function
doc:
<comment>Description:</comment>
  Returns a string containing the SQLSTATE returned by an SQL statement
    
  
  Returns a string containing the SQLSTATE value returned by an SQL statement.
  
  If you do not pass a statement resource as an argument to <strong>db2_stmt_error()</strong>, the driver returns the
  SQLSTATE value associated with the last attempt to return a statement resource, for example, from
  <strong>db2_prepare()</strong> or <strong>db2_exec()</strong>.
  
  To learn what the SQLSTATE value means, you can issue the following command at a DB2 Command Line
  Processor prompt: db2 '? <strong>$sqlstate-value</strong>'. You can also call <strong>db2_stmt_errormsg()</strong> to retrieve an
  explicit error message and the associated SQLCODE value.

<comment>Param:</comment>
  <info>resource|null</info>  <strong>$stmt</strong>  A valid statement resource.

<comment>Return:</comment>
  <info>string</info>  Returns a string containing an SQLSTATE value.

<comment>See Also:</comment>
   * <strong>db2_conn_error()</strong>
   * <strong>db2_conn_errormsg()</strong>
   * <strong>db2_stmt_errormsg()</strong>


id: db2_stmt_errormsg
type: function
doc:
<comment>Description:</comment>
  Returns a string containing the last SQL statement error message
    
  
  Returns a string containing the last SQL statement error message.
  
  If you do not pass a statement resource as an argument to <strong>db2_stmt_errormsg()</strong>, the driver returns
  the error message associated with the last attempt to return a statement resource, for example,
  from <strong>db2_prepare()</strong> or <strong>db2_exec()</strong>.

<comment>Param:</comment>
  <info>resource|null</info>  <strong>$stmt</strong>  A valid statement resource.

<comment>Return:</comment>
  <info>string</info>  Returns a string containing the error message and SQLCODE value for the last error that
          occurred issuing an SQL statement.

<comment>See Also:</comment>
   * <strong>db2_conn_error()</strong>
   * <strong>db2_conn_errormsg()</strong>
   * <strong>db2_stmt_error()</strong>


id: db2_table_privileges
type: function
doc:
<comment>Description:</comment>
  Returns a result set listing the tables and associated privileges in a database
    
  
  Returns a result set listing the tables and associated privileges in a database.

<comment>Param:</comment>
  <info>resource</info>     <strong>$connection</strong>  A valid connection to an IBM DB2, Cloudscape, or Apache Derby database.
  <info>string|null</info>  <strong>$qualifier</strong>   A qualifier for DB2 databases running on OS/390 or z/OS servers. For
                            other databases, pass <info>null</info> or an empty string.
  <info>string|null</info>  <strong>$schema</strong>      The schema which contains the tables. This parameter accepts a search
                            pattern containing <return>_</return> and <return>%</return> as wildcards.
  <info>string|null</info>  <strong>$table_name</strong>  The name of the table. This parameter accepts a search pattern
                            containing <return>_</return> and <return>%</return> as wildcards.

<comment>Return:</comment>
  <info>resource</info>  Returns a statement resource with a result set containing rows describing the privileges
            for the tables that match the specified parameters. The rows are composed of the
            following columns: Column nameDescriptionTABLE_CATThe catalog that contains the table.
            The value is <info>null</info> if this table does not have catalogs.TABLE_SCHEMName of the schema
            that contains the table.TABLE_NAMEName of the table.GRANTORAuthorization ID of the user
            who granted the privilege.GRANTEEAuthorization ID of the user to whom the privilege was
            granted.PRIVILEGE The privilege that has been granted. This can be one of ALTER,
            CONTROL, DELETE, INDEX, INSERT, REFERENCES, SELECT, or UPDATE. IS_GRANTABLE A string
            value of "YES" or "NO" indicating whether the grantee can grant the privilege to other
            users.

<comment>See Also:</comment>
   * <strong>db2_column_privileges()</strong>
   * <strong>db2_columns()</strong>
   * <strong>db2_foreign_keys()</strong>
   * <strong>db2_primary_keys()</strong>
   * <strong>db2_procedure_columns()</strong>
   * <strong>db2_procedures()</strong>
   * <strong>db2_special_columns()</strong>
   * <strong>db2_statistics()</strong>
   * <strong>db2_tables()</strong>


id: db2_tables
type: function
doc:
<comment>Description:</comment>
  Returns a result set listing the tables and associated metadata in a database
    
  
  Returns a result set listing the tables and associated metadata in a database.

<comment>Param:</comment>
  <info>resource</info>     <strong>$connection</strong>  A valid connection to an IBM DB2, Cloudscape, or Apache Derby database.
  <info>string|null</info>  <strong>$qualifier</strong>   A qualifier for DB2 databases running on OS/390 or z/OS servers. For
                            other databases, pass <info>null</info> or an empty string.
  <info>string|null</info>  <strong>$schema</strong>      The schema which contains the tables. This parameter accepts a search
                            pattern containing <return>_</return> and <return>%</return> as wildcards.
  <info>string|null</info>  <strong>$table_name</strong>  The name of the table.  This parameter accepts a search pattern
                            containing <return>_</return> and <return>%</return> as wildcards.
  <info>string|null</info>  <strong>$table_type</strong>  A list of comma-delimited table type identifiers. To match all table
                            types, pass <info>null</info> or an empty string. Valid table type identifiers
                            include: ALIAS, HIERARCHY TABLE, INOPERATIVE VIEW, NICKNAME,
                            MATERIALIZED QUERY TABLE, SYSTEM TABLE, TABLE, TYPED TABLE, TYPED VIEW,
                            and VIEW.

<comment>Return:</comment>
  <info>resource</info>  Returns a statement resource with a result set containing rows describing the tables
            that match the specified parameters. The rows are composed of the following columns:
            Column nameDescriptionTABLE_CATThe catalog that contains the table. The value is <info>null</info> if
            this table does not have catalogs.TABLE_SCHEMName of the schema that contains the
            table.TABLE_NAMEName of the table.TABLE_TYPETable type identifier for the
            table.REMARKSDescription of the table.

<comment>See Also:</comment>
   * <strong>db2_column_privileges()</strong>
   * <strong>db2_columns()</strong>
   * <strong>db2_foreign_keys()</strong>
   * <strong>db2_primary_keys()</strong>
   * <strong>db2_procedure_columns()</strong>
   * <strong>db2_procedures()</strong>
   * <strong>db2_special_columns()</strong>
   * <strong>db2_statistics()</strong>
   * <strong>db2_table_privileges()</strong>


id: dba_close
type: function
doc:
<comment>Description:</comment>
  Cerrar una base de datos DBA
  
  <strong>dba_close()</strong> cierra la base de datos establecida y libera todos los recursos del gestor de base de
  datos especificado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$handle</strong>  El gestor de base de datos, devuelto por <strong>dba_open()</strong> o <strong>dba_popen()</strong>.

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>dba_open()</strong>
   * <strong>dba_popen()</strong>


id: dba_delete
type: function
doc:
<comment>Description:</comment>
  Elimina una entrada DBA especificada por clave
  
  <strong>dba_delete()</strong> elimina la entrada especificada de la base de datos.

<comment>Param:</comment>
  <info>string</info>  <strong>$key</strong>     La clave de la entrada que está siendo eliminada.
  <info></info>        <strong>$gestor</strong>  El gestor de base de datos, devuelto por <strong>dba_open()</strong> o <strong>dba_popen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dba_exists()</strong>
   * <strong>dba_fetch()</strong>
   * <strong>dba_insert()</strong>
   * <strong>dba_replace()</strong>


id: dba_exists
type: function
doc:
<comment>Description:</comment>
  Verificar si la clave existe
  
  <strong>dba_exists()</strong> verifica si la <strong>$key</strong> especificada existe en la base de datos.

<comment>Param:</comment>
  <info>string</info>  <strong>$key</strong>     La clave usada para el chequeo.
  <info></info>        <strong>$gestor</strong>  El gestor de base de datos, devuelto por <strong>dba_open()</strong> o <strong>dba_popen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> si la clave existe, <info>false</info> de lo contrario.

<comment>See Also:</comment>
   * <strong>dba_delete()</strong>
   * <strong>dba_fetch()</strong>
   * <strong>dba_insert()</strong>
   * <strong>dba_replace()</strong>


id: dba_fetch
type: function
doc:
<comment>Description:</comment>
  Recuperar datos especificados por clave
  
  <strong>dba_fetch()</strong> recupera los datos especificados por <strong>$key</strong> desde la base de datos indicada con <strong>$handle</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$key</strong>     La clave que apunta a los datos.
                   
                   Cuando se trabaja con archivos ini, esta función acepta arrays como claves, en
                   donde el índice 0 es el grupo y el índice 1 es el nombre del valor. Vea:
                   <strong>dba_key_split()</strong>.
  <info>int</info>     <strong>$skip</strong>    El número de parejas clave-valor a ignorar cuando se usan bases de datos cdb.
                   Este valor es ignorado por todas las otras bases de datos que no soportan
                   múltiples claves con el mismo nombre.
  <info></info>        <strong>$gestor</strong>  El gestor de base de datos, devuelto por <strong>dba_open()</strong> o <strong>dba_popen()</strong>.

<comment>Return:</comment>
  <info>string</info>  Devuelve la cadena asociada si la pareja clave/datos es encontrada, <info>false</info> de lo contrario.

<comment>See Also:</comment>
   * <strong>dba_exists()</strong>
   * <strong>dba_delete()</strong>
   * <strong>dba_insert()</strong>
   * <strong>dba_replace()</strong>
   * <strong>dba_key_split()</strong>


id: dba_firstkey
type: function
doc:
<comment>Description:</comment>
  Recuperar la primera clave
  
  <strong>dba_firstkey()</strong> devuelve la primera clave de la base de datos y reestablece el apuntador de clave
  interno. Esto permite una búsqueda lineal a través de la base de datos completa.

<comment>Param:</comment>
  <info>resource</info>  <strong>$handle</strong>  El gestor de base de datos, devuelto por <strong>dba_open()</strong> o <strong>dba_popen()</strong>.

<comment>Return:</comment>
  <info>string</info>  Devuelve la clave en caso de tener éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dba_nextkey()</strong>
   * <strong>dba_key_split()</strong>
   * Ejemplo 2 en los ejemplos de DBA


id: dba_handlers
type: function
doc:
<comment>Description:</comment>
  Listar todos los gestores disponibles
  
  <strong>dba_handlers()</strong> lista todos los gestores soportados por esta extensión.

<comment>Param:</comment>
  <info>bool</info>  <strong>$full_info</strong>  Activa/desactiva la mostración de la información completa en el resultado.

<comment>Return:</comment>
  <info>array</info>  Devuelve un array de gestores de bases de datos. Si <strong>$full_info</strong> está establecido a <info>true</info>, el
         array será asociativo con los nombres de los gestores como claves y la información de su
         versión com valor. De otro modo, el resultado será un array indexado de nombres de
         gestores.
         
         Cuando se usa la biblioteca cdb interna verá <return>cdb</return> y <return>cdb_make</return>.


id: dba_insert
type: function
doc:
<comment>Description:</comment>
  Insertar entrada
  
  <strong>dba_insert()</strong> inserta la entrada descrita con <strong>$clave</strong> y <strong>$valor</strong> en la base de datos.

<comment>Param:</comment>
  <info>string</info>    <strong>$key</strong>     La clave de la entrada a ser insertada. Si esta clave ya existe en la base de
                     datos, esta función fallará. Use <strong>dba_replace()</strong> si necesita reemplazar una clave
                     existente.
  <info>string</info>    <strong>$value</strong>   El valor a ser insertado.
  <info>resource</info>  <strong>$handle</strong>  El gestor de base de datos, devuelto por <strong>dba_open()</strong> o <strong>dba_popen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dba_exists()</strong>
   * <strong>dba_delete()</strong>
   * <strong>dba_fetch()</strong>
   * <strong>dba_replace()</strong>


id: dba_key_split
type: function
doc:
<comment>Description:</comment>
  Separa una clave en representación de cadena en representación de array
    
  
  <strong>dba_key_split()</strong> separa una clave (representación tipo cadena) en una representación tipo array.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$key</strong>  La clave en representación de cadena.

<comment>Return:</comment>
  <info>mixed</info>  Devuelve un array de la forma <return>array(0 =&gt; grupo, 1 =&gt; nombre_valor)</return>. Esta función
         devolverá <info>false</info> si <strong>$clave</strong> es <info>null</info> o <info>false</info>.

<comment>See Also:</comment>
   * <strong>dba_firstkey()</strong>
   * <strong>dba_nextkey()</strong>
   * <strong>dba_fetch()</strong>


id: dba_list
type: function
doc:
<comment>Description:</comment>
  Listar todos los archivos de base de datos abiertos
  
  <strong>dba_list()</strong> lista todos los archivos de bases de datos abiertos.

<comment>Return:</comment>
  <info>array</info>  Un array asociativo, en la forma <return>id_recurso =&gt; nombre_archivo</return>.


id: dba_nextkey
type: function
doc:
<comment>Description:</comment>
  Recuperar la siguiente clave
  
  <strong>dba_nextkey()</strong> devuelve la siguiente clave de la base de datos y avanza el apuntador de clave
  interno.

<comment>Param:</comment>
  <info>resource</info>  <strong>$handle</strong>  El gestor de base de datos, devuelto por <strong>dba_open()</strong> o <strong>dba_popen()</strong>.

<comment>Return:</comment>
  <info>string</info>  Devuelve la clave si tiene éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dba_firstkey()</strong>
   * <strong>dba_key_split()</strong>
   * Ejemplo 2 en los ejemplos de DBA


id: dba_open
type: function
doc:
<comment>Description:</comment>
  Abrir una base de datos
  
  <strong>dba_open()</strong> establece una instancia de una base de datos para <strong>$path</strong> con <strong>$mode</strong> usando <strong>$handler</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$path</strong>     Comúnmente una ruta normal de su sistema de ficheros.
  <info>string</info>  <strong>$mode</strong>     Es <return>r</return> para acceso de lectura, <return>w</return> para acceso de lectura/escritura de una base de
                    datos existente, <return>c</return> para acceso de lectura/escritura y creación de una base de
                    datos si no existe actualmente, y <return>n</return> para crear, truncar y acceso de
                    lectura/escritura. La base de datos se crea en el modo BTree, los demás modos
                    (como Hash o Queue) no están soportados.
                    
                    Además se puede establecer el método de bloqueo de la base de datos con el
                    siguiente carácter. Use <return>l</return> para bloquear la base de datos con un fichero .lck o <return>d</return>
                    para bloquear el fichero de la base de datos mismo. Es importante que todas sus
                    aplicaciones hagan esto de manera consistente.
                    
                    Si quiere probar el acceso y no quiere esperar para el bloqueo puede añadir <return>t</return>
                    como tercer carácter. Cuando está absolutamente seguro de que no se requiere el
                    bloqueo de la base de datos, puede usar <return>-</return> en lugar de <return>l</return> o <return>d</return>. Cuando no se usar
                    <return>d</return>,  <return>l</return> o <return>-</return>, dba bloqueará el archivo de la base de datos como si lo estuviera con
                    <return>d</return>.
                    
                    Sólo puede haber un escritor para el archivo de la base de datos. Cuando se usa
                    dba en un servidor web y más de una solicitud requiere operaciones de escritura,
                    sólo pueden hacerlo una tras otra. Tampoco está permitido la lectura durante la
                    escritura. La extensión dba usa bloqueos para impedirlo. Véase la siguiente
                    tabla: Bloqueo de DBAya abierta<strong>$mode</strong> = "rl"<strong>$mode</strong> = "rlt"<strong>$mode</strong> = "wl"<strong>$mode</strong> =
                    "wlt"<strong>$mode</strong> = "rd"<strong>$mode</strong> = "rdt"<strong>$mode</strong> = "wd"<strong>$mode</strong> = "wdt"sin
                    abrirokokokokokokokok<strong>$mode</strong> = "rl"okokwaitfalseillegalillegalillegalillegal<strong>$mode</strong>
                    = "wl"waitfalsewaitfalseillegalillegalillegalillegal<strong>$mode</strong> =
                    "rd"illegalillegalillegalillegalokokwaitfalse<strong>$mode</strong> =
                    "wd"illegalillegalillegalillegalwaitfalsewaitfalse ok: la segunda llamada tendrá
                    éxito.wait: la sedunda llamada esperará hasta que se llame a <strong>dba_close()</strong> la
                    primera vez.false: la segunda llamada devuelve false.illegal: no se pueden
                    mezclar los modificadores <return>"l"</return> y <return>"d"</return> con el parámetro <strong>$mode</strong>.
  <info>string</info>  <strong>$handler</strong>  El nombre del gestor que será usado para acceder a <strong>$path</strong>. Se le pasan todos los
                    parámetros opcionales dados a <strong>dba_open()</strong> y puede actuar en su nombre.

<comment>Return:</comment>
  <info>resource</info>  Devuelve un gestor positivo en caso de éxito  o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dba_popen()</strong>
   * <strong>dba_close()</strong>


id: dba_optimize
type: function
doc:
<comment>Description:</comment>
  Optimizar base de datos
  
  <strong>dba_optimize()</strong> optimiza la base de datos interna.

<comment>Param:</comment>
  <info>resource</info>  <strong>$handle</strong>  El gestor de base de datos, devuelto por <strong>dba_open()</strong> o <strong>dba_popen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dba_sync()</strong>


id: dba_popen
type: function
doc:
<comment>Description:</comment>
  Abrir una base de datos de forma persistente
  
  <strong>dba_popen()</strong> establece una instancia de base de datos persistente para el archivo en <strong>$path</strong> con el
  <strong>$mode</strong> indicado, usando <strong>$handler</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$path</strong>     Usualmente una ruta normal en su sistema de archivos.
  <info>string</info>  <strong>$mode</strong>     Es <return>r</return> para acceso de lectura, <return>w</return> para acceso de lectura/escritura a una base de
                    datos existente, <return>c</return> para acceso de lectura/escritura y creación de base de datos
                    si no existe actualmente, y <return>n</return> para crear, truncar y tener acceso de
                    lectura/escritura.
  <info>string</info>  <strong>$handler</strong>  El nombre del gestor que será usado para acceder a <strong>$path</strong>. A él se le pasan todos
                    los parámetros opcionales dados a <strong>dba_popen()</strong> y puede actuar sobre ellos.

<comment>Return:</comment>
  <info>resource</info>  Devuelve un gestor positivo en caso de éxito, o  o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dba_open()</strong>
   * <strong>dba_close()</strong>


id: dba_replace
type: function
doc:
<comment>Description:</comment>
  Reemplazar o insertar una entrada
  
  <strong>dba_replace()</strong> reemplaza o inserta la entrada descrita con <strong>$key</strong> y <strong>$value</strong> en la base de datos
  especificada por <strong>$handle</strong>.

<comment>Param:</comment>
  <info>string</info>    <strong>$key</strong>     La clave de la entrada a ser reemplazada.
  <info>string</info>    <strong>$value</strong>   El valor a ser reemplazado.
  <info>resource</info>  <strong>$handle</strong>  El gestor de base de datos, devuelto por <strong>dba_open()</strong> o <strong>dba_popen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dba_exists()</strong>
   * <strong>dba_delete()</strong>
   * <strong>dba_fetch()</strong>
   * <strong>dba_insert()</strong>


id: dba_sync
type: function
doc:
<comment>Description:</comment>
  Sincronizar base de datos
  
  <strong>dba_sync()</strong> sincroniza la base de datos. Esto probablemente desencadenará una escritura en disco,
  si es soportado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$handle</strong>  El gestor de base de datos, devuelto por <strong>dba_open()</strong> o <strong>dba_popen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dba_optimize()</strong>


id: dbase_add_record
type: function
doc:
<comment>Description:</comment>
  Añade un registro a una base de datos
  
  Añade la información dad a la base de datos.

<comment>Param:</comment>
  <info>int</info>    <strong>$dbase_identifier</strong>  El identificador de enlace de la base de datos, devuelto por
                            <strong>dbase_open()</strong> o <strong>dbase_create()</strong>..
  <info>array</info>  <strong>$record</strong>            Una matriz indexada de información. El número de elementos debe ser
                            igual al número de campos de la base de datos, si no otherwise
                            <strong>dbase_add_record()</strong> fallará.
                            
                            Si se está usando el valor devuelto por <strong>dbase_get_record()</strong> para este
                            parámetro, recuerde de reiniciar la clave llamada <return>deleted</return>.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dbase_delete_record()</strong>
   * <strong>dbase_replace_record()</strong>


id: dbase_close
type: function
doc:
<comment>Description:</comment>
  Cierra una base de datos
  
  Cierra el identificador de enlace de la base de datos dado.

<comment>Param:</comment>
  <info>int</info>  <strong>$dbase_identifier</strong>  El identificador de enlace de la base de datos, devuelto por <strong>dbase_open()</strong>
                          o <strong>dbase_create()</strong>..

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dbase_open()</strong>
   * <strong>dbase_create()</strong>


id: dbase_create
type: function
doc:
<comment>Description:</comment>
  Crea una base de datos
  
  <strong>dbase_create()</strong> crea una base de datos dBase con la definición dada.
  
  Esta función se ve afectada por open_basedir.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  El nombre de la base de datos. Puede ser una ruta relativa o absoluta al
                     archivo donde dBase almacenará la información.
  <info>array</info>   <strong>$fields</strong>    Una matriz de matrices, donde cada matriz describe el formato de un campo de la
                     base de datos. Cada campo consiste en un nombre, un carácter que indica el tipo
                     de campo y, opcionalmte, una longitud y una precisión.
                     
                     Los nombres de los campos están limitados en longitud y no deben exceder 10
                     caracteres.

<comment>Return:</comment>
  <info>int</info>  Devuelve un identificador de enlace de la base de datos si la base de datos se creó con
       éxito, o <info>false</info> si ocurrión un error.

<comment>See Also:</comment>
   * <strong>dbase_open()</strong>
   * <strong>dbase_close()</strong>


id: dbase_delete_record
type: function
doc:
<comment>Description:</comment>
  Borra un registro de una base de datos
  
  Marca el registro dado para ser borrado de la base de datos.
  
  En realidad, para eliminar el registro de la base de datos, se debe llamar también a <strong>dbase_pack()</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$dbase_identifier</strong>  El identificador de enlace de la base de datos, devuelto por <strong>dbase_open()</strong>
                          o <strong>dbase_create()</strong>..
  <info>int</info>  <strong>$record_number</strong>     Un entero que abarca desde 1 al número de registros de la base de datos
                          (como el devuelto por <strong>dbase_numrecords()</strong>).

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dbase_add_record()</strong>
   * <strong>dbase_replace_record()</strong>


id: dbase_get_header_info
type: function
doc:
<comment>Description:</comment>
  Obtiene la información de cabecera de una base de datos
  
  Devuelve la información de la estructura de columna del identificador de enlace de la base de
  datos dada.

<comment>Param:</comment>
  <info>int</info>  <strong>$dbase_identifier</strong>  El identificador de enlace de la base de datos, devuelto por <strong>dbase_open()</strong>
                          o <strong>dbase_create()</strong>..

<comment>Return:</comment>
  <info>array</info>  Una matriz indexada con una entrada para cada columna de la base de datos. El índice de la
         matriz comienza en 0.
         
         Cada elemento de la matriz contiene una matriz asociativa de información de columna, como
         se describe a continuación: name El nombre de la columna type El nombre legible por humanos
         del tipo de dbase de la columna (p.ej. date, boolean, etc.) length El número de bytes que
         puede soportar esta columna precision El número de dígitos de precisión decimal de la
         columna format Un especificador de formato de <strong>printf()</strong> sugerido para la columna offset El
         índice de byte de la columna desde el inicio de la fila
         
         El nombre de la columna
         
         El nombre legible por humanos del tipo de dbase de la columna (p.ej. date, boolean, etc.)
         
         El número de bytes que puede soportar esta columna
         
         El número de dígitos de precisión decimal de la columna
         
         Un especificador de formato de <strong>printf()</strong> sugerido para la columna
         
         El índice de byte de la columna desde el inicio de la fila
         
         Si no se puede leer la información de la cabecera de la base de datos, se devuleve <info>false</info>.


id: dbase_get_record
type: function
doc:
<comment>Description:</comment>
  Obtiene un registro de una base de datos como una matriz indexada
    
  
  Obtiene un registro de una base de datos como una matriz indexada

<comment>Param:</comment>
  <info>int</info>  <strong>$dbase_identifier</strong>  El identificador de enlace de la base de datos, devuelto por <strong>dbase_open()</strong>
                          o <strong>dbase_create()</strong>..
  <info>int</info>  <strong>$record_number</strong>     El índice del registro.

<comment>Return:</comment>
  <info>array</info>  Una matriz indexada con el registro. Esto también incluye una clave llamada <return>deleted</return> que
         está establecida a 1 si el registro ha sido marcado para el borrado (véase
         <strong>dbase_delete_record()</strong>).
         
         Cada campo se convierte en el tipo de PHP apropiado, excepto:  Las fechas se dejan como
         cadenas.  Los valores int que habrían causado un desbordamiento (&gt; 32 bits) se devuelve
         como cadenas.
         
         Las fechas se dejan como cadenas.
         
         Los valores int que habrían causado un desbordamiento (&gt; 32 bits) se devuelve como
         cadenas.
         
         Si ocurre un error, <strong>dbase_get_record()</strong> devolverá <info>false</info>.

<comment>See Also:</comment>
   * <strong>dbase_get_record_with_names()</strong>


id: dbase_get_record_with_names
type: function
doc:
<comment>Description:</comment>
  Obtiene un registro de una base de datos como una matriz asociativa
    
  
  Obtiene un registro de una base de datos dBase como una matriz asociativa.

<comment>Param:</comment>
  <info>int</info>  <strong>$dbase_identifier</strong>  El identificador de enlace de la base de datos, devuelto por <strong>dbase_open()</strong>
                          o <strong>dbase_create()</strong>..
  <info>int</info>  <strong>$record_number</strong>     El índice del registro.

<comment>Return:</comment>
  <info>array</info>  Una matriz asociativa con le registro. Esto también incluye una clave llamada <return>deleted</return> que
         está establecida a 1 si el registro ha sido marcado para el borrado (véase
         <strong>dbase_delete_record()</strong>).
         
         Cada campo se convierte en el tipo de PHP apropiado, excepto:  Las fechas se dejan como
         cadenas.  Los valores int que habrían causado un desbordamiento (&gt; 32 bits) se devuelve
         como cadenas.
         
         Las fechas se dejan como cadenas.
         
         Los valores int que habrían causado un desbordamiento (&gt; 32 bits) se devuelve como
         cadenas.
         
         Si ocurre un error, <strong>dbase_get_record_with_names()</strong> devolverá <info>false</info>.

<comment>See Also:</comment>
   * <strong>dbase_get_record()</strong>


id: dbase_numfields
type: function
doc:
<comment>Description:</comment>
  Obtiene el número de campos de una base de datos
  
  Obtiene el número de campos (columnas) de la base de datos especificada.
  
  El número de campos está entre 0 y <return>dbase_numfields($db)-1</return>, mientras que el número de registro está
  entre 1 y <return>dbase_numrecords($db)</return>.

<comment>Param:</comment>
  <info>int</info>  <strong>$dbase_identifier</strong>  El identificador de enlace de la base de datos, devuelto por <strong>dbase_open()</strong>
                          o <strong>dbase_create()</strong>..

<comment>Return:</comment>
  <info>int</info>  El número de campos de la base de datos, o <info>false</info> si ocurrió un error.

<comment>See Also:</comment>
   * <strong>dbase_numrecords()</strong>


id: dbase_numrecords
type: function
doc:
<comment>Description:</comment>
  Obtener el número de registros de una base de datos
  
  Obtiene el número de registros (filas) en la base de datos especificada.
  
  El número de registros está entre 1 y <return>dbase_numrecords($db)</return>, mientras que el número de campos está
  entre 0 y <return>dbase_numfields($db)-1</return>.

<comment>Param:</comment>
  <info>int</info>  <strong>$dbase_identifier</strong>  El identificador de enlace de la base de datos, devuelto por <strong>dbase_open()</strong>
                          o <strong>dbase_create()</strong>..

<comment>Return:</comment>
  <info>int</info>  El número de registros de la base de datos, o <info>false</info> si ocurrió un error.

<comment>See Also:</comment>
   * <strong>dbase_numfields()</strong>


id: dbase_open
type: function
doc:
<comment>Description:</comment>
  Abre una base de datos
  
  <strong>dbase_open()</strong> abre una base de datos dBase con el modo de acceso dado.
  
  Esta función se ve afectada por open_basedir.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  El nombre de la base de datos. Puede ser una ruta relativa o absoluta al
                     archivo donde dBase almacenará la información.
  <info>int</info>     <strong>$mode</strong>      Un entero que se corresponde a aquéllos de la llamada al sistema de open()
                     (Normalmente 0 significa sólo lectura, 1 sólo escritura, y 2 lectura y
                     escritura).
                     
                     No se puede abrir un archivo dBase en modo sólo escritura ya que la función
                     fallará al leer la información de las cabeceras, por lo que no se puede usar 1
                     como <strong>$mode</strong>.

<comment>Return:</comment>
  <info>int</info>  Devuelve un identificador de enlace de la base de datos si ésta se abrió con éxito, o <info>false</info>
       si ocurrió un error.

<comment>See Also:</comment>
   * <strong>dbase_create()</strong>
   * <strong>dbase_close()</strong>


id: dbase_pack
type: function
doc:
<comment>Description:</comment>
  Empaquetar una base de datos
  
  Empaqueta una base de datos borrando permanentemente todos los registros marcados para el borrado
  usando <strong>dbase_delete_record()</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$dbase_identifier</strong>  El identificador de enlace de la base de datos, devuelto por <strong>dbase_open()</strong>
                          o <strong>dbase_create()</strong>..

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dbase_delete_record()</strong>


id: dbase_replace_record
type: function
doc:
<comment>Description:</comment>
  Reemplaza un registro en una base de datos
  
  Reemplaza el registro dado en la base de datos con la información dada.

<comment>Param:</comment>
  <info>int</info>    <strong>$dbase_identifier</strong>  El identificador de enlace de la base de datos, devuelto por
                            <strong>dbase_open()</strong> o <strong>dbase_create()</strong>.
  <info>array</info>  <strong>$record</strong>            Ina matriz indexada de información. El número de elementos debe ser
                            igual que el número de campos de la base de datos, de otro modo
                            <strong>dbase_replace_record()</strong> fallará.
                            
                            Si se está usando el valor devulto por <strong>dbase_get_record()</strong> para este
                            parámetro, recuerde de reiniciar la clave llamada <return>deleted</return>.
  <info>int</info>    <strong>$record_number</strong>     Un entero que abarca desde 1 hasta el número de registros de la base de
                            datos (como el devuelto por <strong>dbase_numrecords()</strong>).

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dbase_add_record()</strong>
   * <strong>dbase_delete_record()</strong>


id: dcgettext
type: function
doc:
<comment>Description:</comment>
  Sobrescribe el dominio de la búsqueda única del mensaje
  
  Esta función le permite sobrescribir el dominio actual para  una búsqueda unica del mensaje.

<comment>Param:</comment>
  <info>string</info>  <strong>$domain</strong>    El dominio
  <info>string</info>  <strong>$message</strong>   El mesanje
  <info>int</info>     <strong>$category</strong>  La categoría

<comment>Return:</comment>
  <info>string</info>  Un <info>string</info> si es correcto.

<comment>See Also:</comment>
   * <strong>gettext()</strong>


id: dcngettext
type: function
doc:
<comment>Description:</comment>
  Versión plural de dcgettext
  
  Esta función le permite sobrescribir el dominio actual en una búsqueda en un mensaje único.

<comment>Param:</comment>
  <info>string</info>  <strong>$domain</strong>    The domain
  <info>string</info>  <strong>$msgid1</strong>    
  <info>string</info>  <strong>$msgid2</strong>    
  <info>int</info>     <strong>$n</strong>         
  <info>int</info>     <strong>$category</strong>  

<comment>Return:</comment>
  <info>string</info>  Un <info>string</info> si es correcto.

<comment>See Also:</comment>
   * <strong>ngettext()</strong>


id: debug_backtrace
type: function
doc:
<comment>Description:</comment>
  Genera un rastreo
  
  <strong>debug_backtrace()</strong> genera un rastreo de PHP.

<comment>Param:</comment>
  <info>int</info>  <strong>$options</strong>  Desde 5.3.6, este parámetro es una mascara de bits para las siguientes opciones:
                 <strong>debug_backtrace()</strong> optionsDEBUG_BACKTRACE_PROVIDE_OBJECT Completar el índice
                 "object" o no. DEBUG_BACKTRACE_IGNORE_ARGS Omitir el índice "args" y por lo tanto
                 todos los argumentos de las funciones/métodos para  ahorrar memoria o no.  Antes de
                 5.3.6, el único valor reconocido es <info>true</info> o <info>false</info>, que es lo mismo que establecer y
                 desestablecer la opción <info>DEBUG_BACKTRACE_PROVIDE_OBJECT</info>.
  <info>int</info>  <strong>$limit</strong>    Desde 5.4.0, este parámetro puede ser usado para limitar el número de stack frames
                 que se muestran. Por defecto (<strong>$limit</strong>=<return>0</return>) imprime todos los stack frames.

<comment>Return:</comment>
  <info>array</info>  Devuelve un array de <info>array</info> asociativos. Los posibles elementos devueltos son los
         siguientes:
         
         Posibles elementos devueltos por <strong>debug_backtrace()</strong>NombreTipoDescripciónfunction<info>string</info> El
         nombre de la función actual. Véase también __FUNCTION__. line<info>integer</info> El número de línea
         actual. Véase también __LINE__. file<info>string</info> El nombre de archivo actual. Véase también
         __FILE__. class<info>string</info> El nombre de la clase actual. Véase también __CLASS__ object<info>object</info> El
         objeto actual. type<info>string</info> El tipo de llamada actual. Si es una llamada a un método devuelve
         "-&gt;". Si es una llamada a un método estático devuelve "::". Si es una llamada a una
         función no se devuelve nada. args<info>array</info> Dentro de una función se lista los argumentos de la
         función. Dentro de un archvo incluido se lista el nombre (o nombres) del archivo incluido.

<comment>See Also:</comment>
   * <strong>trigger_error()</strong>
   * <strong>debug_print_backtrace()</strong>


id: debug_print_backtrace
type: function
doc:
<comment>Description:</comment>
  Muestra un rastreo
    
  
  <strong>debug_print_backtrace()</strong> muestra un rastreo PHP. muestra las llamadas a función, archivos incluídos
  y el material evaluado mediante <strong>eval()</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$options</strong>  Desde 5.3.6, este parámetro es una máscara de bits para las siguientes opciones:
                 Opciones de <strong>debug_print_backtrace()</strong>DEBUG_BACKTRACE_IGNORE_ARGS Omitir el índice
                 "args" y por lo tanto todos los argumentos de las funciones/métodos para  ahorrar
                 memoria o no.
  <info>int</info>  <strong>$limit</strong>    Desde 5.4.0, este parámetro puede ser usado para limitar el número de stack frames
                 que se muestran. Por defecto (<strong>$limit</strong>=<return>0</return>) imprime todos los stack frames.

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>debug_backtrace()</strong>


id: debug_zval_dump
type: function
doc:
<comment>Description:</comment>
  Vuelca a la salida una cadena con la representación de un valor interno de zend
  
  Volcar a la salida una cadena con la representación de un valor interno de zend.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$variable</strong>  La variable a ser evaluada

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>var_dump()</strong>
   * <strong>debug_backtrace()</strong>
   * Explicación de las Referencias
   * Explicación de las Referencias (por Derick Rethans)


id: decbin
type: function
doc:
<comment>Description:</comment>
  Decimal a binario
  
  Devuelve una cadena que contiene una representación binaria del argumento  <strong>$number</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$number</strong>  Valor decimal a convertir

<comment>Return:</comment>
  <info>string</info>  Cadena de la representación binaria de <strong>$number</strong>

<comment>See Also:</comment>
   * <strong>bindec()</strong>
   * <strong>decoct()</strong>
   * <strong>dechex()</strong>
   * <strong>base_convert()</strong>
   * <strong>printf()</strong>, usando <return>%b</return>,
     <return>%032b</return> o <return>%064b</return> como formato
    
   * <strong>sprintf()</strong>, usando <return>%b</return>,
     <return>%032b</return> o <return>%064b</return> como formato
    


id: dechex
type: function
doc:
<comment>Description:</comment>
  Decimal a hexadecimal
  
  Devuelve una cadena que contiene una representación hexadecimal del argumento <strong>$number</strong> dado.
  
  El mayor número que puede convertirse es <info>PHP_INT_MAX</info><return> * 2 + 1</return> (o <return>-1</return>): en plataformas de 32 bits,
  este será <return>4294967295</return> en decimal, cuyos resultados utilizando <strong>dechex()</strong> devolverán <return>ffffffff</return>.

<comment>Param:</comment>
  <info>int</info>  <strong>$number</strong>  Valor decimal a convertir.
                
                Aunque los tipos <info>integer</info> PHP tienen signo, la <strong>dechex()</strong> los trata como enteros sin
                signo, de igual forma los enteros negativos serán tratados como si no tuvieran
                signo.

<comment>Return:</comment>
  <info>string</info>  Representación tipo cadena hexadecimal de <strong>$number</strong>.

<comment>See Also:</comment>
   * <strong>hexdec()</strong>
   * <strong>decbin()</strong>
   * <strong>decoct()</strong>
   * <strong>base_convert()</strong>


id: decoct
type: function
doc:
<comment>Description:</comment>
  Decimal a octal
  
  Devuelve una cadena que contiene una representación octal del argumento <strong>$number</strong> dado. El mayor
  número dque puede ser convertido depende de la plataforma empleada. Para plataformas de 32 bits,
  este es normalmente <return>4294967295</return> en decimal, resultando en <return>37777777777</return>. Para plataformas de 64 bits,
  este es normalmente <return>9223372036854775807</return> en decimal, resultando en <return>777777777777777777777</return>.

<comment>Param:</comment>
  <info>int</info>  <strong>$number</strong>  Valor decimal a convertir

<comment>Return:</comment>
  <info>string</info>  Representación tipo cadena octal de <strong>$numero</strong>

<comment>See Also:</comment>
   * <strong>octdec()</strong>
   * <strong>decbin()</strong>
   * <strong>dechex()</strong>
   * <strong>base_convert()</strong>


id: define
type: function
doc:
<comment>Description:</comment>
  Define una constante con nombre
  
  Define una constante con nombre en tiempo de ejecución.

<comment>Param:</comment>
  <info>string</info>  <strong>$name</strong>              El nombre de la constante.
  <info>mixed</info>   <strong>$value</strong>             El valor de la constante. En PHP 5, <strong>$value</strong> debe ser un valor <info>scalar</info>
                             (<info>integer</info>, <info>float</info>, <info>string</info>, <info>boolean</info>, o <info>null</info>). En PHP 7, también se aceptan
                             valores de tipo <info>array</info>.
                             
                             Aunque es posible definir constantes de tipo <info>resource</info>, no se recomienda
                             debido a que podría causar un comportamiento impredecible.
  <info>bool</info>    <strong>$case_insensitive</strong>  Si está establecido a <info>true</info>, la constante será definida insensible a
                             mayúsculas-minúsculas.  El comportamiento predeterminado es sensible a
                             mayúsculas-minúsculas; esto es, <return>CONSTANTE</return> y <return>Constante</return> representan
                             valores diferentes.
                             
                             Las constantes insensibles a mayúsculas-minúsculas se almacenan en
                             minúsculas.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>defined()</strong>
   * <strong>constant()</strong>
   * La sección sobre Constantes


id: defined
type: function
doc:
<comment>Description:</comment>
  Comprueba si existe una constante con nombre dada
  
  Comprueba si existe la constante dada y está definida.
  
  Si quiere ver si existe una variable, use <strong>isset()</strong>, ya que <strong>defined()</strong> sólo se aplica a constantes.
  Si quiere ver si existe una función, use <strong>function_exists()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$name</strong>  El nombre de la constante.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> si la constante con nombre dada por <strong>$name</strong> ha sido definida, si no devuelve
        <info>false</info>.

<comment>See Also:</comment>
   * <strong>define()</strong>
   * <strong>constant()</strong>
   * <strong>get_defined_constants()</strong>
   * <strong>function_exists()</strong>
   * La sección sobre Constantes


id: deflate_add
type: function
doc:
<comment>Description:</comment>
  Incrementally deflate data
  
  Incrementally deflates data in the specified context.

<comment>Param:</comment>
  <info>DeflateContext</info>  <strong>$context</strong>     A context created with <strong>deflate_init()</strong>.
  <info>string</info>          <strong>$data</strong>        A chunk of data to compress.
  <info>int</info>             <strong>$flush_mode</strong>  One of <info>ZLIB_BLOCK</info>, <info>ZLIB_NO_FLUSH</info>, <info>ZLIB_PARTIAL_FLUSH</info>, <info>ZLIB_SYNC_FLUSH</info>
                               (default), <info>ZLIB_FULL_FLUSH</info>, <info>ZLIB_FINISH</info>. Normally you will want to
                               set <info>ZLIB_NO_FLUSH</info> to maximize compression, and <info>ZLIB_FINISH</info> to
                               terminate with the last chunk of data. See the zlib manual for a
                               detailed description of these constants.

<comment>Return:</comment>
  <info>string|false</info>  Returns a chunk of compressed data,  o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>deflate_init()</strong>


id: deflate_init
type: function
doc:
<comment>Description:</comment>
  Initialize an incremental deflate context
  
  Initializes an incremental deflate context using the specified <strong>$encoding</strong>.
  
  Note that the <return>window</return> option here only sets the window size of the algorithm, differently from the
  zlib filters where the same parameter also sets the encoding to use; the encoding must be set with
  the <strong>$encoding</strong> parameter.
  
  Limitation: there is currently no way to set the header information on a GZIP compressed stream,
  which are set as follows: GZIP signature (<return>\x1f\x8B</return>); compression method (<return>\x08</return> == DEFLATE); 6 zero
  bytes; the operating system set to the current system (<return>\x00</return> = Windows, <return>\x03</return> = Unix, etc.)

<comment>Param:</comment>
  <info>int</info>    <strong>$encoding</strong>  One of the <info>ZLIB_ENCODING_*</info> constants.
  <info>array</info>  <strong>$options</strong>   An associative array which may contain the following elements: level The
                    compression level in range -1..9; defaults to -1. memory The compression memory
                    level in range 1..9; defaults to 8. window The zlib window size (logarithmic) in
                    range <return>8</return>..<return>15</return>; defaults to <return>15</return>. zlib changes a window size of <return>8</return> to <return>9</return>, and as of
                    zlib 1.2.8 fails with a warning, if a window size of <return>8</return> is requested for
                    <info>ZLIB_ENCODING_RAW</info> or <info>ZLIB_ENCODING_GZIP</info>. strategy One of <info>ZLIB_FILTERED</info>,
                    <info>ZLIB_HUFFMAN_ONLY</info>, <info>ZLIB_RLE</info>, <info>ZLIB_FIXED</info> or <info>ZLIB_DEFAULT_STRATEGY</info> (the default).
                    dictionary A <info>string</info> or an <info>array</info> of <info>strings</info> of the preset dictionary (default: no
                    preset dictionary).
                    
                    The compression level in range -1..9; defaults to -1.
                    
                    The compression memory level in range 1..9; defaults to 8.
                    
                    The zlib window size (logarithmic) in range <return>8</return>..<return>15</return>; defaults to <return>15</return>. zlib changes
                    a window size of <return>8</return> to <return>9</return>, and as of zlib 1.2.8 fails with a warning, if a window
                    size of <return>8</return> is requested for <info>ZLIB_ENCODING_RAW</info> or <info>ZLIB_ENCODING_GZIP</info>.
                    
                    One of <info>ZLIB_FILTERED</info>, <info>ZLIB_HUFFMAN_ONLY</info>, <info>ZLIB_RLE</info>, <info>ZLIB_FIXED</info> or
                    <info>ZLIB_DEFAULT_STRATEGY</info> (the default).
                    
                    A <info>string</info> or an <info>array</info> of <info>strings</info> of the preset dictionary (default: no preset
                    dictionary).

<comment>Return:</comment>
  <info>DeflateContext|false</info>  Returns a deflate context resource (<return>zlib.deflate</return>) on success,  o <info>false</info> en
                        caso de error.

<comment>See Also:</comment>
   * <strong>deflate_add()</strong>
   * <strong>inflate_init()</strong>


id: deg2rad
type: function
doc:
<comment>Description:</comment>
  Convierte el número en grados a su equivalente en radianes
    
  
  Esta función convierte a <strong>$numero</strong> desde grados a su equivalente en radianes.

<comment>Param:</comment>
  <info>float</info>  <strong>$number</strong>  Valor angular en grados

<comment>Return:</comment>
  <info>float</info>  El equivalente en radianes de <strong>$number</strong>

<comment>See Also:</comment>
   * <strong>rad2deg()</strong>


id: delete
type: function
doc:
<comment>Description:</comment>
  Véase unlink o unset
  
  Esta es una entrada trivial del manual para satisfacer a aquéllos que están buscando <strong>unlink()</strong> o
  <strong>unset()</strong> en el lugar equivocado.

<comment>See Also:</comment>
   * <strong>unlink()</strong>
   * <strong>unset()</strong>


id: dgettext
type: function
doc:
<comment>Description:</comment>
  Sobrescribe el dominio actual
  
  La función <strong>dgettext()</strong> le permite sobrescribir  el <strong>$domain</strong> actual en una búsqueda en un mensaje
  único.

<comment>Param:</comment>
  <info>string</info>  <strong>$domain</strong>   El dominio
  <info>string</info>  <strong>$message</strong>  El mensaje

<comment>Return:</comment>
  <info>string</info>  Un <info>string</info> si es correcto.

<comment>See Also:</comment>
   * <strong>gettext()</strong>


id: die
type: function
doc:
<comment>Description:</comment>
  Equivalente a exit
  
  Este constructor de lenguaje es equivalente a <strong>exit()</strong>.


id: dio_close
type: function
doc:
<comment>Description:</comment>
  Cierra el descriptor de fichero fd
  
  La función <strong>dio_close()</strong> cierra el descriptor de fichero <strong>$fd</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$fd</strong>  Descriptor de fichero devuelto por <strong>dio_open()</strong>.

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>dio_open()</strong>


id: dio_fcntl
type: function
doc:
<comment>Description:</comment>
  Lleva a cabo la función fcntl de la biblioteca C en el fichero fd
  
  La función <strong>dio_fcntl()</strong> realiza la operación especificada por <strong>$cmd</strong> sobre el descriptor de fichero
  <strong>$fd</strong>. Algunos comandos requieren que se proporcionen parámetros adicionales en <strong>$args</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$fd</strong>    Descriptor de fichero devuelto por <strong>dio_open()</strong>.
  <info>int</info>       <strong>$cmd</strong>   Puede ser una de las siguientes operaciones: <info>F_SETLK</info> - Se asigna o quita el
                   bloqueo. Si está bloqueado por otro proceso, <strong>dio_fcntl()</strong> devuelve -1. <info>F_SETLKW</info> -
                   como <info>F_SETLK</info>, pero en caso de que esté bloqueado por otro proceso, <strong>dio_fcntl()</strong>
                   espera a que éste se libere. <info>F_GETLK</info> - <strong>dio_fcntl()</strong>  devuelve un array asociativo
                   (como se describe a continuación) si algún proceso previene el bloqueo. Si no
                   hubiera impedimento, se asignará la clave "type" a <info>F_UNLCK</info>. <info>F_DUPFD</info> - encuentra
                   el número de descriptor más bajo disponible que sea igual o superior a <strong>$args</strong> y lo
                   devuelve. <info>F_SETFL</info> - Establece al descriptor de fichero las banderas especificadas
                   en <strong>$args</strong>, de entre <info>O_APPEND</info>, <info>O_NONBLOCK</info> o  <info>O_ASYNC</info>. Para usar <info>O_ASYNC</info>  debe
                   usarse la extensión PCNTL.
                   
                   <info>F_SETLK</info> - Se asigna o quita el bloqueo. Si está bloqueado por otro proceso,
                   <strong>dio_fcntl()</strong> devuelve -1.
                   
                   <info>F_SETLKW</info> - como <info>F_SETLK</info>, pero en caso de que esté bloqueado por otro proceso,
                   <strong>dio_fcntl()</strong> espera a que éste se libere.
                   
                   <info>F_GETLK</info> - <strong>dio_fcntl()</strong>  devuelve un array asociativo (como se describe a
                   continuación) si algún proceso previene el bloqueo. Si no hubiera impedimento, se
                   asignará la clave "type" a <info>F_UNLCK</info>.
                   
                   <info>F_DUPFD</info> - encuentra el número de descriptor más bajo disponible que sea igual o
                   superior a <strong>$args</strong> y lo devuelve.
                   
                   <info>F_SETFL</info> - Establece al descriptor de fichero las banderas especificadas en <strong>$args</strong>,
                   de entre <info>O_APPEND</info>, <info>O_NONBLOCK</info> o  <info>O_ASYNC</info>. Para usar <info>O_ASYNC</info>  debe usarse la
                   extensión PCNTL.
  <info>mixed</info>     <strong>$args</strong>  <strong>$args</strong> es un array asociativo, cuando <strong>$cmd</strong> sea <info>F_SETLK</info> o <info>F_SETLLW</info>, con las
                   siguientes claves: <return>start</return> - posición donde comienza el bloqueo <return>length</return> - tamaño del
                   area bloqueada. Cero significa hasta el final del fichero <return>whence</return> - Desde dónde se
                   contabiliza l_start: puede ser <info>SEEK_SET</info>, <info>SEEK_END</info> y <info>SEEK_CUR</info> <return>type</return> - tipo de
                   bloqueo: puede ser <info>F_RDLCK</info> (bloqueo de lectura), <info>F_WRLCK</info> (bloqueo de escritura) o
                   <info>F_UNLCK</info> (desbloqueo)
                   
                   <return>start</return> - posición donde comienza el bloqueo
                   
                   <return>length</return> - tamaño del area bloqueada. Cero significa hasta el final del fichero
                   
                   <return>whence</return> - Desde dónde se contabiliza l_start: puede ser <info>SEEK_SET</info>, <info>SEEK_END</info> y
                   <info>SEEK_CUR</info>
                   
                   <return>type</return> - tipo de bloqueo: puede ser <info>F_RDLCK</info> (bloqueo de lectura), <info>F_WRLCK</info> (bloqueo
                   de escritura) o <info>F_UNLCK</info> (desbloqueo)

<comment>Return:</comment>
  <info>mixed</info>  Devuelve el resultado de la llamada a C.


id: dio_open
type: function
doc:
<comment>Description:</comment>
  Abre (crea si fuera necesario) un fichero a un nivel más bajo que el permitido por
     flujos de entrada y salida de las bibliotecas en C
    
  
  <strong>dio_open()</strong> abre un fichero y devuelve su descriptor de fichero.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Ruta del fichero a abrir.
  <info>int</info>     <strong>$flags</strong>     El parámetro <strong>$flags</strong> es una máscara OR de bits compuesta a partir de las
                     siguientes banderas. Estos valores tienen que incluir alguno de entre <info>O_RDONLY</info>,
                     <info>O_WRONLY</info>, o <info>O_RDWR</info>. Además, podría incluir cualquier combinación del resto de
                     banderas de la lista. <info>O_RDONLY</info> - abre el fichero con acceso de lectura.
                     <info>O_WRONLY</info> - abre el fichero con acceso de escritura. <info>O_RDWR</info> - abre el fichero
                     con acceso de lectura y de escritura. <info>O_CREAT</info> - crea el fichero, si no
                     existiera ya. <info>O_EXCL</info> - si tanto <info>O_CREAT</info> como <info>O_EXCL</info> están habilitados, y el
                     fichero existe, <strong>dio_open()</strong> fallará. <info>O_TRUNC</info> - si el fichero existe, y está
                     abierto con sólo escritura, se truncará a cero. <info>O_APPEND</info> - las operaciones de
                     escritura añaden los datos al final del fichero. <info>O_NONBLOCK</info> - asigna el modo no
                     bloqueante. <info>O_NOCTTY</info> - previene que el SO asigne al fichero abierto como el
                     terminal controlador del proceso cuando se abra un fichero de dispositivo TTY.
                     
                     <info>O_RDONLY</info> - abre el fichero con acceso de lectura.
                     
                     <info>O_WRONLY</info> - abre el fichero con acceso de escritura.
                     
                     <info>O_RDWR</info> - abre el fichero con acceso de lectura y de escritura.
                     
                     <info>O_CREAT</info> - crea el fichero, si no existiera ya.
                     
                     <info>O_EXCL</info> - si tanto <info>O_CREAT</info> como <info>O_EXCL</info> están habilitados, y el fichero existe,
                     <strong>dio_open()</strong> fallará.
                     
                     <info>O_TRUNC</info> - si el fichero existe, y está abierto con sólo escritura, se truncará
                     a cero.
                     
                     <info>O_APPEND</info> - las operaciones de escritura añaden los datos al final del fichero.
                     
                     <info>O_NONBLOCK</info> - asigna el modo no bloqueante.
                     
                     <info>O_NOCTTY</info> - previene que el SO asigne al fichero abierto como el terminal
                     controlador del proceso cuando se abra un fichero de dispositivo TTY.
  <info>int</info>     <strong>$mode</strong>      Si <strong>$flags</strong> contiene <info>O_CREAT</info>, <strong>$mode</strong> establecerá los permisos del ficher (permisos
                     de creación). <strong>$mode</strong> es necesario para un correcto funcionamiento cuando <info>O_CREAT</info>
                     se especifica en <strong>$flags</strong>, y se ignorará en cualquier otro caso.
                     
                     Los permisos que realmente se asignan al fichero creado se verán afectados por
                     el umask del proceso, como suele suceder.

<comment>Return:</comment>
  <info>resource</info>  Descriptor de fichero o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>dio_close()</strong>


id: dio_read
type: function
doc:
<comment>Description:</comment>
  Leer bytes de un descriptor de fichero
  
  La función <strong>dio_read()</strong> lee y devuelve <strong>$len</strong> bytes de fichero con descriptor <strong>$fd</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$fd</strong>   El fichero descriptor devuelto por<strong>dio_open()</strong>.
  <info>int</info>       <strong>$len</strong>  El número de bytes a leer. Si no se especifica la lectura    es de  bloques de 1K
                  <strong>dio_read()</strong>

<comment>Return:</comment>
  <info>string</info>  La bytes leídos desde <strong>$fd</strong>.

<comment>See Also:</comment>
   * <strong>dio_write()</strong>


id: dio_seek
type: function
doc:
<comment>Description:</comment>
  Salta a una posición del descriptor de fichero desde donde proceda
  
  <strong>dio_seek()</strong> se usa para cambiar la posición del fichero del descriptor de fichero proporcionado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$fd</strong>      Descriptor de fichero devuelto por <strong>dio_open()</strong>.
  <info>int</info>       <strong>$pos</strong>     Nueva posición.
  <info>int</info>       <strong>$whence</strong>  Indica cómo interpretar la posición <strong>$pos</strong>: <info>SEEK_SET</info> (por omisión) - indica que
                     <strong>$pos</strong> se contabiliza a partir del comienzo del fichero. <info>SEEK_CUR</info> - indica que
                     <strong>$pos</strong> se contabiliza a partir de la posición actual del fichero. Este valor
                     puede ser positivo o negativo. <info>SEEK_END</info> - Indica que <strong>$pos</strong> contabiliza
                     caracteres a partir del final del fichero. Un valor negativo especifica una
                     posición perteneciente al contenido del fichero; un valor positivo especifica
                     una posición que supera el final. Si éste fuera el caso, y se escribieran
                     datos, se rellenaría el fichero con ceros hasta alcanzar la posición que
                     proceda.
                     
                     <info>SEEK_SET</info> (por omisión) - indica que <strong>$pos</strong> se contabiliza a partir del comienzo
                     del fichero.
                     
                     <info>SEEK_CUR</info> - indica que <strong>$pos</strong> se contabiliza a partir de la posición actual del
                     fichero. Este valor puede ser positivo o negativo.
                     
                     <info>SEEK_END</info> - Indica que <strong>$pos</strong> contabiliza caracteres a partir del final del
                     fichero. Un valor negativo especifica una posición perteneciente al contenido
                     del fichero; un valor positivo especifica una posición que supera el final. Si
                     éste fuera el caso, y se escribieran datos, se rellenaría el fichero con ceros
                     hasta alcanzar la posición que proceda.

<comment>Return:</comment>
  <info>int</info>  


id: dio_stat
type: function
doc:
<comment>Description:</comment>
  Consulta información de estado del descriptor de fichero fd
    
  
  <strong>dio_stat()</strong> devuelve información sobre el descriptor de fichero proporcionado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$fd</strong>  Descriptor de fichero devuelto por <strong>dio_open()</strong>.

<comment>Return:</comment>
  <info>array</info>  Devuelve un array asociativo con las siguientes claves:  "device" - dispositivo  "inode" -
         nodo-i  "mode" - modo  "nlink" - número de enlaces duros  "uid" - id de usuario  "gid" - id
         de grupo  "device_type" - tipo de dispositivo (si es un nodo-i de dispositivo)  "size" -
         tamaño total en bytes  "blocksize" - tamaño de bloque  "blocks" - número de bloques
         asignados  "atime" - fecha de último acceso  "mtime" - fecha de última modificación
         "ctime" - fecha de último cambio  En caso de error, <strong>dio_stat()</strong> devuelve <info>null</info>.
         
         "device" - dispositivo
         
         "inode" - nodo-i
         
         "mode" - modo
         
         "nlink" - número de enlaces duros
         
         "uid" - id de usuario
         
         "gid" - id de grupo
         
         "device_type" - tipo de dispositivo (si es un nodo-i de dispositivo)
         
         "size" - tamaño total en bytes
         
         "blocksize" - tamaño de bloque
         
         "blocks" - número de bloques asignados
         
         "atime" - fecha de último acceso
         
         "mtime" - fecha de última modificación
         
         "ctime" - fecha de último cambio


id: dio_tcsetattr
type: function
doc:
<comment>Description:</comment>
  Establece los atributos terminales y la tasa de baudios del puerto serie
    
  
  <strong>dio_tcsetattr()</strong> establece los atributos terminales y la tasa de baudios del fichero <strong>$fd</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$fd</strong>       Descriptor de fichero devuelto por <strong>dio_open()</strong>.
  <info>array</info>     <strong>$options</strong>  Las siguientes opciones están disponibles:  'baud' - tasa de baudios del
                      puerto - puede ser 38400,19200,9600,4800,2400,1800,
                      1200,600,300,200,150,134,110,75 o 50, el valor por omisión es 9600.  'bits' -
                      bits de datos - puede ser 8,7,6 o 5. El valor por omisión es 8.  'stop' - bits
                      de parada - puede ser 1 o 2. El valor por omisión es 1.  'parity' - paridad -
                      puede ser 0,1 o 2. El valor por omisión es 0.
                      
                      'baud' - tasa de baudios del puerto - puede ser
                      38400,19200,9600,4800,2400,1800, 1200,600,300,200,150,134,110,75 o 50, el
                      valor por omisión es 9600.
                      
                      'bits' - bits de datos - puede ser 8,7,6 o 5. El valor por omisión es 8.
                      
                      'stop' - bits de parada - puede ser 1 o 2. El valor por omisión es 1.
                      
                      'parity' - paridad - puede ser 0,1 o 2. El valor por omisión es 0.

<comment>Return:</comment>
  <info>bool</info>  No devuelve ningún valor.


id: dio_truncate
type: function
doc:
<comment>Description:</comment>
  Trunca un descriptor de fichero fd a un determinado número de bytes
    
  
  <strong>dio_truncate()</strong> trunca un fichero a, como mucho, un tamaño de <strong>$offset</strong> bytes.
  
  Si el fichero excediera este tamaño, el contenido extra se perdería. Si fuera inferior en tamaño,
  no se especifica si el fichero se mantiene sin cambios o si se completa. En este último caso, la
  parte completada se haría con ceros.

<comment>Param:</comment>
  <info>resource</info>  <strong>$fd</strong>      Descriptor de fichero devuelto por <strong>dio_open()</strong>.
  <info>int</info>       <strong>$offset</strong>  Tamaño en bytes.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.


id: dio_write
type: function
doc:
<comment>Description:</comment>
  Escribe datos en el descriptor de fichero con un truncado opcional
    
  
  <strong>dio_write()</strong> escriba hasta <strong>$len</strong>  bytes de <strong>$data</strong> al fichero <strong>$fd</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$fd</strong>    Descriptor de fichero devuelto por <strong>dio_open()</strong>.
  <info>string</info>    <strong>$data</strong>  Datos a escribir.
  <info>int</info>       <strong>$len</strong>   Longitud en bytes de los datos a escribir. Si no se especifica, la función
                   escribe todos los datos al fichero especificado.

<comment>Return:</comment>
  <info>int</info>  Devuelve el número de bytes escritos en <strong>$fd</strong>.

<comment>See Also:</comment>
   * <strong>dio_read()</strong>


id: dir
type: function
doc:
<comment>Description:</comment>
  Devuelve una instancia de la clase Directory
  
  Una forma pseudo orientada a objetos de leer un directorio. El directorio proporcionado en
  <strong>$directory</strong> es abierto.

<comment>Param:</comment>
  <info>string</info>    <strong>$directory</strong>  Directorio a abrir
  <info>resource</info>  <strong>$context</strong>    Soporte para context fue
                        añadido en PHP 5.0.0. Para una descripción de <return>contexts</return>, refiérase a
                        .
                        
                        Soporte para context fue
                        añadido en PHP 5.0.0. Para una descripción de <return>contexts</return>, refiérase a
                        .

<comment>Return:</comment>
  <info>Directory</info>  Devuelve una instancia de la clase <class>Directory</class>, <info>null</info> cuando si los parámetros son
             incorrectos o <info>false</info> en caso de cualquier otro error.


id: dirname
type: function
doc:
<comment>Description:</comment>
  Devuelve la ruta de un directorio padre
  
  Dada una cadena que contiene la ruta a un fichero o directorio, esta función devolverá la ruta del
  directorio padre que está a <strong>$levels</strong> niveles del directorio actual.
  
  <strong>dirname()</strong> opera de forma ingénua con la cadena de entrada, y no es consciente del sistema de
  ficheros o los componentes de la ruta como "<return>..</return>".
  
  <strong>dirname()</strong> usa la configuración de idioma local, para poder ver  de forma correcta el nombre de
  directorio con caracteres multibyte en la ruta, se definir la misma configuración local  usando la
  función <strong>setlocale()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$path</strong>    Una ruta.
                   
                   En Windows, la barra (<return>/</return>) y la barra invertida (<return>\</return>) se usan como carácter separador
                   de directorio. En otros entornos se usa la barra hacia delante (<return>/</return>).
  <info>int</info>     <strong>$levels</strong>  El número de directorios padre a subir.
                   
                   Debe ser un número entero mayor que 0.

<comment>Return:</comment>
  <info>string</info>  Devuelve la ruta de un directorio padre. Si no hay barras en <strong>$path</strong>, será devuelto un punto
          ('<return>.</return>'), indicando el directorio actual. De otro modo, la cadena devuelta es <strong>$path</strong> con
          cualquier <return>/componente</return> final eliminado.

<comment>See Also:</comment>
   * <strong>basename()</strong>
   * <strong>pathinfo()</strong>
   * <strong>realpath()</strong>


id: disk_free_space
type: function
doc:
<comment>Description:</comment>
  Devuelve el espacio disponible de un sistema de archivos o partición de disco
  
  Dada una cadena que contiene un directorio, esta función devolverá el número de bytes disponibles
  en el sistema de archivos o partición de disco correspondiente.

<comment>Param:</comment>
  <info>string</info>  <strong>$directory</strong>  Un directorio del sistema de archivos o partición de disco.
                      
                      Dado un nombre de archivo en vez de un directorio, el comportamiento de la
                      función no está especificado y puede diferir entre sistemas operativos y
                      versiones de PHP.

<comment>Return:</comment>
  <info>float</info>  Devuelve el número de bytes disponibles como un float o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>disk_total_space()</strong>


id: disk_total_space
type: function
doc:
<comment>Description:</comment>
  Devuelve el tamaño total de un sistema de archivos o partición de disco
  
  Dada una cadena que contiene un directorio, esta función devolverá el número total de bytes del
  sistema de archivos o partición de disco correspondiente.

<comment>Param:</comment>
  <info>string</info>  <strong>$directory</strong>  Un directorio del sistema de archivos o partición de disco.

<comment>Return:</comment>
  <info>float</info>  Devuelve el número total de bytes como un float o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>disk_free_space()</strong>


id: diskfreespace
type: function
doc:
<comment>Description:</comment>
  Alias de disk_free_space
  
  Esta función es un alias de:  <strong>disk_free_space()</strong>.


id: dl
type: function
doc:
<comment>Description:</comment>
  Carga una extensión de PHP durante la ejecución
  
  Carga la extensión PHP dada por el parámetro <strong>$library</strong>.
  
  Utilice la función <strong>extension_loaded()</strong> para comprobar si la extensión ya está cargada o no.
  Funciona tanto para extensiones ya integradas en PHP o para extensiones que se han cargado
  dinámicamente (ya sea a través de php.ini o <strong>dl()</strong>).
  
  Esta función ha sido eliminada de la mayoría de las SAPI en PHP 5.3.0, y de PHP-FPM en PHP 7.0.0.

<comment>Param:</comment>
  <info>string</info>  <strong>$library</strong>  Este parámetro es solamente el fichero de la extensión a cargar el cual depende
                    del sistema operativo. Por ejemplo, la extensión sockets (si se compila como
                    librería, no como parte de PHP) Se llamará sockets.so en sistemas Unix mientras
                    que en Windows se llamará php_sockets.dll.
                    
                    El directorio desde donde la extensión será cargada también depende del sistema
                    operativo:
                    
                    En Windows - a no ser que se defina explicitamente en php.ini, la extensión será
                    cargada por defecto desde C:\php4\extensions\ (PHP4) o C:\php5\ en (PHP 5).
                    
                    Unix - a no ser que se defina en php.ini, el directorio de extensiones por
                    defecto depende de  Si PHP fué compilado con la opción <return>--enable-debug</return> o no  Si
                    PHP fué comiplado con soporte (experimental) ZTS (Zend Thread Safety) o no  El
                    módulo interno actual <return>ZEND_MODULE_API_NO</return> (Número interno del API Zend, que es
                    básicamente la fecha en que se produjo un cambio de versión, p.ej. <return>20010901</return>)
                    Teniendo esto en cuenta el directorio por defecto será <return>\<install-dir&gt;/lib/php/extensions/ \<debug-or-not&gt;-\<zts-or-not&gt;-ZEND_MODULE_API_NO</return>, p.ej. /usr/local/php/lib/php/extensions/debug-non-zts-20010901 o /usr/local/php/lib/php/extensions/no-debug-zts-20010901.
                    
                    Si PHP fué compilado con la opción <return>--enable-debug</return> o no
                    
                    Si PHP fué comiplado con soporte (experimental) ZTS (Zend Thread Safety) o no
                    
                    El módulo interno actual <return>ZEND_MODULE_API_NO</return> (Número interno del API Zend, que es
                    básicamente la fecha en que se produjo un cambio de versión, p.ej. <return>20010901</return>)

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error. Si la funcionalidad de cargar
        módulos no está disponible o ha sido deshabilitada (ya sea activando enable_dl off en
        php.ini) Se producirá un <info>E_ERROR</info> y se parará la ejecucción de PHP. Si <strong>dl()</strong> falló porque la
        librería especificacda no pudo cargarse a demás de <info>false</info> se producirá un mensaje <info>E_WARNING</info>.

<comment>See Also:</comment>
   * Directivas de cargas de extensiones
   * <strong>extension_loaded()</strong>


id: dngettext
type: function
doc:
<comment>Description:</comment>
  Versión plural de dgettext
  
  La función <strong>dngettext()</strong> permite sobrescribir el valor actual de <strong>$domain</strong> en una consulta en un
  mensaje único en plural.

<comment>Param:</comment>
  <info>string</info>  <strong>$domain</strong>    El dominio
  <info>string</info>  <strong>$singular</strong>  
  <info>string</info>  <strong>$plural</strong>    
  <info>int</info>     <strong>$count</strong>     

<comment>Return:</comment>
  <info>string</info>  Un <info>string</info> si es correcto.

<comment>See Also:</comment>
   * <strong>ngettext()</strong>


id: dns_check_record
type: function
doc:
<comment>Description:</comment>
  Alias de checkdnsrr
  
  Esta función es un alias de:  <strong>checkdnsrr()</strong>.


id: dns_get_mx
type: function
doc:
<comment>Description:</comment>
  Alias de getmxrr
  
  Esta función es un alias de:  <strong>getmxrr()</strong>.


id: dns_get_record
type: function
doc:
<comment>Description:</comment>
  Fetch DNS Resource Records associated with a hostname
  
  Fetch DNS Resource Records associated with the given <strong>$hostname</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$hostname</strong>                    <strong>$hostname</strong> should be a valid DNS hostname such as
                                       "<return>www.example.com</return>". Reverse lookups can be generated using
                                       <return>in-addr.arpa</return> notation, but <strong>gethostbyaddr()</strong> is more suitable
                                       for the majority of reverse lookups.
                                       
                                       Per DNS standards, email addresses are given in <return>user.host</return>
                                       format (for example: <return>hostmaster.example.com</return> as opposed to
                                       <return>hostmaster@example.com</return>), be sure to check this value and
                                       modify if necessary before using it with a functions such as
                                       <strong>mail()</strong>.
  <info>int</info>     <strong>$type</strong>                        By default, <strong>dns_get_record()</strong> will search for any resource
                                       records associated with <strong>$hostname</strong>.  To limit the query,
                                       specify the optional <strong>$type</strong> parameter. May be any one of the
                                       following: <info>DNS_A</info>, <info>DNS_CNAME</info>, <info>DNS_HINFO</info>, <info>DNS_CAA</info>, <info>DNS_MX</info>,
                                       <info>DNS_NS</info>, <info>DNS_PTR</info>, <info>DNS_SOA</info>, <info>DNS_TXT</info>, <info>DNS_AAAA</info>, <info>DNS_SRV</info>,
                                       <info>DNS_NAPTR</info>, <info>DNS_A6</info>, <info>DNS_ALL</info> or <info>DNS_ANY</info>.
                                       
                                       Because of eccentricities in the performance of libresolv
                                       between platforms, <info>DNS_ANY</info> will not always return every
                                       record, the slower <info>DNS_ALL</info> will collect all records more
                                       reliably.
                                       
                                       Windows: <info>DNS_CAA</info> is not supported. Support for <info>DNS_A6</info> is not
                                       implemented.
  <info>array</info>   <strong>$authoritative_name_servers</strong>  Passed by reference and, if given, will be populated with
                                       Resource Records for the Authoritative Name Servers.
  <info>array</info>   <strong>$additional_records</strong>          Passed by reference and, if given, will be populated with any
                                       Additional Records.
  <info>bool</info>    <strong>$raw</strong>                         The <strong>$type</strong> will be interpreted as a raw DNS type ID (the <return>DNS_*</return>
                                       constants cannot be used). The return value will contain a
                                       <return>data</return> key, which needs to be manually parsed.

<comment>Return:</comment>
  <info>array|false</info>  This function returns an array of associative arrays, o <info>false</info> en caso de error. Each
               associative array contains at minimum the following keys: Basic DNS
               attributesAttributeMeaninghost The record in the DNS namespace to which the rest of
               the associated data refers. class<strong>dns_get_record()</strong> only returns Internet class records
               and as such this parameter will always return <return>IN</return>. type String containing the record
               type.  Additional attributes will also be contained in the resulting array dependant
               on the value of type. See table below. ttl<return>"Time To Live"</return> remaining for this record.
               This will not equal the record's original ttl, but will rather equal the original ttl
               minus whatever length of time has passed since the authoritative name server was
               queried.
               
               Other keys in associative arrays dependant on 'type'TypeExtra Columns<return>A</return><return>ip</return>: An IPv4
               addresses in dotted decimal notation. <return>MX</return><return>pri</return>: Priority of mail exchanger. Lower
               numbers indicate greater priority. <return>target</return>: FQDN of the mail exchanger. See also
               <strong>dns_get_mx()</strong>. <return>CNAME</return><return>target</return>: FQDN of location in DNS namespace to which the record is
               aliased. <return>NS</return><return>target</return>: FQDN of the name server which is authoritative for this hostname.
               <return>PTR</return><return>target</return>: Location within the DNS namespace to which this record points. <return>TXT</return><return>txt</return>:
               Arbitrary string data associated with this record. <return>HINFO</return><return>cpu</return>: IANA number designating
               the CPU of the machine referenced by this record. <return>os</return>: IANA number designating the
               Operating System on the machine referenced by this record. See IANA's <return>Operating
               System Names</return> for the meaning of these values. <return>CAA</return><return>flags</return>: A one-byte bitfield;
               currently only bit 0 is defined, meaning 'critical'; other bits are reserved and
               should be ignored. <return>tag</return>: The CAA tag name (alphanumeric ASCII string). <return>value</return>: The CAA
               tag value (binary string, may use subformats). For additional information see: RFC
               6844<return>SOA</return><return>mname</return>: FQDN of the machine from which the resource records originated. <return>rname</return>:
               Email address of the administrative contact for this domain. <return>serial</return>: Serial # of this
               revision of the requested domain. <return>refresh</return>: Refresh interval (seconds) secondary name
               servers should use when updating remote copies of this domain. <return>retry</return>: Length of time
               (seconds) to wait after a failed refresh before making a second attempt. <return>expire</return>:
               Maximum length of time (seconds) a secondary DNS server should retain remote copies
               of the zone data without a successful refresh before discarding. <return>minimum-ttl</return>: Minimum
               length of time (seconds) a client can continue to use a DNS resolution before it
               should request a new resolution from the server.  Can be overridden by individual
               resource records. <return>AAAA</return><return>ipv6</return>: IPv6 address <return>A6</return><return>masklen</return>: Length (in bits) to inherit from
               the target specified by <strong>$chain</strong>. <return>ipv6</return>: Address for this specific record to merge with
               <strong>$chain</strong>. <return>chain</return>: Parent record to merge with <strong>$ipv6</strong> data. <return>SRV</return><return>pri</return>: (Priority) lowest
               priorities should be used first. <return>weight</return>: Ranking to weight which of commonly
               prioritized <strong>$targets</strong> should be chosen at random. <return>target</return> and <return>port</return>: hostname and port
               where the requested service can be found. For additional information see: RFC 2782
               <return>NAPTR</return><return>order</return> and <return>pref</return>: Equivalent to <strong>$pri</strong> and <strong>$weight</strong> above. <return>flags</return>, <return>services</return>, <return>regex</return>,
               and <return>replacement</return>: Parameters as defined by RFC 2915.

<comment>See Also:</comment>
   * <strong>dns_get_mx()</strong>
   * <strong>dns_check_record()</strong>


id: dom_import_simplexml
type: function
doc:
<comment>Description:</comment>
  Obtiene un objeto DOMElement desde un
     objeto SimpleXMLElement
    
  
  Esta función toma el nodo <strong>$node</strong> de la clase SimpleXML y lo convierte en un nodod <class>DOMElement</class>. Este
  nuevo objeto se puede usar como un nodo <class>DOMElement</class> nativo.

<comment>Param:</comment>
  <info>SimpleXMLElement</info>  <strong>$node</strong>  El nodo <class>SimpleXMLElement</class>.

<comment>Return:</comment>
  <info>DOMElement</info>  El nodo <class>DOMElement</class> añdido o <info>false</info> si ocurrió un error.

<comment>See Also:</comment>
   * <strong>simplexml_import_dom()</strong>


id: doubleval
type: function
doc:
<comment>Description:</comment>
  Alias de floatval
  
  Esta función es un alias de:  <strong>floatval()</strong>.


id: each
type: function
doc:
<comment>Description:</comment>
  Devolver el par clave/valor actual de un array y avanzar el cursor del array
  
  Devuelve el par clave/valor actual de un array y avanza el cursor del array.
  
  Después de que <strong>each()</strong> haya sido ejecutado, el cursor del array será puesto en el siguiente
  elemento del array, o pasado el último elemento si alcanza el final del array. Se tiene que usar
  <strong>reset()</strong> si se quiere atravesar de nuevo el array usando each.

<comment>Param:</comment>
  <info>array</info>  <strong>$array</strong>  El array de entrada.

<comment>Return:</comment>
  <info>array</info>  Devuelve el par clave/valor actual del array dado por <strong>$array</strong>. Este par es devuelto en un
         array de cuatro elementos, con las claves <return>0</return>, <return>1</return>, <return>key</return>, y <return>value</return>. Los elementos <return>0</return> y <return>key</return>
         contienen el nombre de la clave del elemento del array, y <return>1</return> y <return>value</return> contienen la
         información.
         
         Si el puntero interno del array apunta al final del contenido de array, <strong>each()</strong> devuelve
         <info>false</info>.

<comment>See Also:</comment>
   * <strong>key()</strong>
   * <strong>list()</strong>
   * <strong>current()</strong>
   * <strong>reset()</strong>
   * <strong>next()</strong>
   * <strong>prev()</strong>
   * foreach
   * Iteración de Objetos


id: easter_date
type: function
doc:
<comment>Description:</comment>
  Obtener la fecha Unix para la medianoche de Pascua de un año dado
  
  Devuelve la fecha Unix correspondiente a la medianoche de Pascua del año dado.
  
  Esta función generará una advertencia si el año está fuera del rango de fechas Unix (es decir
  típicamente, antes de 1970 o después de 2037 en sistemas 32 bits).
  
  La fecha del Domingo de Pascua fue definida por el Concilio de Nicea en el año 325 D.C. como el
  domingo después de la primera luna llena que cae en o después del Equinocio de Primavera. El
  equinocio se asume que cae en el 21 de marzo, por lo que el cálculo se reduce a determinar la
  fecha de la luna llena y la fecha del siguiente domingo. El algoritmo que se usa aquí fue
  introducido alrededor del año 532 por Dionisio el Exiguo. Bajo el Calendario Juliano (para años
  anteriores a 1753) se usa un simple ciclo de 19 años para rastrear las fases de la luna. Bajo el
  Calendario Gregoriano (para años posteriores a 1753 - concebido por Clavio y Lilio, e introducido
  por el papa Gregorio XIII en Octubre de 1582, e introducido en Gran Bretaña y sus colonias en
  Septiembre de 1752) se añadieron dos factores de corrección para hacer el ciclo más exacto.

<comment>Param:</comment>
  <info>int</info>  <strong>$year</strong>    El año como un número entre 1970 y 2037. Si se omite, el valor predeterminado  será
                el del año actual según la hora local.
  <info>int</info>  <strong>$method</strong>  Permite que las fechas de Pascua se calculen en base al calendario Juliano cuando se
                establece para <info>CAL_EASTER_ALWAYS_JULIAN</info>. véase también constantes de calendario.

<comment>Return:</comment>
  <info>int</info>  El Domingo de Pascua como fecha Unix.

<comment>See Also:</comment>
   * <strong>easter_days()</strong> para calcular la Pascua
     antes de 1970 o después de 2037
    


id: easter_days
type: function
doc:
<comment>Description:</comment>
  Obtener el número de días despúes del 21 de marzo en el cuál cae Pascua para un año dado
  
  Obtiene el número de días despúes del 21 de marzo en el cuál cae Pascua para un año dado. Si no se
  especifica el año, se asume el año actual.
  
  Esta función se puede usar en vez de <strong>easter_date()</strong> para calcular cuándo cae Pascua para años fuera
  del rango de fechas Unix (esto es, antes de 1970 o después de 2037).
  
  La fecha del Domiongo de Pascua fue definida por el Concilio de Nicea en el año 325 D.C. como el
  domingo después de la primera luna llena que cae en o después del Equinocio de Primavera. El
  equinocio se asume que cae en el 21 de marzo, por lo que el cálculo se reduce a determinar la
  fecha de la luna llena y la fecha del siguiente domingo. El algoritmo que se usa aquí fue
  introducido alrededor del año 532 por Dionisio el Exiguo. Bajo el Calendario Juliano (para años
  anteriores a 1753) se usa un simple ciclo de 19 años para rastrear las fases de la luna. Bajo el
  Calendario Gregoriano (para años posteriores a 1753 - concebido por Clavio y Lilio, e introducido
  por el papa Gregorio XIII en Octubre de 1582, e introducido en Gran Bretaña y sus colonias en
  Septiembre de 1752) se añadieron dos factores de corrección para hacer el ciclo más exacto.

<comment>Param:</comment>
  <info>int</info>  <strong>$year</strong>    El año como un número positivo. Si se omite, el valor predeterminado  será el del
                año actual según la hora local.
  <info>int</info>  <strong>$method</strong>  Permite calcular las fechas de Pascua basadas en el calendario Gregoriano durante
                los años 1582 - 1752 cuando se establece a <info>CAL_EASTER_ROMAN</info>. Vea las constantes de
                calendario para más constantes válidas.

<comment>Return:</comment>
  <info>int</info>  El número de días después del 21 de marzo en el que cae el Domingo de Pascua para el año
       <strong>$year</strong> dado.

<comment>See Also:</comment>
   * <strong>easter_date()</strong>


id: echo
type: function
doc:
<comment>Description:</comment>
  Muestra una o más cadenas
  
  Muestra todos los parámetros. No se pospone ningua nueva línea adicional.
  
  <return>echo</return> no es realmente una función (es una construcción del lenguaje), por lo que no se requiere el
  uso de paréntesis con él. <return>echo</return> (a diferencia de otras construcciones del lenguaje) no se comporta
  como una función, es decir no siempre se puede usar en el contexto de una función. Además, si se
  quiere pasar más de un parámetro a <return>echo</return>, éstos no deben estar entre paréntesis.
  
  <return>echo</return> también posee una sintaxis abreviada, donde se puede poner el símbolo igual justo después de
  la etiqueta de apertura de PHP. Antes de PHP 5.4.0, este tipo de sintaxis abreviada únicamente
  funciona con la opción de configuración short_open_tag activada.  foo.
  ]]>

<comment>Param:</comment>
  <info>string</info>  <strong>$arg1</strong>  El parámetro a mostrar.
  <info>string</info>  <strong>$...</strong>   

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>print()</strong>
   * <strong>printf()</strong>
   * <strong>flush()</strong>
   * Sintaxis de Heredoc


id: eio_busy
type: function
doc:
<comment>Description:</comment>
  Incrementar artificialmente la carga. Podría ser útil en pruebas,
     evaluaciones comparativas
  
  <strong>eio_busy()</strong> incrementa artificialmente la carga tomanto <strong>$delay</strong> segundos para ejecutarse. Puede
  usarse para depuración, o evaluaciones comparativas.

<comment>Param:</comment>
  <info>int</info>       <strong>$delay</strong>     Retraso en segundos
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  Esta llamada de retorno se llama cuando está hecho todo el grupo de
                       peticiones.
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_busy()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_nop()</strong>


id: eio_cancel
type: function
doc:
<comment>Description:</comment>
  Cancelar una petición
  
  <strong>eio_cancel()</strong> cancela una petición especificada por <strong>$req</strong>

<comment>Param:</comment>
  <info>resource</info>  <strong>$req</strong>       E rescurso de petición
  <info></info>          <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info></info>          <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info></info>          <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info>resource</info>  <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info></info>          <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>eio_grp_cancel()</strong>


id: eio_chmod
type: function
doc:
<comment>Description:</comment>
  Cambiar los permisos de fichero/directorio
  
  <strong>eio_chmod()</strong> cambia los permisos de un fichero o directorio. Los nuevos permisos son especificados
  mediandte <strong>$mode</strong>.

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      La ruta al fichero o directorio objetivo Evita rutas
                       relativas
                       
                       Evita rutas
                       relativas
  <info>int</info>       <strong>$mode</strong>      Los nuevos permisos. P.ej. <info>0644</info>.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_chmod()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_chown()</strong>


id: eio_chown
type: function
doc:
<comment>Description:</comment>
  Cambiar los permisos de un fichero/directorio
  
  Cambia los permisos de un fichero o directorio.

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      La ruta al fichero o directorio. Evita rutas
                       relativas
                       
                       Evita rutas
                       relativas
  <info>int</info>       <strong>$uid</strong>       El ID de usuario. Se ignora si es aigual a -1.
  <info>int</info>       <strong>$gid</strong>       El ID de grupo. Se ignora si es aigual a -1.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_chown()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_chmod()</strong>


id: eio_close
type: function
doc:
<comment>Description:</comment>
  Cerrar un fichero
  
  <strong>eio_close()</strong> cierra el fichero especificado por <strong>$fd</strong>.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_close()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_open()</strong>


id: eio_custom
type: function
doc:
<comment>Description:</comment>
  Ejecutar una petición personalizada como cualquier otra llamada eio_*
  
  <strong>eio_custom()</strong> ejecuta una función personalizada especificada por <strong>$execute</strong> procesándola igual que
  cualquier otra llamada eio_*.

<comment>Param:</comment>
  <info>callable</info>  <strong>$execute</strong>   Especifica la función de petición que debería coincidir con el siguiente
                       prototipo:
                       
                        <strong>$callback</strong> es una llamada de retorno de finalización de evento que debería
                       coincidir con el siguiente prototipo:
                       
                        <strong>$data</strong> son los datos pasados a <strong>$execute</strong> mediante el argumento <strong>$data</strong> sin
                       modificaciones <strong>$result</strong> valor devuelto por <strong>$execute</strong>
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_custom()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.


id: eio_dup2
type: function
doc:
<comment>Description:</comment>
  Duplicar un descriptor de fichero
  
  <strong>eio_dup2()</strong> duplica un descriptor de fichero.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor de fichero numérico origen
  <info>mixed</info>     <strong>$fd2</strong>       Un flujo, un recurso Socket, o un descriptor de fichero numérico objetivo
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_dup2()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.


id: eio_event_loop
type: function
doc:
<comment>Description:</comment>
  Monitorizar libeio hasta que todas las peticiones sean procesadas
  
  <strong>eio_event_loop()</strong> monitoriza libeio hasta que todas las peticiones sean procesadas.

<comment>Return:</comment>
  <info>bool</info>  <strong>eio_event_loop()</strong> devuelve <info>true</info> en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_poll()</strong>


id: eio_fallocate
type: function
doc:
<comment>Description:</comment>
  Permitir al llamador manipular directamente el espacio de disco
     asignado a un fichero
  
  <strong>eio_fallocate()</strong> permite al llamador manipular directamente el espacio de disco asignado al fichero
  especificado por el descriptor de fichero <strong>$fd</strong> para el rango de bytes empezando por <strong>$offset</strong> y
  continuando <strong>$length</strong> bytes.
  
  Se debería usar OR entre <info>EIO_O_CREAT</info> y <info>EIO_O_WRONLY</info> o <info>EIO_O_RDWR</info>

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero, p.ej.,
                       devuelto por <strong>eio_open()</strong>.
  <info>int</info>       <strong>$mode</strong>      Actualmente sólo está soportada una bandera para el modo:
                       <info>EIO_FALLOC_FL_KEEP_SIZE</info> (lo mismo que la constante POSIX
                       <info>FALLOC_FL_KEEP_SIZE</info>).
  <info>int</info>       <strong>$offset</strong>    Especifica el inicio del rango de bytes.
  <info>int</info>       <strong>$length</strong>    Especifica la longitud del rango de bytes.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_fallocate()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de
            error.


id: eio_fchmod
type: function
doc:
<comment>Description:</comment>
  Cambiar los permisos de un fichero
  
  <strong>eio_fchmod()</strong> cambia los permisos del fichero especificado por el descriptor de fichero <strong>$fd</strong>.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero, p.ej.,
                       devuelto por <strong>eio_open()</strong>.
  <info>int</info>       <strong>$mode</strong>      Los nuevos permisos. P.ej. 0644.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_fchmod()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_fchown()</strong>


id: eio_fchown
type: function
doc:
<comment>Description:</comment>
  Cambiar el propietario del fichero
  
  <strong>eio_fchown()</strong> cambia el propietario del fichero especificado por el descriptor de fichero <strong>$fd</strong>.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero.
  <info>int</info>       <strong>$uid</strong>       El ID de ususario. Se ignora si es igual a -1.
  <info>int</info>       <strong>$gid</strong>       El ID de grupo. Se ignora si es igual a -1.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_fdatasync()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de
            error.

<comment>See Also:</comment>
   * <strong>eio_fchmod()</strong>


id: eio_fdatasync
type: function
doc:
<comment>Description:</comment>
  Sincronizar el estado de ficheros que están en memoria con un dispositivo de almacenamiento
  
  <strong>eio_fdatasync()</strong> sincroniza el estado de ficheros que están en memoria con un dispositivo de
  almacenamiento.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero, p.ej.,
                       devuelto por <strong>eio_open()</strong>.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_fdatasync()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de
            error.


id: eio_fstat
type: function
doc:
<comment>Description:</comment>
  Obtener el estado de un fichero
  
  <strong>eio_fstat()</strong> devuelve la información del estado de un fichero en el argumento <strong>$result</strong> de <strong>$callback</strong>

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_busy()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_lstat()</strong>
   * <strong>eio_stat()</strong>


id: eio_fstatvfs
type: function
doc:
<comment>Description:</comment>
  Obtener las estadísticas del sistema de ficheros
  
  <strong>eio_fstatvfs()</strong> devuelve las estadísticas del sistema de ficheros en el parámetro <strong>$result</strong> de
  <strong>$callback</strong>.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un descriptor de fichero de un fichero del sistema de ficheros abierto.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_fstatvfs()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de
            error.

<comment>See Also:</comment>
   * <strong>eio_statvfs()</strong>


id: eio_fsync
type: function
doc:
<comment>Description:</comment>
  Sincronizar el estado de un fichero en memoria con un dispositivo de almacenamiento
  
  Sincroniza el estado de un fichero en memoria con un dispositivo de almacenamiento

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_fsync()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_sync()</strong>


id: eio_ftruncate
type: function
doc:
<comment>Description:</comment>
  Truncar un fichero
  
  <strong>eio_ftruncate()</strong> hace que un fichero regular referenciado por el descriptor de fichero <strong>$fd</strong> sea
  truncado a exactamente <strong>$length</strong> bytes.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero.
  <info>int</info>       <strong>$offset</strong>    Índice desde el principio del fichero.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_ftruncate()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de
            error.

<comment>See Also:</comment>
   * <strong>eio_truncate()</strong>


id: eio_futime
type: function
doc:
<comment>Description:</comment>
  Cambiar los momentos de último y acceso y modificación de un fichero
  
  <strong>eio_futime()</strong> cambia los momentos de último acceso y modificación de un fichero.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero, p.ej.,
                       devuelto por <strong>eio_open()</strong>.
  <info>float</info>     <strong>$atime</strong>     Momento de acceso
  <info>float</info>     <strong>$mtime</strong>     Momento de modificación
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_futime()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_utime()</strong>


id: eio_get_event_stream
type: function
doc:
<comment>Description:</comment>
  Obtiene un flujo que representa una variable usada en comnunicaciones internas con libeio
  
  <strong>eio_get_event_stream()</strong> adquiere un flujo que representa una variable usada en comunicaciones
  internas con libeio. Se podría usar para vinculaciones con algún bucle de eventos proporcionado
  por otra extensión PECL, por ejemplo libevent.

<comment>Return:</comment>
  <info>mixed</info>  <strong>eio_get_event_stream()</strong> devuelve un flujo en caso de éxito; de otro modo devuelve <info>null</info>


id: eio_get_last_error
type: function
doc:
<comment>Description:</comment>
  Devuelve un string que describe el último error asociado con un recurso de petición
  
  <strong>eio_get_last_error()</strong> devuelve un string que describe el último error asociado con <strong>$req</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$req</strong>  El recurso de petición

<comment>Return:</comment>
  <info>string</info>  <strong>eio_get_last_error()</strong> devuelve un string que describe el último error asociado con el
          recurso de petición dado por <strong>$req</strong>.
          
          Esta función ha sido declarada
          EXPERIMENTAL. Su funcionamiento, nombre y
          la documentación que le acompaña puede cambiar sin previo aviso en futuras versiones de
          PHP.
          Utilícela bajo su propia responsabilidad.


id: eio_grp
type: function
doc:
<comment>Description:</comment>
  Crear un grupo de peticiones
  
  <strong>eio_grp()</strong> crea un grupo de peticiones.

<comment>Param:</comment>
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>string</info>    <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>string</info>    <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_grp()</strong> devuelve un recurso de grupo de peticiones en caso de éxito, o <info>false</info> en caso
            de error.

<comment>See Also:</comment>
   * <strong>eio_grp_cancel()</strong>
   * <strong>eio_grp_add()</strong>


id: eio_grp_add
type: function
doc:
<comment>Description:</comment>
  Añadir una petición al grupo de peticiones
  
  <strong>eio_grp_add()</strong> añade una petición al grupo de peticiones.

<comment>Param:</comment>
  <info>resource</info>  <strong>$grp</strong>  El recurso de grupo de peticiones devuelto por <strong>eio_grp()</strong>
  <info>resource</info>  <strong>$req</strong>  El recurso de petición

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>eio_grp()</strong>
   * <strong>eio_grp_cancel()</strong>
   * <strong>eio_grp_limit()</strong>


id: eio_grp_cancel
type: function
doc:
<comment>Description:</comment>
  Cancelar un grupo de peticiones
  
  <strong>eio_grp_cancel()</strong> cancela un grupo de peticiones especificadas por el recurso de grupo de
  peticiones <strong>$grp</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$grp</strong>  El recurso de grupo de peticiones devuelto por <strong>eio_grp()</strong>.

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>eio_grp()</strong>
   * <strong>eio_grp_add()</strong>


id: eio_grp_limit
type: function
doc:
<comment>Description:</comment>
  Establecer el límite de un grupo
  
  Número límite de peticiones en un grupo de peticiones.

<comment>Param:</comment>
  <info>resource</info>  <strong>$grp</strong>    El recurso de grupo de peticiones.
  <info>int</info>       <strong>$limit</strong>  El número de peticiones del grupo.

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>eio_grp_add()</strong>


id: eio_init
type: function
doc:
<comment>Description:</comment>
  (Re-)inicializa Eio
  
  <strong>eio_init()</strong> (re-)inicializa Eio. Asigna memoria para estructuras internas de libeio y Eio. Se puede
  llamar a <strong>eio_init()</strong> antes de usar las funciones de Eio. De otro modo, será invocada internamente
  la primera vez que se invoque a una función de Eio en un proceso.
  
  Esta función fue eliminada en la versión 3.0.0RC1 de la extensión eio para PHP versión 8 y
  superiores.

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.


id: eio_link
type: function
doc:
<comment>Description:</comment>
  Crear un enlace duro par un fichero
  
  <strong>eio_link()</strong> crea el enlace duro dado por <strong>$new_path</strong> para un fichero especificado por <strong>$path</strong>.

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      La ruta del fichero origen.
  <info>string</info>    <strong>$new_path</strong>  La ruta del fichero destino.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  

<comment>See Also:</comment>
   * <strong>eio_symlink()</strong>


id: eio_lstat
type: function
doc:
<comment>Description:</comment>
  Obtener el estado de un fichero
  
  <strong>eio_lstat()</strong> devuelve la información del estado de un fichero en el argumento <strong>$result</strong> de <strong>$callback</strong>

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      La ruta de archivo
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_lstat()</strong> devuelve un recurso de petición en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_stat()</strong>
   * <strong>eio_fstat()</strong>


id: eio_mkdir
type: function
doc:
<comment>Description:</comment>
  Crear un directorio
  
  <strong>eio_mkdir()</strong> crea un directorio con el acceso especificado por <strong>$mode</strong>.

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      La ruta del nuevo directorio.
  <info>int</info>       <strong>$mode</strong>      Modo de acceso, p.ej. 0755
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_mkdir()</strong> devuelve un recurso de petición en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_rmdir()</strong>


id: eio_mknod
type: function
doc:
<comment>Description:</comment>
  Crear un fichero especial u ordinario
  
  <strong>eio_mknod()</strong> crea un fichero ordinario o especial (a menudo).
  
  Esta función
  no está documentada actualmente, solamente se encuentra disponible la lista de parámetros.

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      Ruta del nuevo nodo (fichero).
  <info>int</info>       <strong>$mode</strong>      Especifica tanto los permisos a usar como el tipo de nodo a ser creado.
                       Debería ser una combinación (usando el operador OR) de uno de los tipos de
                       fichero listados abajo y los permisos para el nuevo nodo (p.ej. 0640).
                        Los tipos de ficheros posibles son: <info>EIO_S_IFREG</info> (fichero regular),
                       <info>EIO_S_IFCHR</info> (fichero de carácter), <info>EIO_S_IFBLK</info> (fichero especial de bloqueo),
                       <info>EIO_S_IFIFO</info> (FIFO - tubería nominada) y <info>EIO_S_IFSOCK</info> (socket de dominio
                       UNIX).
                        Para especificar permisos se podrían usar constantes EIO_S_I*.
  <info>int</info>       <strong>$dev</strong>       Si el tipo de fichero es <info>EIO_S_IFCHR</info> o <info>EIO_S_IFBLK</info>, dev especifica el número
                       mayor y menor del recién creado fichero especial de dispositivo. De otro modo
                       <strong>$dev</strong> es ignorado. Véase la página del manual mknod(2) para más detalles.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_mknod()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_open()</strong>


id: eio_nop
type: function
doc:
<comment>Description:</comment>
  No hace nada, sólo recorre el ciclo de peticiones entero
  
  <strong>eio_nop()</strong> no hace nada, sólo recorre el ciclo de peticiones entero. Podría ser util al depurar.

<comment>Param:</comment>
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_nop()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_busy()</strong>


id: eio_npending
type: function
doc:
<comment>Description:</comment>
  Devolver el número de peticiones, excepto las no manejadas
  
  <strong>eio_npending()</strong> devuelve el número de peticiones, excepto las no manejadas.

<comment>Return:</comment>
  <info>int</info>  <strong>eio_npending()</strong> devuelve el número de peticiones, excepto las no manejadas.

<comment>See Also:</comment>
   * <strong>eio_nreqs()</strong>
   * <strong>eio_nready()</strong>
   * <strong>eio_nthreads()</strong>


id: eio_nready
type: function
doc:
<comment>Description:</comment>
  Devolver el número de peticiones aún no tratadas

<comment>Return:</comment>
  <info>int</info>  <strong>eio_nready()</strong> devuelve el número de peticiones aún no tratadas

<comment>See Also:</comment>
   * <strong>eio_nreqs()</strong>
   * <strong>eio_nready()</strong>
   * <strong>eio_nthreads()</strong>


id: eio_nreqs
type: function
doc:
<comment>Description:</comment>
  Devuelve el número de peticiones a ser procesadas
  
  <strong>eio_nreqs()</strong> se podría llamar en un bucle personalizado al llamar a <strong>eio_poll()</strong>.

<comment>Return:</comment>
  <info>int</info>  <strong>eio_nreqs()</strong> devuelve el número de peticiones a ser procesadas.

<comment>See Also:</comment>
   * <strong>eio_poll()</strong>
   * <strong>eio_nready()</strong>


id: eio_nthreads
type: function
doc:
<comment>Description:</comment>
  Devuelve el número de hilos actualmente en uso

<comment>Return:</comment>
  <info>int</info>  <strong>eio_nthreads()</strong> devuelve el número de hilos actualmente en uso.

<comment>See Also:</comment>
   * <strong>eio_npending()</strong>
   * <strong>eio_nready()</strong>
   * <strong>eio_nreqs()</strong>
   * <strong>eio_set_max_idle()</strong>
   * <strong>eio_set_max_parallel()</strong>
   * <strong>eio_set_min_parallel()</strong>


id: eio_open
type: function
doc:
<comment>Description:</comment>
  Abrir un fichero
  
  <strong>eio_open()</strong> abre el archivo especificado por <strong>$path</strong> en el modo de acceso <strong>$mode</strong> con

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      Ruta del archivo a abrir.  En algunas SAPIs (p.ej. PHP-FPM) podría fallar si
                       no se especifica la ruta completa.
                       
                       En algunas SAPIs (p.ej. PHP-FPM) podría fallar si no se especifica la ruta
                       completa.
  <info>int</info>       <strong>$flags</strong>     Una de las constantes EIO_O_*, o sus combinaciones. Las constantes EIO_O_*
                       tienen el mismo significado que sus correspondientes homónimas O_* definidas
                       en el fichero de cabecera C <return>fnctl.h</return>. Por defecto es <info>EIO_O_RDWR</info>.
  <info>int</info>       <strong>$mode</strong>      Una de las constantes EIO_S_I*, o sus combinaciones (mediante el operador a
                       nivel de bits OR). Las constantes tienen el mismo significado que sus
                       homónimas S_I* definidas en el archivo de cabecera C sys/stat.h. Necesario si
                       se crea un fichero. En otro caso es ignorado.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_open()</strong> devuelve un descriptor de fichero en el argumento <strong>$result</strong> de <strong>$callback</strong> en
            caso de éxito; de otro modo, <strong>$result</strong> es igual a <info>-1</info>.

<comment>See Also:</comment>
   * <strong>eio_mknod()</strong>


id: eio_poll
type: function
doc:
<comment>Description:</comment>
  Puede ser llamada siempre que existan peticiones pendientes que necesitan ser finalizadas
  
  <strong>eio_poll()</strong> se puede usar para implementar un bucle de eventos especial. Para esto, podria usarse
  <strong>eio_nreqs()</strong> para comprobar si existen peticiones no procesadas.
  
  Aplicable solamente al implementar bucles de eventos del espacio de usuario.

<comment>Return:</comment>
  <info>int</info>  Si cualquier invocación a una petición devuelve un valor distinto de cero, devuelve ese
       valor. De otro modo devuelve <info>0</info>.

<comment>See Also:</comment>
   * <strong>eio_nreqs()</strong>


id: eio_read
type: function
doc:
<comment>Description:</comment>
  Leer de un descriptor de fichero en un índice dado
  
  <strong>eio_read()</strong> lee hasta <strong>$length</strong> bytes desde el descriptor de fichero <strong>$fd</strong> empezando en <strong>$offset</strong>. Los
  bytes leídos son almacenados en el argumento <strong>$result</strong> de <strong>$callback</strong>.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero.
  <info>int</info>       <strong>$length</strong>    El número máximo de bytes a leer.
  <info>int</info>       <strong>$offset</strong>    El índice dentro del fichero.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_read()</strong> almacena los bytes leídos en el argumento <strong>$result</strong> de la función <strong>$callback</strong>.

<comment>See Also:</comment>
   * <strong>eio_open()</strong>
   * <strong>eio_write()</strong>
   * <strong>eio_close()</strong>
   * <strong>eio_event_loop()</strong>


id: eio_readahead
type: function
doc:
<comment>Description:</comment>
  Perform file readahead into page cache
  
  <strong>eio_readahead()</strong> rellena la caché de página con información de un fichero, por lo que lecturas
  posteriores de ese fichero no bloquearán la E/S del disco. Véase la página del manual <return>READAHEAD(2)</return>
  para más detalles.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero.
  <info>int</info>       <strong>$offset</strong>    El punto de inicio desde el cual se va a leer la información.
  <info>int</info>       <strong>$length</strong>    El número de bytes a leer.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_readahead()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de
            error.


id: eio_readdir
type: function
doc:
<comment>Description:</comment>
  Leer un directorio al completo
  
  Leer un directorio al completo (mediante las llamadas al sistema de <return>opendir</return>, <return>readdir</return> y <return>closedir</return>) y
  devuelve o los nombres o un array en el argumento <strong>$result</strong> de la función <strong>$callback</strong>, dependiendo del
  argumento <strong>$flags</strong>.

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      La ruta del directorio.
  <info>int</info>       <strong>$flags</strong>     Una combinación de constantes EIO_READDIR_*.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>string</info>    <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>string</info>    <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_readdir()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de
            error. Establece el argumento <strong>$result</strong> de la función <strong>$callback</strong> function según el
            parámetro <strong>$flags</strong>:
            
            <info>EIO_READDIR_DENTS</info> (<info>int</info>)  Bandera <strong>eio_readdir()</strong>. Si se especifica, el argumento
            resultante de la llamada de retorno se convierte en un array con las siguientes claves:
            <return>'names'</return> - array de nombres de directorios <return>'dents'</return> - array de <return>structura eio_dirent</return>-como
            los arrays pero teniendo las siguientes claves: <return>'name'</return> - el nombre del directorio;
            <return>'type'</return> - una de las constantes EIO_DT_*; <return>'inode'</return> - el número de inodo, si está
            disponible, de otro modo sin especificar; <info>EIO_READDIR_DIRS_FIRST</info> (<info>int</info>)  Cuando se
            especifica esta bandera, los nombres serán devueltos en un orden donde probablemente los
            directorios vallan primero, en un orden de estadísticas óptimo. <info>EIO_READDIR_STAT_ORDER</info>
            (<info>int</info>)  Cuando se especifica esta bandera, los nombres serán devueltos en un orden
            apropiado para realizar estadísticas (<return>stat</return>) con cada uno. Cuando se planea usar la
            función <strong>stat()</strong> para realizar estadísticas de todos los archivos del directorio dado, el
            orden devuelto probablemente sea más rápido. <info>EIO_READDIR_FOUND_UNKNOWN</info> (<info>int</info>)
             
            
            Bandera <strong>eio_readdir()</strong>. Si se especifica, el argumento resultante de la llamada de
            retorno se convierte en un array con las siguientes claves: <return>'names'</return> - array de nombres
            de directorios <return>'dents'</return> - array de <return>structura eio_dirent</return>-como los arrays pero teniendo las
            siguientes claves: <return>'name'</return> - el nombre del directorio; <return>'type'</return> - una de las constantes
            EIO_DT_*; <return>'inode'</return> - el número de inodo, si está disponible, de otro modo sin
            especificar;
            
            Cuando se especifica esta bandera, los nombres serán devueltos en un orden donde
            probablemente los directorios vallan primero, en un orden de estadísticas óptimo.
            
            Cuando se especifica esta bandera, los nombres serán devueltos en un orden apropiado
            para realizar estadísticas (<return>stat</return>) con cada uno. Cuando se planea usar la función <strong>stat()</strong>
            para realizar estadísticas de todos los archivos del directorio dado, el orden devuelto
            probablemente sea más rápido.
            
            Tipos de nodos: <info>EIO_DT_UNKNOWN</info> (<info>int</info>)  Tipo de nodo desconocido(muy común). Se necistan
            más estadísticas (<strong>stat()</strong>). <info>EIO_DT_FIFO</info> (<info>int</info>)  Tipo de nodo FIFO <info>EIO_DT_CHR</info> (<info>int</info>)  Tipo
            de nodo <info>EIO_DT_MPC</info> (<info>int</info>)  Tipo de nodo de dispositivo de caracteres multiplexado
            (v7+coherent) <info>EIO_DT_DIR</info> (<info>int</info>)  Tipo de nodo de directorio <info>EIO_DT_NAM</info> (<info>int</info>)  Tipo de
            nodo de fichero Xenix nominado especial <info>EIO_DT_BLK</info> (<info>int</info>)  Tipo de nodo <info>EIO_DT_MPB</info> (<info>int</info>)
            Dispositivo de bloqueo multiplexado (v7+coherent) <info>EIO_DT_REG</info> (<info>int</info>)  Tipo de nodo
            <info>EIO_DT_NWK</info> (<info>int</info>)  <info>EIO_DT_CMP</info> (<info>int</info>)  Tipo de noto especial de red HP-UX <info>EIO_DT_LNK</info> (<info>int</info>)
            Tipo de nodo de vínculo <info>EIO_DT_SOCK</info> (<info>int</info>)  Tipo de nodo socket <info>EIO_DT_DOOR</info> (<info>int</info>)  Tipo
            de nodo de puerta de Solaris <info>EIO_DT_WHT</info> (<info>int</info>)  Tipo de nodo <info>EIO_DT_MAX</info> (<info>int</info>)  Valor de
            tipo de nodo más alto
            
            Tipo de nodo desconocido(muy común). Se necistan más estadísticas (<strong>stat()</strong>).
            
            Tipo de nodo FIFO
            
            Tipo de nodo
            
            Tipo de nodo de dispositivo de caracteres multiplexado (v7+coherent)
            
            Tipo de nodo de directorio
            
            Tipo de nodo de fichero Xenix nominado especial
            
            Tipo de nodo
            
            Dispositivo de bloqueo multiplexado (v7+coherent)
            
            Tipo de nodo
            
            Tipo de noto especial de red HP-UX
            
            Tipo de nodo de vínculo
            
            Tipo de nodo socket
            
            Tipo de nodo de puerta de Solaris
            
            Tipo de nodo
            
            Valor de tipo de nodo más alto


id: eio_readlink
type: function
doc:
<comment>Description:</comment>
  Leer el valor de un enlace simbólico

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      La ruta del enlace simbólico fuente
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_readlink()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de
            error.

<comment>See Also:</comment>
   * <strong>eio_symlink()</strong>


id: eio_realpath
type: function
doc:
<comment>Description:</comment>
  Obtener el nombre de ruta absoluto canonizado
  
  <strong>eio_realpath()</strong> devuelve el nombre de ruta absoluto canonizado en el argumento <strong>$result</strong> de la
  función <strong>$callback</strong>.

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      EL nombre abreviado
  <info>int</info>       <strong>$pri</strong>       
  <info>callable</info>  <strong>$callback</strong>  
  <info>string</info>    <strong>$data</strong>      

<comment>Return:</comment>
  <info>resource</info>  


id: eio_rename
type: function
doc:
<comment>Description:</comment>
  Cambiar el nombre o la ubicación de un fichero
  
  <strong>eio_rename()</strong> renombra o mueve un fichero a una nueva ubicación.

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      La ruta de origen
  <info>string</info>    <strong>$new_path</strong>  La ruta destino
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_rename()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.


id: eio_rmdir
type: function
doc:
<comment>Description:</comment>
  Eliminar un directorio
  
  <strong>eio_rmdir()</strong> elimina un directorio.

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      La ruta del directorio
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_rmdir()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_mkdir()</strong>


id: eio_seek
type: function
doc:
<comment>Description:</comment>
  Reposiciona el índice del fichero abierto asociado con el argumento fd al argumento offset según
  la
  directiva whence
  
  <strong>eio_seek()</strong> reposiciona el índice del fichero abierto asociado con el flujo, el recurso Socket, o
  el descriptor de fichero especificado por <strong>$fd</strong> al argumento <strong>$offset</strong> según la directiva <strong>$whence</strong> como
  sigue: <info>EIO_SEEK_SET</info> - Establece la posición igual a <strong>$offset</strong> bytes.<info>EIO_SEEK_CUR</info> - Establece la
  posición a la ubicación actual más <strong>$offset</strong>.<info>EIO_SEEK_END</info> - Establece la posición al final del
  fichero más <strong>$offset</strong>.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor de fichero numérico
  <info>int</info>       <strong>$offset</strong>    El punto de inicio desde donde van a leerse los datos.
  <info></info>          <strong>$length</strong>    El número de bytes a leer.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Una variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_seek()</strong> devuelve el recurso solicitado en caso de éxito, o <info>false</info> en caso de error.


id: eio_sendfile
type: function
doc:
<comment>Description:</comment>
  Transferir información entre descriptores de ficheros
  
  <strong>eio_sendfile()</strong> copia información entre un descriptor de fichero y otror. Véase la página del
  manual <return>SENDFILE(2)</return> para más detalles.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$out_fd</strong>    Un flujo de salida, un recurso Socket, o un descriptor de fichero. Debería
                       ser abierto para escritura.
  <info>mixed</info>     <strong>$in_fd</strong>     Un flujo de entrada, un recurso Socket, o un descriptor de fichero. Debería
                       ser abierto para lectura.
  <info>int</info>       <strong>$offset</strong>    El índice dentro del fichero fuente.
  <info>int</info>       <strong>$length</strong>    El número de bytes a copiar.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>string</info>    <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>string</info>    <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_sendfile()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de
            error.


id: eio_set_max_idle
type: function
doc:
<comment>Description:</comment>
  Establecer el número máximo de hilos parados

<comment>Param:</comment>
  <info>int</info>  <strong>$nthreads</strong>  El número de hilo parados.

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>eio_nthreads()</strong>
   * <strong>eio_set_min_parallel()</strong>
   * <strong>eio_set_max_parallel()</strong>


id: eio_set_max_parallel
type: function
doc:
<comment>Description:</comment>
  Esteblecer el máximo de hilos paralelos

<comment>Param:</comment>
  <info>int</info>  <strong>$nthreads</strong>  El número de hilos paralelos.

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>eio_nthreads()</strong>
   * <strong>eio_set_max_idle()</strong>
   * <strong>eio_set_min_parallel()</strong>


id: eio_set_max_poll_reqs
type: function
doc:
<comment>Description:</comment>
  Establecer el máximo número de peticiones procesadas en una monitorización

<comment>Param:</comment>
  <info>int</info>  <strong>$nreqs</strong>  El número de peticiones

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.


id: eio_set_max_poll_time
type: function
doc:
<comment>Description:</comment>
  Establecer el tiempo máximo de monitorización
  
  La monitorización se detiene si toma más de <strong>$nseconds</strong> segundos.

<comment>Param:</comment>
  <info>float</info>  <strong>$nseconds</strong>  El número de segundos

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.


id: eio_set_min_parallel
type: function
doc:
<comment>Description:</comment>
  Esteblecer el número de hilos paralelos mínimo

<comment>Param:</comment>
  <info>string</info>  <strong>$nthreads</strong>  El número de hilos paralelos.

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>eio_nthreads()</strong>
   * <strong>eio_set_max_idle()</strong>
   * <strong>eio_set_max_parallel()</strong>


id: eio_stat
type: function
doc:
<comment>Description:</comment>
  Obtener el estado de un fichero
  
  <strong>eio_stat()</strong> devuelve la información del estado de un fichero en el argumento <strong>$result</strong> de <strong>$callback</strong>

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      La ruta de archivo
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_stat()</strong>devuelve un recurso de petición en caso de éxito o <info>false</info> en caso de error. En
            caso de éxito asigna el argumento <strong>$result</strong> de <strong>$callback</strong> a un array.

<comment>See Also:</comment>
   * <strong>eio_lstat()</strong>
   * <strong>eio_fstat()</strong>


id: eio_statvfs
type: function
doc:
<comment>Description:</comment>
  Obtener las estadísticas del sistema de ficheros
  
  <strong>eio_statvfs()</strong> devuelve la información de las estadísticas del sistema de ficheros en el argumento
  <strong>$result</strong> de <strong>$callback</strong>

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      El nombre de ruta de cualquier fichero dentro del sistema de ficheros montado
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_statvfs()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de
            error. En caso de éxito asigna el argumento <strong>$result</strong> de <strong>$callback</strong> a un array.


id: eio_symlink
type: function
doc:
<comment>Description:</comment>
  Crear un enlace simbólico
  
  <strong>eio_symlink()</strong> crea un enlace simbólico <strong>$new_path</strong> hacia <strong>$path</strong>.

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      La ruta fuente
  <info>string</info>    <strong>$new_path</strong>  La ruta destino
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_symlink()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de
            error.

<comment>See Also:</comment>
   * <strong>eio_link()</strong>


id: eio_sync
type: function
doc:
<comment>Description:</comment>
  Consignar el caché de buffer cache al disco

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_sync()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.


id: eio_sync_file_range
type: function
doc:
<comment>Description:</comment>
  Sincornizar un segmento de fichero con el disco
  
  <strong>eio_sync_file_range()</strong> permite un control preciso al sincronizar el fichero abierto mencionado por
  el descriptor de fichero <strong>$fd</strong> con el disco.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        El descriptor de fichero
  <info>int</info>       <strong>$offset</strong>    El byte de inicio del rango del archivo a ser sincronizado
  <info>int</info>       <strong>$nbytes</strong>    Especifica la longitud del rango a ser sincronizado, en bytes. Si <strong>$nbytes</strong> es
                       cero, son sicronizados todos los bytes desde <strong>$offset</strong> hasta el final del
                       fichero.
  <info>int</info>       <strong>$flags</strong>     Una máscara de bits. Puede incluir cualquiera de los siguientes valores:
                       <info>EIO_SYNC_FILE_RANGE_WAIT_BEFORE</info>, <info>EIO_SYNC_FILE_RANGE_WRITE</info>,
                       <info>EIO_SYNC_FILE_RANGE_WAIT_AFTER</info>. Estas banderas tienen el mismo significado
                       que sus homónimas SYNC_FILE_RANGE_* (véase la página del manual
                       <return>SYNC_FILE_RANGE(2)</return>).
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_sync_file_range()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso
            de error.


id: eio_syncfs
type: function
doc:
<comment>Description:</comment>
  Realizar una llamada al sistema de syncfs de Linux si está disponible

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Descriptor de fichero
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_syncfs()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.


id: eio_truncate
type: function
doc:
<comment>Description:</comment>
  Truncar un fichero
  
  <strong>eio_truncate()</strong> hace que el fichero nominado por <strong>$path</strong> sea truncado al tamaño de exactamente
  <strong>$length</strong> bytes

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      Ruta del fichero.
  <info>int</info>       <strong>$offset</strong>    Índice desde el principio del fichero.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_busy()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_ftruncate()</strong>


id: eio_unlink
type: function
doc:
<comment>Description:</comment>
  Borrar un nombre y posiblemente el fichero al que se refiere
  
  <strong>eio_unlink()</strong> borra un nombre del sistema de ficheros.

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      Ruta del fichero.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_unlink()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.


id: eio_utime
type: function
doc:
<comment>Description:</comment>
  Cambiar los momentos de último y acceso y modificación de un fichero

<comment>Param:</comment>
  <info>string</info>    <strong>$path</strong>      Ruta del fichero.
  <info>float</info>     <strong>$atime</strong>     Momento de acceso
  <info>float</info>     <strong>$mtime</strong>     Momento de modificación
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_utime()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_futime()</strong>


id: eio_write
type: function
doc:
<comment>Description:</comment>
  Escribir en un fichero
  
  <strong>eio_write()</strong> escribe hasta <strong>$length</strong> bytes desde <strong>$str</strong> en el índice <strong>$offset</strong> desde el principo del
  fichero.

<comment>Param:</comment>
  <info>mixed</info>     <strong>$fd</strong>        Un flujo, un recurso Socket, o un descriptor numérico de fichero, p.ej.,
                       devuelto por <strong>eio_open()</strong>.
  <info>string</info>    <strong>$str</strong>       La cadena fuente
  <info>int</info>       <strong>$length</strong>    Número máximo de bytes a escribir.
  <info>int</info>       <strong>$offset</strong>    ïndice desde el principio del fichero.
  <info>int</info>       <strong>$pri</strong>       La prioridad de petición: <info>EIO_PRI_DEFAULT</info>, <info>EIO_PRI_MIN</info>, <info>EIO_PRI_MAX</info>, o <info>null</info>.
                       Si se pasa <info>null</info>, <strong>$pri</strong> es establecido internamente a
                       <info>EIO_PRI_DEFAULT</info>.
  <info>callable</info>  <strong>$callback</strong>  La función <strong>$callback</strong> es llamada cuando la petición está hecha.
                       Debería seguir el siguiente prototipo: 
                       <strong>$data</strong>son datos personalizados pasados a la petición.<strong>$result</strong>es el valor del
                       resultado específico de la petición; básicamente, el valor devuelto por la
                       correspondiente llamada al sistema.<strong>$req</strong>es el recurso de petición opcional que
                       puede usarse con funciones como <strong>eio_get_last_error()</strong>
                       
                       son datos personalizados pasados a la petición.
                       
                       es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
                       
                       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      son datos personalizados pasados a la petición.
  <info></info>          <strong>$result</strong>    es el valor del resultado específico de la petición; básicamente, el valor
                       devuelto por la correspondiente llamada al sistema.
  <info></info>          <strong>$req</strong>       es el recurso de petición opcional que puede usarse con funciones como
                       <strong>eio_get_last_error()</strong>
  <info>mixed</info>     <strong>$data</strong>      Variable arbitraria pasada a <strong>$callback</strong>.

<comment>Return:</comment>
  <info>resource</info>  <strong>eio_write()</strong> devuelve un recurso de petición en caso de éxito, o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>eio_open()</strong>


id: empty
type: function
doc:
<comment>Description:</comment>
  Determina si una variable está vacía
  
  Determina si una variable es considerada vacía. Una variable se considera vacía si no existe o si
  su valor es igual a <info>false</info>. <strong>empty()</strong> no genera una advertencia si la variable no existe.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$var</strong>  La variable que se comprueba
               
               Antes de PHP 5.5, <strong>empty()</strong> sólo soportaba variables; cualquier otra cosa provocaría un
               error del intérprete. En otras palabras, lo siguiente no funcionaría:
               empty(trim($nombre)). En su lugar, utilice trim($nombre) == false.
               
               No se genera una advertencia si la variable no existe. Esto significa que <strong>empty()</strong> es
               esencialmente el equivalente conciso de !isset($var) || $var == false.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>false</info> si <strong>$var</strong> existe y tiene un valor no vacío, distinto de cero. De otro modo
        devuelve <info>true</info>.
        
        Los siguientes valores son considerados como vacíos: <return>"" (una cadena vacía)</return><return>0 (0 como un
        integer)</return><return>0.0 (0 como un float)</return><return>"0" (0 como un string)</return><info>null</info><info>false</info><return>array() (un array vacío)</return>

<comment>See Also:</comment>
   * <strong>isset()</strong>
   * __isset()
   * <strong>unset()</strong>
   * <strong>array_key_exists()</strong>
   * <strong>count()</strong>
   * <strong>strlen()</strong>
   * Las tablas de comparación de tipos


id: enchant_broker_describe
type: function
doc:
<comment>Description:</comment>
  Enumera los proveedores de Enchant
  
  Enumera los proveedores de Enchant e indica alguna información rudimentaria sobre ellos. La misma
  información es proporcionada a través de phpinfo().

<comment>Param:</comment>
  <info>resource</info>  <strong>$broker</strong>  Recurso de agente

<comment>Return:</comment>
  <info>array</info>  Devuelve un <info>array</info> de los proveedores de Enchant disponibles con sus datos,  o <info>false</info> en caso
         de error.


id: enchant_broker_dict_exists
type: function
doc:
<comment>Description:</comment>
  Si existe o no un diccionario. Usando una etiqueta no vacía
  
  Indica si un diccionario existo o no, usando etiquetas no vacías

<comment>Param:</comment>
  <info>resource</info>  <strong>$broker</strong>  Recurso de agente
  <info>string</info>    <strong>$tag</strong>     Etiqueta no vacía en el formato REGINAL, ej.: us_US, ch_DE, etc.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> cuando existe la etiqueta o <info>false</info> cuando no.

<comment>See Also:</comment>
   * <strong>enchant_broker_describe()</strong>


id: enchant_broker_free
type: function
doc:
<comment>Description:</comment>
  Liberar el recurso de agente y sus diccionarios
  
  Libera un recurso de agente con todos sus diccionarios.

<comment>Param:</comment>
  <info>resource</info>  <strong>$broker</strong>  Recurso de agente

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>enchant_broker_init()</strong>


id: enchant_broker_free_dict
type: function
doc:
<comment>Description:</comment>
  Liberar un recurso de diccionario
  
  Libera un recurso de diccionario.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dict</strong>  Recurso de diccionario.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>enchant_broker_request_dict()</strong>
   * <strong>enchant_broker_request_pwl_dict()</strong>


id: enchant_broker_get_dict_path
type: function
doc:
<comment>Description:</comment>
  Obtener la ruta del directorio para un 'backend' dado
  
  Obtener la ruta del directorio para un 'backend' dado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$broker</strong>     El recurso de 'broker'.
  <info>int</info>       <strong>$dict_type</strong>  El tipo de diccionario, esto es, <info>ENCHANT_MYSPELL</info> o <info>ENCHANT_ISPELL</info>.

<comment>Return:</comment>
  <info>bool</info>  Devuelve la ruta del directorio del diccionario en caso de éxito  o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>enchant_broker_set_dict_path()</strong>


id: enchant_broker_get_error
type: function
doc:
<comment>Description:</comment>
  Devuelve el último error del agente
  
  Devuelve el último error que ocurrión en este agente.

<comment>Param:</comment>
  <info>resource</info>  <strong>$broker</strong>  Recurso de agente.

<comment>Return:</comment>
  <info>string</info>  Devuelve la cadena de mensaje si se encontró un error o <info>false</info>


id: enchant_broker_init
type: function
doc:
<comment>Description:</comment>
  Crear un nuevo objeto agente capaz de hacer peticiones

<comment>Return:</comment>
  <info>resource</info>  Devuelve un recurso de agente si se tuvo éxito o <info>false</info>.

<comment>See Also:</comment>
   * <strong>enchant_broker_free()</strong>


id: enchant_broker_list_dicts
type: function
doc:
<comment>Description:</comment>
  Devuelve una lista de los diccionarios disponibles
  
  Devuelve una lista de los diccionarios disponibles con sus detalles.

<comment>Param:</comment>
  <info>resource</info>  <strong>$broker</strong>  Recurso de agente

<comment>Return:</comment>
  <info>mixed</info>  Devuelve un <info>array</info> de los diccionarios disponibles con sus detalles,  o <info>false</info> en caso de
         error.

<comment>See Also:</comment>
   * <strong>enchant_broker_describe()</strong>


id: enchant_broker_request_dict
type: function
doc:
<comment>Description:</comment>
  Crear un diccionario usanto una etiqueta
  
  Crea un diccionario usando una etiqueta no vacía que se desea para solicitar un diccionario
  ("en_US", "de_DE", ...)

<comment>Param:</comment>
  <info>resource</info>  <strong>$broker</strong>  Recurso de agente
  <info>string</info>    <strong>$tag</strong>     Una etiqueta que describe la configuración regional, por ejemplo en_US, de_DE

<comment>Return:</comment>
  <info>resource</info>  Devuelve un recurso de diccionario si se tuvo éxito  o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>enchant_dict_describe()</strong>
   * <strong>enchant_broker_dict_exists()</strong>
   * <strong>enchant_broker_free_dict()</strong>


id: enchant_broker_request_pwl_dict
type: function
doc:
<comment>Description:</comment>
  Crea un diccionario usando un fichero PWL
  
  Crea un diccionario usando un fichero PWL. Un fichero PWL es un fichero personal de palabras con
  una palabra por línea.

<comment>Param:</comment>
  <info>resource</info>  <strong>$broker</strong>    Recurso de agente
  <info>string</info>    <strong>$filename</strong>  Ruta al fichero PWL. Si no existe tal fichero, se creará uno nuevo si es
                       posible.

<comment>Return:</comment>
  <info>resource</info>  Devuelve un recurso de diccionario si se tuvo éxito  o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>enchant_dict_describe()</strong>
   * <strong>enchant_broker_dict_exists()</strong>
   * <strong>enchant_broker_free_dict()</strong>


id: enchant_broker_set_dict_path
type: function
doc:
<comment>Description:</comment>
  Establecer la ruta del directorio para un 'backend' dado
  
  Establecer la ruta del directorio para un 'backend' dado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$broker</strong>     El recurso de 'broker'.
  <info>int</info>       <strong>$dict_type</strong>  El tipo de diccionario, esto es, <info>ENCHANT_MYSPELL</info> o <info>ENCHANT_ISPELL</info>.
  <info>string</info>    <strong>$value</strong>      La ruta de directorio del diccionario.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>enchant_broker_get_dict_path()</strong>


id: enchant_broker_set_ordering
type: function
doc:
<comment>Description:</comment>
  Declara una preferencia de diccionarios a usar para el lenguaje
  
  Declara una preferencia de diccionarios a usar para el lenguaje descrito/referido por 'tag'. El
  orden es una lista delimitada por comas de nombres de proveedores. Como excepción especial, la
  etiqueta (tag) "*" se puede usar como una etiqueta de lenguaje para declarar un orden
  predeterminado para cualquier lenguaje que no declare explícitamente un orden.

<comment>Param:</comment>
  <info>resource</info>  <strong>$broker</strong>    Recurso de agente
  <info>string</info>    <strong>$tag</strong>       Etiqueta de lenguaje. La etiqueta especial "*" se puede usar como una
                       etiqueta de lenguaje para declarar un orden predeterminado para cualquier
                       lenguaje que no declare explícitamente un orden.
  <info>string</info>    <strong>$ordering</strong>  Lista delimitada por comas de nombres de proveedores

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.


id: enchant_dict_add
type: function
doc:
<comment>Description:</comment>
  Add a word to personal word list
  
  Add a word to personal word list of the given dictionary.

<comment>Param:</comment>
  <info>EnchantDictionary</info>  <strong>$dictionary</strong>  An Enchant dictionary returned by <strong>enchant_broker_request_dict()</strong> or
                                  <strong>enchant_broker_request_pwl_dict()</strong>.
  <info>string</info>             <strong>$word</strong>        The word to add

<comment>Return:</comment>
  <info>void</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>enchant_broker_request_pwl_dict()</strong>
   * <strong>enchant_broker_request_dict()</strong>


id: enchant_dict_add_to_personal
type: function
doc:
<comment>Description:</comment>
  Añadir una palabra a una lista personal de palabras
  
  Añade una palabra a una lista personal de palabras del diccionario dado.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dict</strong>  Recurso de diccionario
  <info>string</info>    <strong>$word</strong>  La palabra a añadir

<comment>Return:</comment>
  <info>void</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.

<comment>See Also:</comment>
   * <strong>enchant_broker_request_pwl_dict()</strong>
   * <strong>enchant_broker_request_dict()</strong>


id: enchant_dict_add_to_session
type: function
doc:
<comment>Description:</comment>
  Añadir una palabra a esta sesión ortográfica
  
  Añade una palabra al diccionario dado. Sólo será añadida para la sesión ortográfica activa.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dict</strong>  Recurso de diccionario
  <info>string</info>    <strong>$word</strong>  La palabra a añadir

<comment>Return:</comment>
  <info>void</info>  No devuelve ningún valor.

<comment>See Also:</comment>
   * <strong>enchant_broker_request_dict()</strong>


id: enchant_dict_check
type: function
doc:
<comment>Description:</comment>
  Comprobar si una palabra está correctamente escrita o no
  
  Si la palabra está correctamente escrita se devuelve <info>true</info>, de otro modo se devuelve <info>false</info>

<comment>Param:</comment>
  <info>resource</info>  <strong>$dict</strong>  Recurso de diccionario
  <info>string</info>    <strong>$word</strong>  La palabra a comprobar

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> si la palabra está correctamente escrita, <info>false</info> si no.


id: enchant_dict_describe
type: function
doc:
<comment>Description:</comment>
  Describe un diccionario individual
  
  Devuelve los detalles del diccionario.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dict</strong>  Recurso de diccionario

<comment>Return:</comment>
  <info>mixed</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.


id: enchant_dict_get_error
type: function
doc:
<comment>Description:</comment>
  Devuelve el último error de la sesión ortográfica actual
  
  Devuelve el último error de la sesión ortográfica actual

<comment>Param:</comment>
  <info>resource</info>  <strong>$dict</strong>  Recurso de diccionario

<comment>Return:</comment>
  <info>string</info>  Devuelve un mensaje de error como cadena o <info>false</info> si no se produjo ningún error.


id: enchant_dict_is_added
type: function
doc:
<comment>Description:</comment>
  Whether or not 'word' exists in this spelling-session
  
  Tells whether or not a word already exists in the current session.

<comment>Param:</comment>
  <info>EnchantDictionary</info>  <strong>$dictionary</strong>  An Enchant dictionary returned by <strong>enchant_broker_request_dict()</strong> or
                                  <strong>enchant_broker_request_pwl_dict()</strong>.
  <info>string</info>             <strong>$word</strong>        The word to lookup

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if the word exists or <info>false</info>

<comment>See Also:</comment>
   * <strong>enchant_dict_add_to_session()</strong>


id: enchant_dict_is_in_session
type: function
doc:
<comment>Description:</comment>
  Si existe o no una palabra en esta sesión ortográfica
  
  Indica si una palabra ya existe en la sesión actual.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dict</strong>  Recurso de diccionario
  <info>string</info>    <strong>$word</strong>  La palabra a buscar

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> si la palabra exsite o <info>false</info>

<comment>See Also:</comment>
   * <strong>enchant_dict_add_to_session()</strong>


id: enchant_dict_quick_check
type: function
doc:
<comment>Description:</comment>
  Verifica si la palabra está correctamente escrita y proporciona sugerencias
  
  Si la palabra está correctamente escrita devuelve <info>true</info>, de otro modo devuelve <info>false</info>, si la
  varialbe de sugerencias se proporciona, la rellena con alternativas ortográficas.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dict</strong>         Recurso de diccionario
  <info>string</info>    <strong>$word</strong>         La palabra a verificar
  <info>array</info>     <strong>$suggestions</strong>  Si la palabra no está correctamente escrita, está variable contendrá una
                          matriz de sugerencias.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> si la palabra está correctamente escrita o <info>false</info>

<comment>See Also:</comment>
   * <strong>enchant_dict_check()</strong>
   * <strong>enchant_dict_suggest()</strong>


id: enchant_dict_store_replacement
type: function
doc:
<comment>Description:</comment>
  Añadir una corrección a una palabra
  
  Añade una corrección a 'mis' usando 'cor'. Observe que se reemplaza @mis por @cor, por lo que es
  posible que algunas incidencias futuras de @mis sean reemplazadas por @cor. Así se podría subir
  @cor en la lista de sugerencias.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dict</strong>  Recurso de diccionario
  <info>string</info>    <strong>$mis</strong>   La palabra a corregir
  <info>string</info>    <strong>$cor</strong>   La palabra corregida

<comment>Return:</comment>
  <info>void</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.


id: enchant_dict_suggest
type: function
doc:
<comment>Description:</comment>
  Devolverá una lista de valores si no se reúnen esas pre-condiciones

<comment>Param:</comment>
  <info>resource</info>  <strong>$dict</strong>  Recurso de diccionario
  <info>string</info>    <strong>$word</strong>  Palabra a usar para las sugerencias.

<comment>Return:</comment>
  <info>array</info>  Devolverá una matriz de sugerencias si la palabra está mal escrita.

<comment>See Also:</comment>
   * <strong>enchant_dict_check()</strong>
   * <strong>enchant_dict_quick_check()</strong>


id: end
type: function
doc:
<comment>Description:</comment>
  Establece el puntero interno de un array a su último elemento
  
  <strong>end()</strong> avanza el puntero interno del <strong>$array</strong> hasta su último elemento y devuelve su valor.

<comment>Param:</comment>
  <info>array</info>  <strong>$array</strong>  El array. Este array es pasado por referencia porque es modificado por la función.
                 Esto significa que se debe pasar una variable real y no  una función que devuelve
                 un array porque solamente variables puede ser pasadas por referencia.

<comment>Return:</comment>
  <info>mixed</info>  Devuelve el valor del último elemento o <info>false</info> si el array está vacío.

<comment>See Also:</comment>
   * <strong>current()</strong>
   * <strong>each()</strong>
   * <strong>prev()</strong>
   * <strong>reset()</strong>
   * <strong>next()</strong>
   * <strong>array_key_last()</strong>


id: enum_exists
type: function
doc:
<comment>Description:</comment>
  Checks if the enum has been defined
  
  This function checks whether or not the given enum has been defined.

<comment>Param:</comment>
  <info>string</info>  <strong>$enum</strong>      The enum name. The name is matched in a case-insensitive manner.
  <info>bool</info>    <strong>$autoload</strong>  Whether to autoload if not already loaded.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if <strong>$enum</strong> is a defined enum, <info>false</info> otherwise.

<comment>See Also:</comment>
   * <strong>function_exists()</strong>
   * <strong>class_exists()</strong>
   * <strong>interface_exists()</strong>
   * <strong>get_declared_classes()</strong>


id: error_clear_last
type: function
doc:
<comment>Description:</comment>
  Limpiar el error más reciente

<comment>Return:</comment>
  <info>void</info>  Limpia los errores más recientes, no pudiéndose recuperarlos así con <strong>error_get_last()</strong>.

<comment>See Also:</comment>
   * Constantes de error


id: error_get_last
type: function
doc:
<comment>Description:</comment>
  Obtener el último error que ocurrió
  
  Obtiene información sobre el último error que ocurrió.

<comment>Return:</comment>
  <info>array</info>  Devuelve una matriz asociativa describiendo el último error con las claves "type" (tipo),
         "message" (mensaje), "file" (archivo) y "line" (línea). Si el error ha sido causado por una
         función interna de PHP, el "message" (mensaje) comienza con su nombre. Devuelve <info>null</info> si no
         ha habido aún un error.

<comment>See Also:</comment>
   * Constantes de error
   * La variable $php_errormsg
   * <strong>error_clear_last()</strong>
   * La directiva <strong>$display_errors</strong>
   * La directiva <strong>$html_errors</strong>
   * La directiva <strong>$xmlrpc_errors</strong>


id: error_log
type: function
doc:
<comment>Description:</comment>
  Enviar un mensaje de error a las rutinas de manejo de errores definidas
  
  Envía un mensaje de error al registro de errores del servidor web o a un fichero.

<comment>Param:</comment>
  <info>string</info>  <strong>$message</strong>        El mensaje de error que debería ser registrado.
  <info>int</info>     <strong>$message_type</strong>   Indica dónde debería ir el error. Los tipos de mensaje posibles son:
                          
                          Tipos de registro de <strong>error_log()</strong>0<strong>$message</strong> es enviado al registro del
                          sistema de PHP, usando el mecanismo de registro del Sistema Operativo o un
                          fichero, dependiendo de qué directiva de configuración esté establecida en
                          error_log. Esta opción es la  predeterminada. 1<strong>$message</strong> es enviado por
                          email a la dirección del parámetro <strong>$destination</strong>. Este es el único tipo de
                          mensaje donde se usa el cuarto parámetro <strong>$extra_headers</strong>. 2 Ya no es una
                          opción. 3<strong>$message</strong> es añadido al final del fichero <strong>$destination</strong>. No se
                          añade automáticamente una nueva línea al final del string <strong>$message</strong>.
                          4<strong>$message</strong> es enviado directamente al gestor de registro de la SAPI.
  <info>string</info>  <strong>$destination</strong>    El destino. Su significado depende del parámetro <strong>$message_type</strong> tal como se
                          describió arriba.
  <info>string</info>  <strong>$extra_headers</strong>  Las cabeceras extra. Se usa cuando el parámetro <strong>$message_type</strong> está
                          establecido a <return>1</return>. Este tipo de mensaje usa la misma función interna que
                          <strong>mail()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Devuelve <info>true</info> en caso de éxito o <info>false</info> en caso de error.


id: error_reporting
type: function
doc:
<comment>Description:</comment>
  Establece cuáles errores de PHP son notificados
  
  La función <strong>error_reporting()</strong> establece la directiva error_reporting en tiempo de ejecución. PHP
  tiene varios niveles de errores para notificar, al utilizar ésta función se define el nivel de
  duración (tiempo de ejecución) de sus scripts. Si el parámetro opcional <strong>$level</strong> no se define, la
  función <strong>error_reporting()</strong> sólo devolverá el nivel actual de notificación de error.

<comment>Param:</comment>
  <info>int</info>  <strong>$level</strong>  El nuevo nivel de error_reporting. Este nivel toma una máscara de bit o constantes
               nominadas. Al utilizar constantes nominadas se recomienda encarecidamente asegurar la
               compatibilidad para versiones futuras. Según se añaden niveles de error, el rango de
               los enteros incrementa,  por lo que los niveles antiguos de errores basados en
               enteros no siempre se comportarán como se esperaba.
               
               Las constantes de niveles de error disponibles, y los significados actuales de esos
               niveles de error están descritos en constantes predefinidas.

<comment>Return:</comment>
  <info>int</info>  Devuelve el nivel antiguo de error_reporting o el nivel actual si el parámetro <strong>$level</strong> no se
       proporciona.

<comment>See Also:</comment>
   * La directiva display_errors
   * La directiva html_errors
   * La directiva xmlrpc_errors
   * <strong>ini_set()</strong>


id: escapeshellarg
type: function
doc:
<comment>Description:</comment>
  Escapar una cadena a ser usada como argumento del
     intérprete de comandos
  
  <strong>escapeshellarg()</strong> agrega comillas sencillas alrededor de una cadena y rodea de comillas/escapa
  cualquier comilla sencilla existente, permitiéndole pasar la cadena directamente a una función del
  intérprete de comandos, y logrando que sea tratada como un solo argumento seguro. Esta función
  debe ser usada para escapar argumentos individuales a funciones del intérprete de comandos que
  provienen de la entrada del usuario. Las funciones del intérprete de comandos incluyen <strong>exec()</strong>,
  <strong>system()</strong> y el operador de comilla invertida.
  
  En Windows, <strong>escapeshellarg()</strong> elimina en su lugar los signos de porcentaje, remplaza las comillas
  dobles por espacios y añade comillas dobles al string.

<comment>Param:</comment>
  <info>string</info>  <strong>$arg</strong>  El argumento que será escapado.

<comment>Return:</comment>
  <info>string</info>  La cadena escapada.

<comment>See Also:</comment>
   * <strong>escapeshellcmd()</strong>
   * <strong>exec()</strong>
   * <strong>popen()</strong>
   * <strong>system()</strong>
   * operador de
     comilla invertida


id: escapeshellcmd
type: function
doc:
<comment>Description:</comment>
  Escapar meta-caracteres del intérprete de comandos
  
  <strong>escapeshellcmd()</strong> escapa cualquier caracter en una cadena que pudiera ser usada para engañar a un
  comando shell para que ejecute comandos arbitrarios. Esta función debería usarse para asegurarse
  de que cualquier información procedente de la entrada del usuario sea escapada antes de que dicha
  información sea pasada a las funciones <strong>exec()</strong> o <strong>system()</strong>, o al operador de comilla invertida.
  
  Los siguientes caracteres son precedidos por una barra invertida: <return>#&;`|*?~\<&gt;^()[]{}$\</return>, <return>\x0A</return> y <return>\xFF</return>. <return>'</return> y <return>"</return> son escapados únicamente si no están emparejados. En Windows, todos estos caracteres más <return>%</return> son reemplazados en su lugar por un espacio.

<comment>Param:</comment>
  <info>string</info>  <strong>$command</strong>  El comando a ser escapado.

<comment>Return:</comment>
  <info>string</info>  La cadena escapada.

<comment>See Also:</comment>
   * <strong>escapeshellarg()</strong>
   * <strong>exec()</strong>
   * <strong>popen()</strong>
   * <strong>system()</strong>
   * operador de comilla invertida


id: eval
type: function
doc:
<comment>Description:</comment>
  Evaluar una cadena como código de PHP
  
  Evalua el código dado por <strong>$code</strong> como código PHP.
  
  El constructor de lenguaje <strong>eval()</strong> es muy peligroso porque permite la ejecución de código de PHP
  arbitrario. Su uso está totalmente desaconsejado. Si se ha verificado cuidadosamente que no existe
  otra opción que usar este constructor, se ha de poner especial atención en no pasar ninguna
  información proporcionada por el usuario a esta función sin haberla validado apropiadamente con
  anterioridad.

<comment>Param:</comment>
  <info>string</info>  <strong>$code</strong>  El código de PHP válido ser evaluado.
                 
                 El código no debe encerrarse entre etiquetas de PHP de apertura y cierre, es decir,
                 se debe pasar <return>'echo "¡Hola!";'</return> en vez de <return>'\<?php echo "¡Hola!"; ?&gt;'</return>. Aún es posible abandonar y reentrar en el modo PHP usando las etiquetas de PHP apropiadas, p.ej. <return>'echo "¡En el modo PHP!"; ?&gt;¡En el modo HTML!\<?php echo "¡De vuelta en el modo PHP!";'</return>.
                 
                 Aparte de que el código pasado debe ser código de PHP válido. Esto incluye que
                 todas las sentencias deben finalizar apropiadamente usando un punto y coma. <return>'echo
                 "¡Hola!"'</return>, por ejemplo, causará un error de análisis, mientras que <return>'echo "¡Hola!";'</return>
                 funcionará.
                 
                 Una sentencia <return>return</return> finalizará inmediantamente la evaluación del código.
                 
                 El código se ejecutará en el ámbito del código que llama a <strong>eval()</strong>. Así, cualquier
                 variable definida o cambiada en la llamada a <strong>eval()</strong> permanecerá visible después de
                 que finalice.

<comment>Return:</comment>
  <info>mixed</info>  <strong>eval()</strong> devuelve <info>null</info> a menos que se llame a <return>return</return> en el código evaluado, en cuyo caso el
         valor pasado a <return>return</return> es devuelto. A partir de PHP 7, si hay un error de análisis en el
         código evaluado, <strong>eval()</strong> lanzará una excepción ParseError. Antes de PHP 7, <strong>eval()</strong> devolvía
         <info>false</info> y la ejecución del código posterior continuaba normalmente. No es posible capturar un
         error de análisis de <strong>eval()</strong> usando <strong>set_error_handler()</strong>.

<comment>See Also:</comment>
   * <strong>call_user_func()</strong>


id: exec
type: function
doc:
<comment>Description:</comment>
  Ejecutar un programa externo
  
  <strong>exec()</strong> ejecuta el <strong>$comando</strong> dado.

<comment>Param:</comment>
  <info>string</info>  <strong>$command</strong>     El comando que será ejecutado.
  <info>array</info>   <strong>$output</strong>      Si el argumento <strong>$output</strong> está presente, entonces el array especificado será
                       llenado con cada línea de la salida del comando. El espacio en blanco extra,
                       como <return>\n</return>, no es incluido en este array. Note que si el array ya contiene
                       algunos elementos, <strong>exec()</strong> anexará sus resultados al final del array. Si no
                       desea que la función anexe los elementos, use <strong>unset()</strong> sobre el array antes de
                       pasarla a <strong>exec()</strong>.
  <info>int</info>     <strong>$return_var</strong>  Si el argumento <strong>$return_var</strong> está presente junto con el argumento <strong>$output</strong>,
                       entonces el status de retorno del comando ejecutado será escrito en esta
                       variable.

<comment>Return:</comment>
  <info>string</info>  La última línea de los resultados del comando. Si necesita ejecutar un comando y tener
          todos los datos desde el comando pasados directamente de vuelta sin interferencia alguna,
          use la función <strong>passthru()</strong>.
          
          Para obtener la salida del comando ejecutado, asegúrese de definir y usar el parámetro
          <strong>$output</strong>.

<comment>See Also:</comment>
   * <strong>system()</strong>
   * <strong>passthru()</strong>
   * <strong>escapeshellcmd()</strong>
   * <strong>pcntl_exec()</strong>
   * operador de
    comilla invertida


id: exif_imagetype
type: function
doc:
<comment>Description:</comment>
  Determinar el tipo de una imagen
  
  <strong>exif_imagetype()</strong> lee los primeros bytes de una imagen y comprueba su firma.
  
  <strong>exif_imagetype()</strong> se puede usar para evitar llamar a otras funciones exif con tipos de archivos no
  soportados o junto con $_SERVER['HTTP_ACCEPT'] para verificar si el visionador es capaz o no de
  ver una imagen específica en el navegador.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  La imagen que va a ser comprobada.

<comment>Return:</comment>
  <info>int</info>  Cuando se encuentra una firma correcta, se devolverá el valor de la constante apropiada o, de
       otro modo, el valor devuelto será <info>false</info>. El valor devuelto es el mismo valor que devuelve
       <strong>getimagesize()</strong> en el índice 2, pero <strong>exif_imagetype()</strong> es mucho más rápida.
       
       <strong>exif_imagetype()</strong> emitirá un mensaje <info>E_NOTICE</info> y devolverá <info>false</info> si no es capaz de leer
       suficientes bytes del archivo como para determinar el tipo de la imagen.

<comment>See Also:</comment>
   * <strong>image_type_to_mime_type()</strong>
   * <strong>getimagesize()</strong>


id: exif_read_data
type: function
doc:
<comment>Description:</comment>
  Lee las cabeceras EXIF desde un JPEG o un TIFF
  
  <strong>exif_read_data()</strong> lee las cabeceras EXIF desde un archivo de imagen JPEG o TIFF. De esta forma se
  puede leer los meta-datos generados por cámaras digitales.
  
  Las cabeceras EXIF tienden a estar presentes en imágenes JPEG/TIFF generadas por cámaras
  digitales, pero desafortunadamente cada fabricante de cámaras digitales tiene una idea diferente
  de cómo etiquetar sus imágenes, por lo que no siempre se puede contar con que una cabecera Exif
  específica esté presente.
  
  <return>Height</return> y <return>Width</return> son computados de la misma forma que lo hace <strong>getimagesize()</strong> por lo que sus valores
  no deben ser parte de ninguna cabecera devuelta. También, <return>html</return> es una cadena de texto de
  alto/ancho para usar dentro de un HTML normal.
  
  Cuando una cabecera Exif contiene una nota de Copyright, puede contener ella misma dos valores.
  Como la solución es inconsistente en el estándar Exif 2.10, la sección <return>COMPUTED</return> devolverá las dos
  entradas <return>Copyright.Photographer</return> y <return>Copyright.Editor</return> mientras que las secciones <return>IFD0</return> contienen la
  matriz de bytes con el carácter  NULL que divide ambas entradas. O sólo la primera entrada si el
  tipo de información era erróneo (el comportamiento normal de Exif). <return>COMPUTED</return> también contendrá la
  entrada <return>Copyright</return> que es la cadena del copyright original, o una lista separada por comas del
  copyright de la fotografía y del editor.
  
  La etiqueta <return>UserComment</return> tiene el mismo problema que la etiqueta Copyright. Puede almacenar dos
  valores. El primero es el que usa la codificación, y el segundo es el valor mismo. Por lo que si
  la sección <return>IFD</return> sólo contiene la codificación o una matriz de bytes, la sección <return>COMPUTED</return> almacenará
  la dos entradas <return>UserCommentEncoding</return> y <return>UserComment</return>. La entrada <return>UserComment</return> está disponible en ambos
  casos por lo que se debería usar con preferencia al valor de la sección <return>IFD0</return>.
  
  <strong>exif_read_data()</strong> también valida las etiquetas de información EXIF según la especifiación EXIF
  (http://exif.org/Exif2-2.PDF, página 20).
  
  Windows Me/XP pueden borrar las cabeceras Exif cuando se conecta una cámara.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>   El nombre de la imagen que se va a leer. No puede ser una URL.
  <info>string</info>  <strong>$sections</strong>   Es una lista separada por comas de las secciones que necesitan estar presentes
                      en el archivo para producir un <info>array</info> resultante. Si no se puede encontrar
                      ninguna sección el valor devuelto es <info>false</info>. FILEFileName, FileSize,
                      FileDateTime, SectionsFoundCOMPUTED html, Width, Height, IsColor, y más si
                      están disponibles. Height y Width son computados de la misma forma que lo hace
                      <strong>getimagesize()</strong> por lo que sus valores no deben ser parte de ninguna cabecera
                      devuelta.  También, <return>html</return> es una cadena de texto de alto/ancho para usar dentro
                      de un HTML normal. ANY_TAGCualquier información que tenga una Etiqueta, p.ej.,
                      <return>IFD0</return>, <return>EXIF</return>, ...IFD0 Toda la información etiquetada de IFD0. En archivos de
                      imagen normales, ésto contiene el tamaño de la imagen y así sucesivamente.
                      THUMBNAIL Se supone que un archivo contiene una miniatura si tiene un segundo
                      <return>IFD</return>. Toda la información etiquetada acerca de la miniatura embebida es
                      almacenada en esta sección. COMMENTCabeceras de comentarios de imágenes
                      JPEG.EXIF La sección EXIF es una subsección de <return>IFD0</return>. Contiene información más
                      detallada sobre la imagen. La mayoría de estas entradas están relacionadas con
                      la cámara digital.
  <info>bool</info>    <strong>$arrays</strong>     Especifica si cada sección se convierte o no en una matriz.  <strong>$sections</strong>
                      <return>COMPUTED</return>, <return>THUMBNAIL</return>, y <return>COMMENT</return>  siempre se convierten en matrices ya que
                      pueden contener valores cuyos nombres entran en conflicto con otras secciones.
  <info>bool</info>    <strong>$thumbnail</strong>  Cuando se establece a <info>true</info> se lee la miniatura misma. Si no, sólo se lee la
                      información etiquetada.

<comment>Return:</comment>
  <info>array</info>  Devuelve un <info>array</info> asociativo donde los índices de la matriz son los nombres de las
         cabeceras y los valores de la matriz son los valores asociados con esas cabeceras. Si no se
         puede devolver información, <strong>exif_read_data()</strong> devolverá <info>false</info>.

<comment>See Also:</comment>
   * <strong>exif_thumbnail()</strong>
   * <strong>getimagesize()</strong>


