Specielle og indbyggede globale variable
&rune.laursen.role;
Specielle og indbyggede globale variable
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.
@dcop(appId, objekt, funktion, argumenter)
Lav et &DCOP;-kald. @DCOP(kmail
, KMailIface
, checkMail()
,
)
@dcopid
Processens &DCOP;-ID (kmdr-executor-@pid)
@dialog(dialog[,parametre])
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 variabel=værdi
. Du kan derefter finde overførte parametre i den globale samling. @global(variable) ville returnere værdi
.
@env(miljøVariabel)
Udvides til den givne miljøvariabel. @env(PWD) udvides til $PWD. Husk at $
er en del af skallen og ikke må bruges.
@exec(kommando)
returnerer uddata ved eksekveringen af den givne kommando @exec(ls -l).
@execBegin ... @execEnd
ligesom @exec, men understøtter shebang og multilinje scripter. Dette servicerer forskellige scriptsprog, enten ved at erklære dem eller ved at bruge en shebang.
@execBegin(php)
@execBegin#!/usr/bin/php
Den første bruger navnet på PHP-kørbare. &kommander; søger i PATH efter php 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 shebang
som kan have nogle fordele og problemer. Hvis du har en betaudgave af PHP5 i f.eks. /usr/local/bin som ikke ville blive fundet fordi der søges i /usr/bin er dette brugbart. Hvis du derimod distribuerer dialogen til en som kun har PHP i /usr/local/bin 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.
@global(variabel)
udvides til værdien af den givne globale variabel.
@null
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.
@parentPid
Forældreprocessens &PID;.
@pid
Processens &PID;.
@readSetting(nøgle, standardVærdi)
læser en værdi fra kommanderrc
@selectedWidgetText
det markerede indhold i en kontrol som kan vise mere end en værdi, som listekontroller
@setGlobal(variabel, værdi)
Sætter den globale variabel til den givne værdi.
@widgetText
en kontrols indhold
@writeSetting(nøgle, værdi)
skriv værdi til kommanderrc
Array-funktionsgruppe
@Array.values(array)
Returnerer EOL-adskilt liste af alle værdier i arrayet. Kan bruges til at gennemgå et array.
@Array.keys(array)
Returnerer en EOL-adskilt liste af alle nøgler i arrayet.
@Array.setValue(array, nøgle, værdi)
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.
@Array.clear(array)
Fjerner alle elementer i et array.
@Array.count(array)
Returnerer antallet af elementer i arrayet.
@Array.value(array,nøgle)
Returnerer værdie associeret med den givne nøgle.
@Array.remove(array,nøgle)
Fjern element med given nøgle fra arrayet.
@Array.fromString(array,streng)
Tilføjer alle elementer i strengen til arrayet. Strengen skal have formatet:nøgle\tværdi\n."
@Array.toString(array,streng)
"Returnerer alle elementer i array i nøgle\tværdi\n format."
Filfunktionsgruppe
@File.read(fil)
Returnerer indhold af den givne fil.
@File.write(filstreng)
Skriv given streng til en fil.
@File.append(filstreng)
Tilføj given streng til slutningen af en fil.
Strengfunktionsgruppe
@String.length(streng)
Returnerer antal tegn i strengen.
@String.contains(streng,understreng)
Undersøger om strengen indeholder den givne understreng.
@String.find(streng)
Returnerer en understrengs position i strengen eller -1 hvis den ikke findes."
Dette får en valgfri startposition angivet med et heltal til søgning efter næste, i alfa 6.
@String.left(streng, heltalt)
Returnerer første n tegn i strengen.
@String.right(streng, heltal)
Returnerer sidste n tegn i strengen.
@String.mid(streng, heltal startposition, heltal slutposition)
Returnerer strengens understreng, begynder fra given position.
@String.remove(streng, understreng)
Fjerner alle forekomster af den givne understreng.
@String.replace(streng, understreng find, understreng erstat)
Erstatter alle forekomster af en given understreng med den givne erstatningsstreng.
@String.upper(streng)
Konverterer strengen til store bogstaver.
@String.lower(streng)
Konverterer strengen til små bogstaver.
@String.compare(streng, streng)
Sammenligner to strenge. Returnerer 0, hvis de er ens, -1 hvis den første er mindst, 1 hvis den første er størst.
@String.isEmpty(streng)
Undersøger om strengen er tom.
@String.isNumber(streng)
Undersøger om strengen er et gyldigt tal.
Indbyggede globale
Indbyggede globale tilgås ligesom almindelige globale variable med @global.
@global(_KDDIR)
Katalogen den aktuelle dialog er i.
@global(_NAME)
Navnet på dialogen