diff options
Diffstat (limited to 'tde-i18n-it/docs/tdewebdev/kommander/specials.docbook')
| -rw-r--r-- | tde-i18n-it/docs/tdewebdev/kommander/specials.docbook | 717 |
1 files changed, 717 insertions, 0 deletions
diff --git a/tde-i18n-it/docs/tdewebdev/kommander/specials.docbook b/tde-i18n-it/docs/tdewebdev/kommander/specials.docbook new file mode 100644 index 00000000000..bdcd25f2a06 --- /dev/null +++ b/tde-i18n-it/docs/tdewebdev/kommander/specials.docbook @@ -0,0 +1,717 @@ +<?xml version="1.0" encoding="UTF-8" ?> + +<sect1 id="specials"> +<sect1info> +<title +>Comandi Speciali e Variabili Globali Integrate</title> +<authorgroup> +<author +><firstname +></firstname +> <surname +></surname +> <affiliation +><address +> <email +></email> +</address +></affiliation> +</author> + +<othercredit role="translator" +><firstname +>Samuele</firstname +><surname +>Kaplun</surname +><affiliation +><address +><email +>kaplun@aliceposta.it</email +></address +></affiliation +><contrib +>Traduzione del documento</contrib +></othercredit +> + +</authorgroup> +</sect1info> + +<title +>Comandi Speciali e Variabili Globali Integrate</title> + +<para +>I comandi speciali sono funzioni che vengono processate da &kommander;. Sappi che fino a quando &kommander; non avrà un parser completo tutti i comandi speciali saranno eseguiti prima che venga eseguito lo script. In molti casi questo non è un problema, ma talvolta sì. </para> + +<variablelist> +<varlistentry> +<term +><function +>@dcop(<parameter +>appId</parameter +>, <parameter +>oggetto</parameter +>, <parameter +>funzione</parameter +>, <parameter +>argomenti</parameter +>)</function +></term> +<listitem> +<para +>Esegue una chiamata a &DCOP;. @dcop(<quote +>kmail</quote +>, <quote +>KMailIface</quote +>, <quote +>checkMail()</quote +>, <quote +></quote +>) </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@dcopid</function +></term> +<listitem> +<para +>L'id &DCOP; del processo (kmdr-executor-@pid) </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@dialog(<parameter +>finestra_di_dialogo</parameter +>[,<parameter +>parametri</parameter +>])</function +></term> +<listitem> +<para +>Richiama la finestra di dialogo di Kommander specificata. Le finestre di dialogo sono ricercate nella cartella delle finestre di dialogo e nella cartella corrente - in quest'ordine. Ciò mette in sospeso la chiamata all'esecutore ed imposta la cartella predefinita a quella in cui si trova l'applicazione di Kommander. I parametri possono essere passati nell'usuale maniera Unix o puoi passare dei parametri per nome come in <quote +>variabile=valore</quote +>. Puoi infine recuperare i parametri passati nell'ambiente globale. @global(variabile) ritornerebbe <quote +>valore</quote +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@env(<parameter +>variabileDiAmbiente</parameter +>)</function +></term> +<listitem> +<para +>Viene espanso alla variabile d'ambiente specificata. @env(PWD) viene espanso a $PWD. Ricorda che <quote +>$</quote +> è parte della sintassi shell e non dovrebbe essere utilizzato. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@exec(<parameter +>comando</parameter +>)</function +></term> +<listitem> +<para +>restituisce l'output dell'esecuzione del comando specificato. @exec(ls -l). </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@execBegin ... @execEnd</function +></term> +<listitem> +<para +>come in <function +>@exec</function +>, ma supporta gli script shebang (cioè che cominciano, ad esempio, con #!/bin/sh) e su più righe. Questo è utile in diversi linguaggi di scripting sia dichiarandoli o utilizzando una shebang. </para> +<itemizedlist> +<listitem +><para +><function +>@execBegin(php)</function +></para +></listitem> +<listitem +><para +><function +>@execBegin</function +>#!/usr/bin/php</para +></listitem> +</itemizedlist> +<para +>Il primo utilizza il nome dell'eseguibile <acronym +>PHP</acronym +>. &kommander; cerca nel PATH <application +>php</application +> e se non lo trova verifica se è registrato con &kommander; in una posizione al di fuori del tuo path. Se non è così notifica all'utente che non può essere trovato. Il secondo esempio utilizza la classica <quote +>shebang</quote +> che può portare sia benefici che alcuni problemi. È utile ad esempio, se possiedi una copia beta di <acronym +>PHP5</acronym +> in <filename +>/usr/local/bin</filename +> che non deve essere trovata perché il percorso di ricerca è <filename +>/usr/bin</filename +>. Se, però, distribuisce la finestra di dialogo a qualcuno che ha messo <acronym +>PHP</acronym +> in <filename +>/usr/local/bin</filename +> questo non verrà trovato quando verrà usata la shebang. Perciò utilizzate le shebang con cautela. È invece raccomandato indicare l'eseguibile se condividete i file.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@global(<parameter +>variabile</parameter +>)</function +></term> +<listitem> +<para +>viene espanso nel valore della variabile globale specificata. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@null</function +></term> +<listitem> +<para +>Restituisce null. Ora che Kommander verifica i widget vuoti durante l'esecuzione questo comando preverrà la segnalazione errata di errori nel caso della non impostazione dello stato di un widget.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@parentPid</function +></term> +<listitem> +<para +>Il &PID; del processo genitore. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@pid</function +></term> +<listitem> +<para +>Il &PID; del processo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@readSetting(<parameter +>chiave</parameter +>, <parameter +>valorePredefinito</parameter +>)</function +></term> +<listitem> +<para +>legge un valore da <filename +>kommanderrc</filename +> </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@selectedWidgetText</function +></term> +<listitem> +<para +>il contenuto selezionato di un widget che può visualizzare più di un valore, come i widget lista </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@setGlobal(<parameter +>variabile</parameter +>, <parameter +>valore</parameter +>)</function +></term> +<listitem> +<para +>Imposta la variabile globale al valore specificato. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@widgetText</function +></term> +<listitem> +<para +>il contenuto di un widget </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@writeSetting(<parameter +>chiave</parameter +>, <parameter +>valore</parameter +>)</function +></term> +<listitem> +<para +>scrive il valore in <filename +>kommanderrc</filename +> </para> +</listitem> +</varlistentry> +</variablelist> + +<sect2 id="arrays"> +<title +>Gruppo delle Funzioni per Array</title> + +<variablelist> +<varlistentry> +<term +><function +>@Array.values(<parameter +>array</parameter +>)</function +></term> +<listitem> +<para +>Restituisce una lista separata da EOL di tutti i valori contenuti nell'array. Può essere utilizzato per scorrere attraverso l'array.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.keys(<parameter +>array</parameter +>)</function +></term> +<listitem> +<para +>Restituisce un elenco separato da fine riga (EOL) di tutte le chiavi del vettore.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.setValue(<parameter +>array</parameter +>, <parameter +>chiave</parameter +>, <parameter +>valore</parameter +>)</function +></term> +<listitem> +<para +>Imposta una chiave ed un valore per un elemento di un array. Se l'array non esiste, viene creato.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.clear(<parameter +>array</parameter +>)</function +></term> +<listitem> +<para +>Rimuove tutti gli elementi dal vettore.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.count(<parameter +>array</parameter +>)</function +></term> +<listitem> +<para +>Restituisce il numero di elementi nel vettore.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.value(<parameter +>array</parameter +>,<parameter +>chiave</parameter +>)</function +></term> +<listitem> +<para +>Restituisce il valore associato alla chiave indicata.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.remove(<parameter +>array</parameter +>,<parameter +>chiave</parameter +>)</function +></term> +<listitem> +<para +>Rimuove l'elemento con la chiave indicata dall'array.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.fromString(<parameter +>array</parameter +>,<parameter +>stringa</parameter +>)</function +></term> +<listitem> +<para +>Aggiunge tutti gli elementi nella stringa nell'array. La stringa dovrebbe essere nel formato <emphasis +>chiave\tvalore\n</emphasis +>."</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.toString(<parameter +>array</parameter +>,<parameter +>stringa</parameter +>)</function +></term> +<listitem> +<para +>Restituisce tutti gli elementi nell'array nel formato <emphasis +>chiave\t\n</emphasis +>."</para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="files"> +<title +>Gruppo di Funzioni per File</title> +<variablelist> + +<varlistentry> +<term +><function +>@File.read(<parameter +>file</parameter +>)</function +></term> +<listitem> +<para +>Restituisce il contenuto del file indicato.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@File.write(<parameter +>file</parameter +><parameter +>stringa</parameter +>)</function +></term> +<listitem> +<para +>Scrive la stringa data su un file.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@File.append(<parameter +>file</parameter +><parameter +>stringa</parameter +>)</function +></term> +<listitem> +<para +>Aggiunge la stringa data alla fine del file.</para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="strings"> +<title +>Gruppo di Funzioni per Stringhe</title> +<variablelist> + +<varlistentry> +<term +><function +>@String.length(<parameter +>stringa</parameter +>)</function +></term> +<listitem> +<para +>Restituisce il numero di caratteri nella stringa.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.contains(<parameter +>stringa</parameter +>,<parameter +>sottostringa</parameter +>)</function +></term> +<listitem> +<para +>Controlla se la stringa contiene la sottostringa data.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.find(<parameter +>stringa</parameter +>)</function +></term> +<listitem> +<para +>Restituisce la posizione di una sottostringa nella stringa, o -1 se non trovata."</para> +<note +><para +>Questo comando avrà un altro parametro intero opzionale indicante la posizione iniziale da cui cercare nella versione Alpha 6.</para +></note> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.left(<parameter +>stringa</parameter +>, <parameter +>int</parameter +>)</function +></term> +<listitem> +<para +>Restituisce i primi n caratteri della stringa.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.right(<parameter +>stringa</parameter +>, <parameter +>int</parameter +>)</function +></term> +<listitem> +<para +>Restituisce gli ultimi n caratteri della stringa.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.mid(<parameter +>stringa</parameter +>, <parameter +>int inizio</parameter +>, <parameter +>int fine</parameter +>)</function +></term> +<listitem> +<para +>Restituisce una sottostringa della stringa, iniziando dalla posizione data.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.remove(<parameter +>stringa</parameter +>, <parameter +>sottostringa</parameter +>)</function +></term> +<listitem> +<para +>Rimuove tutte le occorrenze di una data sottostringa.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.replace(<parameter +>stringa</parameter +>, <parameter +>sottostringa_trova</parameter +>, <parameter +>sottostringa_sostituisci</parameter +>)</function +></term> +<listitem> +<para +>Sostituisce tutte le occorrenze di una data sottostringa con un'altra fornita.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.upper(<parameter +>stringa</parameter +>)</function +></term> +<listitem> +<para +>Converte la stringa in maiuscolo.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.lower(<parameter +>stringa</parameter +>)</function +></term> +<listitem> +<para +>Converte la stringa in minuscolo.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.compare(<parameter +>stringa</parameter +>, <parameter +>stringa</parameter +>)</function +></term> +<listitem> +<para +>Confronta due stringhe. Restituisce 0 se sono uguali, -1 se la prima è più bassa, 1 se la prima è più alta</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.isEmpty(<parameter +>stringa</parameter +>)</function +></term> +<listitem> +<para +>Controlla se la stringa è vuota.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.isNumber(<parameter +>stringa</parameter +>)</function +></term> +<listitem> +<para +>Controlla se la stringa è un numero valido.</para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="builtins"> +<title +>Variabili Globali Integrate</title> +<para +>L'accesso alle variabili globali integrate è analogo alle variabili globali regolari con <function +>@global</function +>.</para> +<variablelist> +<varlistentry> +<term +><function +>@global(_KDDIR)</function +></term> +<listitem> +<para +>La cartella in cui si trova la finestra di dialogo corrente.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><function +>@global(_NAME)</function +></term> +<listitem +><para +>Il nome della finestra di dialogo</para +></listitem> +</varlistentry> +</variablelist> +</sect2> + +</sect1> |