cvs: phpdoc /it/functions ibase.xml

perugini Tue Oct 10 06:16:35 2000 EDT Modified files: /phpdoc/it/functions ibase.xml Log: Translated by Fabio fabio@immortaldescendants.org Index: phpdoc/it/functions/ibase.xml diff -u phpdoc/it/functions/ibase.xml:1.6 phpdoc/it/functions/ibase.xml:1.7 --- phpdoc/it/functions/ibase.xml:1.6 Tue Oct 10 06:05:46 2000 +++ phpdoc/it/functions/ibase.xml Tue Oct 10 06:16:35 2000 @@ -1,28 +1,18 @@ <reference id="ref.ibase"> - <title>InterBase functions</title> + <title>Funzioni InterBase</title> <titleabbrev>InterBase</titleabbrev> <partintro> <para> - InterBase is a popular database put out by Borland/Inprise. More - information about InterBase is available at <ulink - url="&url.ibase;">&url.ibase;</ulink>. Oh, by the way, InterBase - just joined the open source movement! + InterBase è un famoso database prodotto da Borland/Inprise. Maggiori + informazioni riguardo InterBase sono disponibili a <ulink + url="&url.ibase;">&url.ibase;</ulink>. Oh, a proposito, InterBase + è da poco entrato nel movimento open source! </para> <note> <para> - Full support for InterBase 6 was added in PHP 4.0. + Il supporto completo per InterBase 6 è stato aggiunto in PHP 4.0. </para> - <para> - This database uses a single quote (') character for escaping, a - behavior similar to the Sybase database, add to your - <filename>php.ini</filename> the following directive: - <informalexample> - <programlisting> -magic_quotes_sybase = On - </programlisting> - </informalexample> - </para> </note> </partintro> @@ -30,11 +20,11 @@ <refnamediv> <refname>ibase_connect</refname> <refpurpose> - Open a connection to an InterBase database + Apre una connessione con un database InterBase </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ibase_connect</function></funcdef> @@ -60,30 +50,30 @@ </funcprototype> </funcsynopsis> <para> - Establishes a connection to an InterBase server. - The <parameter>database</parameter> argument - has to be a valid path to database file on the server it resides on. - If the server is not local, it must be prefixed with either - 'hostname:' (TCP/IP), '//hostname/' (NetBEUI) or 'hostname@' (IPX/SPX), - depending on the connection protocol used. <parameter>username</parameter> - and <parameter>password</parameter> can also - be specified with PHP configuration directives ibase.default_user and - ibase.default_password. <parameter>charset</parameter> is the default - character set for a database. <parameter>buffers</parameter> is the number - of database buffers to allocate for the server-side cache. If 0 or omitted, - server chooses its own default. <parameter>dialect</parameter> selects - the default SQL dialect for any statement executed within a connection, - and it defaults to the highest one supported by client libraries. - </para> - <para> - In case a second call is made to - <function>ibase_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. 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 + Stabilisce una connessione con un server InterBase. + Il parametro <parameter>database</parameter> + deve essere un percorso valido di un file di database sul server dove risiede. + Se il server non fosse locale, bisogna aggiungere prima del percorso o + 'hostname:' (TCP/IP), o '//hostname/' (NetBEUI) o 'hostname@' (IPX/SPX), + in base al protocollo di connessione utilizzato. <parameter>username</parameter> + e <parameter>password</parameter> possono venire specificati + anche con le direttive di configurazione del PHP ibase.default_user e + ibase.default_password. <parameter>charset</parameter> è il set di caratteri predefinito + per un database. <parameter>buffers</parameter> è il numero di + buffer di database da allocare per la cache dal lato server. Se è 0 o viene omesso, + il server usa il suo valore predefinito. <parameter>dialect</parameter> seleziona + il dialetto SQL predefinito per ogni operazione eseguita all'interno di una connessione, + e il suo valore predefinito è il più alto supportato dalle librerie del client. + </para> + <para> + In caso di una seconda chiamata fatta con + <function>ibase_connect</function> con gli stessi parametri, non verrà creato + alcun nuovo collegamento, bensì, l'identificatore del collegamento già aperto + verrà restituito. Il collegamento al server verrà chiuso appena termina + l'esecuzione dello script, a meno che non venga chiuso prima esplicitamente chiamando <function>ibase_close</function>. <example> - <title><function>Ibase_connect</function> example</title> + <title>Esempio di <function>Ibase_connect</function></title> <programlisting role="php"> &lt;?php $dbh = ibase_connect ($host, $username, $password); @@ -99,23 +89,23 @@ </para> <note> <para> - <parameter>buffers</parameter> was added in PHP4-RC2. + <parameter>buffers</parameter> è stato aggiunto in PHP4-RC2. </para> </note> <note> <para> - <parameter>dialect</parameter> was added in PHP4-RC2. It is functional - only with InterBase 6 and versions higher than that. + <parameter>dialect</parameter> è stato aggiunto in PHP4-RC2. E' funzionante + solo con InterBase 6 e versioni successive. </para> </note> <note> <para> - <parameter>role</parameter> was added in PHP4-RC2. It is functional - only with InterBase 5 and versions higher than that. + <parameter>role</parameter> è stato aggiunto in PHP4-RC2. E' funzionante + solo con InterBase 5 e versioni successive. </para> </note> <para> - See also: <function>ibase_pconnect</function>. + Vedere anche: <function>ibase_pconnect</function>. </para> </refsect1> </refentry> @@ -124,11 +114,11 @@ <refnamediv> <refname>ibase_pconnect</refname> <refpurpose> - Creates an persistent connection to an InterBase database + Crea una connessione persistente ad un database Interbase </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ibase_connect</function></funcdef> @@ -148,21 +138,21 @@ </funcprototype> </funcsynopsis> <para> - <function>ibase_pconnect</function> acts very much like - <function>ibase_connect</function> with two major differences. - First, when connecting, the function will first try to find a - (persistent) link that's already opened with the same parameters. - If one is found, an identifier for it will be returned instead of - opening a new connection. Second, the connection to the InterBase - server will not be closed when the execution of the script ends. - Instead, the link will remain open for future use - (<function>ibase_close</function> will not close links established - by <function>ibase_pconnect</function>). This type of link is - therefore called 'persistent'. + <function>ibase_pconnect</function> agisce in modo molto simile a + <function>ibase_connect</function> con due differenze principali. + Innanzitutto, durante la connessione, la funzione cercherà prima di trovare un + collegamento (persistente) che è già stato aperto con gli stessi parametri. + Se viene trovato, il suo identificatore verrà restituito al posto di aprire + una nuova connessione. In secondo luogo, la connessione al server InterBase + non verrà chiusa al termine dell'esecuzione dello script. + Invece, il collegamento resterà aperto per un uso futuro + (<function>ibase_close</function> non chiuderà i collegamenti stabiliti + da <function>ibase_pconnect</function>). Questo tipo di collegamento è + perciò chiamato 'persistente'. </para> <para> - See also <function>ibase_connect</function> for the meaning of - parameters passed to this function. They are exactly the same. + Vedere anche <function>ibase_connect</function> per il significato dei parametri + passati a questa funzione. Sono esattamente gli stessi. </para> </refsect1> </refentry> @@ -171,11 +161,11 @@ <refnamediv> <refname>ibase_close</refname> <refpurpose> - Close a connection to an InterBase database + Chiude una connessione ad un database InterBase </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ibase_close</function></funcdef> @@ -185,11 +175,11 @@ </funcprototype> </funcsynopsis> <para> - Closes the link to an InterBase database that's associated with - a connection id returned from <function>ibase_connect</function>. - If the connection id is omitted, the last opened link is assumed. - Default transaction on link is committed, other transactions are - rolled back. + Chiude il collegamento ad un database InterBase che è stato associato con + un id di connessione restituito da <function>ibase_connect</function>. + Se l'id di connessione viene omesso, viene considerato l'ultimo collegamento che è stato aperto. + La transazione predefinita sul collegamento viene "committed", le altre transazioni vengono + "rolled back". </para> </refsect1> </refentry> @@ -197,10 +187,10 @@ <refentry id="function.ibase-query"> <refnamediv> <refname>ibase_query</refname> - <refpurpose>Execute a query on an InterBase database</refpurpose> + <refpurpose>Esegue una query su di un database InterBase</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ibase_query</function></funcdef> @@ -216,18 +206,18 @@ </funcprototype> </funcsynopsis> <simpara> - Performs a query on an InterBase database, returning a result - identifier for use with <function>ibase_fetch_row</function>, + Esegue una query su di un database InterBase, restituendo un identificatore di + result da usare con <function>ibase_fetch_row</function>, <function>ibase_fetch_object</function>, - <function>ibase_free_result</function> and + <function>ibase_free_result</function> e <function>ibase_free_query</function>. </simpara> <note> <para> - Although this function supports variable binding to parameter - placeholders, there is not very much meaning using this capability - with it. For real life use and an example, see - <function>ibase_prepare</function> and + Sebbene questa funzione supporti il binding di variabile sui "segnaposto" + dei parametri, non ha molto senso usare questa possibilità con essa. + Per un uso reale e un esempio, vedere + <function>ibase_prepare</function> e <function>ibase_execute</function>. </para> </note> @@ -237,10 +227,10 @@ <refentry id="function.ibase-fetch-row"> <refnamediv> <refname>ibase_fetch_row</refname> - <refpurpose>Fetch a row from an InterBase database</refpurpose> + <refpurpose>Elabora una riga da un database InterBase</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>array <function>ibase_fetch_row</function></funcdef> @@ -250,8 +240,8 @@ </funcprototype> </funcsynopsis> <simpara> - Returns the next row specified by the result identifier obtained - using the <function>ibase_query</function>. + Restituisce la riga successiva specificata dell'identificatore di result ottenuto + usando <function>ibase_query</function>. </simpara> </refsect1> </refentry> @@ -259,10 +249,10 @@ <refentry id="function.ibase-fetch-object"> <refnamediv> <refname>ibase_fetch_object</refname> - <refpurpose>Get an object from a InterBase database</refpurpose> + <refpurpose>Ottiene un oggetto da un database InterBase</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>object <function>ibase_fetch_object</function></funcdef> @@ -272,9 +262,9 @@ </funcprototype> </funcsynopsis> <para> - Fetches a row as a pseudo-object from a - <parameter>result_id</parameter> obtained either by - <function>ibase_query</function> or + Elabora una riga come un pseudo-oggetto da un + <parameter>result_id</parameter> ottenuto o da + <function>ibase_query</function> o da <function>ibase_execute</function>. <informalexample> <programlisting role="php"> @@ -291,7 +281,7 @@ </informalexample> </para> <para> - See also <function>ibase_fetch_row</function>. + Vedere anche <function>ibase_fetch_row</function>. </para> </refsect1> </refentry> @@ -299,10 +289,10 @@ <refentry id="function.ibase-free-result"> <refnamediv> <refname>ibase_free_result</refname> - <refpurpose>Free a result set</refpurpose> + <refpurpose>Libera la memoria allocata da un result set</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ibase_free_result</function></funcdef> @@ -312,7 +302,7 @@ </funcprototype> </funcsynopsis> <simpara> - Free's a result set the has been created by + Libera un result set che è stato creato da <function>ibase_query</function>. </simpara> </refsect1> @@ -322,12 +312,12 @@ <refnamediv> <refname>ibase_prepare</refname> <refpurpose> - Prepare a query for later binding of parameter placeholders and - execution + Prepara una query per un successivo binding dei segnaposto dei parametri ed + esecuzione </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ibase_prepare</function></funcdef> @@ -338,8 +328,8 @@ </funcprototype> </funcsynopsis> <simpara> - Prepare a query for later binding of parameter placeholders and - execution (via <function>ibase_execute</function>). + Prepara una query per un successivo binding dei segnaposto dei parametri ed + esecuzione (tramite <function>ibase_execute</function>). </simpara> </refsect1> </refentry> @@ -347,10 +337,10 @@ <refentry id="function.ibase-execute"> <refnamediv> <refname>ibase_execute</refname> - <refpurpose>Execute a previously prepared query</refpurpose> + <refpurpose>Esegue una query preparata in precedenza</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ibase_execute</function></funcdef> @@ -363,10 +353,10 @@ </funcprototype> </funcsynopsis> <para> - Execute a query prepared by <function>ibase_prepare</function>. - This is a lot more effective than using <function>ibase_query</function> - if you are repeating a same kind of query several times with only - some parameters changing. + Esegue una query preparata da <function>ibase_prepare</function>. + Ciò è molto più efficace che usare <function>ibase_query</function> + se state ripetendo uno stesso tipo di query molte volte cambiando solo + alcuni parametri. <informalexample> <programlisting role="php"> &lt;?php @@ -392,11 +382,11 @@ <refnamediv> <refname>ibase_free_query</refname> <refpurpose> - Free memory allocated by a prepared query + Libera la memoria allocata da una query preparata </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ibase_free_query</function></funcdef> @@ -406,7 +396,7 @@ </funcprototype> </funcsynopsis> <simpara> - Free a query prepared by <function>ibase_prepare</function>. + Libera la memoria allocata da una query preparata da <function>ibase_prepare</function>. </simpara> </refsect1> </refentry> @@ -415,11 +405,11 @@ <refnamediv> <refname>ibase_timefmt</refname> <refpurpose> - Sets the format of timestamp, date and time type columns returned from queries + Imposta il formato delle colonne timestamp, date e time restituite dalle query </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ibase_timefmt</function></funcdef> @@ -432,39 +422,39 @@ </funcprototype> </funcsynopsis> <para> - Sets the format of timestamp, date or time type columns returned - from queries. Internally, the columns are formatted by c-function - strftime(), so refer to it's documentation regarding to the format - of the string. <parameter>columntype</parameter> is one of the - constants IBASE_TIMESTAMP, IBASE_DATE and IBASE_TIME. If omitted, - defaults to IBASE_TIMESTAMP for backwards compatibility. + Imposta il formato delle colonne di tipo timestamp, date o time restituite + dalle query. Internamente, le colonne vengono formattate dalla funzione C + strftime(), quindi fate riferimento alla sua documentazione riguardo al formato della + stringa. <parameter>columntype</parameter> è una delle costanti + IBASE_TIMESTAMP, IBASE_DATE e IBASE_TIME. Se omessa, + è predefinita a IBASE_TIMESTAMP per motivi di compatibilità con il passato. <informalexample> <programlisting role="php"> &lt;?php - // InterBase 6 TIME-type columns will be returned in - // the form '05 hours 37 minutes'. + // Le colonne di tipo TIME di InterBase vengono restituite nella + // forma '05 hours 37 minutes'. ibase_timefmt("%H hours %M minutes", IBASE_TIME); ?> </programlisting> </informalexample> </para> <para> - You can also set defaults for these formats with PHP configuration - directives ibase.timestampformat, ibase.dateformat and ibase.timeformat. + Potete impostare anche valori predefiniti per questi formati con la direttiva di configurazione + ibase.timestampformat, ibase.dateformat e ibase.timeformat. </para> <note> <para> - <parameter>columntype</parameter> was added in PHP 4.0. It has any - meaning only with InterBase version 6 and higher. + <parameter>columntype</parameter> è stata aggiunta in PHP 4.0. Ha significato + solo con InterBase versione 6 e successive. </para> </note> <note> <para> - A backwards incompatible change happened in PHP 4.0 when PHP - configuration directive ibase.timeformat was renamed to - ibase.timestampformat and directives ibase.dateformat and - ibase.timeformat were added, so that the names would match better - their functionality. + Un'incompatibilità con il passato si è avuta nel PHP 4.0 quando la direttiva di configurazione del PHP + ibase.timeformat è stata rinominata in + ibase.timestampformat e la direttiva ibase.dateformat e + ibase.timeformat sono state aggiunte, così che i loro nomi fossero più simili + alle loro funzionalità. </para> </note> </refsect1> @@ -474,11 +464,11 @@ <refnamediv> <refname>ibase_num_fields</refname> <refpurpose> - Get the number of fields in a result set + Ottiene il numero di campi in un result set </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ibase_num_fields</function></funcdef> @@ -486,7 +476,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an integer containing the number of fields in a result + Restituisce un integer contenente il numero di campi in un result set. <informalexample> <programlisting role="php"> @@ -500,7 +490,7 @@ print $row->email . "\n"; } } else { - die ("No Results were found for your query"); + die ("Nessun result è stato trovato per la tua query"); } ibase_close ($dbh); @@ -509,11 +499,11 @@ </informalexample> </para> <para> - See also: <function>ibase_field_info</function>. + Vedere anche: <function>ibase_field_info</function>. </para> <note> <para> - <function>Ibase_num_fields</function> is currently not functional + <function>Ibase_num_fields</function> è attualmente non funzionante in PHP 4. </para> </note>