Assembly Language & x86 Low-Level Systems Programming · レッスン

Cからアセンブリを呼び出す

呼び出し規約を使ってパラメーターを渡し、戻り値を受け取ることで、アセンブリルーチンをC/C++プロジェクトに統合する方法を学びます。

レッスン 1/411 ステップ

「Cからアセンブリを呼び出す」はCoddyKit上の無料Assembly Language & x86 Low-Level Systems Programmingレッスンです。 これはレッスン1/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはAssembly Language & x86 Low-Level Systems Programming学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Assembly Language & x86 Low-Level Systems Programmingコースには全4レッスンが含まれています。

このレッスンの一部はまだ翻訳されておらず、英語で表示されています。

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!

無料で開始

AI チューターと学ぶ Assembly — 無料

ブラウザでリアルコードを書いて実行し、24/7 の AI チューターから瞬時にサポートを受け、ウェブまたはアプリで続きから学習できます。

コース
12
レッスン
48

よくある質問

「Cからアセンブリを呼び出す」レッスンは無料ですか?

はい。「Cからアセンブリを呼び出す」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し(組み込みコードエディタと24時間対応のAIチューター)、Assembly Language & x86 Low-Level Systems Programmingコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Assembly Language & x86 Low-Level Systems Programmingコースには全4レッスンが含まれています。

「Cからアセンブリを呼び出す」で何を学びますか?

呼び出し規約を使ってパラメーターを渡し、戻り値を受け取ることで、アセンブリルーチンをC/C++プロジェクトに統合する方法を学びます。 ブラウザで直接実行するハンズオンコードでAssembly Language & x86 Low-Level Systems Programmingを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Assembly Language & x86 Low-Level Systems Programmingを始めるのに経験は必要ですか?

事前経験は必要ありません。CoddyKitのAssembly Language & x86 Low-Level Systems Programmingは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン1/4です。

「Cからアセンブリを呼び出す」レッスンにはどのくらい時間がかかりますか?

ほとんどのCoddyKitレッスンは約5~10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このAssembly Language & x86 Low-Level Systems Programmingレッスンでコードを書いて実行できますか?

はい。すべてのAssembly Language & x86 Low-Level Systems Programmingレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. Cからアセンブリを呼び出す
  2. アセンブリからCを呼び出す
  3. 混在言語プログラミング技法
  4. 呼び出し規約:cdecl、stdcall、System V
← Assembly Language & x86 Low-Level Systems Programmingに戻る