Aller au contenu principal

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​

TypeDescriptionExemples
bsBitstream 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​

SujetIntroduction rapideDétails complets
TypesCette pageTypes et valeurs
OpérateursOpérateurs — référence complèteNotes de conception — fondement
MémoireCette pageGestion de la mémoire
IntégrésCette pageFonctions intégrées et E/S
GrammaireAperçu de la grammaireRéférence de la grammaire