README

NLLang is een speelse programmeertaal met Nederlandse sleutelwoorden, geschreven in PHP.

⚠️ Waarschuwing: NLLang is gebouwd voor kinderen, nieuwsgierige geesten en mensen die te veel Nederlandse koffie hebben gedronken. Gebruik het niet in productie — tenzij je baas ook Nederlands spreekt en geen idee heeft wat hij doet.

Installatie

Vereisten: PHP 8.0 of hoger en Composer.

composer global require aagjalpankaj/nllang

Eenmalige instelling: Zorg dat Composer's globale bin-map in je $PATH staat. Voeg dit toe aan ~/.zshrc of ~/.bashrc:

export PATH="$PATH:$(composer global config bin-dir --absolute)"

Herlaad je shell daarna met source ~/.zshrc. Als je dit al eerder hebt gedaan voor een ander globaal Composer-pakket, is deze stap niet nodig.

Gebruik

Maak een nieuw bestand aan (test.nl)

Bewerk het bestand in een teksteditor.

hoi
  zeg "Hoi, wereld!";
doei

Uitvoeren

nllang test.nl

Uitvoer

Hoi, wereld!

Documentatie

Algemeen

hoi is het beginpunt van een programma en elk programma moet eindigen met doei. Alles buiten deze blokken wordt genegeerd.

Dit wordt genegeerd

hoi
  // Schrijf hier je code
doei

Dit ook

Variabelen

Variabelen worden gedeclareerd met stel. Meerdere variabelen kunnen in één statement worden gedeclareerd.

hoi
  stel a = 10;
  stel b = "twee";
  stel c = 15;
  stel d, e = 5, f;
  a = a + 1;
  b = 21;
  c *= 2;
doei

Typen

Getallen en teksten werken zoals in andere talen. Lege waarden worden aangeduid met niets. waar en onwaar zijn de booleaanse waarden.

hoi
  stel a = 10;
  stel b = 10 + (15 * 20);
  stel c = "tekst";
  stel d = 'ook tekst';
  stel e = 3.14;
  stel f = niets;
  stel g = waar;
  stel h = onwaar;
doei

Ingebouwde functies

Gebruik zeg om iets af te drukken. Meerdere waarden worden gescheiden door een spatie.

hoi
  zeg "Hoi, wereld!";
  stel a = 10;
  {
    stel b = 20;
    zeg a + b;
  }
  zeg 5, 'ok', niets, waar, onwaar;
doei

Hoi, wereld!
30
5 ok niets waar onwaar

Bewerkingen

NLLang ondersteunt de gebruikelijke rekenkundige en vergelijkingsoperatoren. Strings worden samengevoegd met +.

hoi
  stel a = 10, b = 3;

  zeg a + b;   // 13
  zeg a - b;   // 7
  zeg a * b;   // 30
  zeg a / b;   // 3.333...
  zeg a % b;   // 1

  zeg a == 10; // waar
  zeg a != b;  // waar
  zeg a > b;   // waar
  zeg a <= 10; // waar

  zeg "Neder" + "land"; // Nederland

  a += 5;
  b *= 2;
  zeg a, b;
doei

Voorwaarden

NLLang ondersteunt als/anders als/anders constructies. Het als blok wordt uitgevoerd als de voorwaarde waar is, anders wordt een anders als blok uitgevoerd als de bijbehorende voorwaarde waar is, en het anders blok wordt uitgevoerd als alle voorwaarden onwaar zijn.

hoi
  stel score = 75;

  als (score >= 90) {
    zeg "Uitstekend!";
  } anders als (score >= 70) {
    zeg "Goed gedaan!";
  } anders als (score >= 50) {
    zeg "Voldoende.";
  } anders {
    zeg "Onvoldoende.";
  }
doei

Goed gedaan!

Lussen

Statements in een zolang blok worden herhaald zolang de voorwaarde waar is. Gebruik stop om de lus te verlaten en verder om naar de volgende iteratie te gaan.

hoi
  stel i = 0;
  zolang (i < 10) {
    i += 1;
    als (i == 5) {
      zeg "Vijf! Doorgaan...";
      verder;
    }
    als (i == 8) {
      zeg "Stop bij acht.";
      stop;
    }
    zeg i;
  }
  zeg "Klaar!";
doei

1
2
3
4
Vijf! Doorgaan...
6
7
Stop bij acht.
Klaar!

Scoping

Variabelen leven in het blok waarin ze zijn gedeclareerd. Een binnenste blok kan variabelen van buiten lezen, maar kan ze ook overschaduwen met een nieuwe declaratie.

hoi
  stel x = 5;
  {
    stel x = 99;
    zeg x; // 99
  }
  zeg x; // 5
doei

Commentaar

Gebruik // voor regelcommentaar en /* */ voor blokcommentaar.

hoi
  // Dit is een regelcommentaar
  stel a = 10; // ook hier

  /*
    Dit is
    blokcommentaar
  */
  zeg a;
doei

Sleutelwoordenlijst

Voorbeelden

Bekijk de map examples/ voor kant-en-klare voorbeeldprogramma's:

• hallo.nl — Hallo wereld
• rekenen.nl — Rekenkundige bewerkingen
• keuze.nl — Voorwaarden en scoping
• teller.nl — Lussen en Fibonacci