cortesi Wed Nov 28 19:10:01 2001 EDT Modified files: /phpdoc/it/functions mssql.xml Log: updating translation by Darvin Andrioli to EN 1.22
Index: phpdoc/it/functions/mssql.xml diff -u phpdoc/it/functions/mssql.xml:1.9 phpdoc/it/functions/mssql.xml:1.10 --- phpdoc/it/functions/mssql.xml:1.9 Sat Nov 10 16:50:03 2001 +++ phpdoc/it/functions/mssql.xml Wed Nov 28 19:10:01 2001 @@ -1,8 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.15 Maintainer: darvin Status: ready --> -<reference id="ref.mssql"> +<!-- EN-Revision: 1.22 Maintainer: darvin Status: ready --> + <reference id="ref.mssql"> <title>Funzioni per Microsoft SQL Server</title> <titleabbrev>MS SQL Server</titleabbrev> + <partintro> + <simpara> + L'estensione per MSSQL è disponibile solamente sui sistemi Win32. + Sulle altre piattaforme si può utilizzare il modulo Sybase per + connettersi con database MSSQL. + </simpara> + <simpara> + Queste funzioni permettono di accedere a database MS SQL Server. + Per potere funzionare è richiesto che sia installato il MS SQL Client Tools + sullo stesso sistema su cui è il installato il PHP. Il Client Tools può essere +installato + o dal cd di MS SQL Server, o copiando il file ntwdblib.dll dalla directory +\winnt\system32 del + server alla directory \winnt\system32 della macchina su cui è installato + il PHP. La copia del file ntwdblib.dll permette solo l'accesso al database. + La configurazione del client richiede comunque l'installazione di tutto il +pacchetto MS SQL Client Tools. + </simpara> + <simpara> + Il modulo MSSQL si abilita aggiungendo extension=php_mssql.dll al file di +configurazione php.ini. + </simpara> + </partintro> <refentry id="function.mssql-close"> <refnamediv> @@ -20,12 +39,11 @@ </funcprototype> </funcsynopsis> <para> - Restituisce: vero se l'operazione riesce, falso se si verifica un errore. + Restituisce: &true; 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. + 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> @@ -141,8 +159,7 @@ </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 + 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> @@ -236,10 +253,9 @@ <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à ). + 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 @@ -347,8 +363,7 @@ <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> + quest'ultima restituirà il campo richiesto tramite +<function>mssql_fetch_field</function>.</para> <para></para> <para> Vedere anche <function>mssql_fetch_field</function>.</para> @@ -388,15 +403,12 @@ </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. + E' necessario l'utilizzo della funzione <function>mssql_free_result</function> + solo quando si è preoccupati dell'occupazione di memoria durante l'esecuzione + dello script. Normalmente tutti i dati verranno rimossi automaticamente dalla + memoria al termine dell'esecuzione dello script.E' tuttavia possibile eseguire + <function>mssql_free_result</function>, per liberare la memoria occupata dai dati + indicati dal parametro <parameter>id_risultato</parameter> </para> </refsect1> </refentry> @@ -405,7 +417,8 @@ <refnamediv> <refname>mssql_get_last_message</refname> <refpurpose> - Restituisce l'ultimo messaggio dal server ( oltre min_message_severity?) + Restituisce l'ultimo messaggio dal server (oltre + min_message_severity?) </refpurpose> </refnamediv> <refsect1> @@ -457,6 +470,52 @@ </refsect1> </refentry> + <refentry id="function.mssql-next-result"> + <refnamediv> + <refname>mssql_next_result</refname> + <refpurpose>Muove il puntatore interno al risultato successivo</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool + <function>mssql_next_result</function> + </funcdef> + <paramdef>int <parameter>id_risultato</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Nel caso in cui si eseguano più di una istruzione SQL al server, oppure si +eseguano + delle procedure memorizzate (stored procedure) con possibilità di molteplici +risultati, il server restituirà un set di diversi risultati. + Questa funzione verifica se esistono ulteriori risultati dal server. Se +effettivamente + esiste un'altro risultato, questa funzione libera la memoria dal risultato +corrente + e si predispone per la ricezione del risultato successivo. + La funzione restituisce &true; se è disponibile un'altro risultato, + &false; in caso contrario. + </para> + <example> + <title><function>mssql_next_result</function> Esempio di utilizzo</title> + <programlisting role="php"> +<![CDATA[ +<?php + $link = mssql_connect ("localhost", "utente", "password"); + mssql_select_db("MyDB", $link); + $SQL = "Select * from tabella1 select * from tabella2"; + $rs = mssql_query($SQL, $link); + do { + while ($row = mssql_fetch_row($rs)) { + } + } while (mssql_next_result($rs)); + mssql_free_result($rs); + mssql_close ($link); +?> +]]> + </programlisting> + </example> + </refsect1> + </refentry> + <refentry id="function.mssql-num-fields"> <refnamediv> <refname>mssql_num_fields</refname> @@ -531,7 +590,7 @@ </funcsynopsis> <para> La funzione restituisce: o un identificativo di connessione persistente, - o falso se si verifica un errore. + o &false; se si verifica un errore. </para> <para> La funzione <function>mssql_pconnect</function> agisce come @@ -539,9 +598,8 @@ </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 + 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> @@ -566,7 +624,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mssql_query</function></funcdef> - <paramdef>string <parameter>teso_query</parameter></paramdef> + <paramdef>string <parameter>testo_query</parameter></paramdef> <paramdef>int <parameter><optional>id_connessione</optional></parameter> </paramdef> @@ -582,8 +640,7 @@ 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. + utilizzata la funzione <function>mssql_connect</function>, e utilizza quella. </para> <para> Vedere anche: <function>mssql_db_query</function>, @@ -608,10 +665,6 @@ <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. @@ -624,9 +677,10 @@ 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. + 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: @@ -661,8 +715,7 @@ 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. + utilizzata la funzione <function>mssql_connect</function>, e utilizza quella. </para> <para> Ciascuna esecuzione di <function>mssql_query</function> sarà