Specialvärden och inbyggda globala variabler
Specialvärden och inbyggda globala variabler
Specialvärden är funktioner som behandlas av &kommander;. Du bör vara medveten om att när den gamla tolken används, utförs alla &kommander; specialvärden först och därefter körs skriptet. I det flesta fall är det inte något problem, men i några enstaka fall (särskilt i snurror och villkor) kan det vara det.
Listan nedan kan vara något föråldrad. Du rekommenderas att använda funktionsbläddraren för att få hjälp om tillgängliga funktioner. Funktionsbläddraren kan nås inne i editorn Kommander Text, genom att klicka på knappen Funktion....
@dcop(pgmId, objekt, funktion, argument)
Gör ett &DCOP;-anrop, @dcop(kmail
, KMailIface
, checkMail()
,
)
@dcopid
&DCOP;-id för processen (kmdr-executor-@pid)
@dialog(dialogruta[,parametrar])
Startar angiven Kommander dialogruta. Dialogrutan letas efter i katalogen med dialogrutor och i arbetskatalogen, i den ordningen. Det här lägger till anropet till Executor i början och ändrar standardkatalog till den som Kommander programmet finns i. Parametrar kan skickas som vanligt i Unix, eller så kan namngivna parametrar som variabel=värde
skickas. Därefter hittar du skickade parametrar i den globala uppsättningen. @global(variabel) skulle returnera värde
.
@env(miljövariabel)
Ersätts med den angivna miljövariabeln. @env(PWD) ersätts med $PWD. Kom ihåg att $
ingår i skalet, och ska inte användas.
@exec(kommando)
Returnerar utmatningen från körningen av det angivna kommandot. @exec(ls -l).
@execBegin ... @execEnd
Samma som @exec, men stöder inledning med "#!" och skript med flera rader. Det fungerar med diverse skriptspråk antingen genom att deklarera dem eller genom att använda "#!".
@execBegin(php)
@execBegin(#!/usr/bin/php)
Det första exemplet använder namnet på det körbara programmet PHP. &kommander; söker i PATH efter php och om det inte hittas kontrollerar om det är registrerat i &kommander; på en plats som inte finns i sökvägen. Om inte får användaren reda på att det inte kan hittas. Det andra exemplet använder den klassiska inledningen !#
, som både kan ha fördelar men också problem. Om du till exempel har en betaversion av PHP5 i /usr/local/bin hittas den inte eftersom en annan hittas i /usr/bin, är det användbart. Om du dock distribuerar dialogrutan till någon som bara har PHP i /usr/local/bin hittas den inte med inledningen som används. Alltså varnas för att använda en inledning, och det rekommenderas att använda det körbara namnet om du delar filer.
@global(variabel)
Ersätts med värdet på den angivna globala variabeln.
@null
Returnerar null. Nu när Kommander kontrollerar om widgetText är tom vid körning, förhindrar detta felaktiga fel med fallet då en grafisk komponent har ett tillstånd som inte är angivet.
@parentPid
Process-id för överliggande process.
@pid
Process-id för processen.
@readSetting(nyckel, förvalt värde)
Läser ett värde från kommanderrc. Se också @writeSetting.
@selectedWidgetText
Det markerade innehållet i en grafisk komponent som kan visa mer än ett värde, som listkomponenter.
@setGlobal(variabel, värde)
Tilldelar den globala variabeln det angivna värdet.
@widgetText
Innehållet i en grafisk komponent.
@writeSetting(nyckel, värde)
Skriv värde till kommanderrc. Alla &kommander;-dialogrutor delar samma kommanderrc-fil, och var och en har sin egen sektion i den.
Fältfunktionsgruppen
@Array.values(fält)
Returnerar en lista åtskild med nyrader med alla värden i fältet. Kan användas för att gå igenom ett fält.
@Array.keys(fält)
Returnerar en lista med alla nycklar i fältet åtskilda med nyrader.
@Array.setValue(fält, nyckel, värde)
Anger en nyckel och värde för ett element i ett fält. Om fältet inte finns, skapas det.
@Array.clear(fält)
Ta bort alla element från fältet.
@Array.count(fält)
Returnera antal element i fältet.
@Array.value(fält,nyckel)
Returnera värdet som hör ihop med den givna nyckeln.
@Array.remove(fält,nyckel)
Ta bort elementet med den givna nyckeln från fältet.
@Array.fromString(fält,sträng)
Lägger till alla element i strängen till fältet. Strängen ska har formatet nyckel\tvärde\n.
@Array.toString(fält,sträng)
Returnerar alla element i fältet på formatet nyckel\tvärde\n.
Filfunktionsgruppen
@File.read(fil)
Returnera innehållet i den givna filen.
@File.write(fil,sträng)
Skriv given sträng till en fil.
@File.append(fil,sträng)
Skriv given sträng i slutet på en fil.
Strängfunktionsgruppen
@String.length(sträng)
Returnera antalet tecken i strängen.
@String.contains(sträng,delsträng)
Kontrollera om strängen innehåller en given delsträng.
@String.find(sträng)
Returnera en delsträngs position i strängen, eller -1 om den inte hittas.
Det här kommer att ha ett valfritt heltal med startposition, för användning för att söka igen i version alfa 6.
@String.left(sträng, heltal)
Returnerar de första n tecknen i strängen.
@String.right(sträng, heltal)
Returnerar de sista n tecknen i strängen.
@String.mid(sträng, heltal start, heltal slut)
Returnerar en delsträng av strängen, med början på angiven position.
@String.remove(sträng, delsträng)
Ta bort alla förekomster av en given delsträng.
@String.replace(sträng, delsträng sök, delsträng ersätt)
Ersätt alla förekomster av en given delsträng med en given ersättning.
@String.upper(sträng)
Konvertera strängen till stora bokstäver.
@String.lower(sträng)
Konvertera strängen till små bokstäver.
@String.compare(sträng, sträng)
Jämför två strängar. Returnera 0 om de är lika, -1 om den första är tidigare, 1 om den första är senare.
@String.isEmpty(sträng)
Kontrollera om strängen är tom.
@String.isNumber(sträng)
Kontrollera om strängen är ett giltigt tal.
Inbyggda globala variabler
Inbyggda globala variabler kan kommas åt precis som vanliga globala variabler med @global.
@global(_KDDIR)
Katalogen den nuvarande dialogrutan är i.
@global(_NAME)
Dialogrutans namn