mirror of
https://github.com/sigmasternchen/php-doc-en
synced 2025-03-15 16:38:54 +00:00
ec1ea24811
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@9477 c90b9560-bf6c-de11-be94-00142212c4b1
511 lines
18 KiB
Text
511 lines
18 KiB
Text
|
|
<reference id="ref.mssql">
|
|
<title>MS SQL Server Functions</title>
|
|
<titleabbrev>MS SQL Server</titleabbrev>
|
|
|
|
<refentry id="function.mssql-affected-rows">
|
|
<refnamediv>
|
|
<refname>mssql_affected_rows</refname>
|
|
<refpurpose>get number of affected rows in last query</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_affected_rows</function></funcdef>
|
|
<paramdef>int <parameter><optional>link_identifier</optional>
|
|
</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para>
|
|
Returns: The number of affected rows by the last query.
|
|
<para>
|
|
<function>mssql_affected_rows</function> returns the number of
|
|
rows affected by the last INSERT, UPDATE or DELETE query on the
|
|
server associated with the specified link identifier. If the
|
|
link identifier isn't specified, the last opened link is assumed.
|
|
<para>
|
|
This command is not effective for SELECT statements, only on
|
|
statements which modify records. To retrieve the number of rows
|
|
returned from a SELECT, use <function>mssql_num_rows</function>.
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-close">
|
|
<refnamediv>
|
|
<refname>mssql_close</refname>
|
|
<refpurpose>close MS SQL Server connection</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_close</function></funcdef>
|
|
<paramdef>int <parameter>link_identifier</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para>Returns: true on success, false on error
|
|
</para>
|
|
<para> mssql_close() closes the link to a MS SQL Server database that's
|
|
associated with the specified link identifier. If the link
|
|
identifier isn't specified, the last opened link is assumed.
|
|
</para>
|
|
<para> Note that this isn't usually necessary, as non-persistent
|
|
open links are automatically closed at the end of the script's
|
|
execution.
|
|
</para>
|
|
<para> mssql_close() will not close persistent links generated by
|
|
mssql_pconnect().
|
|
</para>
|
|
<para> See also: <function>mssql_connect</function>,
|
|
<function>mssql_pconnect</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-connect">
|
|
<refnamediv>
|
|
<refname>mssql_connect</refname>
|
|
<refpurpose>open MS SQL server connection</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_connect</function></funcdef>
|
|
<paramdef>string <parameter>servername</parameter></paramdef>
|
|
<paramdef>string <parameter>username</parameter></paramdef>
|
|
<paramdef>string <parameter>password</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para> Returns: A positive MS SQL link identifier on success, or
|
|
false on error.
|
|
</para>
|
|
<para> mssql_connect() establishes a connection to a MS SQL server.
|
|
The servername argument has to be a valid servername that is defined
|
|
in the 'interfaces' file.
|
|
</para>
|
|
<para> In case a second call is made to mssql_connect() with the
|
|
same arguments, no new link will be established, but instead, the
|
|
link identifier of the already opened link will be returned.
|
|
</para>
|
|
<para> The link to the server will be closed as soon as the
|
|
execution of the script ends, unless it's closed earlier by
|
|
explicitly calling <function>mssql_close</function>.
|
|
</para>
|
|
<para>See also <function>mssql_pconnect</function>,
|
|
<function>mssql_close</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-data-seek">
|
|
<refnamediv>
|
|
<refname>mssql_data_seek</refname>
|
|
<refpurpose>move internal row pointer</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_data_seek</function></funcdef>
|
|
<paramdef>int <parameter>result_identifier</parameter></paramdef>
|
|
<paramdef>int <parameter>row_number</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para> Returns: true on success, false on failure
|
|
</para>
|
|
<para> mssql_data_seek() moves the internal row pointer of the
|
|
MS SQL result associated with the specified result identifier to
|
|
pointer to the specifyed row number. The next call to
|
|
<function>mssql_fetch_row</function> would return that row.
|
|
</para>
|
|
<para> See also: <function>mssql_data_seek</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-fetch-array">
|
|
<refnamediv>
|
|
<refname>mssql_fetch_array</refname>
|
|
<refpurpose>fetch row as array</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_fetch_array</function></funcdef>
|
|
<paramdef>int <parameter>result</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para> Returns: An array that corresponds to the fetched row, or
|
|
false if there are no more rows.
|
|
</para>
|
|
<para>
|
|
mssql_fetch_array() is an extended version of
|
|
<function>mssql_fetch_row</function>. In addition to storing the
|
|
data in the numeric indices of the result array, it also stores
|
|
the data in associative indices, using the field names as keys.
|
|
</para>
|
|
<para>
|
|
An important thing to note is that using mssql_fetch_array() is
|
|
NOT significantly slower than using mssql_fetch_row(), while it
|
|
provides a significant added value.
|
|
<para>
|
|
For further details, also see
|
|
<function>mssql_fetch_row</function>
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-fetch-field">
|
|
<refnamediv>
|
|
<refname>mssql_fetch_field</refname>
|
|
<refpurpose>get field information</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>object <function>mssql_fetch_field</function></funcdef>
|
|
<paramdef>int <parameter>result</parameter></paramdef>
|
|
<paramdef>int <parameter>field_offset</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para>
|
|
Returns an object containing field information.
|
|
</para>
|
|
<para>
|
|
mssql_fetch_field() can be used in order to obtain information about
|
|
fields in a certain query result. If the field offset isn't
|
|
specified, the next field that wasn't yet retreived by
|
|
mssql_fetch_field() is retreived.
|
|
</para>
|
|
<para>
|
|
The properties of the object are:
|
|
</para>
|
|
|
|
<itemizedlist>
|
|
<listitem><simpara>
|
|
name - column name. if the column is a result of a function, this property is set to computed#N,
|
|
where #N is a serial number.
|
|
</simpara></listitem>
|
|
<listitem><simpara>
|
|
column_source - the table from which the column was taken
|
|
</simpara></listitem>
|
|
<listitem><simpara>
|
|
max_length - maximum length of the column
|
|
</simpara></listitem>
|
|
<listitem><simpara>
|
|
numeric - 1 if the column is numeric
|
|
</simpara></listitem>
|
|
</itemizedlist>
|
|
|
|
<para>
|
|
See also <function>mssql_field_seek</function>
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-fetch-object">
|
|
<refnamediv>
|
|
<refname>mssql_fetch_object</refname>
|
|
<refpurpose>fetch row as object</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_fetch_object</function></funcdef>
|
|
<paramdef>int <parameter>result</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para> Returns: An object with properties that correspond to the
|
|
fetched row, or false if there are no more rows.
|
|
</para>
|
|
<para> mssql_fetch_object() is similar to
|
|
<function>mssql_fetch_array</function>, with one difference - an
|
|
object is returned, instead of an array. Indirectly, that means
|
|
that you can only access the data by the field names, and not by
|
|
their offsets (numbers are illegal property names).
|
|
<para>
|
|
Speed-wise, the function is identical to
|
|
<function>mssql_fetch_array</function>, and almost as quick as
|
|
<function>mssql_fetch_row</function> (the difference is
|
|
insignificant).
|
|
</para>
|
|
<para> See also: <function>mssql_fetch-array</function> and
|
|
<function>mssql_fetch-row</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-fetch-row">
|
|
<refnamediv>
|
|
<refname>mssql_fetch_row</refname>
|
|
<refpurpose>get row as enumerated array</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>array <function>mssql_fetch_row</function></funcdef>
|
|
<paramdef>int <parameter>result</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para> Returns: An array that corresponds to the fetched row, or
|
|
false if there are no more rows.
|
|
</para>
|
|
<para>
|
|
mssql_fetch_row() fetches one row of data from the result
|
|
associated with the specified result identifier. The row is
|
|
returned as an array. Each result column is stored in an array
|
|
offset, starting at offset 0.
|
|
</para>
|
|
<para>
|
|
Subsequent call to mssql_fetch_rows() would return the next row
|
|
in the result set, or false if there are no more rows.
|
|
</para>
|
|
<para>
|
|
See also: <function>mssql_fetch_array</function>,
|
|
<function>mssql_fetch_object</function>,
|
|
<function>mssql_data_seek</function>,
|
|
<function>mssql_fetch_lengths</function>, and
|
|
<function>mssql_result</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-field-seek">
|
|
<refnamediv>
|
|
<refname>mssql_field_seek</refname>
|
|
<refpurpose>set field offset</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_field_seek</function></funcdef>
|
|
<paramdef>int <parameter>result</parameter></paramdef>
|
|
<paramdef>int <parameter>field_offset</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para>
|
|
Seeks to the specified field offset. If the next call to
|
|
<function>mssql_fetch_field</function> won't include a field
|
|
offset, this field would be returned.
|
|
<para>
|
|
<para>
|
|
See also: <function>mssql_fetch_field</function>.
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-free-result">
|
|
<refnamediv>
|
|
<refname>mssql_free_result</refname>
|
|
<refpurpose>free result memory</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_free_result</function></funcdef>
|
|
<paramdef>int <parameter>result</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para>
|
|
<function>mssql_free_result</function> only needs to be called
|
|
if you are worried about using too much memory while your script
|
|
is running. All result memory will automatically be freed when
|
|
the script, you may call <function>mssql_free_result</function>
|
|
with the result identifier as an argument and the associated
|
|
result memory will be freed.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-num-fields">
|
|
<refnamediv>
|
|
<refname>mssql_num_fields</refname>
|
|
<refpurpose>get number of fields in result</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_num_fields</function></funcdef>
|
|
<paramdef>int <parameter>result</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para> mssql_num_fields() returns the number of fields in a result
|
|
set.
|
|
</para>
|
|
<para>
|
|
See also:
|
|
<function>mssql_db_query</function>,
|
|
<function>mssql_query</function>,
|
|
<function>mssql_fetch_field</function>,
|
|
<function>mssql_num_rows</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-num-rows">
|
|
<refnamediv>
|
|
<refname>mssql_num_rows</refname>
|
|
<refpurpose>get number of rows in result</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_num_rows</function></funcdef>
|
|
<paramdef>string <parameter>result</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para>
|
|
mssql_num_rows() returns the number of rows in a result set.
|
|
</para>
|
|
<para>
|
|
See also:
|
|
<function>mssql_db_query</function>,
|
|
<function>mssql_query</function> and,
|
|
<function>mssql_fetch_row</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-pconnect">
|
|
<refnamediv>
|
|
<refname>mssql_pconnect</refname>
|
|
<refpurpose>open persistent MS SQL connection</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_pconnect</function></funcdef>
|
|
<paramdef>string <parameter>servername</parameter></paramdef>
|
|
<paramdef>string <parameter>username</parameter></paramdef>
|
|
<paramdef>string <parameter>password</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para>
|
|
Returns: A positive MS SQL persistent link identifier on success,
|
|
or false on error
|
|
<para>
|
|
mssql_pconnect() acts very much like
|
|
<function>mssql_connect</function> with two major differences.
|
|
<para>
|
|
First, when connecting, the function would first try to find a
|
|
(persistent) link that's already open with the same host,
|
|
username and password. If one is found, an identifier for it
|
|
will be returned instead of opening a new connection.
|
|
<para>
|
|
Second, the connection to the SQL server will not be closed when
|
|
the execution of the script ends. Instead, the link will remain
|
|
open for future use (<function>mssql_close</function> will not
|
|
close links established by <literal>mssql_pconnect()</literal>).
|
|
<para>
|
|
This type of links is therefore called 'persistent'.
|
|
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-query">
|
|
<refnamediv>
|
|
<refname>mssql_query</refname>
|
|
<refpurpose>send MS SQL query</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_query</function></funcdef>
|
|
<paramdef>string <parameter>query</parameter></paramdef>
|
|
<paramdef>int <parameter>link_identifier</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para> Returns: A positive MS SQL result identifier on success, or
|
|
false on error.
|
|
</para>
|
|
<para> mssql_query() sends a query to the currently active
|
|
database on the server that's associated with the specified link
|
|
identifier. If the link identifier isn't specified, the last
|
|
opened link is assumed. If no link is open, the function tries to
|
|
establish a link as if <function>mssql_connect</function> was
|
|
called, and use it.
|
|
</para>
|
|
<para>
|
|
See also:
|
|
<function>mssql_db_query</function>,
|
|
<function>mssql_select_db</function>, and
|
|
<function>mssql_connect</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-result">
|
|
<refnamediv>
|
|
<refname>mssql_result</refname>
|
|
<refpurpose>get result data</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_result</function></funcdef>
|
|
<paramdef>int <parameter>result</parameter></paramdef>
|
|
<paramdef>int <parameter>i</parameter></paramdef>
|
|
<paramdef>mixed <parameter>field</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para> Returns: The contents of the cell at the row and offset in
|
|
the specified MS SQL result set.
|
|
</para>
|
|
<para>
|
|
mssql_result() returns the contents of one cell from a MS SQL
|
|
result set. The field argument can be the field's offset, or the
|
|
field's name, or the field's table dot field's name
|
|
(fieldname.tablename). If the column name has been aliased
|
|
('select foo as bar from...'), use the alias instead of the
|
|
column name.
|
|
</para>
|
|
<para>
|
|
When working on large result sets, you should consider using one
|
|
of the functions that fetch an entire row (specified below). As
|
|
these functions return the contents of multiple cells in one
|
|
function call, they're MUCH quicker than mssql_result(). Also,
|
|
note that specifying a numeric offset for the field argument is
|
|
much quicker than specifying a fieldname or tablename.fieldname
|
|
argument.
|
|
</para>
|
|
<para>
|
|
Recommended high-performance alternatives:
|
|
<function>mssql_fetch_row</function>,
|
|
<function>mssql_fetch_array</function>, and
|
|
<function>mssql_fetch_object</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.mssql-select-db">
|
|
<refnamediv>
|
|
<refname>mssql_select_db</refname>
|
|
<refpurpose>select MS SQL database</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>mssql_select_db</function></funcdef>
|
|
<paramdef>string <parameter>database_name</parameter></paramdef>
|
|
<paramdef>int <parameter>link_identifier</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para> Returns: true on success, false on error
|
|
</para>
|
|
<para> mssql_select_db() sets the current active database on the
|
|
server that's associated with the specified link identifier. If
|
|
no link identifier is specified, the last opened link is assumed.
|
|
If no link is open, the function will try to establish a link as
|
|
if <function>mssql_connect</function> was called, and use it.
|
|
</para>
|
|
<para>
|
|
Every subsequent call to <function>mssql_query</function> will be
|
|
made on the active database.
|
|
</para>
|
|
<para> See also:
|
|
<function>mssql_connect</function>,
|
|
<function>mssql_pconnect</function>, and
|
|
<function>mssql_query</function>
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"../manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
-->
|