0Pricing
Assembly Language & x86 Low-Level Systems Programming · Leçon

Appeler l’assembleur depuis C

Apprenez à intégrer des routines assembleur à des projets C/C++, à transmettre des paramètres et à recevoir des valeurs de retour conformément aux conventions d’appel.

Appeler l’assembleur depuis C est une leçon Assembly Language & x86 Low-Level Systems Programming gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Assembly Language & x86 Low-Level Systems Programming, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Assembly Language & x86 Low-Level Systems Programming comprend 4 leçons au total.

Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.

Why C Needs Assembly

Why would you mix C/C++ and Assembly? It might seem old-fashioned, but there are powerful reasons!

  • Performance: For critical code sections, hand-optimized assembly can be faster than compiler-generated code.
  • Hardware Access: Interact directly with hardware features not exposed by C/C++.
  • Specific Instructions: Use special CPU instructions (e.g., for cryptography or multimedia) directly.
  • Legacy Code: Integrate with existing assembly routines or operating system components.

It allows you to get the "best of both worlds" – C's high-level structure with assembly's low-level power.

The Calling Contract

When C calls an assembly function, they need to agree on a "contract" for how things work. This contract is called a calling convention.

It defines:

  • How arguments are passed (registers or stack).
  • Who cleans up the stack after the call.
  • Which registers the called function must preserve.

For modern 64-bit Linux/macOS systems, the System V AMD64 ABI is standard. We'll focus on this.

Assembly's Public Face

To make an assembly function callable from C, you need to declare it as global. This tells the linker that the function can be accessed from other files.

The basic structure looks like this:

  • Use the global directive.
  • Define your function with a label (often prefixed with an underscore, like _my_function, though not strictly required by System V ABI, it's a common practice).
  • Include your assembly instructions.
  • End with a ret instruction to return control to the caller.
section .text
global _my_function
_my_function:
    ; Your assembly code here
    ret

C's View of Assembly

From the C side, an assembly function is just like any other function defined elsewhere. You declare it using the extern keyword.

The function prototype in C must exactly match what the assembly function expects in terms of arguments and return type.

For example, if your assembly function takes two long integers and returns a long, your C prototype would be: extern long my_assembly_func(long a, long b);

extern long my_assembly_func(long a, long b);

Sending Data to Assembly

Under the System V AMD64 ABI, the first six integer or pointer arguments are passed via specific registers:

  • 1st argument: RDI
  • 2nd argument: RSI
  • 3rd argument: RDX
  • 4th argument: RCX
  • 5th argument: R8
  • 6th argument: R9

Any additional arguments are pushed onto the stack from right to left.

Getting Results Back

When your assembly function finishes, it places its return value into a specific register so C can retrieve it.

  • For integer or pointer return values, use the RAX register.
  • For floating-point values, use the XMM0 register.

After placing the result, the assembly function simply executes ret to jump back to the C code that called it.

Add Numbers: C Calls Assembly (ASM)

Let's create an assembly function to add two numbers. This file would typically be named my_add.asm.

Pay attention to how arguments are received in RDI and RSI, and the result is placed in RAX.

; my_add.asm
section .text
global add_two_numbers

add_two_numbers:
    ; RDI holds the first argument (a)
    ; RSI holds the second argument (b)
    mov rax, rdi    ; Move 'a' into RAX
    add rax, rsi    ; Add 'b' to RAX (RAX = a + b)
    ret             ; Return to caller (RAX holds the result)

Add Numbers: C Calls Assembly (C)

Now, let's write the C code that uses our assembly function. This file would typically be named main.c. Remember to declare it with extern.

To compile and link:

nasm -f elf64 my_add.asm -o my_add.o

gcc main.c my_add.o -o my_program

./my_program

// main.c
#include <stdio.h>

// Declare the assembly function
extern long add_two_numbers(long a, long b);

int main() {
    long num1 = 10;
    long num2 = 25;
    long sum;

    // Call the assembly function
    sum = add_two_numbers(num1, num2);

    printf("The sum of %ld and %ld is %ld\n", num1, num2, sum);

    return 0;
}

Protecting Registers

When your assembly function runs, it might use various registers. Some registers are caller-saved (caller must save them if it needs them later), and others are callee-saved (the assembly function must save and restore them if it modifies them).

Common callee-saved registers (x64): RBX, RBP, RSP, R12, R13, R14, R15.

If your assembly function modifies a callee-saved register, you must PUSH its value at the start and POP it back before returning.

_my_function_with_preservation:
    push rbx      ; Save RBX
    ; ... use RBX ...
    pop rbx       ; Restore RBX
    ret

Quick Check

Based on the System V AMD64 ABI, which register would typically hold the third integer argument passed to an assembly function from C?

Recap: Bridging C & Assembly

Great job! You've learned the fundamentals of calling assembly code from C.

  • We understood why you'd link C and assembly.
  • We explored calling conventions, focusing on the System V AMD64 ABI.
  • You saw how to declare functions on both the assembly and C sides.
  • You learned how arguments are passed (registers) and return values are received (RAX).
  • We touched upon register preservation rules to avoid unexpected side effects.

This skill is vital for low-level optimization and system interaction!

Questions Fréquemment Posées

La leçon « Appeler l’assembleur depuis C » est-elle gratuite ?

Oui — le texte complet de « Appeler l’assembleur depuis C » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Assembly Language & x86 Low-Level Systems Programming, passe à CoddyKit PRO. Le cours Assembly Language & x86 Low-Level Systems Programming comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Appeler l’assembleur depuis C » ?

Apprenez à intégrer des routines assembleur à des projets C/C++, à transmettre des paramètres et à recevoir des valeurs de retour conformément aux conventions d’appel. Tu pratiques Assembly Language & x86 Low-Level Systems Programming avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Assembly Language & x86 Low-Level Systems Programming ?

Aucune expérience préalable n'est requise. Assembly Language & x86 Low-Level Systems Programming sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « Appeler l’assembleur depuis C » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Assembly Language & x86 Low-Level Systems Programming ?

Oui. Chaque leçon Assembly Language & x86 Low-Level Systems Programming inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Appeler l’assembleur depuis C
  2. Appeler C depuis l’assembleur
  3. Techniques de programmation multilingue
  4. Conventions d’appel : cdecl, stdcall et System V
← Retour à Assembly Language & x86 Low-Level Systems Programming