diff --git a/appendices/tokens.xml b/appendices/tokens.xml index 772643ca4..71f8fd925 100644 --- a/appendices/tokens.xml +++ b/appendices/tokens.xml @@ -1,5 +1,5 @@ - + Lista de tokens del analizador @@ -149,7 +149,7 @@ defined('T_FN') || define('T_FN', 10001); T_CLASS_C __CLASS__ - constantes mágicas + constantes mágicas @@ -232,7 +232,7 @@ defined('T_FN') || define('T_FN', 10001); T_DIR __DIR__ - constantes mágicas + constantes mágicas T_DIV_EQUAL @@ -379,7 +379,7 @@ defined('T_FN') || define('T_FN', 10001); T_FILE __FILE__ - constantes mágicas + constantes mágicas T_FINAL @@ -418,7 +418,7 @@ defined('T_FN') || define('T_FN', 10001); T_FUNC_C __FUNCTION__ - constantes mágicas + constantes mágicas @@ -526,7 +526,7 @@ defined('T_FN') || define('T_FN', 10001); T_LINE __LINE__ - constantes mágicas + constantes mágicas T_LIST @@ -564,7 +564,7 @@ defined('T_FN') || define('T_FN', 10001); T_METHOD_C __METHOD__ - constantes mágicas + constantes mágicas @@ -711,7 +711,7 @@ defined('T_FN') || define('T_FN', 10001); T_PROPERTY_C __PROPERTY__ - constantes mágicas + constantes mágicas diff --git a/language/oop5/property-hooks.xml b/language/oop5/property-hooks.xml index 9f5858ff1..af75953bc 100644 --- a/language/oop5/property-hooks.xml +++ b/language/oop5/property-hooks.xml @@ -1,5 +1,5 @@ - + Hooks de propiedad diff --git a/reference/dom/dom/childnode/remove.xml b/reference/dom/dom/childnode/remove.xml index 3d95e94f8..f22af0864 100644 --- a/reference/dom/dom/childnode/remove.xml +++ b/reference/dom/dom/childnode/remove.xml @@ -1,6 +1,6 @@ - - + + Dom\ChildNode::remove diff --git a/reference/dom/dom/parentnode/append.xml b/reference/dom/dom/parentnode/append.xml index a098d4413..3cc59da9c 100644 --- a/reference/dom/dom/parentnode/append.xml +++ b/reference/dom/dom/parentnode/append.xml @@ -1,6 +1,6 @@ - - + + Dom\ParentNode::append diff --git a/reference/dom/domelement/insertadjacentelement.xml b/reference/dom/domelement/insertadjacentelement.xml new file mode 100644 index 000000000..71e570268 --- /dev/null +++ b/reference/dom/domelement/insertadjacentelement.xml @@ -0,0 +1,114 @@ + + + + + + DOMElement::insertAdjacentElement + Inserta un elemento adyacente + + + + &reftitle.description; + + public DOMElementnullDOMElement::insertAdjacentElement + stringwhere + DOMElementelement + + + Inserta un elemento en una posición relativa dada por where. + + + + + &reftitle.parameters; + + + + where + + + + beforebegin - Inserta antes del elemento objetivo. + afterbegin - Inserta como primer hijo del elemento objetivo. + beforeend - Inserta como último hijo del elemento objetivo. + afterend - Inserta después del elemento objetivo. + + + + + + element + + + El elemento a insertar. + + + + + + + + + &reftitle.returnvalues; + + Devuelve DOMElement o &null; en caso de fallo. + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMElement::insertAdjacentElement</methodname> + +loadXML('

foo

'); +$container = $dom->documentElement; +$p = $container->firstElementChild; + +$p->insertAdjacentElement('beforebegin', $dom->createElement('A')); +echo $dom->saveXML(); +?> +]]> + + &example.outputs; + + +

foo

 +]]> + + + + + + &reftitle.seealso; + + + DOMElement::insertAdjacentText + + + + + diff --git a/reference/uodbc/functions/odbc-autocommit.xml b/reference/uodbc/functions/odbc-autocommit.xml index 160adc7f1..f0764218b 100644 --- a/reference/uodbc/functions/odbc-autocommit.xml +++ b/reference/uodbc/functions/odbc-autocommit.xml @@ -1,24 +1,28 @@ - + + odbc_autocommit - Activa el comportamiento automático de envío + Activa el modo de autovalidación + &reftitle.description; - mixedodbc_autocommit - resourceconnection_id - boolOnOfffalse + intboolodbc_autocommit + Odbc\Connectionodbc + boolnullenable&null; - Activa el comportamiento automático de envío. + Sin el argumento enable, + odbc_autocommit devuelve el estado de autovalidación - Por defecto, el auto envío está activado en una conexión. Deshabilitar - el auto envío es equivalente a iniciar una transacción. + Por omisión, la autovalidación está activada. Desactivar + la autovalidación es equivalente a iniciar una + transacción. @@ -26,17 +30,20 @@ - connection_id + odbc &odbc.connection.id; - OnOff + enable - Si OnOff es &true;, el auto envío está habilitado, si - es &false; el auto envío está deshabilitado. + Si enable es &true;, la autovalidación + está activada. Si es &false;, la autovalidación + está desactivada. + Si se pasa &null;, esta función devuelve el estado de autovalidación para + odbc. @@ -46,16 +53,39 @@ &reftitle.returnvalues; - Sin el parámetro OnOff, está función devuelve - el estado de auto envío para connection_id. Se devuelve - un valor distinto de cero si el auto envío está activado, 0 si está desactivado, o &false; si se - produjo un error. + Con un argumento enable igual a &null;, + odbc_autocommit devuelve el estado de autovalidación + de la conexión odbc. Un valor diferente de 0 + si el modo está activado, 0 si no lo está, + o &false; si ocurre un error. - Si está establecido OnOff, esta función devolverá &true; si - se tuvo éxito y &false; si falló. + Si enable no es null, esta función devuelve &true; + en caso de éxito, y &false; si ocurre un error. + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + + 8.3.0 + + enable es ahora nullable. + + + + + + &reftitle.seealso; @@ -66,7 +96,6 @@ - - + + odbc_binmode - Manejo de información de columna binaria + Modifica la gestión de columnas de datos binarios + &reftitle.description; - boolodbc_binmode - resourceresult_id + trueodbc_binmode + Odbc\Resultstatement intmode - Habilita el manejo de información de columna binaria. Los tipos de SQL ODBC son - BINARY, VARBINARY, y + odbc_binmode controla la gestión de las + columnas de datos binarios. Los tipos ODBC SQL afectados son + BINARY, VARBINARY y LONGVARBINARY. + El modo predeterminado puede definirse utilizando la directiva &php.ini; + uodbc.defaultbinmode + + + Cuando un dato SQL se convierte en carácter C, + (ODBC_BINMODE_CONVERT) + los 8 bits del carácter fuente se representan + por dos caracteres ASCII. Estos caracteres son representaciones + ASCII de los números en formato hexadecimal. + Por ejemplo, el binario 00000001 se + convierte en "01" + y el binario 11111111 se convierte + en "FF". - Cuando se convierte informaicón SQL binaria a información C de carácter, cada byte - (8 bits) de información fuente está representado como dos caractéres ASCII. - Estos caracteres la representación de caracteres ASCII del - número en su forma hexadecimal. Por ejemplo, el número binario - 00000001 se convierte a - "01" y 11111111 - se convierte a "FF". + Mientras que la gestión de las columnas BINARY y + VARBINARY depende únicamente del binmode, + la gestión de las columnas LONGVARBINARY + depende también de longreadlen, como se muestra a continuación: - Manejo de LONGVARBINARY + Conversión de <literal>LONGVARBINARY</literal> - binmode - longreadlen - result + Modo + Longitud + Resultado ODBC_BINMODE_PASSTHRU 0 - passthru + passthru ODBC_BINMODE_RETURN 0 - passthru + passthru ODBC_BINMODE_CONVERT 0 - passthru - - - ODBC_BINMODE_PASSTHRU - 0 - passthru + passthru ODBC_BINMODE_PASSTHRU - >0 - passthru + >0 + passthru ODBC_BINMODE_RETURN - >0 - devuelve como es + >0 + Tal cual ODBC_BINMODE_CONVERT - >0 - devuelve como tipo char + >0 + Carácter
