Index: phpdoc/it/functions/uodbc.xml diff -u phpdoc/it/functions/uodbc.xml:1.13 phpdoc/it/functions/uodbc.xml:1.14 --- phpdoc/it/functions/uodbc.xml:1.13 Sat Nov 10 16:50:04 2001 +++ phpdoc/it/functions/uodbc.xml Thu Nov 29 12:05:07 2001 @@ -1,15 +1,16 @@ - - + + Funzioni ODBC Unificate ODBC In aggiunta al normale supporto ODBC, le funzioni ODBC unificate del PHP consentono l'accesso a diversi database che hanno preso in prestito - la semantica dell'API ODBC per implementare la loro API. Invece di mantenere - più driver per database che sono tutti pressoché identici, questi driver sono - stati riuniti in un singolo insieme di funzioni ODBC. + la semantica dell'API ODBC per implementare la loro API. Invece di + mantenere più driver per database che sono tutti pressoché + identici, questi driver sono stati riuniti in un singolo insieme di + funzioni ODBC. I seguenti database sono supportati dalle funzioni ODBC unificate: @@ -31,7 +32,12 @@ Nella connessione ai database sopra elencati non vengono coinvolte funzioni ODBC. Le funzioni che vengono utilizzate per collegarsi nativamente con essi - condividono solamente lo stesso nome e sintassi delle funzioni ODBC. + condividono solamente lo stesso nome e sintassi delle funzioni ODBC.L'eccezione + a questo è iODBC. Compilando il PHP con il supporto di iODBC, + si può utilizzare qualsiasi driver compatibile ODBC nelle applicazioni PHP. + iODBC è gestito da + OpenLink Software. Maggiori informazioni su iODBC, e un + HOWTO sono diponibili nel sito www.iodbc.org. @@ -58,13 +64,13 @@ Se il campo OnOff è posto a vero, l' auto-commit è abilitato, - se è valorizzato a falso l'autocommit è disabilitato. La funzione restituisce - vero se l'operazione riesce, falso se si + se è valorizzato a falso l'auto-commit è disabilitato. La funzione restituisce + &true; se l'operazione riesce, &false; se si verifica un errore. - Per default, l'autocommit è abilitato. La disabilitazione - dell'autocommit equivale ad iniziare una transazione. + Per default, l'auto-commit è abilitato. La disabilitazione + dell'auto-commit equivale ad iniziare una transazione. Vedere inoltre @@ -121,7 +127,7 @@ Modalità - impostazione di longreadlen + Impostazione di longreadlen Comportamento @@ -143,26 +149,30 @@ ODBC_BINMODE_PASSTHRU + 0 + passthru + + + ODBC_BINMODE_PASSTHRU >0 direttamente al client ODBC_BINMODE_RETURN >0 - ritorna inalterato + restituito inalterato ODBC_BINMODE_CONVERT >0 - ritorna come char + restituito come char - Se viene utilizzata la funzione odbc_fetch_into, nei casi - in cui il dato viene inviato direttamente al client, quest'ultima + Se viene utilizzata odbc_fetch_into, nei casi in cui il dato viene inviato direttamente al client, quest'ultima restituisce una stringa vuota per le colonne binarie. @@ -247,8 +257,8 @@ - Restituisce: vero per operazione corretta, - falso se si verifica un errore. Sono eseguite tutte le + Restituisce: &true; per operazione corretta, + &false; se si verifica un errore. Sono eseguite tutte le transazioni pendenti sulla connessione indicata dall'argomento id_connessione. @@ -276,9 +286,8 @@ L'identificatore di connessione ritornato da questa funzione è - utilizzato dalle altre funzioni ODBC. Si possono avere più connessioni - aperte contemporaneamente. Il quarto parametro ( opzionale ), setta - il tipo di cursore da utilizzare per questa connessione. Normalmente + utilizzato dalle altre funzioni ODBC. Si possono avere più connessioni aperte contemporaneamente. + Il quarto parametro (opzionale), setta il tipo di cursore da utilizzare per questa connessione. Normalmente questo parametro non è necessario, ma può essere utilizzato per aggirare dei problemi che si manifestano con alcuni driver ODBC. @@ -364,6 +373,59 @@ + + + odbc_error + Restituisce l'ultimo codice di errore + + + Descrizione + + + string odbc_error + int id_connessione + + + + La funzione restituisce un codice di 6 cifre indicante lo stato di ODBC. Se non + vi sono errori viene restituita una stringa vuota. Se viene passato il parametro id_connessione, viene + restituito l'ultimo stato di questa connessione, altrimenti si ha l'ultimo stato + dell'ultima operazione su una qualsiasi connessione. + + + Vedere anche: odbc_errormsg e + odbc_exec. + + + + + + + odbc_errormsg + Restituisce l'ultimo messaggio d'errore + + + Descrizione + + + string odbc_errormsg + int id_connessione + + + + la funzione restituisce una stringa contenente l'ultimo messaggio di + errore generato da ODBC, oppure una stringa vuota se non ci sono errori. Se + viene passato il parametro id_connessione, viene restituito l'ultimo stato di questa + connessione, altrimenti si ha l'ultimo stato dell'ultima operazione su una qualsiasi + connessione. + + + Vedere anche: odbc_error and + odbc_exec. + + + + odbc_exec @@ -379,20 +441,18 @@ - Restituisce falso se si verifica un errore. Restituisce - un identificatore del risultato se l'espressione SQL viene - eseguita correttamente. + Restituisce &false; se si verifica un errore. Restituisce un + identificatore del risultato ODBC se l'espressione SQL viene eseguita correttamente. odbc_exec invia una espressione SQL al server tramite la connessione specificata da id_connessione. Questo parametro deve essere - un identificativo valido restituito da - odbc_connect oppure + un identificativo valido restituito da odbc_connect oppure odbc_pconnect. - Vedere anche: odbc_prepare ed + Vedere anche: odbc_prepare e odbc_execute per l'esecuzione di molteplici espressioni SQL. @@ -417,8 +477,8 @@ Esegue una espressione SQL memorizzata tramite la funzione odbc_prepare. Restituisce - vero se l'esecuzione riesce, - falso in caso negativo. L'array + &true; se l'esecuzione riesce, + &false; in caso negativo. L'array array_parametri occorre soltanto se è necessario fornire parametri all'espressione. @@ -442,12 +502,73 @@ La funzione restituisce il numero di colonne presenti nel risultato; - falso se si verifica un errore. + &false; se si verifica un errore. Il parametro array_dati deve essere passato per referenza, ma può essere di qualsiasi tipo dato che verrà convertito in array. Nell'array saranno posti i valori delle colonne di una riga tratta dalla tabella risultante dalla query a partire dall'indice 0. + + + <function>odbc_fetch_into</function> Esempi pre 4.0.6 + + + + + oppure + + + + + + + + A partire dalla versione 4.0.5 non è necessario che il parametro + result_array sia passato per riferimento. + + + A partire dalla versione 4.0.6 il parametro rownumber + non può essere passato come una costante, ma solo come una variabile. + + + + <function>odbc_fetch_into</function> Esempi con PHP 4.0.6 + + + + + oppure + + + + + + + + Versioni future:: In PHP 4.1, questa funzione assurà il seguente + formato: + + + int odbc_fetch_into + int id_risultato + array array_dati + int numero_riga + + + Notare che numero_riga sarà opzionale, mentre + array_dati no. + @@ -467,8 +588,8 @@ Se odbc_fetch_row ha successo ( c'è almeno - una riga), la funzione restituisce vero. Altrimenti, se non vi sono più - righe, la funzione restituisce falso. + una riga), la funzione restituisce &true;. Altrimenti, se non vi sono più + righe, la funzione restituisce &false;. odbc_fetch_row estrae un record dai dati @@ -537,8 +658,7 @@ odbc_field_num restituisce il numero della colonna in cui si trova il campo richiesto all'interno di un risultato ODBC indicato dall'argomento id_risultato. La numerazione delle colonne - parte da 1. - Si ottiene falso se si verifica un errore. + parte da 1. Si ottiene &false; se si verifica un errore. @@ -546,7 +666,7 @@ odbc_field_type - Tipo di campo + Tipo di dato di campo Descrizione @@ -560,8 +680,7 @@ La funzione odbc_field_type restituisce il tipo di dato SQL del campo indicato dal numero all'interno di un set di righe - referenziate dall'identificativo di risultato ODBC passato. - La numerazione delle colonne parte da 1. + referenziate dall'identificativo di risultato ODBC passato. La numerazione delle colonne parte da 1. @@ -583,8 +702,7 @@ All'interno di un set di righe, referenziate dall'identificativo di risultato ODBC fornito, la funzione odbc_field_len - restituisce la dimensione ( precisione ) del campo indicato dall'argomento - numero_campo. La numerazione dei campi parte da 1. + restituisce la dimensione (precisione) del campo indicato dall'argomento. La numerazione dei campi parte da 1. Vedere anche: odbc_field_scale per ottenere la scala di @@ -655,7 +773,7 @@ - Restituisce sempre vero. + Restituisce sempre &true;. La funzione odbc_free_result permette @@ -669,7 +787,7 @@ - Se si ha l'autocommit disabilitato (vedere + Se si ha l'auto-commit disabilitato (vedere odbc_autocommit) e si esegue odbc_free_result prima di eseguire il commit, tutte le transazioni pendenti saranno annullate, @@ -689,7 +807,7 @@ int odbc_longreadlen - int id_risultato + int id_risultato int lunghezza @@ -722,10 +840,9 @@ - All'interno di un set di righe, referenziate dall'identificativo - di risultato ODBC fornito, la funzione odbc_num_fields - restituisce il numero di campi (colonne) presenti. La funzione restituisce -1 se vi - è un errore. L'argomento fornito è un identificatore di esito restituito + All'interno di un set di righe, referenziate dall'identificativo di risultato ODBC fornito, la funzione odbc_num_fields + restituisce il numero di campi (colonne) presenti. La funzione restituisce -1 se si + verifica un errore. L'argomento fornito è un identificatore di esito restituito dalla funzione odbc_exec. @@ -748,14 +865,15 @@ - Restituisce un identificatore di connessione ODBC oppure 0 (falso) - su errore. Questa funzione è molto simile a odbc_connect, - eccetto che la connessione non viene realmente chiusa quando - lo script finisce. Future richieste di connessione che utilizzino la - stessa combinazione di dsn, + Restituisce un identificatore di connessione ODBC oppure 0 (&false;) + su errore. Questa funzione è molto simile + a odbc_connect, eccetto che la connessione non viene realmente chiusa quando + lo script finisce. Successive richieste di connessione che utilizzino la + stessa combinazione di dsn, utente, password (eseguite sia utilizzando odbc_connect, sia utilizzando - odbc_pconnect) possono riutilizzare la connessione. + odbc_pconnect) possono riutilizzare la + connessione. @@ -788,13 +906,12 @@ - La funzione ritorna falso su errore. + La funzione restituisce &false; su errore. - Restituisce un identificativo di risultato ODBC se l'espressione SQL - viene predisposta correttamente. L'identificativo restituito può essere - utilizzato successivamente per eseguire l'espressione utilizzando - la funzione odbc_execute. + Restituisce un identificativo di risultato ODBC se l'espressione SQL viene predisposta + correttamente. L'identificativo restituito può essere utilizzato successivamente per eseguire + l'espressione utilizzando la funzione odbc_execute. @@ -822,7 +939,8 @@ Nota: Con diversi driver, la funzione odbc_num_rows, utilizzata con - lo scopo di determinare il numero di righe dopo una SELECT, restituisce -1. + lo scopo di determinare il numero di righe dopo una SELECT, + restituisce -1. @@ -849,33 +967,37 @@ indicante il numero di colonna del campo desiderato; sia una stringa contenente il nome del campo. Ad esempio: + - Nel primo caso l'esecuzione di odbc_result - restituisce il terzo campo del record corrente. - Nel secondo, la funzione odbc_result restituisce il valore - del campo il cui nome è "val", sempre utilizzando i dati dal record corrente. - Si ha un errore qualora il numero di colonna fornito sia minore di 1 - oppure sia superiore al numero delle colonne ( o campi ) presenti + Nel primo caso l'esecuzione di odbc_result restituisce + il valore del terzo campo del record corrente della + query. Nel secondo, la funzione + odbc_result restituisce il valore del campo + il cui nome è "val", sempre utilizzando i dati dal record + corrente. Si ha un errore qualora il numero di colonna fornito sia minore di 1 + oppure sia superiore al numero delle colonne (o campi) presenti nel record corrente. Analogamente, si ottiene un errore se il nome del campo - richiesto non sia presente nella tabella/e oggetto della ricerca. + richiesto non sia presente nella tabella/e + oggetto della ricerca. L'indice dei campi parte da 1. Per quanto riguarda la gestione dei campi - di tipo binario o long fare riferimento a odbc_binmode - e a odbc_longreadlen. + di tipo binario o long fare riferimento a + odbc_binmode e a + odbc_longreadlen.