Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

asm — déclaration d’assembleur

Le mot-clé asm introduit une déclaration généralement utilisée pour transmettre du texte à un assembleur. Sa prise en charge est conditionnelle et sa signification dépend de l’implémentation ; ce n’est donc pas un moyen portable d’exécuter des instructions du processeur.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

asm ( string-literal ) ;

asm introduit une déclaration d’assembleur, et non un appel de fonction. En C++23, la forme de base est asm ( string-literal ) ; ; le point-virgule est obligatoire. Cette déclaration peut notamment apparaître dans un bloc de fonction ou dans la portée d’un espace de noms.

Cette construction est prise en charge sous condition : une implémentation n’est pas tenue de la prendre en charge. Ses restrictions et sa signification dépendent de l’implémentation. En général, le texte est transmis à un assembleur, mais ISO C++ ne définit ni jeu d’instructions portable ni mécanisme permettant d’accéder aux variables C++ depuis ce texte.

Ne considérez pas la syntaxe d’un compilateur pour les opérandes, les registres ou les listes de clobbers comme une syntaxe C++23 universelle. En pratique, consultez la documentation du compilateur et de la plateforme cible concernés. L’emploi de asm à lui seul ne constitue pas une barrière de synchronisation portable.

L’exemple utilise asm("") uniquement en supposant que l’implémentation accepte un fragment d’assembleur vide sans effet à l’exécution. Dans ce cas, la sortie attendue est Reached suivi d’un saut de ligne. Il ne s’agit ni d’une garantie de la norme ni du résultat d’un test rapporté.

La source fournie est un projet de travail en évolution, et non un texte C++23 figé ; elle présente actuellement la syntaxe plus générale balanced-token-seq. Ne transposez pas automatiquement cette différence au mode C++23. Un indicateur de compilation dans le dépôt n’atteste pas du fonctionnement dans un environnement de production.

Exemples

#include <iostream>

int main() {
    asm("");
    std::cout << "Reached\n";
}

Résultat

Reached

La cohérence de la sortie attendue avec le code a été vérifiée sous l’hypothèse décrite ci-dessus. Cela ne signifie pas que le programme a été exécuté.

Sources