- Si se usa odbc_fetch_into, passthru significa se devuelve - una cadena vacía para esta columnas. + Si se utiliza odbc_fetch_into, passthru + significa que se devolverá una cadena vacía para estas columnas. + Si se utiliza la función odbc_result, passthru + significa que los datos se envían directamente al cliente (es decir, se imprimen). @@ -86,22 +96,10 @@ - result_id + statement - El identificador de resultado. - - - Si result_id es 0, las - configuraciones se aplican por defecto para los nuevos resultados. - - - longreadlen por defecto es 4096 y - mode por defecto es - ODBC_BINMODE_RETURN. El manejo de columnas binarias - de tipo long también está afectado por odbc_longreadlen. - - + &odbc.result.object;. @@ -109,24 +107,30 @@ mode - Los valores posibles para mode son: + Valores posibles para el parámetro mode: - ODBC_BINMODE_PASSTHRU: Realiza passthru en daots BINARY + ODBC_BINMODE_PASSTHRU: devolver los datos en binario - ODBC_BINMODE_RETURN: Devuelve como es + ODBC_BINMODE_RETURN: devolver sin conversión - ODBC_BINMODE_CONVERT: Covierte a tipo char y devuelve + ODBC_BINMODE_CONVERT: convertir en carácter + + + La gestión de columnas de tipo binary long también se ve afectada + por la función odbc_longreadlen. + + @@ -136,11 +140,26 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + - - + + + odbc_close_all - Cerrar todas las conexiones ODBC + Cierra todas las conexiones ODBC &reftitle.description; @@ -13,11 +15,11 @@ - odbc_close_all cerrará todas - las conexión del/de los servidor/es de bases de datos. + odbc_close_all cierra todas las conexiones + ODBC a fuentes de datos. - + &reftitle.parameters; &no.function.parameters; @@ -33,8 +35,8 @@ &reftitle.notes; - Esta función fallará si hay transaccines abiertas sobre una conexión. - En este caso la conexión permanecerá abierta. + odbc_close_all fallará si hay transacciones + en curso en esta conexión. En este caso, la conexión permanecerá abierta. diff --git a/reference/uodbc/functions/odbc-close.xml b/reference/uodbc/functions/odbc-close.xml index d503f4c95..d701a5408 100644 --- a/reference/uodbc/functions/odbc-close.xml +++ b/reference/uodbc/functions/odbc-close.xml @@ -1,19 +1,22 @@ - + + + odbc_close - Cerrar una conexión ODBC + Cierra una conexión ODBC &reftitle.description; voidodbc_close - resourceconnection_id + Odbc\Connectionodbc - Cierra una conexión a un servidor de bases de datos. + Cierra la conexión con la fuente de datos representada por + el identificador de conexión connection_id. @@ -21,7 +24,7 @@ - connection_id + odbc &odbc.connection.id; @@ -35,17 +38,34 @@ &return.void; + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + + + + + &reftitle.notes; - Esta función fallará si hay transaccines abiertas sobre una conexión. - En este caso la conexión permanecerá abierta. + odbc_close fallará si hay transacciones en curso en esta conexión. En este caso, la conexión + permanecerá abierta. - - + + + odbc_columnprivileges - Lista las columnas y los privilegios asociados para la tabla dada + Lista las columnas y sus derechos asociados &reftitle.description; - resourceodbc_columnprivileges - resourceconnection_id - stringqualifier - stringowner - stringtable_name - stringcolumn_name + Odbc\Resultfalseodbc_columnprivileges + Odbc\Connectionodbc + stringnullcatalog + stringschema + stringtable + stringcolumn - Lista las columnas y los privilegios asociados para la tabla dada. + Lista las columnas y sus derechos asociados. @@ -25,79 +27,129 @@ - connection_id + odbc &odbc.connection.id; - qualifier + catalog - El cualificador. + &odbc.parameter.catalog; - owner + schema - El propietario. + &odbc.parameter.schema; + &odbc.parameter.search; - table_name + table - El nombre de la table. + El nombre de la tabla. + &odbc.parameter.search; - column_name + column - El argumento column_name acepta patrones de - búsqueda ('%' para comparar cero o más caracteres y '_' para comparar - un único carácter). + El nombre de la columna. + &odbc.parameter.search; - - Los parámetros schema, table_name y - column_name aceptan patrones de búsqueda ('%' para comparar - cero o más caracteres y '_' para comparar un único carácter). - &reftitle.returnvalues; - Devuelve un identificador de resultado de ODBC &return.falseforfailure;. - Este identificador de resultado se puede usar para traer una lista de columnas y - privilegios asociados. + &odbc.result.object-return-falseforfailure; + Este objeto resultado puede ser utilizado para recuperar una lista de columnas y + los derechos asociados. - El conjunto de resultados tiene las siguientes columnas: + El conjunto de resultados contiene las siguientes columnas: - TABLE_QUALIFIER - TABLE_OWNER - TABLE_NAME - GRANTOR - GRANTEE - PRIVILEGE - IS_GRANTABLE + TABLE_CAT + TABLE_SCHEM + TABLE_NAME + COLUMN_NAME + GRANTOR + GRANTEE + PRIVILEGE + IS_GRANTABLE + &odbc.result.driver-specific; - - El conjunto de resultados está ordenados según TABLE_QUALIFIER, TABLE_OWNER y - TABLE_NAME. - + + El conjunto de resultados está ordenado por TABLE_CAT, TABLE_SCHEM, + TABLE_NAME, COLUMN_NAME y PRIVILEGE. + - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + + + + + + + &reftitle.examples; + + Listar los Privilegios para una Columna + + +]]> + + &example.outputs.similar; + + TutorialDB + [TABLE_SCHEM] => dbo + [TABLE_NAME] => test + [COLUMN_NAME] => id + [GRANTOR] => dbo + [GRANTEE] => dbo + [PRIVILEGE] => INSERT + [IS_GRANTABLE] => YES +) +]]> + + + + + - + + + odbc_columns - Lista los nombres de columnas de la tabla especificada + Lista las columnas de una tabla &reftitle.description; - resourceodbc_columns - resourceconnection_id - stringqualifier - stringschema - stringtable_name - stringcolumn_name + Odbc\Resultfalseodbc_columns + Odbc\Connectionodbc + stringnullcatalog&null; + stringnullschema&null; + stringnulltable&null; + stringnullcolumn&null; - Lista todas las columnas en el rango solicitado. + Lista las columnas de una tabla. + &reftitle.parameters; - connection_id + odbc &odbc.connection.id; - qualifier + catalog - El cualificador. + &odbc.parameter.catalog; @@ -42,73 +45,148 @@ schema - El propietariio. + &odbc.parameter.schema; + &odbc.parameter.search; - table_name + table - El nombre de la table. + El nombre de la tabla. + &odbc.parameter.search; - column_name + column El nombre de la columna. + &odbc.parameter.search; - - Los parámetros schema, table_name y - column_name aceptan patrones de búsqueda ('%' para comparar - cero o más caracteres y '_' para comparar un único carácter). - + &reftitle.returnvalues; - Devuelve un idenrificador de resultado de ODBC &return.falseforfailure;. + &odbc.result.object-return-falseforfailure; - El conjunto de resultados tiene las siguietes columnas: + El conjunto de resultados contiene las siguientes columnas: - TABLE_QUALIFIER - TABLE_SCHEM - TABLE_NAME - COLUMN_NAME - DATA_TYPE - TYPE_NAME - PRECISION - LENGTH - SCALE - RADIX - NULLABLE - REMARKS + TABLE_CAT + TABLE_SCHEM + TABLE_NAME + COLUMN_NAME + DATA_TYPE + TYPE_NAME + COLUMN_SIZE + BUFFER_LENGTH + DECIMAL_DIGITS + NUM_PREC_RADIX + NULLABLE + REMARKS + COLUMN_DEF + SQL_DATA_TYPE + SQL_DATETIME_SUB + CHAR_OCTET_LENGTH + ORDINAL_POSITION + IS_NULLABLE + &odbc.result.driver-specific; - - El conjunto de resultados está ordenado según TABLE_QUALIFIER, TABLE_SCHEM y - TABLE_NAME. - + + El conjunto de resultados está ordenado por TABLE_CAT, TABLE_SCHEM, + TABLE_NAME y ORDINAL_POSITION. + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + + 8.0.0 + + schema, table y column + ahora son anulables. + + + + + + + + + &reftitle.examples; + + Listar las Columnas de una Tabla + + +]]> + + &example.outputs.similar; + + TutorialDB + [TABLE_SCHEM] => dbo + [TABLE_NAME] => TEST + [COLUMN_NAME] => id + [DATA_TYPE] => 4 + [TYPE_NAME] => int + [COLUMN_SIZE] => 10 + [BUFFER_LENGTH] => 4 + [DECIMAL_DIGITS] => 0 + [NUM_PREC_RADIX] => 10 + [NULLABLE] => 0 + [REMARKS] => + [COLUMN_DEF] => + [SQL_DATA_TYPE] => 4 + [SQL_DATETIME_SUB] => + [CHAR_OCTET_LENGTH] => + [ORDINAL_POSITION] => 1 + [IS_NULLABLE] => NO +) +]]> + + + + &reftitle.seealso; - odbc_columnprivileges para recuperar los privilegios - asociados + odbc_columnprivileges + odbc_procedurecolumns - - + + + odbc_commit - Envía una transacción ODBC + Valida una transacción ODBC &reftitle.description; boolodbc_commit - resourceconnection_id + Odbc\Connectionodbc - Envía todas las transacciones pendientes en una conexión. + Valida todas las transacciones en curso en la conexión + connection_id. @@ -21,7 +24,7 @@ - connection_id + odbc &odbc.connection.id; @@ -35,8 +38,24 @@ &return.success; - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + + + + + - - + + odbc_connect - Conectar a una fuente de datos + Conexión a una fuente - + &reftitle.description; - resourceodbc_connect + Odbc\Connectionfalseodbc_connect stringdsn - stringuser - stringpassword - intcursor_type + stringnulluser&null; + stringnullpassword&null; + intcursor_optionSQL_CUR_USE_DRIVER - El id de conexión devuelto por estas funciones es necesario por otras - funciones ODBC. Se pueden tener abiertas mútiples conexiones de una vez mientras - que usen bases de datos o credenciales diferentes. + El identificador de conexión devuelto por esta función es + necesario para todas las demás funciones ODBC. Puede + tener múltiples conexiones al mismo tiempo. - Con algunos controladores ODBC, el ejecutar un procedimiento de almacenamiento complejo puede - fallar con un error similar a: "Cannot open a cursor on a stored - procedure that has anything other than a single select statement - in it" (No se pudo abrir un cursor en un procedimiento de almacenamiento - que tiene una única declaración de selección). Se puede evitar este error usando SQL_CUR_USE_ODBC. También, algunos - controladores no soportan el parámetro opcional row_number en - odbc_fetch_row. SQL_CUR_USE_ODBC might también - ayuda en este case. + Con algunos controladores ODBC, la ejecución de procedimientos + almacenados complejos puede producir el siguiente error: + "Cannot open a cursor on a stored procedure that has anything + other than a single select statement in it", lo que significa: + "No se puede abrir un cursor en un procedimiento almacenado que tenga + algo distinto de una única sentencia SELECT". Utilizar la opción SQL_CUR_USE_ODBC permite + evitar este error. Además, algunos controladores no soportan el parámetro + opcional de número de línea en odbc_fetch_row. + SQL_CUR_USE_ODBC puede también permitir resolver estos problemas. - + &reftitle.parameters; @@ -42,8 +42,7 @@ dsn - El nombre de la fuente de base de datos para la conexión. Alternativamente - se puede usar una cadena de conexión sin DSN. + El nombre de la fuente de datos (DSN), para la conexión. @@ -52,6 +51,9 @@ El nombre de usuario. + Este parámetro se ignora si dsn contiene uid. + Para una conexión sin especificar un user, + utilizar &null;. @@ -60,19 +62,23 @@ La contraseña. + Este parámetro se ignora si dsn contiene pwd. + Para una conexión sin especificar un password, + utilizar &null;. - cursor_type + cursor_option - Establece el tipo de cursor a usar - para esta conexión. Este parámetro normalmente no es necesario, pero - puede ser útil para evitar problemas con algunos controladores ODBC. + Establece el tipo de cursor de resultado + utilizado para esta conexión. Este parámetro no es + generalmente necesario, pero puede ser + útil para evitar ciertos problemas ODBC. - Las siguientes constantes están definidas para el tipo de cursor: + Las constantes siguientes están definidas como tipos de cursor: @@ -98,39 +104,58 @@ - + &reftitle.returnvalues; - Devuelve una conexión ODBC o (&false;) si ocurre un error. + Devuelve una conexión ODBC, &return.falseforfailure;. - + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-return; + &odbc.changelog.credential-params; + + + + + &reftitle.examples; - Conexiones sin DSN + Conexión sin DSN ]]> - + &reftitle.seealso; @@ -139,9 +164,8 @@ $conexión = odbc_connect("Driver={Microsoft Excel Driver (*.xls)};DriverId=790; - - + - + odbc_connection_string_is_quoted - Determina si un string de conexión ODBC está entre comillas + Determina si un valor de string de conexión ODBC está entre comillas @@ -14,10 +14,7 @@ stringstr - Determina si un string está correctamente entre comillas para un string de - conexión ODBC. La puesta entre comillas de strings de conexión ODBC se realiza - utilizando llaves, y las llaves de cierre en un string deben ser escapadas - repitiéndolas dos veces, similar a la puesta entre comillas SQL. + Determina si un string está correctamente entre comillas para un string de conexión ODBC. La colocación entre comillas de strings de conexión ODBC se realiza utilizando llaves, y las llaves de cierre en un string deben ser escapadas repitiéndolas dos veces, similar a la colocación entre comillas SQL. @@ -28,7 +25,7 @@ str - El string a verificar para la puesta entre comillas. + El string a verificar para la colocación entre comillas. @@ -51,7 +48,6 @@ - - + odbc_connection_string_quote @@ -15,17 +15,17 @@ Pone entre comillas un valor de string de conexión, según las reglas ODBC. - Es decir, será rodeado de comillas, y cualquier llave de cierre - será escapada. Esto debe hacerse para todos los valores de string de conexión - que provengan de la entrada del usuario. No hacerlo puede causar - problemas al analizar la cadena de conexión, o valores inyectados - en la cadena de conexión. + Es decir, se rodeará de comillas, y cualquier llave de cierre + será escapada. Esto debería hacerse para todos los valores de string de conexión + que provienen de la entrada del usuario. No hacerlo puede provocar + problemas durante el análisis de la string de conexión, o valores inyectados + en la string de conexión. - Observe que esta función no verifica si el string ya - está puesto entre comillas, ni si el string necesita ser puesto entre comillas. Para ello, llamar - odbc_connection_string_is_quoted y - odbc_connection_string_should_quote. + Tenga en cuenta que esta función no verifica si la string ya está + entre comillas, ni si la string necesita ser puesta entre comillas. Para ello, llamar + a odbc_connection_string_is_quoted y + a odbc_connection_string_should_quote. @@ -36,7 +36,7 @@ str - El string a poner entre comillas. + La string sin comillas. @@ -46,18 +46,18 @@ &reftitle.returnvalues; - Un string, rodeado de comillas, y correctamente escapado. + Una string, rodeada de comillas, y correctamente escapada. &reftitle.examples; - <function>odbc_connection_string_quote</function> ejemplo + Ejemplo de <function>odbc_connection_string_quote</function> - Este ejemplo pone entre comillas un string, luego lo coloca en una cadena de conexión. - Observe que el string está puesto entre comillas, y el carácter de cierre de comillas - en medio del string ha sido escapado. + Este ejemplo pone entre comillas una string, luego la coloca en una string de conexión. + Tenga en cuenta que la string está entre comillas, y el carácter de comilla + de cierre en medio de la string ha sido escapado. - + odbc_connection_string_should_quote @@ -18,10 +18,10 @@ Es decir, si contiene caracteres especiales. - Observe que esta función no verifica si el string ya - está puesto entre comillas; un string ya puesto entre comillas - contendrá caracteres que harán que esta función devuelva true. Debería llamar - odbc_connection_string_is_quoted para verificar. + Tenga en cuenta que esta función no verifica si el string ya + está entre comillas; un string ya entre comillas + contendrá caracteres que harán que esta función devuelva verdadero. Se debería llamar + a odbc_connection_string_is_quoted para verificar. @@ -42,7 +42,7 @@ &reftitle.returnvalues; - &true; si el string debe ser puesto entre comillas, de lo contrario &false;. + &true; si el string debe estar entre comillas, de lo contrario &false;. diff --git a/reference/uodbc/functions/odbc-cursor.xml b/reference/uodbc/functions/odbc-cursor.xml index 81b15f829..15957167f 100644 --- a/reference/uodbc/functions/odbc-cursor.xml +++ b/reference/uodbc/functions/odbc-cursor.xml @@ -1,19 +1,21 @@ - + + odbc_cursor - Obtener el nombre del cursor + Lee el nombre del puntero de resultado actual &reftitle.description; - stringodbc_cursor - resourceresult_id + stringfalseodbc_cursor + Odbc\Resultstatement - Obtiene el nombre del cursor para el párametro result_id dado. + odbc_cursor lee el nombre del puntero de resultado + actual para el resultado result_id. @@ -21,10 +23,10 @@ - result_id + statement - El indentificador de resultados. + &odbc.result.object;. @@ -34,11 +36,27 @@ &reftitle.returnvalues; - Devuelve el nombre del cursor, como cadena. + Devuelve el nombre del cursor, en forma de &string;, &return.falseforfailure;. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + + - + + + odbc_data_source - Devuelve información sobre una conexión actual + Devuelve información sobre los DSNs disponibles &reftitle.description; - arrayodbc_data_source - resourceconnection_id + arraynullfalseodbc_data_source + Odbc\Connectionodbc intfetch_type - Esta función devolverá la lista de DSN disponibles (después de llamarla - varias veces). + Devuelve una lista de DSN disponibles (tras haberla llamado varias veces). @@ -23,7 +24,7 @@ - connection_id + odbc &odbc.connection.id; @@ -32,24 +33,77 @@ fetch_type - El parámetro fetch_type puede ser uno de los dos tipos de constantes: - SQL_FETCH_FIRST, SQL_FETCH_NEXT. - Use SQL_FETCH_FIRST la primera vez que llame a esta - función, a partir de entonces use SQL_FETCH_NEXT. + El parámetro connection_id es una conexión + ODBC válida. El parámetro fetch_type puede ser una de las + dos constantes siguientes: SQL_FETCH_FIRST o + SQL_FETCH_NEXT. Utilice SQL_FETCH_FIRST + la primera vez que se llama a la función, luego SQL_FETCH_NEXT. + &reftitle.returnvalues; - Devuelve &false; si se produjo un error, y un array si tuvo éxito. + Devuelve &false; si ocurre un error, un &array; en caso de éxito, y + &null; tras haber recuperado el último DSN disponible. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + + + + + + + &reftitle.examples; + + Listar los DSNs disponibles + + +]]> + + &example.outputs.similar; + + dsn + [description] => ODBC Driver 17 for SQL Server +) +Array +( + [server] => other_dsn + [description] => Microsoft Access Driver (*.mdb, *.accdb) +)]]> + + + + + - + + + odbc_do diff --git a/reference/uodbc/functions/odbc-error.xml b/reference/uodbc/functions/odbc-error.xml index 11bc4b7ca..91c10cdd0 100644 --- a/reference/uodbc/functions/odbc-error.xml +++ b/reference/uodbc/functions/odbc-error.xml @@ -1,28 +1,29 @@ - + + odbc_error - Obtener el último código de error + Lee el último código de error &reftitle.description; stringodbc_error - resourceconnection_id + Odbc\Connectionnullodbc&null; - Devuelve el estado de ODBC mediante un número de seis dígitos, o una cadena vacía si no hubo - errores. + Devuelve un estado ODBC de 6 dígitos, o una cadena vacía si no había más errores. + &reftitle.parameters; - connection_id + odbc &odbc.connection.id; @@ -30,18 +31,45 @@ + &reftitle.returnvalues; - Si se especifica connection_id, se devuelve el último estado - de esta conexión, si no, se devuleve el último estado de cualquier - conexión. + Si odbc está especificado, se devuelve el último + estado ODBC de esta conexión. Si + connection_id se omite, se devuelve el último + estado de cualquier conexión. - Esta función devuelve un valor significativo sólo si la última consultaodbc falló - (es decir, odbc_exec devolvió &false;). + Esta función devuelve un valor significativo únicamente si + la última consulta ODBC ha fallado + (es decir, la función odbc_exec ha devuelto &false;). + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + + 8.0.0 + + odbc es ahora nullable. + + + + + + + &reftitle.seealso; @@ -52,7 +80,6 @@ - - + + odbc_errormsg - Obtener el último mensaje de error + Lee el último mensaje de error &reftitle.description; stringodbc_errormsg - resourceconnection_id + Odbc\Connectionnullodbc&null; - Devuelve una cadena que contiene el último mensaje de error de ODBC, o una cadena - vacía si no hubo errores. + Devuelve un string que contiene el último mensaje de error ODBC, o + un string vacío si no hubo error. @@ -22,7 +23,7 @@ - connection_id + odbc &odbc.connection.id; @@ -33,15 +34,39 @@ &reftitle.returnvalues; - Si se especifica connection_id, se devuelve el último - estado de esa conexión, si no se devuelve el último estado de cualquier - conexión. + Si odbc está especificado, el + último estado ODBC de esta conexión es devuelto. - Esta función devuelve un valor significativo sólo si falló la última consulta odbc - (es decir, si odbc_exec devolvió &false;). + Esta función devuelve un valor significativo únicamente si + la última consulta ODBC falló + (i.e. la función odbc_exec devolvió &false;). + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + + 8.0.0 + + odbc es ahora nullable. + + + + + + + &reftitle.seealso; @@ -52,7 +77,6 @@ - - - + + odbc_exec - Preparar y ejecutar una sentencia SQL + Ejecuta directamente una consulta SQL &reftitle.description; - resourceodbc_exec - resourceconnection_id - stringquery_string - intflags + Odbc\Resultfalseodbc_exec + Odbc\Connectionodbc + stringquery - Envía una sentencia SQL al servidor de bases de datos. + odbc_exec envía un comando SQL + a la fuente de datos ODBC, representada por + connection_id. @@ -24,24 +25,16 @@ - connection_id + odbc &odbc.connection.id; - query_string + query - La sentencia SQL. - - - - - flags - - - Este parámetro no se usa actualmente. + La consulta SQL. @@ -51,10 +44,33 @@ &reftitle.returnvalues; - Devuelve un identificador de resultado de ODBC si el comando SQL se ejecutó - con éxito, o &false; si se produjo un error. + &odbc.result.object-return; si el comando SQL se ejecutó con éxito + &false; si ocurre un error. + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + &odbc.changelog.result-return; + + 8.0.0 + + flags fue eliminado. + + + + + + &reftitle.seealso; @@ -65,7 +81,6 @@ - - - + + + odbc_execute - Ejecutar una declaración preparada + Ejecuta una consulta SQL preparada &reftitle.description; boolodbc_execute - resourceresult_id - arrayparameters_array + Odbc\Resultstatement + arrayparams[] - Ejecuta una declaración preparado con odbc_prepare. + Ejecuta una consulta SQL preparada por odbc_prepare. @@ -25,35 +26,34 @@ - result_id + statement - El resource de identificación de resultado, desde odbc_prepare. + &odbc.result.object; desde odbc_prepare. - parameters_array + params - Los parámetros en parameter_array serán - sustituidoss por parámetros de sustitución en la declaración preparada en orden. - Los elementos de este array serán convertidos a cadenas al llamar a esta - función. + Los valores del parámetro params serán + sustituidos en las variables de consulta de la consulta preparada. + Los elementos de este array serán convertidos a string al + llamar a esta función. - Cualquier parámetro de parameter_array que - comience y finalice con comillas simples se tomará como el nombre de un - archivo para leer y enviar al servor de la base de datos como la información para el - parámetro de sustitución apropiado. + Todo parámetro de params que + comience y termine con comillas simples será considerado + como un nombre de fichero a leer y enviado a la base de datos, + con la variable de consulta apropiada. - Si desea almacenar una cadena que comienza y finaliza con - comillas simples, debe añadir un espacio u otro carácter distinto de las comillas simples - al inicio o final del parámetro, lo que prevendrá al - parámetro de ser tomado como un nombre de archivo. Si esto no es una opción, - entonces debe usar otro mecanismo para almacenar la cadena, tal como - ejecutar la consulta directamente con odbc_exec). + Si se desea almacenar un string que comience y termine + realmente con comillas, se debe añadir un espacio al inicio + o al final del string, para evitar que este parámetro sea confundido con + un nombre de fichero. Si esto no es posible en el contexto de la aplicación, + se deberá utilizar la función odbc_exec. @@ -68,14 +68,41 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-return; + + 8.0.0 + + El parámetro flags, sin uso, ha sido eliminado. + + + + + + + &reftitle.examples; - Ejemplo de <function>odbc_execute</function> y <function>odbc_prepare</function> + + Ejemplo con <function>odbc_execute</function> y + <function>odbc_prepare</function> + - En el código siguiente, $éxito solamente será - &true; si los tres parámetros de myproc son parámetros IN: + En el script siguiente, $success solo será + posible si los tres parámetros de maproc + son parámetros de tipo IN: ]]> - Si se necesita llamar a procedimientos almacendos usando parámetros INOUT o OUT, - una solución recomendada es usar una extensión nativa para la base de datos - (por ejemplo, oci8 para Oracle). + Si se necesita llamar a un procedimiento almacenado utilizando parámetros + INOUT o OUT, la solución es utilizar una extensión nativa de la base de datos + (por ejemplo oci8 para Oracle). @@ -103,11 +130,10 @@ $éxito = odbc_execute($declaración, array($a, $b, $c)); odbc_prepare - - + + - - - + + + odbc_fetch_array - Obtener una fila de resultados como una matriz asociativa + Lee una línea de resultado en un array asociativo - + &reftitle.description; - arrayodbc_fetch_array - resourceresult - intrownumber + arrayfalseodbc_fetch_array + Odbc\Resultstatement + intnullrow&null; - Obtiene un array asociativo desde una consulta de ODBC. + odbc_fetch_array lee una línea de resultado + en un array asociativo desde una consulta ODBC. - + &reftitle.parameters; - result + statement - El recurso del resultado de odbc_exec. + &odbc.result.object; desde odbc_exec. - rownumber + row - Escoger opcionalmente qué número de fila a recuperar. + El número de la línea que debe ser leída, opcional. - + &reftitle.returnvalues; - Devuelve una matriz que se corresponde con la fila traída, o &false; si ya - no hay más filas. + Devuelve un array correspondiente a la línea recuperada, o &false; + si no hay más líneas disponibles. - + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + 8.4.0 + + row es ahora nullable. + + + + + + + &reftitle.notes; - Esta función existe cuando se compila con soporte para DBMaker, IBM DB2 o UnixODBC. + Esta función está disponible cuando PHP es compilado con + el soporte IBM DB2 o UnixODBC. - + &reftitle.seealso; @@ -72,7 +98,6 @@ - - - + + + odbc_fetch_into - Traer una fila de resultados en una matriz + Lee una línea de resultado y la coloca en un array - + &reftitle.description; - intodbc_fetch_into - resourceresult_id - arrayresult_array - intrownumber + intfalseodbc_fetch_into + Odbc\Resultstatement + arrayarray + intnullrow&null; - Trae una fila de resultados en un array. + Lee una línea de resultado y la coloca en un array. @@ -26,29 +27,28 @@ - result_id + statement - El resource del resultado. + &odbc.result.object;. - result_array + array - El array resultante - que puede ser de cualquier tipo ya que será convertido a tipo - array. La matriz contendrá los valores de columnas comenzando en el índice - de matriz 0. + Puede ser de cualquier tipo, ya que será convertido + en array. El array contendrá los valores de las columnas, estas + últimas están numeradas a partir de 0. - rownumber + row - El número de fila. + El número de la línea. @@ -59,20 +59,42 @@ &reftitle.returnvalues; - Devuelve el número de columnas del resultado; - &false; si se produjo un error. + Devuelve el número de columnas del resultado, o &false; si ocurre un error. + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + 8.4.0 + + row es ahora nullable. + + + + + + + &reftitle.examples; - Ejemplos de <function>odbc_fetch_into</function> + Ejemplo con <function>odbc_fetch_into</function> ]]> @@ -82,7 +104,7 @@ $rc = odbc_fetch_into($res_id, $mi_array); ]]> @@ -90,7 +112,6 @@ $rc = odbc_fetch_into($res_id, $mi_array, 2); - - - + + + odbc_fetch_object - Obtener una fila de resultados como un objeto + Lee una línea de resultado en un objeto - + &reftitle.description; - objectodbc_fetch_object - resourceresult - intrownumber + stdClassfalseodbc_fetch_object + Odbc\Resultstatement + intnullrow&null; - Obtiene un object desde una consulta de ODBC. + odbc_fetch_object lee una línea de resultado + en un objeto desde una consulta ODBC. - + &reftitle.parameters; - result + statement - El recurso de resultado de odbc_exec. + &odbc.result.object; desde odbc_exec. - rownumber + row - Escoger opcionalmente qué número de fila recuperar. + El número de línea a recuperar, opcional. - + &reftitle.returnvalues; - Devuelve un objeto que se corresponde con la fila traída, o &false; si ya - no hay más filas. + Devuelve un objeto que corresponde a la línea recuperada, o &false; + si no hay más líneas disponibles. - + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + 8.4.0 + + row es ahora nullable. + + + + + + + &reftitle.notes; - Esta función existe cuando se compila con soporte para DBMaker, IBM DB2 o UnixODBC. + Esta función está disponible cuando PHP es compilado + con soporte IBM DB2 o UnixODBC. - + &reftitle.seealso; @@ -72,7 +98,6 @@ - - + + odbc_fetch_row - Traer una fila + Lee una línea de resultado &reftitle.description; boolodbc_fetch_row - resourceresult_id - introw_number + Odbc\Resultstatement + intnullrow&null; - Trae una fila de la información que fue devuelta por odbc_do - o odbc_exec. Después de llamar a odbc_fetch_row, - se puede acceder a los campos de esa fila con - odbc_result. + Lee una línea en el resultado identificado por + result_id y devuelto por + odbc_do o + odbc_exec. Tras + odbc_fetch_row, los campos serán accesibles + con la función odbc_result. @@ -25,30 +28,30 @@ - result_id + statement - El indentificador de resultado. + &odbc.result.object;. - row_number + row - Si no se especifica row_number, - odbc_fetch_row intentará traer la siguiente fila del - conjunto de resultados. Se pueden mezclar las llamadas a odbc_fetch_row - con o sin row_number. + Si row es omitido, + row intentará leer la siguiente + línea en el resultado. Llamadas repetidas + a odbc_fetch_row con y sin parámetro + row pueden ser combinadas libremente. - Para revisar el resultado más de una vez se puede llamar a - odbc_fetch_row con - row_number 1, y después continuar haciendo - odbc_fetch_row sin - row_number para revisar el resultado. Si un controlador - no soporta traer filas mediante número, el - parámetro row_number es ignorado. + Para revisar todas las líneas de un resultado varias veces, + se puede llamar a odbc_fetch_row con row_number = 1, + luego continuar llamando a odbc_fetch_row sin el + parámetro row para revisar + todo el resultado. Si un controlador no soporta la lectura de + líneas por número, el parámetro será ignorado. @@ -58,11 +61,48 @@ &reftitle.returnvalues; - Devuelve &true; si hubo una fila, de otro modo &false;. + Devuelve &true; si la línea existe, &false; en caso contrario. - + + &reftitle.errors; + + Se emite un E_WARNING cuando row + es igual o inferior a cero. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + 8.4.0 + + Ahora se emite un E_WARNING cuando row + es igual o inferior a cero. + + + + 8.0.0 + + row ahora es nullable. + + + + + + + - - + + + odbc_field_len - Obtener la longitud (precisión) de un campo + Lee la longitud de un campo &reftitle.description; - intodbc_field_len - resourceresult_id - intfield_number + intfalseodbc_field_len + Odbc\Resultstatement + intfield - Obtiene la longitud de un campo referenciado por número del indentificador de resultado - dado. + Lee la longitud del campo identificado por su número. @@ -24,18 +24,18 @@ - result_id + statement - El identificador de resultado. + &odbc.result.object;. - field_number + field - El número de campo. La numeración de campos empieza en 1. + El número del campo. La numeración comienza en 1. @@ -45,20 +45,38 @@ &reftitle.returnvalues; - Devuelve la longitud del campo, o &false; en caso de error. + Devuelve la longitud del campo o + &false; si ocurre un error. + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + + &reftitle.seealso; - odbc_field_scale para obtener la escala de un - número de coma flotante + odbc_field_scalepara conocer + la escala de un número de coma flotante - - + + + odbc_field_name - Obtener el nombre de una columna + Lee el nombre de la columna &reftitle.description; - stringodbc_field_name - resourceresult_id - intfield_number + stringfalseodbc_field_name + Odbc\Resultstatement + intfield - Obtiene el nombre de la columna que ocupa el número de columna dado del identificador - de resultado dado. + Obtiene el nombre del campo que ocupa el número de columna dado en el objeto resultado especificado. @@ -23,18 +24,18 @@ - result_id + statement - El identificador de resultado. + &odbc.result.object;. - field_number + field - El número de columna. La numeración de columnas comienza en 1. + El número de la columna. La numeración comienza en 1. @@ -44,11 +45,28 @@ &reftitle.returnvalues; - Devuelve el nombre del campo como cadena, o &false; si se produjo un error. + Devuelve el nombre de la columna, como un &string;, + o &false; si ocurre un error. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + + - + + + odbc_field_num - Devolver el número de columna + Número de columna &reftitle.description; - intodbc_field_num - resourceresult_id - stringfield_name + intfalseodbc_field_num + Odbc\Resultstatement + stringfield - Obtiene el número del espacio de columna que se corresponde con el campo nominado del - identificador de resultado dado. + Obtiene el número de la columna correspondiente al campo nombrado en el objeto resultado especificado. @@ -23,15 +24,15 @@ - result_id + statement - El identificador de resultado. + &odbc.result.object;. - field_name + field El nombre del campo. @@ -44,12 +45,28 @@ &reftitle.returnvalues; - Devuelve el número de campo como un valor entero, o &false; si se produjo un error. - La numeración de campos comienza en 1. + Devuelve el número del campo, en forma de &integer;, o + &false; si ocurre un error. La numeración comienza en 1. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + + - + + + odbc_field_precision @@ -17,8 +19,8 @@ &reftitle.seealso; - odbc_field_scale para obtener la escala de un - número de coma flotante. + odbc_field_scale para conocer + la escala de un número de coma flotante. diff --git a/reference/uodbc/functions/odbc-field-scale.xml b/reference/uodbc/functions/odbc-field-scale.xml index 67d0522c0..87fd1155b 100644 --- a/reference/uodbc/functions/odbc-field-scale.xml +++ b/reference/uodbc/functions/odbc-field-scale.xml @@ -1,21 +1,24 @@ - + + + odbc_field_scale - Obtener la escala de un campo + Lee la escala de un campo &reftitle.description; - intodbc_field_scale - resourceresult_id - intfield_number + intfalseodbc_field_scale + Odbc\Resultstatement + intfield - Obtiene la escala de un campo referenciado mediante número del identificador de resultado - dado. + Lee la escala del campo referenciado por su número de campo + field_number en el resultado ODBC + result_id. @@ -23,18 +26,18 @@ - result_id + statement - El identificador de resultado. + &odbc.result.object;. - field_number + field - El número de campo. La numeración de campos comienza en 1. + El número del campo. La numeración comienza en 1. @@ -44,11 +47,27 @@ &reftitle.returnvalues; - Devuelve la escala del campo como un valor de tipo integer, o &false; si se produjo un error. + Devuelve la escala del campo, en forma de &integer;, o &false; en caso de error. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + + - + + + odbc_field_type @@ -9,13 +11,12 @@ &reftitle.description; - stringodbc_field_type - resourceresult_id - intfield_number + stringfalseodbc_field_type + Odbc\Resultstatement + intfield - Obtiene el tipo SQL de un campo referenciado mediante número en el identificador de - resultado dado. + Lee el tipo de datos SQL de un campo, identificado por su número. @@ -23,18 +24,18 @@ - result_id + statement - El identificador de resultado. + &odbc.result.object;. - field_number + field - El número de campo. La numeración de campos comienza en 1. + El número del campo. La numeración comienza en 1. @@ -44,11 +45,28 @@ &reftitle.returnvalues; - Devuelve el tipo de campo como cadena, o &false; si se produjo un error. + Devuelve el tipo del campo, en forma de &string;, + o &false; en caso de error. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + + - + + odbc_foreignkeys - Recupera información de una lista de claves extranjeras + Lista las claves foráneas - + &reftitle.description; - resourceodbc_foreignkeys - resourceconnection_id - stringpk_qualifier - stringpk_owner + Odbc\Resultfalseodbc_foreignkeys + Odbc\Connectionodbc + stringnullpk_catalog + stringpk_schema stringpk_table - stringfk_qualifier - stringfk_owner + stringfk_catalog + stringfk_schema stringfk_table - Recupera una lista de claves extranjeras de la tabla especificada o una lista de - claves extranjeras de otras tablas que hacen referencia a la clave primaria de la - tabla especificada + Lista las claves foráneas utilizadas en la tabla + pk_table. @@ -31,24 +31,26 @@ - connection_id + odbc &odbc.connection.id; - pk_qualifier + fk_catalog - El cualificador de clave primaria. + El catálogo ('qualifier' en terminología ODBC 2) de la clave + primaria de la tabla. - pk_owner + pk_schema - El propietario de la clave primaria. + El esquema ('qualifier' en terminología ODBC 2) de la clave + primaria de la tabla. @@ -56,23 +58,25 @@ pk_table - La tabla de la clave primaria. + La tabla de clave primaria. - fk_qualifier + pk_catalog - El cualificador de la clave extranjera. + El catálogo ('qualifier' en terminología ODBC 2) de la clave + foránea de la tabla. - fk_owner + fk_schema - El propietario de la clave extranjera. + El esquema ('qualifier' en terminología ODBC 2) de la clave + foránea de la tabla. @@ -80,7 +84,7 @@ fk_table - La tabla de la clave extranjera. + La tabla de clave foránea. @@ -91,50 +95,87 @@ &reftitle.returnvalues; - Devuelve un identificador de resultado ODBC &return.falseforfailure;. + &odbc.result.object-return-falseforfailure; - El conjunto de resultados tiene las siguientes columnas: + El conjunto de resultados contiene las siguientes columnas: - PKTABLE_QUALIFIER - PKTABLE_OWNER - PKTABLE_NAME - PKCOLUMN_NAME - FKTABLE_QUALIFIER - FKTABLE_OWNER - FKTABLE_NAME - FKCOLUMN_NAME - KEY_SEQ - UPDATE_RULE - DELETE_RULE - FK_NAME - PK_NAME + PKTABLE_CAT + PKTABLE_SCHEM + PKTABLE_NAME + PKCOLUMN_NAME + FKTABLE_CAT + FKTABLE_SCHEM + FKTABLE_NAME + FKCOLUMN_NAME + KEY_SEQ + UPDATE_RULE + DELETE_RULE + FK_NAME + PK_NAME + DEFERRABILITY + &odbc.result.driver-specific; + + Si las claves foráneas asociadas con una clave primaria son solicitadas, el conjunto + de resultados está ordenado por FKTABLE_CAT, FKTABLE_SCHEM, + FKTABLE_NAME y KEY_SEQ. + Si las claves primarias asociadas con una clave foránea son solicitadas, el conjunto + de resultados está ordenado por PKTABLE_CAT, PKTABLE_SCHEM, + PKTABLE_NAME y KEY_SEQ. + Si pk_table contiene un nombre de tabla, - odbc_foreignkeys devuelve un conjunto de resultados - que contienen la clave primaria de la tabla especificada y todas las - claves extranjeras que hacen referencia a ella. + odbc_foreignkeys retorna la clave primaria + de la tabla pk_table, y todas las + claves foráneas que hacen referencia a ella. Si fk_table contiene un nombre de tabla, - odbc_foreignkeys devuelve un conjunto de resultados - que contienen todas las claves extranjeras de la tabla especificada y las - claves primarias (de otras tablas) a las que hacen referencia. + odbc_foreignkeys retorna la lista de + claves foráneas de la tabla fk_table, + y las claves primarias (de otras tablas) que hacen referencia a ella. Si pk_table y fk_table contienen nombres de tablas, - odbc_foreignkeys devuelve las claves extranjeras de - la tabla especificada en fk_table que hacen referencia - a la clave primaria de la tabla especificada en - pk_table. Debería ser una clave como máximo. + odbc_foreignkeys retorna la lista de claves + foráneas de la tabla fk_table que utilizan + la clave primaria de la tabla pk_table. + Esta lista debería contener como máximo una clave. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + &odbc.changelog.result-return; + + + + + + &reftitle.seealso; + + + odbc_tables + odbc_primarykeys + + + + + - + + + odbc_free_result - Liberar los recursos asociados con un resultado + Libera los objetos asociados a un resultado &reftitle.description; - boolodbc_free_result - resourceresult_id + trueodbc_free_result + Odbc\Resultstatement - Libera los recursos asociados con un resultado. + Libera los objetos asociados a un resultado. - odbc_free_result sólo necesita ser llamado si se tiene - preocupación de usar demasiada memoria mientras se está ejecutando el script. - Toda la memoria de resultados será liberada cuando el script finalice. + odbc_free_result solo es necesario + si se teme utilizar demasiada memoria durante la ejecución + del script. Todos los resultados en memoria se liberarán + al final del script. @@ -26,10 +29,10 @@ - result_id + statement - El identificador de resultado. + &odbc.result.object;. @@ -39,21 +42,39 @@ &reftitle.returnvalues; - Siempre devuelve &true;. + &return.true.always; + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + + &reftitle.notes; - Si el auto-envío está deshabilitado (véase odbc_autocommit) y - se llama a odbc_free_result antes del envío, todas - las transacciones pendientes serán reanudadas. + Si la autovalidación está desactivada (ver + odbc_autocommit) y se llama + a odbc_free_result antes de validar las consultas, + todas las transacciones preparadas se cancelarán. - - + + + odbc_gettypeinfo - Recupera información sobre los tipos de datos soportados por la fuente de datos + Lista los tipos de datos soportados por un origen - + &reftitle.description; - resourceodbc_gettypeinfo - resourceconnection_id - intdata_type + Odbc\Resultfalseodbc_gettypeinfo + Odbc\Connectionodbc + intdata_type0 - Recupera información sobre los tipos de datos soportados por la fuente de datos. + Lista los tipos de datos soportados por un origen. @@ -24,7 +26,7 @@ - connection_id + odbc &odbc.connection.id; @@ -33,8 +35,8 @@ data_type - El tipo de datos, el cuál se puede usar para restringir la información a un - único tipo de datos. + Puede ser utilizado para restringir la información a + un solo tipo de datos. @@ -45,11 +47,10 @@ &reftitle.returnvalues; - Devuelve un identificador de resultado ODBC o - &false; si se produjo un error. + &odbc.result.object-return-falseforfailure; - El conjunto de resultados tiene las siguientes columnas: + El resultado posee las columnas siguientes: TYPE_NAME DATA_TYPE @@ -69,12 +70,29 @@ - El conjunto de resultados está ordenado por DATA_TYPE y TYPE_NAME. + El resultado está ordenado por DATA_TYPE y TYPE_NAME. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + &odbc.changelog.result-return; + + + + + - + + + odbc_longreadlen - Manejo de columnas LONG + Gestión de columnas de tipo LONG &reftitle.description; - boolodbc_longreadlen - resourceresult_id + trueodbc_longreadlen + Odbc\Resultstatement intlength - Habilita el manejo de columnas de tipo LONG y LONGVARBINARY. + Activa la gestión de columnas de tipo LONG, + LONGVARCHAR y LONGVARBINARY. + La longitud por defecto puede ser definida utilizando la directiva &php.ini; + uodbc.defaultlrl. @@ -22,10 +27,10 @@ - result_id + statement - El identificador de resultado. + &odbc.result.object;. @@ -33,9 +38,10 @@ length - El número de bytes devueltos a PHP está controlado por el parámetro - length. Si está establecido a 0, la información de la columna Long se pasa a través del - cliente. + El número de bytes retornado a PHP. + Si se define como 0, los datos de las columnas + de tipo LONG son pasados al cliente (es decir, impresos) cuando son + recuperados con la función odbc_result. @@ -45,20 +51,37 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + + &reftitle.notes; - El manejo de columnas LONGVARBINARY también está afectado por + La gestión de tipos LONGVARBINARY también es afectada por odbc_binmode. - - - + + + odbc_next_result - Verifica si están disponibles múltiples resultados + Verifica si hay múltiples resultados disponibles &reftitle.description; boolodbc_next_result - resourceresult_id + Odbc\Resultstatement - Verifica si hay más conjuntos de resultados disponibles así como permitir el acceso - al siguiente conjunto de resultados mediante odbc_fetch_array, + Verifica si hay más conjuntos de resultados disponibles accesibles + mediante las funciones odbc_fetch_array, odbc_fetch_row, odbc_result, etc. @@ -23,10 +24,10 @@ - result_id + statement - El identificador de resultado. + &odbc.result.object;. @@ -36,14 +37,32 @@ &reftitle.returnvalues; - Devuelve &true; si hay más conjuntos de resultados, &false; si no. + Devuelve &true; si no hay más conjuntos de resultados, &false; en caso contrario. + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + + &reftitle.examples; - <function>odbc_next_result</function> + Ejemplo con <function>odbc_next_result</function> ]]> @@ -86,31 +105,30 @@ var_dump(odbc_next_result($r_Results)); &example.outputs; string(1) "A" } bool(false) -Get second results set bool(true) -Dump second result set array(1) { +Recuperación del segundo conjunto de resultados:bool(true) +Muestra el segundo conjunto de resultados: array(1) { ["B"]=> string(1) "B" } bool(false) -Get third results set bool(true) -Dump third result set array(1) { +Recuperación del tercer conjunto de resultados: bool(true) +Muestra el tercer conjunto de resultados: array(1) { ["C"]=> string(1) "C" } bool(false) -Try for a fourth result set bool(false) +Intento de recuperar un cuarto conjunto de resultados: bool(false) ]]> - - + + + odbc_num_fields - Número de columnas de un resultado + Número de columnas en un resultado &reftitle.description; intodbc_num_fields - resourceresult_id + Odbc\Resultstatement - Obtiene el número de campos (columnas) de un resultado ODBC. + Obtiene el número de columnas en un resultado ODBC. @@ -21,10 +23,11 @@ - result_id + statement - El identificador de resultado devuelto por odbc_exec. + &odbc.result.object; devuelto por la función + odbc_exec. @@ -34,11 +37,27 @@ &reftitle.returnvalues; - Devuelve el número de campos, o -1 si se produjo un error. + Devuelve el número de columnas, o -1 en caso de error. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + + - + + + odbc_num_rows - Número de filas de un resultado + Número de filas en un resultado &reftitle.description; intodbc_num_rows - resourceresult_id + Odbc\Resultstatement - Obtiene el número de filas de un resultado. Para las declaraciones INSERT, UPDATE y - DELETE, odbc_num_rows devuelve el número de filas - afectadas. Para la cláusula SELECT este puede ser el número - de filas disponibles. + Lee el número de filas en un resultado. Para los comandos INSERT, + UPDATE y DELETE, odbc_num_rows devuelve el + número de filas afectadas. Para los comandos SELECT, esto + PUEDE ser el número de filas disponibles, pero + no es seguro. @@ -24,10 +27,11 @@ - result_id + statement - El identificador de resultado devuelto por odbc_exec. + &odbc.result.object; devuelto por la función + odbc_exec. @@ -37,21 +41,38 @@ &reftitle.returnvalues; - Devuelve el número de filas de un resultado ODBC. - Esta función devolverá -1 si se produjo un error. + Devuelve el número de filas en el resultado ODBC. + Esta función devolverá -1 si ocurre un error. &reftitle.notes; - Usar odbc_num_rows para determinar el número de filas - disponibles después de que SELECT devuelva -1 con varios controladores. + El uso de la función odbc_num_rows para + determinar el número de filas disponibles después de un SELECT devolverá + -1 con la mayoría de los controladores. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + + + - + + odbc_pconnect - Abrir una conexión persistente a una base de datos + Abre una conexión persistente a un origen de datos - + &reftitle.description; - resourceodbc_pconnect + Odbc\Connectionfalseodbc_pconnect stringdsn - stringuser - stringpassword - intcursor_type + stringnulluser&null; + stringnullpassword&null; + intcursor_optionSQL_CUR_USE_DRIVER - Abre una conexión persistente a una base de datos. + Abre una conexión persistente a un origen de datos. - Esta función es como - odbc_connect, excepto que la conexión no - se cierra en realidad cuando el script finaliza. Futuras consultas - para una conexión con la misma combinación de dsn, - user, password - (mediante odbc_connect y - odbc_pconnect) pueden reusar la conexión - persistente. + odbc_pconnect se comporta de manera similar + a odbc_connect, pero la conexión abierta + no se cierra realmente cuando el script finaliza. Las siguientes + solicitudes que se realicen a una conexión cuyos + dsn, user, + password sean los mismos que esta (con + odbc_connect y odbc_pconnect) + reutilizarán la conexión abierta. - + &reftitle.parameters; - Véase odbc_connect para más detalles. + Consulte la función odbc_connect para más detalles. - + &reftitle.returnvalues; - Devuelve un identificador de conexión ODBCo 0 (&false;) si - se produjo un error. + Devuelve una conexión ODBC, &return.falseforfailure;. - + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-return; + &odbc.changelog.credential-params; + + + + + &reftitle.notes; - Las conexiones persistentes no tienen efecto si PHP se usa como programa + Las conexiones persistentes no tienen ningún efecto si PHP se utiliza como CGI. - + &reftitle.seealso; odbc_connect - Conexiones Persistentes a Bases de Datos + Las conexiones + persistentes a bases de datos - - + - - + + + odbc_prepare - Prepara una declaración para su ejecución + Prepara una orden para su ejecución &reftitle.description; - resourceodbc_prepare - resourceconnection_id - stringquery_string + Odbc\Resultfalseodbc_prepare + Odbc\Connectionodbc + stringquery - Prepara una declaración para su ejecución. El identificador de resultado se puede usar - después para ejecutar la declaración con odbc_execute. + Prepara una orden para su ejecución. &odbc.result.object; puede ser utilizado más + tarde para ejecutar la orden con odbc_execute. - Algunas bases de datos (como IBM DB2, MS SQL Server, y Oracle) soportan - procedimientos almacenados que aceptan parámetros de tipo IN, INOUT, y OUT como - están definidos por la especificación ODBC. Sin embargo, el controlador ODBC Unificado - actualmente sólo soporta parámetros de tipo IN para procedimientos almacenados. + Algunas bases de datos (como IBM DB2, MS SQL Server y Oracle) + soportan los procedimientos almacenados que aceptan los tipos de parámetros + IN, INOUT y OUT como se definen en las especificaciones ODBC. Sin embargo, + el driver unificado ODBC soporta actualmente únicamente el tipo de parámetros + IN para los procedimientos almacenados. @@ -32,16 +34,16 @@ - connection_id + odbc &odbc.connection.id; - query_string + query - La declaración de cadena de consulta que va a ser preparada. + La consulta a preparar. @@ -52,19 +54,38 @@ &reftitle.returnvalues; - Devuelve un identificador de resultado ODBC si el comando SQL se preparó - con éxito. Devuleve &false; si se produjo un error. + &odbc.result.object-return; si la orden SQL ha sido + preparada con éxito. Retorna &false; si ocurre un error. + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + &odbc.changelog.result-return; + + + + + &reftitle.examples; - Ejemplo de <function>odbc_execute</function> y <function>odbc_prepare</function> + Ejemplo con <function>odbc_prepare</function> y <function>odbc_execute</function> - En el siguiente código, $éxito sólo será - &true; si todos los parámetros de miproc son parámetros IN: + En el código siguiente, $res solo será + válido si los tres parámetros para myproc + son parámetros IN: ]]> - Si se necesita llamar a un procedimiento almacenado usando parámetros INOUT o OUT, - la solución recomendada es usar una extensión nativa para la base de datos - (por ejemplo, oci8 para Oracle). + Si necesita llamar a un procedimiento almacenado que utilice parámetros + INOUT o OUT, se recomienda utilizar la extensión nativa de su + base de datos + (por ejemplo oci8 para Oracle). @@ -92,11 +114,10 @@ $éxito = odbc_execute($stmt, array($a, $b, $c)); odbc_execute - - + + - - + + + odbc_primarykeys - Obtiene las claves primarias de una tabla + Lista las columnas utilizadas en una clave primaria &reftitle.description; - resourceodbc_primarykeys - resourceconnection_id - stringqualifier - stringowner + Odbc\Resultfalseodbc_primarykeys + Odbc\Connectionodbc + stringnullcatalog + stringschema stringtable - Devuelve un identificador de resultado que puede usarse para traer los nombres de columnas + Devuelve un objeto resultado que puede ser utilizado para recuperar los nombres de las columnas que componen la clave primaria de una tabla. + &reftitle.parameters; - connection_id + odbc &odbc.connection.id; - qualifier + catalog + &odbc.parameter.catalog; - owner + schema + &odbc.parameter.schema; @@ -54,25 +59,92 @@ + &reftitle.returnvalues; - Devuelve un identificador de resultado ODBC &return.falseforfailure;. + &odbc.result.object-return-falseforfailure; - El conjunto de resultados tiene las siguientes columnas: + El conjunto de resultados contiene las siguientes columnas: - TABLE_QUALIFIER - TABLE_OWNER - TABLE_NAME - COLUMN_NAME - KEY_SEQ - PK_NAME + TABLE_CAT + TABLE_SCHEM + TABLE_NAME + COLUMN_NAME + KEY_SEQ + PK_NAME + &odbc.result.driver-specific; + + El conjunto de resultados está ordenado por TABLE_CAT, TABLE_SCHEM, + TABLE_NAME y KEY_SEQ. + - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + &odbc.changelog.result-return; + + + + + + + &reftitle.examples; + + Listar las Claves primarias de una Columna + + +]]> + + &example.outputs.similar; + + TutorialDB + [TABLE_SCHEM] => dbo + [TABLE_NAME] => TEST + [COLUMN_NAME] => id + [KEY_SEQ] => 1 + [PK_NAME] => PK__TEST__3213E83FE141F843 +) +]]> + + + + + + &reftitle.seealso; + + + odbc_tables + odbc_foreignkeys + + + + + - + + + odbc_procedurecolumns - Recuperar información sobre los parámetros a procedimientos + Lista los parámetros de los procedimientos - + &reftitle.description; - resourceodbc_procedurecolumns - resourceconnection_id - - - resourceodbc_procedurecolumns - resourceconnection_id - stringqualifier - stringowner - stringproc - stringcolumn + Odbc\Resultfalseodbc_procedurecolumns + Odbc\Connectionodbc + stringnullcatalog&null; + stringnullschema&null; + stringnullprocedure&null; + stringnullcolumn&null; - Recuperar información sobre los parámetros a procedimientos. + Lista los parámetros de los procedimientos. @@ -31,30 +29,30 @@ - connection_id + odbc &odbc.connection.id; - qualifier + catalog - El cualificador. + &odbc.parameter.catalog; - owner + schema - El propietario. + &odbc.parameter.schema; &odbc.parameter.search; - proc + procedure El procedimiento. @@ -78,36 +76,121 @@ &reftitle.returnvalues; - Devuelve una lista de parámetros de entrada y de salida, así como las - columnas que componen el conjunto de resultados para los procedimientos especificados. - Devuelve un identificador de resultado ODBC &return.falseforfailure;. + Devuelve los parámetros de entrada y salida, así como las columnas + utilizadas en los procedimientos designados por los argumentos. + &odbc.result.object-return-falseforfailure; - El conjunto de resultados tiene las siguientes columnas: + El conjunto de resultados contiene las siguientes columnas: - PROCEDURE_QUALIFIER - PROCEDURE_OWNER - PROCEDURE_NAME - COLUMN_NAME - COLUMN_TYPE - DATA_TYPE - TYPE_NAME - PRECISION - LENGTH - SCALE - RADIX - NULLABLE - REMARKS + PROCEDURE_CAT + PROCEDURE_SCHEM + PROCEDURE_NAME + COLUMN_NAME + COLUMN_TYPE + DATA_TYPE + TYPE_NAME + COLUMN_SIZE + BUFFER_LENGTH + DECIMAL_DIGITS + NUM_PREC_RADIX + NULLABLE + REMARKS + COLUMN_DEF + SQL_DATA_TYPE + SQL_DATETIME_SUB + CHAR_OCTET_LENGTH + ORDINAL_POSITION + IS_NULLABLE + &odbc.result.driver-specific; - El conjunto de resultados está ordenado por PROCEDURE_QUALIFIER, PROCEDURE_OWNER, - PROCEDURE_NAME y COLUMN_TYPE. + El conjunto de resultados está ordenado por PROCEDURE_CAT, PROCEDURE_SCHEM, + PROCEDURE_NAME y COLUMN_TYPE. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + &odbc.changelog.result-return; + + 8.0.0 + + Antes de esta versión, la función solo podía ser llamada con uno o cinco argumentos. + + + + + + + + &reftitle.examples; + + Lista las columnas de un procedimiento almacenado + + +]]> + + &example.outputs.similar; + + TutorialDB + [PROCEDURE_SCHEM] => dbo + [PROCEDURE_NAME] => GetEmployeeSalesYTD;1 + [COLUMN_NAME] => @SalesPerson + [COLUMN_TYPE] => 1 + [DATA_TYPE] => -9 + [TYPE_NAME] => nvarchar + [COLUMN_SIZE] => 50 + [BUFFER_LENGTH] => 100 + [DECIMAL_DIGITS] => + [NUM_PREC_RADIX] => + [NULLABLE] => 1 + [REMARKS] => + [COLUMN_DEF] => + [SQL_DATA_TYPE] => -9 + [SQL_DATETIME_SUB] => + [CHAR_OCTET_LENGTH] => 100 + [ORDINAL_POSITION] => 1 + [IS_NULLABLE] => YES +) +]]> + + + + + + &reftitle.seealso; + + + odbc_columns + + + + + - + + + odbc_procedures - Obtener la lista de procedimientos almacenados en una fuente de datos específica + Lista los procedimientos almacenados - + &reftitle.description; - resourceodbc_procedures - resourceconnection_id - - - resourceodbc_procedures - resourceconnection_id - stringqualifier - stringowner - stringname + Odbc\Resultfalseodbc_procedures + Odbc\Connectionodbc + stringnullcatalog&null; + stringnullschema&null; + stringnullprocedure&null; - Lista todos los procedimientos en el rango solicitado. + Lista los procedimientos almacenados. @@ -30,30 +28,30 @@ - connection_id + odbc &odbc.connection.id; - qualifier + catalog - El cualificador. + &odbc.parameter.catalog; - owner + schema - El propietario. + &odbc.parameter.schema; &odbc.parameter.search; - name + procedure El nombre. @@ -68,26 +66,98 @@ &reftitle.returnvalues; - Devuelve un identificador de resultaod ODBC - que contiene la información &return.falseforfailure;. + &odbc.result.object-return; que contiene las informaciones&return.falseforfailure;. - El conjunto de resultados tiene las siguientes columnas: + El conjunto de resultados contiene las columnas siguientes: - PROCEDURE_QUALIFIER - PROCEDURE_OWNER - PROCEDURE_NAME - NUM_INPUT_PARAMS - NUM_OUTPUT_PARAMS - NUM_RESULT_SETS - REMARKS - PROCEDURE_TYPE + PROCEDURE_CAT + PROCEDURE_SCHEM + PROCEDURE_NAME + NUM_INPUT_PARAMS + NUM_OUTPUT_PARAMS + NUM_RESULT_SETS + REMARKS + PROCEDURE_TYPE + &odbc.result.driver-specific; + + El conjunto de resultados está ordenado por PROCEDURE_CAT, + PROCEDURE_SCHEMA y PROCEDURE_NAME. + - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + &odbc.changelog.result-return; + + 8.0.0 + + Antes de esta versión, la función solo podía ser llamada con uno o cuatro argumentos. + + + + + + + + &reftitle.examples; + + Lista los procedimientos almacenados de una base de datos + + +]]> + + &example.outputs.similar; + + TutorialDB + [PROCEDURE_SCHEM] => dbo + [PROCEDURE_NAME] => GetEmployeeSalesYTD;1 + [NUM_INPUT_PARAMS] => -1 + [NUM_OUTPUT_PARAMS] => -1 + [NUM_RESULT_SETS] => -1 + [REMARKS] => + [PROCEDURE_TYPE] => 2 +) +]]> + + + + + + &reftitle.seealso; + + + odbc_procedurecolumns + odbc_tables + + + + + - + + odbc_result_all - Imprimir el resultado como una tabla HTML + Muestra el resultado en forma de tabla HTML + + + &warn.deprecated.function-8-1-0; + + &reftitle.description; - intodbc_result_all - resourceresult_id - stringformat + #[\Deprecated] + intfalseodbc_result_all + Odbc\Resultstatement + stringformat"" - Imprime todas las filas de un identificador de resultado producido por - odbc_exec. El resultado se imprime con formato de tabla HTML. + Muestra todas las filas de un resultado. La visualización se realiza en formato HTML. + Los datos no están escapados. + + + Esta función no está destinada a ser utilizada en un entorno de + producción; está prevista para el desarrollo para mostrar + rápidamente un conjunto de resultados. @@ -23,10 +34,10 @@ - result_id + statement - El identificador de resultado. + &odbc.result.object;. @@ -34,7 +45,7 @@ format - Formateo de tabla global adicional. + Permite modificar el aspecto global de la tabla. @@ -44,11 +55,37 @@ &reftitle.returnvalues; - Devuelve el número de filas del resultado o &false; si se produjo un error. + Devuelve el número de filas del resultado, o &false; si se + produce un error. - + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + 8.1.0 + + Esta función ha sido declarada obsoleta. + + + + + + + + + - + + + odbc_result - Obtener información de resultado + Lee un campo de resultado UODBC - + &reftitle.description; - mixedodbc_result - resourceresult_id - mixedfield + stringboolnullodbc_result + Odbc\Resultstatement + stringintfield - Obtener información de resultado + Lee un campo de resultado UODBC. @@ -24,10 +26,10 @@ - result_id + statement - El resource ODBC. + &odbc.result.object;. @@ -35,9 +37,10 @@ field - El nombre de campo a ser traído. Puede ser un entero que contiene - el número de columna o el campo que se quiera; o puede ser una cadena - que contiene el nombre del campo. + El nombre del campo a recuperar. Puede ser tanto un entero, + que contiene el número de columna del campo, en el + resultado, como una cadena de caracteres, que + representa el nombre del campo. @@ -48,28 +51,47 @@ &reftitle.returnvalues; - Devuelve los contenidos de cadena del campo, &false; si se produjo un error, &null; para - datos NULL, o &true; para datos binarios. + Devuelve el contenido del campo, &false; si ocurre un error, &null; + para datos NULL, o &true; para datos binarios. + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &odbc.changelog.result-param; + + + &reftitle.examples; - La primera llamada a odbc_result devuelve el - valor del tercer campo del registro actual del resultado de la - consulta. La segunda llamada a - odbc_result devuelve el valor del campo - cuyo nombre de campo es "val" en el registro actual del resultado de la - consulta. Ocurrirá un error si un parámetro de número de columna para un campo - es menor o excede al número de columnas (o campos) del - registro actual. De forma similar, ocurrirá un error si un campo con un - nombre que no es uno de los nombres de campos de la/s tabla/s que está/n - siendo consultada/s. + La primera llamada a odbc_result devuelve + el valor del tercer campo de la fila actual del + resultado result_id. La segunda + llamada a odbc_result devuelve el valor del + tercer campo cuyo nombre es "val" de la fila actual del + resultado result_id. Se produce un error si + el parámetro de columna es inferior a 1, o + supera el número de columnas del resultado. De la misma + manera, se produce un error si el nombre del campo pasado no + corresponde a ningún campo en el resultado. - Ejemplos de <function>odbc_result</function> + Ejemplo con <function>odbc_result</function> &reftitle.notes; - Los índices de campos comienzan en 1. Respecto a la forma en que - la información binaria o de tipo long es devuelta, consulte - odbc_binmode y + Los índices de campos comienzan en 1. Para más información + sobre cómo leer columnas de tipo binario o largo, + consulte odbc_binmode y odbc_longreadlen. - - - - + + + odbc_rollback - Revertir una transacción + Anula una transacción &reftitle.description; boolodbc_rollback - resourceconnection_id + Odbc\Connectionodbc - Revierte todas las sentencias pendientes de la conexión. + Anula todas las transacciones en la conexión connection_id. @@ -22,7 +23,7 @@ - connection_id + odbc &odbc.connection.id; @@ -36,8 +37,24 @@ &return.success; - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + + + + + - + + + odbc_setoption - Ajustar la configuración de ODBC + Modifica los parámetros ODBC - + &reftitle.description; boolodbc_setoption - resourceid - intfunction + Odbc\ConnectionOdbc\Resultodbc + intwhich intoption - intparam + intvalue - Esta función permite juguetear con las opciones de ODBC para una - conexión o resultado de consulta en particular. Fue escrita para ayudar - a encontrar soluciones a problemas en controladoes ODBC estrafalarios. Probablemente, debería - usar esta función sólo si es un programador de ODBC y - entiende los efectos de las opciones que se dan. Desde luego - necesitará una buena referencia de ODBC para explicar todas las diferentes - opciones y valores que se pueden usar. Diferentes versiones de controlardes - soportan diferentes opciones. + odbc_setoption permite acceder a las opciones + ODBC para una conexión particular o un resultado de + consulta. Fue escrita para ayudar a + la resolución de problemas relacionados con los controladores ODBC + problemáticos. Será necesario utilizar + odbc_setoption si se es un programador + ODBC y se comprenden los diversos efectos de las opciones disponibles. + Asimismo, se necesitará un buen manual de referencia para + comprender las opciones y su uso. Diferentes versiones de + controladores admiten diferentes versiones de opciones. - Ya que los efectos pueden variar dependiendo del controlador ODBC, se desaconseja - el uso de esta función en scripts que van a estar disponilbes públicamente. - También, algunas opciones ODBC no están disponibles - para esta función ya que deben ser establecidas antes de que se - establezca la conexión o la consulta esté preparada. No obstante, - lo que realmente importa es que si en trabajo en particular hace que PHP funcione, - su jefe no le diga que use un producto comercial. + Dado que los efectos pueden variar de un controlador a + otro, el uso de odbc_setoption en + scripts destinados a ser entregados al público + está muy fuertemente desaconsejado. Además, ciertas + opciones ODBC no están disponibles porque deben ser + fijadas antes del establecimiento de la conexión. Sin embargo, + si en un caso bien específico, odbc_setoption + permite utilizar PHP sin que el jefe obligue a + usar un producto comercial, entonces no importa. @@ -42,22 +48,23 @@ - id + odbc - Es un id de conexión o de resultado sobre el que cambiar las configuraciones. - Para SQLSetConnectOption(), es un id de conexión. - Para SQLSetStmtOption(), es un id de resultado. + Un identificador de conexión, o un identificador + de resultado, para el cual se desea modificar opciones. + Para SQLSetConnectOption(), es un identificador de conexión. + Para SQLSetStmtOption(), es un identificador de resultado. - function + which - Es la función ODBC a usar. El valor debería ser - 1 para SQLSetConnectOption() y - 2 para SQLSetStmtOption(). + Función ODBC a utilizar. + El valor debe ser 1 para usar SQLSetConnectOption() y 2 + para SQLSetStmtOption(). @@ -65,15 +72,15 @@ option - La opción a establecer. + La opción a definir. - param + value - El valor para la opción dada por option. + El valor para la opción dada. @@ -88,27 +95,50 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + odbc espera ahora una instancia de Odbc\Connection + o de Odbc\Result; anteriormente, se esperaba un resource. + + + + + + + &reftitle.examples; - Ejemplos de <function>odbc_setoption</function> + Ejemplo con <function>odbc_setoption</function> ]]> @@ -117,7 +147,6 @@ odbc_execute($resultado); - - + + + odbc_specialcolumns - Recupera columnas especiales + Devuelve el conjunto óptimo de columnas - + &reftitle.description; - resourceodbc_specialcolumns - resourceconnection_id + Odbc\Resultfalseodbc_specialcolumns + Odbc\Connectionodbc inttype - stringqualifier - stringowner + stringnullcatalog + stringschema stringtable intscope intnullable - Recupera o bien el conjunto óptimo de columnas que identifican de manera única una - fila de la tabla, o las columnas que son actualizadas automáticamente cuando cualquier - valor de la fila es actualizado por una transacción. + Devuelve el conjunto óptimo de columnas que identifica de manera única + una fila de una tabla, o las columnas que se actualizan automáticamente + cuando alguno de los valores de la fila es modificado por una transacción. @@ -31,7 +33,7 @@ - connection_id + odbc &odbc.connection.id; @@ -40,31 +42,33 @@ type - Cuando el tipo de argumento es SQL_BEST_ROWID, - odbc_specialcolumns devuelve la - columna o columnas que identifican de forma única cada fila de la tabla. + Cuando el tipo es SQL_BEST_ROWID, + odbc_specialcolumns + devuelve la o las columnas que permiten identificar de manera única + cada fila de una tabla. - Cuando el tipo de argumento es SQL_ROWVER, - odbc_specialcolumns devuelve la columnas o columnas de la - tabla especificada, si hibiera alguna, que son actualizadas automáticamente por la fuente de datos - cuando cualquier valor de la fila es actualizado por cualquier transacción. + Cuando el tipo es SQL_ROWVER, + odbc_specialcolumns devuelve la columna o las columnas + de la tabla especificada, si las hay, que se actualizan automáticamente + por los datos de origen cuando cada valor de la fila es modificado + por cualquier transacción. - qualifier + catalog - El cualificador. + &odbc.parameter.catalog; - owner + schema - El propietario. + &odbc.parameter.schema; @@ -80,7 +84,9 @@ scope - El alcance, el cual ordena el conjunto de resultados. + El scope, que ordena el conjunto de resultados. + Uno de SQL_SCOPE_CURROW, SQL_SCOPE_TRANSACTION + o SQL_SCOPE_SESSION. @@ -88,7 +94,9 @@ nullable - La opción nullable. + Determina si las columnas especiales que pueden tener un valor NULL + deben ser devueltas o no. + Uno de SQL_NO_NULLS o SQL_NULLABLE. @@ -99,26 +107,55 @@ &reftitle.returnvalues; - Devuelve un identificador de resultado ODBC o &false; si - se produjo un fallo. + &odbc.result.object-return-falseforfailure; - El conjunto de resultados tiene las siguientes columnas: + El conjunto de resultados contiene las siguientes columnas: - SCOPE - COLUMN_NAME - DATA_TYPE - TYPE_NAME - PRECISION - LENGTH - SCALE - PSEUDO_COLUMN + SCOPE + COLUMN_NAME + DATA_TYPE + TYPE_NAME + COLUMN_SIZE + BUFFER_LENGTH + DECIMAL_DIGITS + PSEUDO_COLUMN + &odbc.result.driver-specific; + + El conjunto de resultados está ordenado por SCOPE. + - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + &odbc.changelog.result-return; + + + + + + &reftitle.seealso; + + + odbc_tables + + + + + - + + + odbc_statistics - Recuperar las estadísticas de un tabla + Cálculo de estadísticas sobre una tabla - + &reftitle.description; - resourceodbc_statistics - resourceconnection_id - stringqualifier - stringowner - stringtable_name + Odbc\Resultfalseodbc_statistics + Odbc\Connectionodbc + stringnullcatalog + stringschema + stringtable intunique intaccuracy - Obteber las estadísticas de una tabla y sus índices. + Cálculo de estadísticas sobre una tabla. @@ -28,29 +30,29 @@ - connection_id + odbc &odbc.connection.id; - qualifier + catalog - El cualificador. + &odbc.parameter.catalog; - owner + schema - El propietario. + &odbc.parameter.schema; - table_name + table El nombre de la tabla. @@ -61,7 +63,8 @@ unique - El atributo unique. + El tipo del índice. + Uno de SQL_INDEX_UNIQUE o SQL_INDEX_ALL. @@ -69,7 +72,10 @@ accuracy - La presición. + Uno de SQL_ENSURE o SQL_QUICK. + Este último solicita al controlador que recupere CARDINALITY + y PAGES solo si están inmediatamente disponibles + desde el servidor. @@ -80,34 +86,101 @@ &reftitle.returnvalues; - Devuelve un identificador de resultado ODBC &return.falseforfailure;. + &odbc.result.object-return-falseforfailure; - El conjunto de resultados tiene las siguientes columnas: + El conjunto de resultados contiene las siguientes columnas: - TABLE_QUALIFIER - TABLE_OWNER - TABLE_NAME - NON_UNIQUE - INDEX_QUALIFIER - INDEX_NAME - TYPE - SEQ_IN_INDEX - COLUMN_NAME - COLLATION - CARDINALITY - PAGES - FILTER_CONDITION + TABLE_CAT + TABLE_SCHEM + TABLE_NAME + NON_UNIQUE + INDEX_QUALIFIER + INDEX_NAME + TYPE + ORDINAL_POSITION + COLUMN_NAME + ASC_OR_DESC + CARDINALITY + PAGES + FILTER_CONDITION + &odbc.result.driver-specific; - El conjunto de resultados está ordenado por NON_UNIQUE, TYPE, INDEX_QUALIFIER, - INDEX_NAME y SEQ_IN_INDEX. + El conjunto de resultados está ordenado por NON_UNIQUE, TYPE, INDEX_QUALIFIER, + INDEX_NAME y ORDINAL_POSITION. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + &odbc.changelog.result-return; + + + + + + + &reftitle.examples; + + Lista las estadísticas de una tabla + + +]]> + + &example.outputs.similar; + + TutorialDB + [TABLE_SCHEM] => dbo + [TABLE_NAME] => TEST + [NON_UNIQUE] => + [INDEX_QUALIFIER] => + [INDEX_NAME] => + [TYPE] => 0 + [ORDINAL_POSITION] => + [COLUMN_NAME] => + [ASC_OR_DESC] => + [CARDINALITY] => 15 + [PAGES] => 3 + [FILTER_CONDITION] => +) +]]> + + + + + &reftitle.seealso; + + + odbc_tables + + + + + - + + + odbc_tableprivileges - Lista las tablas y los privilegios asociados con cada tabla + Lista las tablas y sus privilegios - + &reftitle.description; - resourceodbc_tableprivileges - resourceconnection_id - stringqualifier - stringowner - stringname + Odbc\Resultfalseodbc_tableprivileges + Odbc\Connectionodbc + stringnullcatalog + stringschema + stringtable - Lista las tablas en el rango solicitado y los privilegios asociados - con cada tabla. + Lista las tablas y sus privilegios. @@ -27,34 +28,34 @@ - connection_id + odbc &odbc.connection.id; - qualifier + catalog - El cualificador. + &odbc.parameter.catalog; - owner + schema - El propietario. Acepta los siguientes patrones de búsqueda: - ('%' para comparar cero o más caracteres y '_' para comparar un único carácter) + &odbc.parameter.schema; + &odbc.parameter.search; - name + table - EL nombre. Acepta los siguientes patrones de búsqueda: - ('%' para comparar cero o más caracteres y '_' para comparar un único carácter) + El nombre. + &odbc.parameter.search; @@ -65,28 +66,89 @@ &reftitle.returnvalues; - Un identificador de resultado ODBC &return.falseforfailure;. + &odbc.result.object-return-falseforfailure; - El conjunto de resultados tiene las siguientes columnas: + El conjunto de resultados contiene las siguientes columnas: - TABLE_QUALIFIER - TABLE_OWNER - TABLE_NAME - GRANTOR - GRANTEE - PRIVILEGE - IS_GRANTABLE + TABLE_CAT + TABLE_SCHEM + TABLE_NAME + GRANTOR + GRANTEE + PRIVILEGE + IS_GRANTABLE + &odbc.result.driver-specific; - El conjunto de resultados está ordenado por TABLE_QUALIFIER, TABLE_OWNER y - TABLE_NAME. + El conjunto de resultados está ordenado por TABLE_CAT, TABLE_SCHEM, + TABLE_NAME, PRIVILEGE y GRANTEE. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + &odbc.changelog.result-return; + + + + + + + &reftitle.examples; + + Lista los Privilegios de una Tabla + + +]]> + + &example.outputs.similar; + + SalesOrders + [TABLE_SCHEM] => dbo + [TABLE_NAME] => Orders + [GRANTOR] => dbo + [GRANTEE] => dbo + [PRIVILEGE] => DELETE + [IS_GRANTABLE] => YES +) +]]> + + + + + &reftitle.seealso; + + + odbc_tables + + + + + - + + odbc_tables - Obtener la lista de los nombres de las tablas almacenados en una fuente de datos específica + Lista las tablas de una fuente - + &reftitle.description; - resourceodbc_tables - resourceconnection_id - stringqualifier - stringowner - stringname - stringtypes + Odbc\Resultfalseodbc_tables + Odbc\Connectionodbc + stringnullcatalog&null; + stringnullschema&null; + stringnulltable&null; + stringnulltypes&null; - Lista todas las tablas del rango solicitado. + Lista las tablas de una fuente. - Para soportar la enumeración de cualificadores, propietarios y tipos de tabla, - están disponibles las siguientes semánticas especiales para - qualifier, owner, - name, y - table_type: + Para soportar las enumeraciones de calificadores + propietarios y tipos de tabla, la siguiente + semántica para los parámetros + catalog, schema, + table y + table_type está disponible: - Si qualifier es un único carácter de - porcentaje (%) y owner y - name son cadenas vacías, el conjunto de - resultados contendrá una lista de cualificadores válidos para la fuente de - datos. (Todas las columnas excepto la columna TABLE_QUALIFIER contienen - NULLs.) + Si catalog es un signo de porcentaje (%), y + schema y table son + strings vacíos, entonces el resultado contiene la lista de + calificadores válidos para la fuente (todas las columnas excepto + TABLE_QUALIFIER contienen NULL). - Si owner es un único carácter de porcentaje - (%) y qualifier y - name son cadenas vacías, el conjunto de - resultados contendrá una lista de propietarios válidos para la fuente de datos. (Todas - las columnas excepto la columna TABLE_OWNER contienen - NULLs.) + Si schema es un signo de porcentaje (%), y + catalog y table + son strings vacíos, entonces el resultado contiene la lista de + propietarios de la fuente (todas las columnas excepto + TABLE_OWNER contienen NULL). - Si table_type es un único carácter de - porcentaje (%) y qualifier, - owner y name - son cadenas vacías, el conjunto de resultados contendrá una lista de - tipos de tablas válidos para la fuente de datos. (Todas las columnas excepto la - conlumna TABLE_TYPE contienen NULLs.) + Si table_type es un signo de porcentaje (%), y + catalog, schema y + table son strings vacíos, entonces el resultado + contiene la lista de tipos de tablas de la fuente (todas las columnas excepto + TABLE_TYPE contienen NULL). - + &reftitle.parameters; - connection_id + odbc &odbc.connection.id; - qualifier + catalog - El cualificador. + &odbc.parameter.catalog; - owner + schema - El propietario. Acepta patrones de búsqueda ('%' para comparar cero o más - caracteres y '_' para comparar un único carácter). + &odbc.parameter.schema; + &odbc.parameter.search; - name + table - El nombre. Acepta patrones de búsqueda ('%' para comparar cero o más - caracteres y '_' para comparar un único carácter). + El nombre. + &odbc.parameter.search; @@ -101,53 +100,114 @@ types - Si table_type no es una cadena vacía - debe contener una lista de valores serparados por comas para los tipos que - son de interés; cada valor puede ser encerrado en comillas simples (') o - sin comillas. Por ejemplo, "'TABLE','VIEW'" o "TABLE, VIEW". Si la - fuente de datos no soporta un tipo de tabla especificado, - odbc_tables no devolverá ningún resultado para - ese tipo. + Si table_type no es un string vacío, + debe contener una lista de valores, separados por comas, + que representan los tipos buscados. Cada valor puede estar + entre comillas simples ('), o sin comillas. Por + ejemplo, 'TABLE','VIEW' o TABLE, VIEW. Si la fuente de datos + no soporta un tipo de tabla dado, odbc_tables + no devolverá ningún resultado para ese tipo. - + &reftitle.returnvalues; - Devuelve un identificador de resultado ODBC que contiene la información + &odbc.result.object-return; que contiene las informaciones &return.falseforfailure;. - El conjunto de resultados tiene las siguientes columnas: + El conjunto de resultados contiene las siguientes columnas: - TABLE_QUALIFIER - TABLE_OWNER - TABLE_NAME - TABLE_TYPE - REMARKS + TABLE_CAT + TABLE_SCHEM + TABLE_NAME + TABLE_TYPE + REMARKS + &odbc.result.driver-specific; - El conjunto de resultados está ordenado por TABLE_TYPE, TABLE_QUALIFIER, - TABLE_OWNER y TABLE_NAME. + El conjunto de resultados está ordenado por TABLE_TYPE, TABLE_CAT, + TABLE_SCHEM y TABLE_NAME. - + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &odbc.changelog.connection-param; + &odbc.changelog.result-return; + + 8.0.0 + + schema, table y types + ahora son anulables. + + + + + + + + + &reftitle.examples; + + Lista las Tablas en un Catálogo + + +]]> + + &example.outputs.similar; + + SalesOrders + [TABLE_SCHEM] => dbo + [TABLE_NAME] => Orders + [TABLE_TYPE] => TABLE + [REMARKS] => +) +]]> + + + + &reftitle.seealso; odbc_tableprivileges + odbc_columns + odbc_specialcolumns + odbc_statistics + odbc_procedures - - +