Funciones de Microsoft SQL Server

1). mssql_close:
mssql_close -- cierra una conexin con MS SQL Server
Descripcin
int mssql_close (int link_identifier)
Devuleve: TRUE si se finaliza con xito, FALSE si se produce un error
mssql_close() cierra la conexin con una base de datos MS SQL Server que est asociada
al identificador especificado. Si el identificador no se especifica, se asume la ltima
conexin abierta.
Observe que normalmente esto no es necesario, ya que las conexiones no-persistentes
abiertas se cierran automaticamente en cuanto finaliza el script.
mssql_close() no cerrar conexiones persistentes generadas por mssql_pconnect().

2). mssql_connect:
mssql_connect -- abre una conexin con MS SQL server
Descripcin
int mssql_connect (string servername, string username, string password)
Devuelve: Un identificador de MSSQL si se ejecuta correctamente, o FALSE si se
produce un error.
mssql_connect() establece una conexin con MS SQL server. El argumento servername
debe ser un nombre de servidor vlido, que est definido en el fichero 'interfaces'.
En caso de hacer una segunda llamada a mssql_connect() con los mismos argumentos, no
se establecer una nueva conexin, sino que se devolver el identificador de la conexin
establecida anteriormente.

La conexin con el servidor se cerrar tan pronto como finalice el script, a menos que se
cierre antes, mediante una llamada explicita a la funcin mssql_close().

3). mssql_data_seek:
mssql_data_seek -- mueve el puntero interno de las filas
Descripcin
int mssql_data_seek (int result_identifier, int row_number)
Devuelve: TRUE si se ejecuta con xito, FALSE si falla.
mssql_data_seek() mueve el puntero interno de la consulta MS SQL asociada al
result_identifier especificado, para que apunte al nmero de fila especificada. La siguiente
llamada a mssql_fetch_row() devolver esa fila.

4). mssql_fetch_array:
mssql_fetch_array -- Captura la fila en un array
Descripcin
int mssql_fetch_array (int result)
Devuelve: Un array que corresponde a la fila capturada, o FALSE si no hay ms filas.
mssql_fetch_array() es una versin extendida de mssql_fetch_row(). Aade el almacenar
los datos en los ndices numricos del array resultante, tambin almacena los datos en
ndices asociativos, usando los nombres de los campos como claves.
Una observacin a tener en cuenta es, que usar mssql_fetch_array() NO es ms lento que
usar mssql_fetch_row(), mientras que esta provee un valor aadido significativo.

5). mssql_fetch_field:
mssql_fetch_field -- obtiene la informacin de los campos

Descripcin
object mssql_fetch_field (int result, int field_offset)
Devuleve un objeto que contiene informacin de los campos.
mssql_fetch_field() se puede usar para obtener informacin acerca de los campos
pertenecientes al resultado de una consulta. Si el parmetro field_offset no es
especificado, se devuelve la informacin del siguiente campo que todava no ha sido
devuelto por mssql_fetch_field().
Las propiedades de este objeto son:

name - nombre de la columna. si la columna es el resultado de una funcin, esta

propiedad vale #N, donde #N es un nmero de serie.

column_source - la tabla de donde se tom la columna

max_length - longitud mxima de columna

numeric - 1 si la columna es numrica

6). mssql_fetch_object:
mssql_fetch_object -- captura la fila como un objeto
Descripcin
int mssql_fetch_object (int result)
Devuelve: Un objeto con propiedades que se corresponden con la fila capturada, o
FALSE si no hay ms filas.
mssql_fetch_object() es parecida a mssql_fetch_array(), con una diferencia - devuelve un
objeto en vez de un array. Indirectamente, esto significa que slo se puede acceder a los
datos por el nombre de los campos, y no por sus posiciones en el objeto (los nmeros no
son nombres de propiedades vlidas).

La funcin es idntica a mssql_fetch_array(), y casi tan rpida como mssql_fetch_row()

(la diferencia es insignificante).

7).mssql_fetch_row:
mssql_fetch_row -- obtiene la fila como un array numerado
Descripcin
array mssql_fetch_row (int result)
Devuleve: Un array que corresponde a la fila capturada, o FALSE si no hay ms filas.
mssql_fetch_row() captura una fila de datos pertenecientes al resultado asociado con el
identificador de resultado especificado. La fila es devuelta como un array. Cada columna
de resultados es almacenada en una posicin del array, comenzando en la posicin 0.
Siguientes llamadas a mssql_fetch_rows() devolveran las filas siguientes del result set, o
FALSE si no hay mas filas.

