Notes de conception
Raml est conçu autour d'un contrôle explicite et précis des données au niveau du bit, avec un minimum de surcouche d'abstraction. Cette page documente le fondement des décisions de conception clés.
Principes fondamentaux
Types basés sur les bits
Tous les types scalaires utilisent le type bs (bitstream), qui fournit un stockage de largeur dynamique avec une conversion automatique en entier. Cela simplifie le système de types tout en maintenant la flexibilité pour la programmation système.
Syntaxe basée sur l'indentation
Les blocs sont définis par l'indentation plutôt que par des accolades. Cela élimine le bruit visuel et impose un formatage cohérent.
Gestion manuelle de la mémoire
Pas de garbage collector. make, @, # et free donnent un contrôle direct sur l'allocation et la libération.
Syntaxe séparée par des espaces
Raml évite les parenthèses, virgules et accolades pour les appels de fonction. Les arguments sont toujours séparés par des espaces :
len s // pas len(s)
min a b // pas min(a, b)
c = make counter 0 // pas make(counter, 0)
Cette conception élimine l'ambiguïté d'analyse et maintient la grammaire simple.
Conception des niveaux d'expressions
Raml utilise trois niveaux d'expressions pour résoudre une ambiguïté fondamentale d'analyse.
Le problème
Sans restrictions, les arguments d'appels de méthodes pourraient absorber les opérateurs suivants :
b:get move != 0
Cela pourrait être analysé comme :
(board_get(&b, move)) != 0— comparer la valeur de retour (prévu)board_get(&b, (move != 0))— passer la comparaison comme argument (imprévu)
La solution : trois niveaux
| Niveau | Règle | Permet les comparaisons ? | Utilisé dans |
|---|---|---|---|
| Complet | expr | Oui | Affectations, conditions, while, expressions autonomes |
| Éléments | exprItem | Oui | Instructions print, expressions pipe |
| Restreint | simpleExprItem | Non | Arguments d'appels de méthodes/fonctions |
Solution de contournement
Calculez d'abord la comparaison, ou utilisez le groupement :: :
is_occupied = b:get move != 0
if is_occupied:
print "occupé"
if ::b:get move != 0:::
print "occupé"
Définition formelle
Les trois niveaux forment une hiérarchie stricte où doubleColonExpr (::expr::) fournit une échappatoire pour les comparaisons dans des contextes d'expressions restreintes.
Switch vs Switchloop
switch est un branchement unique : une fois qu'un cas correspond et s'exécute, le contrôle quitte le bloc switch.
switchloop enveloppe le switch dans une boucle do { } while(0), permettant à continue de réévaluer la condition du switch.
Différence de génération de code :
| Construction | Sortie C |
|---|---|
switch | switch (expr) { case N: ... break; } |
switchloop | do { switch (expr) { case N: ... continue; } } while(0) |
Auto-conversion des bitstreams
Le type bs (bitstream) est dynamique et contient des données de longueur variable. Quand il est passé comme argument à des méthodes ou fonctions attendant des types numériques fixes, une conversion automatique en uint32_t est effectuée via raml_bs_to_uint32().
Logique de conversion :
bs_t → est-ce un intégré qui attend bs ? (load, len, print)
→ Oui : passer bs_t directement
→ Non : envelopper avec raml_bs_to_uint32(bs)
Exclus : load, len, print.
Localisation des mots-clés
Raml supporte les mots-clés non-anglais via des fichiers keywords.raml.lang.
Plongée : Comment fonctionne la localisation
- Découverte du fichier : Au démarrage, l'interpréteur cherche
keywords.raml.langdans le répertoire du fichier source, puis remonte les répertoires parents jusqu'à en trouver un. - Analyse du fichier de mapping : Chaque ligne
'mot-clé_anglais' | 'mot-clé_localisé'définit un mapping bidirectionnel. - Transformation de la source : Avant que l'analyseur lexical ANTLR ne s'exécute, toutes les occurrences des mots-clés localisés dans la source sont remplacées par leurs équivalents anglais.
- L'analyseur voit l'anglais : La grammaire et l'analyseur sont inchangés — seule l'entrée de l'analyseur lexical est modifiée.
Cette conception signifie :
- Aucun changement de grammaire nécessaire pour de nouvelles langues
- Le même fichier
.rmlpeut être écrit dans n'importe quelle langue supportée - Les sources multilingues sont possibles (bien que déconseillées)
- Les messages d'erreur et représentations internes utilisent toujours les mots-clés anglais
Pourquoi des arguments séparés par des espaces ?
- Grammaire plus simple : Pas besoin de distinguer
f(a, b)def (a, b). - Pas d'ambiguïté avec le groupement : Les parenthèses peuvent être réservées pour le groupement explicite si nécessaire à l'avenir.
- Cohérent avec le reste de la syntaxe : L'affectation multi-champs
:f1 f2 f3:, les listesfree n1 n2 n3, et les appels de méthodes->c:inc 5utilisent tous le même motif séparé par des espaces. - L'indentation comme groupement : Les listes d'arguments sur plusieurs lignes utilisent l'indentation (via la syntaxe pipe
|), pas les parenthèses.
Disposition mémoire des objets
Les objets (structures) en Raml sont mappés directement aux structs C :
counter:
value
functions:
inc:
in: step
value += step
Devient :
typedef struct { uint32_t value; } counter_t;
void counter_inc(counter_t* self, uint32_t step) {
self->value += step;
}
Décisions de conception clés :
- Le pointeur
selfest implicite — toujours le premier paramètre dans les fonctions C générées. - Les méthodes qui ne modifient pas l'état reçoivent
const counter_t* self. - Les champs sont toujours accédés via la struct.
- La disposition de la struct suit les règles de l'ABI C pour une compatibilité maximale.
Héritage de conception de C
| Concept | Raml | C |
|---|---|---|
| Address-of | @x | &x |
| Déréférencement | *p | *p |
| Arithmétique de pointeurs | p += n | p += n |
| Accès struct (direct) | obj:field | obj.field |
| Accès struct (pointeur) | ptr:field | ptr->field |
| Alloc tas | make T args auto | malloc + init |
| Libération | free p | free(p) |