[PHP-DOC] cvs: phpdoc /it/functions mssql.xml From: Luca Perugini (l.perugini <email protected>)
Date: 07/30/00

perugini Sun Jul 30 16:08:48 2000 EDT

  Modified files:
    /phpdoc/it/functions mssql.xml
  Log:
  Translated by "Darvin Andrioli" <darvin.andrioli <email protected>>
  
  
Index: phpdoc/it/functions/mssql.xml
diff -u phpdoc/it/functions/mssql.xml:1.4 phpdoc/it/functions/mssql.xml:1.5
--- phpdoc/it/functions/mssql.xml:1.4 Sun Jul 30 16:05:39 2000
+++ phpdoc/it/functions/mssql.xml Sun Jul 30 16:08:48 2000
@@ -1,682 +1,694 @@
- <reference id="ref.mssql">
- <title>Microsoft SQL Server functions</title>
- <titleabbrev>MS SQL Server</titleabbrev>
-
- <refentry id="function.mssql-close">
- <refnamediv>
- <refname>mssql_close</refname>
- <refpurpose>Close MS SQL Server connection</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>mssql_close</function></funcdef>
- <paramdef>int
- <parameter><optional>link_identifier</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns: true on success, false on error.
- </para>
- <para>
- <function>Mssql_close</function> 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>
- <function>Mssql_close</function> will not close persistent links
- generated by <function>mssql_pconnect</function>.
- </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>
- <funcprototype>
- <funcdef>int <function>mssql_connect</function></funcdef>
- <paramdef>string
- <parameter><optional>servername</optional></parameter>
- </paramdef>
- <paramdef>string
- <parameter><optional>username</optional></parameter>
- </paramdef>
- <paramdef>string
- <parameter><optional>password</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns: A positive MS SQL link identifier on success, or false
- on error.
- </para>
- <para>
- <function>Mssql_connect</function> 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
- <function>mssql_connect</function> 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>
- <funcprototype>
- <funcdef>int <function>mssql_data_seek</function></funcdef>
- <paramdef>int <parameter>result_identifier</parameter></paramdef>
- <paramdef>int <parameter>row_number</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns: true on success, false on failure.
- </para>
- <para>
- <function>Mssql_data_seek</function> moves the internal row
- pointer of the MS SQL result associated with the specified result
- identifier to point to the specified 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>
- <funcprototype>
- <funcdef>int <function>mssql_fetch_array</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns: An array that corresponds to the fetched row, or false
- if there are no more rows.
- </para>
- <para>
- <function>Mssql_fetch_array</function> 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
- <function>mssql_fetch_array</function> is NOT significantly
- slower than using <function>mssql_fetch_row</function>, while it
- provides a significant added value.
- </para>
- <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>
- <funcprototype>
- <funcdef>object <function>mssql_fetch_field</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
- <paramdef>int
- <parameter><optional>field_offset</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns an object containing field information.
- </para>
- <para>
- <function>Mssql_fetch_field</function> 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
- retrieved by <function>mssql_fetch_field</function> is retrieved.
- </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>
- <funcprototype>
- <funcdef>int <function>mssql_fetch_object</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns: An object with properties that correspond to the fetched
- row, or false if there are no more rows.
- </para>
- <para>
- <function>Mssql_fetch_object</function> 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>
- <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>
- <funcprototype>
- <funcdef>array <function>mssql_fetch_row</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns: An array that corresponds to the fetched row, or false
- if there are no more rows.
- </para>
- <para>
- <function>Mssql_fetch_row</function> 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 <function>mssql_fetch_rows</function> 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-length">
- <refnamediv>
- <refname>mssql_field_length</refname>
- <refpurpose>Get the length of a field</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>mssql_field_length</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
- <paramdef>int
- <parameter><optional>offset</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsect1>
- </refentry>
-
- <refentry id="function.mssql-field-name">
- <refnamediv>
- <refname>mssql_field_name</refname>
- <refpurpose>Get the name of a field</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>mssql_field_name</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
- <paramdef>int
- <parameter><optional>offset</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- </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>
- <funcprototype>
- <funcdef>int <function>mssql_field_seek</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
- <paramdef>int <parameter>field_offset</parameter></paramdef>
- </funcprototype>
- </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></para>
- <para>
- See also: <function>mssql_fetch_field</function>.</para>
- </refsect1>
- </refentry>
-
- <refentry id="function.mssql-field-type">
- <refnamediv>
- <refname>mssql_field_type</refname>
- <refpurpose>Get the type of a field</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>mssql_field_type</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
- <paramdef>int
- <parameter><optional>offset</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- </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>
- <funcprototype>
- <funcdef>int <function>mssql_free_result</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
- </funcprototype>
- </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 ends. 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-get-last-message">
- <refnamediv>
- <refname>mssql_get_last_message</refname>
- <refpurpose>
- Returns the last message from server (over
- min_message_severity?)
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string
- <function>mssql_get_last_message</function>
- </funcdef>
- <paramdef>void <parameter></parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsect1>
- </refentry>
-
- <refentry id="function.mssql-min-error-severity">
- <refnamediv>
- <refname>mssql_min_error_severity</refname>
- <refpurpose>Sets the lower error severity</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void
- <function>mssql_min_error_severity</function>
- </funcdef>
- <paramdef>int <parameter>severity</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsect1>
- </refentry>
-
- <refentry id="function.mssql-min-message-severity">
- <refnamediv>
- <refname>mssql_min_message_severity</refname>
- <refpurpose>Sets the lower message severity</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void
- <function>mssql_min_message_severity</function>
- </funcdef>
- <paramdef>int <parameter>severity</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- </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>
- <funcprototype>
- <funcdef>int <function>mssql_num_fields</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>Mssql_num_fields</function> 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>, and
- <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>
- <funcprototype>
- <funcdef>int <function>mssql_num_rows</function></funcdef>
- <paramdef>string <parameter>result</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>Mssql_num_rows</function> 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>
- <funcprototype>
- <funcdef>int <function>mssql_pconnect</function></funcdef>
- <paramdef>string
- <parameter><optional>servername</optional></parameter>
- </paramdef>
- <paramdef>string
- <parameter><optional>username</optional></parameter>
- </paramdef>
- <paramdef>string
- <parameter><optional>password</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns: A positive MS SQL persistent link identifier on success,
- or false on error.
- </para>
- <para>
- <function>Mssql_pconnect</function> acts very much like
- <function>mssql_connect</function> with two major differences.
- </para>
- <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>
- <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 <function>mssql_pconnect</function>).
- </para>
- <para>
- This type of links is therefore called 'persistent'.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.mssql-query">
- <refnamediv>
- <refname>mssql_query</refname>
- <refpurpose>Send MS SQL query</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>mssql_query</function></funcdef>
- <paramdef>string <parameter>query</parameter></paramdef>
- <paramdef>int
- <parameter><optional>link_identifier</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns: A positive MS SQL result identifier on success, or false
- on error.
- </para>
- <para>
- <function>Mssql_query</function> 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>
- <funcprototype>
- <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>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>Mssql_result</function> returns the contents of one
- cell from a MS SQL result set. The field argument can be the
- field's offset, the field's name or the field's table dot
- field's name (tablename.fieldname). If the column name has been
- aliased ('select foo as bar from...'), it uses 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
- <function>mssql_result</function>. 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>
- <funcprototype>
- <funcdef>int <function>mssql_select_db</function></funcdef>
- <paramdef>string <parameter>database_name</parameter></paramdef>
- <paramdef>int
- <parameter><optional>link_identifier</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para> Returns: true on success, false on error
- </para>
- <para>
- <function>Mssql_select_db</function> 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>
-
-</reference>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
--->
+ <reference id="ref.mssql">
+ <title>Funzioni per Microsoft SQL Server</title>
+ <titleabbrev>MS SQL Server</titleabbrev>
+
+ <refentry id="function.mssql-close">
+ <refnamediv>
+ <refname>mssql_close</refname>
+ <refpurpose>Chiude la connessione con MS SQL Server</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_close</function></funcdef>
+ <paramdef>int
+ <parameter><optional>id_connessione</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Restituisce: vero se l'operazione riesce, falso se si verifica un errore.
+ </para>
+ <para>
+ La funzione <function>Mssql_close</function> chiude la connessione
+ ad un database MS SQL
+ Server che è associata all' argomento id_connessione.
+ Se l' id_connessione non viene indicato, si fa riferimento all'ultima connessione
+ aperta.
+ </para>
+ <para>
+ Nota: solitamente non è necessario l'uso della funzione, dato che
+ tutte le connessioni non-persistenti sono chiuse automaticamente al
+ termine dell'esecuzione dello script.
+ </para>
+ <para>
+ <function>Mssql_close</function> non chiude i collegamenti persistenti
+ aperti utilizzando <function>mssql_pconnect</function>.
+ </para>
+ <para>
+ Vedere anche: <function>mssql_connect</function>,
+ <function>mssql_pconnect</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-connect">
+ <refnamediv>
+ <refname>mssql_connect</refname>
+ <refpurpose>Apre una connessione con un server MS SQL</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_connect</function></funcdef>
+ <paramdef>string
+ <parameter><optional>nome_server</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>nome_utente</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>password</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Restituisce: un identificativo di connessione su l'operazione riesce,
+ oppure falso se si verifica un errore.
+ </para>
+ <para>
+ La funzione <function>Mssql_connect</function> realizza una connessione
+ con un server MS SQL. L' argomento nome_server deve essere un nome valido
+ di server come definito nel file 'interfaces'.
+ </para>
+ <para>
+ Qualora la funzione <function>mssql_connect</function> venga eseguita
+ una seconda volta con i medesimi parametri, non viene realizzata una nuova
+ connessione, ma, invece, viene restituito l'identificativo della connessione
+ già aperta.
+ </para>
+ <para>
+ La connessione con il server verrà chiusa non appena lo script terminerà
+ l'esecuzione, a meno che la connessione non sia già stata chiusa utilizzando
+ la funzione <function>mssql_close</function>.
+ </para>
+ <para>
+ Vedere anche <function>mssql_pconnect</function>, e
+ <function>mssql_close</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-data-seek">
+ <refnamediv>
+ <refname>mssql_data_seek</refname>
+ <refpurpose>Sposta il puntatore di riga interno</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_data_seek</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ <paramdef>int <parameter>numero_riga</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Restituisce: vero se l'operazione riesce, falso se si verifica un errore.
+ </para>
+ <para>
+ La funzione <function>Mssql_data_seek</function> sposta il puntatore
+ di riga, interno al risultato associato all'identificativo di risultato,
+ alla riga indicata dall'argomento numero_riga. La chiamata successiva a
+ <function>mssql_fetch_row</function> restituirà la riga richiesta.
+ </para>
+ <para>
+ Vedere anche <function>mssql_data_seek</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-fetch-array">
+ <refnamediv>
+ <refname>mssql_fetch_array</refname>
+ <refpurpose>Restituisce una riga in un array</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_fetch_array</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ La funzione restituisce: un array corrispondente alla riga estratta, oppure
+ falso se non vi sono più righe.
+ </para>
+ <para>
+ La funzione <function>Mssql_fetch_array</function> è un' estensione
+ della funzione
+ <function>mssql_fetch_row</function>. Oltre a memorizzare i dati in un array
+ con indice numerico, la funzione memorizza i dati in un array associativo
+ in cui la chiave è costituita dal nome del campo.
+ </para>
+ <para>
+ Un aspetto da notare è che la funzione
+ <function>mssql_fetch_array</function> NON è significativamente più
+ lenta rispetto a <function>mssql_fetch_row</function>, mentre nel contempo
+ fornisce funzionalità maggiori.
+ </para>
+ <para>
+ Per ulteriori dettagli vedere anche
+ <function>mssql_fetch_row</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-fetch-field">
+ <refnamediv>
+ <refname>mssql_fetch_field</refname>
+ <refpurpose>Restituisce le informazioni di un campo</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>object <function>mssql_fetch_field</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>offset_campo</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ La funzione restituisce un oggetto contenente le informazioni sul campo.
+ </para>
+ <para>
+ La funzione <function>Mssql_fetch_field</function> può essere utilizzata
+ per ottenere informazioni sui campi presenti nel risultato di una certa query.
+ Se non viene specificato l'argomento offset_campo, la funzione restituisce
+ il campo successivo che non è ancora stato restituito da
+ <function>mssql_fetch_field</function>.
+ </para>
+ <para>
+ Le proprietà dell'oggetto sono:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ name - nome della colonna. Se la colonna è il risultato di una funzione, questa
+ proprietà è valorizzata con "computed#N", dove #N è un numero progressivo.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ column_source - tabella da cui sono ricavate le colonne
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ max_length - lunghezza massima della colonna
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ numeric - 1 se la colonna è numerica
+ </simpara></listitem>
+ </itemizedlist>
+ <para>
+ Vedere anche <function>mssql_field_seek</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-fetch-object">
+ <refnamediv>
+ <refname>mssql_fetch_object</refname>
+ <refpurpose>Restituisce una riga come oggetto</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_fetch_object</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ La funzione restituisce un oggetto le cui proprietà corrispondono alla riga estratta,
+ oppure falso se non vi sono più righe.
+ </para>
+ <para>
+ La funzione <function>Mssql_fetch_object</function> è simile a
+ <function>mssql_fetch_array</function>, tranne che per una
+ differenza, la prima restituisce un oggetto, la seconda un array.
+ Indirettamente questo significa che si può accedere ai dati solo
+ attraverso il nome dei campi e non tramite il loro offset ( i numeri non
+ sono dei validi nomi di proprietà ).
+ </para>
+ <para>
+ A livello di velocità il comportamento è simile a
+ <function>mssql_fetch_array</function>, e quasi veloce come
+ <function>mssql_fetch_row</function> (la differenza è
+ insignificante ).
+ </para>
+ <para>
+ Vedere anche <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>Restituisce una riga come array numerato</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>mssql_fetch_row</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ La funzione restituisce un array che corrisponde alla riga estratta,
+ oppure falso se non vi sono più righe.
+ </para>
+ <para>
+ La funzione <function>Mssql_fetch_row</function> estrae una riga
+ di dati dal risultato associato all'identificativo di risultato passato.
+ La riga viene restituita in un array. Ciascuna colonna è memorizzata
+ in un campo dell'array. Il primo ha indice 0.
+ </para>
+ <para>
+ Esecuzione successive di <function>mssql_fetch_rows</function> restituiscono
+ le righe successive presenti nel risultato, oppure falso
+ se non vi sono più righe.
+ </para>
+ <para>
+ Vedere anche <function>mssql_fetch_array</function>,
+ <function>mssql_fetch_object</function>,
+ <function>mssql_data_seek</function>,
+ <function>mssql_fetch_lengths</function>, e
+ <function>mssql_result</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-field-length">
+ <refnamediv>
+ <refname>mssql_field_length</refname>
+ <refpurpose>Restituisce la lunghezza di un campo</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_field_length</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>offset</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-field-name">
+ <refnamediv>
+ <refname>mssql_field_name</refname>
+ <refpurpose>Restituisce il nome di un campo</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_field_name</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>offset</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-field-seek">
+ <refnamediv>
+ <refname>mssql_field_seek</refname>
+ <refpurpose>Posizionamento sul campo</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_field_seek</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ <paramdef>int <parameter>offset_campo</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Si posiziona sul campo richiesto. Eseguendo successivamente la
+ funzione <function>mssql_fetch_field</function> senza indicare alcun campo,
+ quest'ultima restituirà il campo richiesto tramite
+ <function>mssql_fetch_field</function>.</para>
+ <para></para>
+ <para>
+ Vedere anche <function>mssql_fetch_field</function>.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-field-type">
+ <refnamediv>
+ <refname>mssql_field_type</refname>
+ <refpurpose>Restituisce il tipo di un campo</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>mssql_field_type</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>offset</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-free-result">
+ <refnamediv>
+ <refname>mssql_free_result</refname>
+ <refpurpose>Libera la memoria di un risultato</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_free_result</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ La funzione <function>mssql_free_result</function> permette
+ di non utilizzare molta memoria durante l'esecuzione di uno script.
+ Infatti, se si è sicuri di non avere più bisogno dei dati del risultato,
+ si può eseguire <function>mssql_free_result</function>, e la memoria associata
+ a <parameter>id_risultato</parameter> sarà liberata. Se la funzione
+ non viene utilizzata, le aree di memoria resteranno disponibili per tutta
+ la durata dello script. Al termine verranno liberate in modo automatico.
+ Tuttavia utilizzando la funzione <function>mssql_free_result</function>,
+ l'area di memoria del risultato associato a id_risultato, sarà liberata.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-get-last-message">
+ <refnamediv>
+ <refname>mssql_get_last_message</refname>
+ <refpurpose>
+ Restituisce l'ultimo messaggio dal server ( oltre min_message_severity?)
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string
+ <function>mssql_get_last_message</function>
+ </funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-min-error-severity">
+ <refnamediv>
+ <refname>mssql_min_error_severity</refname>
+ <refpurpose>Setta il livello minimo di errori critici.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void
+ <function>mssql_min_error_severity</function>
+ </funcdef>
+ <paramdef>int <parameter>livello_critico</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-min-message-severity">
+ <refnamediv>
+ <refname>mssql_min_message_severity</refname>
+ <refpurpose>Setta li livello critico minimo di messaggi</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void
+ <function>mssql_min_message_severity</function>
+ </funcdef>
+ <paramdef>int <parameter>livello_critico</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-num-fields">
+ <refnamediv>
+ <refname>mssql_num_fields</refname>
+ <refpurpose>Restituisce il numero di campi in un risultato</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_num_fields</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ La funzione <function>Mssql_num_fields</function> restituisce il numero di
+ campi presenti in un risultato.
+ </para>
+ <para>
+ Vedere anche: <function>mssql_db_query</function>,
+ <function>mssql_query</function>,
+ <function>mssql_fetch_field</function>, e
+ <function>mssql_num_rows</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-num-rows">
+ <refnamediv>
+ <refname>mssql_num_rows</refname>
+ <refpurpose>Restituisce il numero di righe</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_num_rows</function></funcdef>
+ <paramdef>string <parameter>id_risultato</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ La funzione <function>Mssql_num_rows</function> restituisce il numero di righe
+ presenti in un risultato.
+ </para>
+ <para>
+ Vedere anche: <function>mssql_db_query</function>,
+ <function>mssql_query</function>, e
+ <function>mssql_fetch_row</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-pconnect">
+ <refnamediv>
+ <refname>mssql_pconnect</refname>
+ <refpurpose>Apre una connessione persistente con MS SQL</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_pconnect</function></funcdef>
+ <paramdef>string
+ <parameter><optional>nome_server</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>nome_utente</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>password</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ La funzione restituisce: o un identificativo di connessione persistente,
+ o falso se si verifica un errore.
+ </para>
+ <para>
+ La funzione <function>Mssql_pconnect</function> agisce come
+ <function>mssql_connect</function> tranne che per due differenze.
+ </para>
+ <para>
+ Prima differenza, quando si cerca di stabilire la connessione, la funzione
+ per prima cosa cerca di trovare una connessione ( persistente ) già
+ aperta verso lo stesso server con i medesimi utenti e password.
+ Se ne viene trovata una, la funzione restituisce l'identificativo di
+ quella connessione, invece di stabilirne una nuova.
+ </para>
+ <para>
+ Seconda differenza, la connessione con il server SQL non verrà chiusa
+ al termine dello script. Il collegamento resterà aperto per utilizzi futuri
+ (la funzione <function>mssql_close</function> non chiude i collegamenti
+ aperti da <function>mssql_pconnect</function>).
+ </para>
+ <para>
+ Per questo motivo questo tipo di collegamento viene definito 'persistente'.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-query">
+ <refnamediv>
+ <refname>mssql_query</refname>
+ <refpurpose>Invia una query a MS SQL</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_query</function></funcdef>
+ <paramdef>string <parameter>teso_query</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>id_connessione</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ La funzione restituisce un identificativo di risultato in caso di esecuzione
+ corretta, oppure falso in caso di errore.
+ </para>
+ <para>
+ La funzione <function>Mssql_query</function> invia una query al database
+ attivo sul server attraverso la connessione specificata da id_connessione.
+ Se l'argomento id_connessione non viene fornito, si utilizza l'ultima connessione
+ aperta in ordine di tempo. Se non vi sono connessioni aperte,
+ la funzione tenta di stabilire una connessione, come se fosse
+ utilizzata la funzione <function>mssql_connect</function>, e utilizza
+ quella.
+ </para>
+ <para>
+ Vedere anche: <function>mssql_db_query</function>,
+ <function>mssql_select_db</function>, e
+ <function>mssql_connect</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-result">
+ <refnamediv>
+ <refname>mssql_result</refname>
+ <refpurpose>Restituisce i dati di un risultato</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_result</function></funcdef>
+ <paramdef>int <parameter>id_risultato</parameter></paramdef>
+ <paramdef>int <parameter>i</parameter></paramdef>
+ <paramdef>mixed <parameter>campo</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ La funzione restituisce il contenuto della cella ( identificata dalla riga
+ e dal campo indicato) dal risultato associato a id_risultato.
+ </para>
+ <para>
+ La funzione <function>Mssql_result</function> restituisce il contenuto di una
+ cella da un risultato di una query a MS SQL.
+ L'argomento campo può essere la posizione di un campo, oppure il suo nome,
+ oppure nome tabella punto nome campo ( nome_tabella.nome_campo ). Se il nome
+ della colonna ha un sostituto, ('select foo as bar from...'), usare quello
+ anzichè il nome originale.
+ </para>
+ <para>
+ Quando si lavora con risultati abbastanza grossi, si dovrebbe considerare
+ l'utilizzo di funzioni che restituiscono l'intera riga ( indicate di seguito ),
+ dato che queste restituiscono il contenuto di molte celle in una chiamata sola.
+ Pertanto sono MOLTO più veloci di <function>mssql_result</function>.
+ Da notare inoltre, che specificando la posizione per l'argomento campo, la funzione
+ è molto più veloce rispetto al caso in cui si indica il nome del campo o della tabella.
+ </para>
+ <para>
+ Le alternative più veloci raccomandate sono:
+ <function>mssql_fetch_row</function>,
+ <function>mssql_fetch_array</function>, e
+ <function>mssql_fetch_object</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mssql-select-db">
+ <refnamediv>
+ <refname>mssql_select_db</refname>
+ <refpurpose>Seleziona un database MS SQL</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mssql_select_db</function></funcdef>
+ <paramdef>string <parameter>Nome_database</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>id_connessione</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para> Restituisce: vero se l'operazione riesce, falso se si verifica un errore.
+ </para>
+ <para>
+ La funzione <function>Mssql_select_db</function> setta il database attivo
+ sul server attraverso la connessione specificata da id_connessione.
+ Se l'argomento id_connessione non viene fornito, si utilizza l'ultima connessione
+ aperta in ordine di tempo. Se non vi sono connessioni aperte,
+ la funzione tenta di stabilire una connessione, come se fosse
+ utilizzata la funzione <function>mssql_connect</function>, e utilizza
+ quella.
+ </para>
+ <para>
+ Ciascuna esecuzione di <function>mssql_query</function> sarà
+ fatta sul database attivo.
+ </para>
+ <para> Vedere anche:
+ <function>mssql_connect</function>,
+ <function>mssql_pconnect</function>, e
+ <function>mssql_query</function>
+ </para>
+ </refsect1>
+ </refentry>
+
+</reference>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->