1 Vienuma atslēgas formāts

Vienuma atslēgas formātam, tostarp atslēgas parametriem, jāatbilst sintakses noteikumiem. Tālāk redzamajās ilustrācijās ir attēlota atbalstītā sintakse. Atļautos elementus un rakstzīmes katrā punktā var noteikt, sekojot bultiņām — ja kādu bloku var sasniegt pa līniju, tas ir atļauts, ja ne — tas nav atļauts.

Lai izveidotu derīgu vienuma atslēgu, vispirms jānorāda atslēgas nosaukums, pēc tam var izvēlēties, vai izmantot parametrus vai neizmantot tos — kā parādīts ar divām līnijām, kurām var sekot.

Atslēgas nosaukums

Pašam atslēgas nosaukumam ir ierobežots atļauto rakstzīmju diapazons, kuras vienkārši seko cita citai. Atļautās rakstzīmes ir:

0-9a-zA-Z_-.

Tas nozīmē:

  • visi cipari;
  • visi mazie burti;
  • visi lielie burti;
  • pasvītrojuma zīme;
  • defise;
  • punkts.

Atslēgas parametri

Vienuma atslēgai var būt vairāki parametri, kas ir atdalīti ar komatiem.

Katrs atslēgas parametrs var būt vai nu pēdiņās ievietota virkne, virkne bez pēdiņām vai masīvs.

Parametru var arī atstāt tukšu, tādējādi izmantojot noklusējuma vērtību. Šādā gadījumā ir jāpievieno atbilstošs komatu skaits, ja ir norādīti vēl citi parametri. Piemēram, vienuma atslēga icmpping[,,200,,500] norāda, ka intervāls starp atsevišķiem ping pieprasījumiem ir 200 milisekundes, noildze — 500 milisekundes, bet visiem pārējiem parametriem tiek izmantotas to noklusējuma vērtības.

Parametros ir iespējams iekļaut makrosus. Tie var būt lietotāja makrosi vai daži no iebūvētajiem makrosiem. Lai redzētu, kuri konkrētie iebūvētie makrosi tiek atbalstīti vienuma atslēgas parametros, lapā Atbalstītie makrosi meklējiet "item key parameters".

Parametrs — pēdiņās ietverta virkne

Ja atslēgas parametrs ir pēdiņās ietverta virkne, ir atļauta jebkura Unicode rakstzīme. Ja atslēgas parametra virkne satur pēdiņu, šim parametram jābūt ietvertam pēdiņās, un katra pēdiņa, kas ir parametra virknes daļa, ir jāekranē ar slīpsvītras (\) rakstzīmi. Ja atslēgas parametra virkne satur komatu, šim parametram jābūt ietvertam pēdiņās.

Lai liktu vienums atslēgas parametrus pēdiņās, izmantojiet tikai dubultpēdiņas. Vienkāršās pēdiņas netiek atbalstītas.

Daudzlīmeņu parametru masīvi, piemēram, [a,[b,[c,d]],e], nav atļauti.

Parametrs — neievietota virkne pēdiņās

Ja atslēgas parametrs ir virkne bez pēdiņām, ir atļauta jebkura Unicode rakstzīme, izņemot komatu un labo kvadrātiekavu (]). Parametrs bez pēdiņām nedrīkst sākties ar kreiso kvadrātiekavu ([).

Parametrs - masīvs

Ja atslēgas parametrs ir masīvs, tas atkal tiek ietverts kvadrātiekavās, kur atsevišķi parametri tiek norādīti saskaņā ar vairāku parametru norādīšanas noteikumiem un sintaksi.