<?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>