Guide du langage
Raml en un coup d'œil — syntaxe, structure, et aperçu des fonctionnalités. Cette page vous donne une vue d'ensemble. Suivez les liens vers les pages individuelles pour tous les détails.
Syntaxe
Les blocs commencent après : et sont définis par une indentation de 4 espaces. Les points-virgules sont optionnels. Les labels sont :name: et peuvent être ciblés par jump.
:start: // point d'entrée du programme
x = 5 // déclaration de variable
print x // sortie
Voir Aperçu de la grammaire pour la liste complète des instructions.
Types et valeurs
| Type | Description | Exemples |
|---|---|---|
bs | Bitstream dynamique (scalaire unique) | "hello", data = keyboard |
name# | Pointeur d'objet typé | node# np = @n |
Formes de déclaration :
x y z = 10 // types inférés : variables multiples
count = 5 // inféré : par défaut bs
value = 42 // inféré : par défaut bs
Littéraux : décimal (42), hexadécimal (0xFF), binaire (0b1010), chaînes simple/double/triple guillemets.
Voir Types et valeurs pour la référence complète.
Opérateurs
Table de précédence complète et référence des opérateurs →
result = (a + b) * c // arithmétique
masked = value & 0xFF // bitwise
in_range = ::x > 0:: && ::x < 10:: // comparaison + logique
Différence clé avec C : Les comparaisons dans les arguments de méthodes/fonctions nécessitent le groupement ::expr::.
Flux de contrôle
if condition:
stmt
orif condition2:
stmt
else:
stmt
while condition:
stmt
switch expr:
case 1:
stmt
default:
stmt
try:
stmt
catch:
stmt
:label:
jump :label:
Objets et méthodes
Les objets définissent des champs et des méthodes. Les méthodes utilisent la syntaxe ->receiver:method :
counter:
value
functions:
init:
in: start
value = start
inc:
in: step
value += step
:start:
c = make counter 0
->c:inc 5
Fonctionnalités :
- Objets imbriqués : blocs de champs indentés
- Méthodes externes : syntaxe
typeName:methodName: - Affectation multi-champs :
:f1 f2 f3: = value - Accès dynamique aux champs :
object:expr: - Vérification de plage de champs :
c:1..9: == 0: - Valeurs de retour : la dernière expression d'un corps de fonction/méthode est automatiquement retournée
Voir Mémoire pour les opérations sur les pointeurs d'objets.
Mémoire
n = make node 42 // allocation sur la pile
n = make node 42 auto // allocation sur le tas
@var // address-of
#ptr // déréférencement
free var // libération
Gestion manuelle de la mémoire — pas de garbage collector. Voir Mémoire pour le guide complet.
Fonctions intégrées et E/S
input = keyboard // lire stdin
print "x" x "y" y // sortie
save "f.bin" data // écriture fichier
data = load "f.bin" // lecture fichier
len s // longueur bitstream
abs -42 // valeur absolue
min 3 7 // minimum
max 3 7 // maximum
pow 2 8 // puissance
Voir Fonctions intégrées et E/S pour les détails, y compris la conversion automatique bs_t → uint32_t.
Commentaires
// une ligne
/* bloc */
… commentaire ellipse (ignoré)
Localisation des mots-clés
Raml supporte les mots-clés non-anglais via des fichiers keywords.raml.lang. Voir Mots-clés et localisation.
Référence rapide vs Plongées techniques
| Sujet | Introduction rapide | Détails complets |
|---|---|---|
| Types | Cette page | Types et valeurs |
| Opérateurs | Opérateurs — référence complète | Notes de conception — fondement |
| Mémoire | Cette page | Gestion de la mémoire |
| Intégrés | Cette page | Fonctions intégrées et E/S |
| Grammaire | Aperçu de la grammaire | Référence de la grammaire |