8).mssql_field_seek:
mssql_field_seek -- set field offset
Descripcin
int mssql_field_seek (int result, int field_offset)
Se posiciona en el campo especificado por el parmetro field_offset. Si la siguiente
llamada a mssql_fetch_field() no incluye el parmetro field_offset, lo que devuelve la
funcin es el campo.

9).mssql_free_result:
mssql_free_result -- libera de la memoria el resultado de una consulta
Descripcin
int mssql_free_result (int result)

mssql_free_result() slo se necesita llamarla si le preocupa el estar usando mucha

memoria mientras se est ejecutando el script. Toda el resultado en memoria ser liberado
automaticamente cuando finalice el script, puede llamar a mssql_free_result() con el
identificador de la consulta como argumento y la consulta asociada ser liberada de la
memoria.

10). mssql_num_fields:
mssql_num_fields -- obtiene el nmero de campos de la consulta
Descripcin
int mssql_num_fields (int result)
mssql_num_fields() devuelve el nmero de campos de la consulta o result set.

11).mssql_num_rows:
mssql_num_rows -- obtiene el nmero de filas de la consulta
Descripcin
int mssql_num_rows (string result)
mssql_num_rows() devuelve el nmero de filas de la consulta o result set.

12).mssql_query:
mssql_query -- envia una consulta MS SQL
Descripcin
int mssql_query (string query, int link_identifier)
Devuelve: Un identificado de resultado valido si no hay error, o FALSE en caso contrario.
mssql_query() envia una peticin de consulta a la base de datos activa en el servidor
asociada al identificador de enlace especificado. Si el identificador del enlace no es
especificado, se asume como abierto el ltimo enlace. Si no hay ningn enlace abierto, la

funcin intenta establecer un enlace como si mssql_connect() hubiera sido llamada, y lo

usa.

13).mssql_pconnect:
mssql_pconnect -- abre una conexin persistenete con MS SQL
Descripcin
int mssql_pconnect (string servername, string username, string password)
Devuelve: Un identificador persistente postivo si no hay error, o FALSE si se produce
alguno
mssql_pconnect() funciona de la misma forma que mssql_connect() aunque con dos
grandes diferencias.
La primera es que cuando intenta conectar, la funcin intentar encontrar un enlace
(persistente) que ya est abierto en el mismo ordenador, nombre de usuario y contrasea.
Si lo encuentra, la funcion devolver el identificador de esta en vez de abrir una nueva
conexin.
Y la segunda, la conexin con el servidor no se cerrar cuando finalice la ejecucin del
script. En vez de esto, el enlace permanecer abierto para un uso futuro. (mssql_close() no
cerrar enlaces establecidos por mssql_pconnect()).
Por consiguiente, este tipo de enlace es llamado 'persistente'.

14).mssql_result:
mssql_result -- get result data
Descripcin
int mssql_result (int result, int i, mixed field)
Devuelve: El contenido de la celda en la fila y posicin del result set especificado.

mssql_result() devuelve el contenido de una celda del result set. El parametro field puede
ser la posicin del campo, o el nombre del campo o bin nombretabla.nombrecampo. Si el
nombre de la columna ha sido renombrado ('select foo as bar from...'), use el alias en vez
del nombre de la columna.
Trabajando con result sets de gran tamao, debera considerar el uso de una de las
funciones que capturan una fila completa (especificadas abajo). Como estas funciones
devuelven el contenido de mltiples celdas en una sla llamada, estas son MUCHO ms
rpidas que mssql_result(). Tambin, observe que especificar una posicin nmerica para
el argumento field es mucho mas rpido que especificar el nombre de un campo o utilizar
la forma nombretabla.nombrecampo como argumento.

15).mssql_select_db:
mssql_select_db -- selecciona una base de datos MS SQL
Descripcin
int mssql_select_db (string database_name, int link_identifier)
Devuelve: TRUE si todo va bin, FALSE si se produce un error
mssql_select_db() selecciona como base de datos activa del servidor, la que est asociada
al identificador de enlace especificado. Si no se especifica nign identificador, se asume el
ltimo enlace. Si no hay ningn enlace abierto, la funcin intentar establecer un enlace
como si se llamara a la funcin mssql_connect(), y lo usa.
Cada llamada a mssql_query() ser realizada sobre la base de datos activa.