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.
704 lines
12 KiB
704 lines
12 KiB
<?xml version="1.0" encoding="UTF-8" ?>
|
|
|
|
<sect1 id="specials">
|
|
<sect1info>
|
|
<title
|
|
>Specielle og indbyggede globale variable</title>
|
|
<authorgroup>
|
|
<author
|
|
><firstname
|
|
></firstname
|
|
> <surname
|
|
></surname
|
|
> <affiliation
|
|
><address
|
|
> <email
|
|
></email>
|
|
</address
|
|
></affiliation>
|
|
</author>
|
|
|
|
&rune.laursen.role;
|
|
|
|
</authorgroup>
|
|
</sect1info>
|
|
|
|
<title
|
|
>Specielle og indbyggede globale variable</title>
|
|
|
|
<para
|
|
>Specielle er funktioner der behandles af &kommander;. Du skal være opmærksom på at indtil &kommander; har en fuldstændig fortolker, vil alle specielle eksekveres først og derefter eksekveres scriptet. I de fleste tilfælde er dette ikke et problem, men somme tider opstår der problemer. </para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@dcop(<parameter
|
|
>appId</parameter
|
|
>, <parameter
|
|
>objekt</parameter
|
|
>, <parameter
|
|
>funktion</parameter
|
|
>, <parameter
|
|
>argumenter</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Lav et &DCOP;-kald. @DCOP(<quote
|
|
>kmail</quote
|
|
>, <quote
|
|
>KMailIface</quote
|
|
>, <quote
|
|
>checkMail()</quote
|
|
>, <quote
|
|
></quote
|
|
>) </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@dcopid</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Processens &DCOP;-ID (kmdr-executor-@pid) </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@dialog(<parameter
|
|
>dialog</parameter
|
|
>[,<parameter
|
|
>parametre</parameter
|
|
>])</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Starter den givne kommander-dialog. Dialogen søges i dialogkataloget og i det aktuelle katalog, i den rækkefølge. Dette kommer før kaldet til executoren og sætter standardkataloget til den Kommander-programmet findes i. Parametre kan overføres i sædvanlig UNIX-stil eller overføres som <quote
|
|
>variabel=værdi</quote
|
|
>. Du kan derefter finde overførte parametre i den globale samling. @global(variable) ville returnere <quote
|
|
>værdi</quote
|
|
>. </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@env(<parameter
|
|
>miljøVariabel</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Udvides til den givne miljøvariabel. @env(PWD) udvides til $PWD. Husk at <quote
|
|
>$</quote
|
|
> er en del af skallen og ikke må bruges. </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@exec(<parameter
|
|
>kommando</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>returnerer uddata ved eksekveringen af den givne kommando @exec(ls -l). </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@execBegin ... @execEnd</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>ligesom <function
|
|
>@exec</function
|
|
>, men understøtter shebang og multilinje scripter. Dette servicerer forskellige scriptsprog, enten ved at erklære dem eller ved at bruge en shebang. </para>
|
|
<itemizedlist>
|
|
<listitem
|
|
><para
|
|
><function
|
|
>@execBegin(php)</function
|
|
></para
|
|
></listitem>
|
|
<listitem
|
|
><para
|
|
><function
|
|
>@execBegin</function
|
|
>#!/usr/bin/php</para
|
|
></listitem>
|
|
</itemizedlist>
|
|
<para
|
|
>Den første bruger navnet på <acronym
|
|
>PHP</acronym
|
|
>-kørbare. &kommander; søger i PATH efter <application
|
|
>php</application
|
|
> og ser efter et sted uden din sti, om den er registreret i &kommander; hvis ikke den findes. Hvis ikke før den brugeren opmærksom på at den ikke blev fundet. Det andet eksempel bruger den klassiske <quote
|
|
>shebang</quote
|
|
> som kan have nogle fordele og problemer. Hvis du har en betaudgave af <acronym
|
|
>PHP5</acronym
|
|
> i f.eks. <filename
|
|
>/usr/local/bin</filename
|
|
> som ikke ville blive fundet fordi der søges i <filename
|
|
>/usr/bin</filename
|
|
> er dette brugbart. Hvis du derimod distribuerer dialogen til en som kun har <acronym
|
|
>PHP</acronym
|
|
> i <filename
|
|
>/usr/local/bin</filename
|
|
> ville den ikke blive fundet når der bruges en shebang. Så at bruge shebang skal tages med forbehold og det anbefales at bruge den eksekverbare hvis du deler filer.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@global(<parameter
|
|
>variabel</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>udvides til værdien af den givne globale variabel. </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@null</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Returnerer null. Nu da Kommander undersøger for tom widgetText på kørselstidspunktet, forebygger dette, fejlagtige fejl hvis en kontrol har en tilstand der ikke er sat.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@parentPid</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Forældreprocessens &PID;. </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@pid</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Processens &PID;. </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@readSetting(<parameter
|
|
>nøgle</parameter
|
|
>, <parameter
|
|
>standardVærdi</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>læser en værdi fra <filename
|
|
>kommanderrc</filename
|
|
> </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@selectedWidgetText</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>det markerede indhold i en kontrol som kan vise mere end en værdi, som listekontroller </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@setGlobal(<parameter
|
|
>variabel</parameter
|
|
>, <parameter
|
|
>værdi</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Sætter den globale variabel til den givne værdi. </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@widgetText</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>en kontrols indhold </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@writeSetting(<parameter
|
|
>nøgle</parameter
|
|
>, <parameter
|
|
>værdi</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>skriv værdi til <filename
|
|
>kommanderrc</filename
|
|
> </para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<sect2 id="arrays">
|
|
<title
|
|
>Array-funktionsgruppe</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@Array.values(<parameter
|
|
>array</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Returnerer EOL-adskilt liste af alle værdier i arrayet. Kan bruges til at gennemgå et array.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@Array.keys(<parameter
|
|
>array</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Returnerer en EOL-adskilt liste af alle nøgler i arrayet.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@Array.setValue(<parameter
|
|
>array</parameter
|
|
>, <parameter
|
|
>nøgle</parameter
|
|
>, <parameter
|
|
>værdi</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Sætter en nøgle og en værdi til et element i et array. Eksisterer der ikke et array i forvejen, oprettes der et.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@Array.clear(<parameter
|
|
>array</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Fjerner alle elementer i et array.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@Array.count(<parameter
|
|
>array</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Returnerer antallet af elementer i arrayet.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@Array.value(<parameter
|
|
>array</parameter
|
|
>,<parameter
|
|
>nøgle</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Returnerer værdie associeret med den givne nøgle.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@Array.remove(<parameter
|
|
>array</parameter
|
|
>,<parameter
|
|
>nøgle</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Fjern element med given nøgle fra arrayet.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@Array.fromString(<parameter
|
|
>array</parameter
|
|
>,<parameter
|
|
>streng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Tilføjer alle elementer i strengen til arrayet. Strengen skal have formatet:<emphasis
|
|
>nøgle\tværdi\n</emphasis
|
|
>."</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@Array.toString(<parameter
|
|
>array</parameter
|
|
>,<parameter
|
|
>streng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>"Returnerer alle elementer i array i <emphasis
|
|
>nøgle\tværdi\n</emphasis
|
|
> format."</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</sect2>
|
|
|
|
<sect2 id="files">
|
|
<title
|
|
>Filfunktionsgruppe</title>
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@File.read(<parameter
|
|
>fil</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Returnerer indhold af den givne fil.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@File.write(<parameter
|
|
>fil</parameter
|
|
><parameter
|
|
>streng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Skriv given streng til en fil.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@File.append(<parameter
|
|
>fil</parameter
|
|
><parameter
|
|
>streng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Tilføj given streng til slutningen af en fil.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</sect2>
|
|
|
|
<sect2 id="strings">
|
|
<title
|
|
>Strengfunktionsgruppe</title>
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.length(<parameter
|
|
>streng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Returnerer antal tegn i strengen.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.contains(<parameter
|
|
>streng</parameter
|
|
>,<parameter
|
|
>understreng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Undersøger om strengen indeholder den givne understreng.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.find(<parameter
|
|
>streng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Returnerer en understrengs position i strengen eller -1 hvis den ikke findes."</para>
|
|
<note
|
|
><para
|
|
>Dette får en valgfri startposition angivet med et heltal til søgning efter næste, i alfa 6.</para
|
|
></note>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.left(<parameter
|
|
>streng</parameter
|
|
>, <parameter
|
|
>heltalt</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Returnerer første n tegn i strengen.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.right(<parameter
|
|
>streng</parameter
|
|
>, <parameter
|
|
>heltal</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Returnerer sidste n tegn i strengen.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.mid(<parameter
|
|
>streng</parameter
|
|
>, <parameter
|
|
>heltal startposition</parameter
|
|
>, <parameter
|
|
>heltal slutposition</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Returnerer strengens understreng, begynder fra given position.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.remove(<parameter
|
|
>streng</parameter
|
|
>, <parameter
|
|
>understreng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Fjerner alle forekomster af den givne understreng.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.replace(<parameter
|
|
>streng</parameter
|
|
>, <parameter
|
|
>understreng find</parameter
|
|
>, <parameter
|
|
>understreng erstat</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Erstatter alle forekomster af en given understreng med den givne erstatningsstreng.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.upper(<parameter
|
|
>streng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Konverterer strengen til store bogstaver.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.lower(<parameter
|
|
>streng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Konverterer strengen til små bogstaver.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.compare(<parameter
|
|
>streng</parameter
|
|
>, <parameter
|
|
>streng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Sammenligner to strenge. Returnerer 0, hvis de er ens, -1 hvis den første er mindst, 1 hvis den første er størst.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.isEmpty(<parameter
|
|
>streng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Undersøger om strengen er tom.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@String.isNumber(<parameter
|
|
>streng</parameter
|
|
>)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Undersøger om strengen er et gyldigt tal.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</sect2>
|
|
|
|
<sect2 id="builtins">
|
|
<title
|
|
>Indbyggede globale</title>
|
|
<para
|
|
>Indbyggede globale tilgås ligesom almindelige globale variable med <function
|
|
>@global</function
|
|
>.</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@global(_KDDIR)</function
|
|
></term>
|
|
<listitem>
|
|
<para
|
|
>Katalogen den aktuelle dialog er i.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term
|
|
><function
|
|
>@global(_NAME)</function
|
|
></term>
|
|
<listitem
|
|
><para
|
|
>Navnet på dialogen</para
|
|
></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</sect2>
|
|
|
|
</sect1>
|