You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
718 lines
13 KiB
718 lines
13 KiB
<?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>
|