Řídicí výrazy

Přehled

SP-Lang nabízí celou řadu řídicích výrazů.

• !IF: Jednoduché podmíněné větvení.
• !WHEN: Silné větvení.
• !MATCH: Porovnávání vzorů.
• !TRY: Provádění do prvního bezchybného výrazu.
• !FOR: Aplikace výrazu na každou položku v posloupnosti.

---

!IF

Jednoduché podmíněné větvení.

Typ: Mapping.

Výraz !IF je rozhodovací výraz, který vede vyhodnocení k rozhodování na základě zadaného testu.

!IF
test: <expression>
then: <expression>
else: <expression>

Na základě hodnoty test se vyhodnotí větev:

• then v případě test !EQ true
• else v případě test !EQ false

Oba případy then a else musejí vracet stejný typ, který bude zároveň typem návratové hodnoty !IF.

Example

!IF
test:
  !EQ
  - !ARG input
  - 2
then:
  Je to dva.
else:
  Není to dva.

---

!WHEN

Silné větvení.

Typ: Sequence.

Výraz !WHEN je podstatně silnější než výraz !IF. Jednotlivé případy mohou odpovídat mnoha různým vzorům, včetně intervalových shod, tuples atd.

!WHEN
- test: <expression>
  then: <expression>

- test: <expression>
  then: <expression>

- test: <expression>
  then: <expression>

- ...

- else: <expression>

Pokud není zadáno else, pak !WHEN vrací None (chyba).

Example

Příklad použití !WHEN pro přesnou shodu, shodu rozsahu a nastavenou shodu:

!WHEN

# Přesná shoda hodnot
- test:
    !EQ
    - !ARG key
    - 34
  then:
    "třicet čtyři"

# Shoda rozsahu
- test:
    !LT
    - 40
    - !ARG key
    - 50
  then:
    "čtyřicet až padesát (bez krajních hodnot)"

# In-set match
- test:
    !IN
    what: !ARG key
    where:
      - 75
      - 77
      - 79
  then:
    "sedmdesát pět, sedm, devět"

- else:
    "neznámý"

---

!MATCH

Porovnávání vzorů.

Typ: Mapping.

!MATCH
what: <what-expression>
with:
  <value>: <expression>
  <value>: <expression>
  ...
else:
  <expression>

Výraz !MATCH vyhodnotí výraz what-expression, přiřadí hodnotu výrazu k klauzuli case a provede výraz expression spojený s tímto případem.

Větev else výrazu !MATCH je nepovinná. Výraz selže s chybou, pokud není nalezena žádná odpovídající <value> a větev else chybí.

Example

!MATCH
what: !ARG value
with:
    1: "jedna"
    2: "dva"
    3: "tři"
else:
    "jiné číslo"

Použití !MATCH pro strukturování kódu

!MATCH
what: !ARG kód
with:
    1: !INCLUDE code-1.yaml
    2: !INCLUDE code-2.yaml
else:
    !INCLUDE code-else.yaml

---

!TRY

Provádění do prvního bezchybného výrazu.

Typ: Sequence

!TRY
- <expression>
- <expression>
- <expression>
...

Iteruje jednotlivými výrazy (odshora dolů), pokud výraz vrátí nenulový výsledek (None), zastaví iteraci a vrátí tuto hodnotu. V opačném případě pokračuje k dalšímu výrazu.

Při dosažení konce seznamu vrátí None (chyba).

Poznámka: !FIRST je zastaralý alias pro !TRY a je stále podporován.

---

!FOR

Aplikuje výraz na každou položku v posloupnosti.

Typ: Mapping.

!FOR
each: <posloupnost>
do: <výraz>

Vrací seznam s výsledkem vyhodnocení do pro každou položku z each.

Aktuální položka z each není předána do do jako argument.