CUDA Academy · Урок

Универсальный макрос CUDA_CHECK

Оборачивайте каждый вызов для повышения безопасности.

«Универсальный макрос CUDA_CHECK» — бесплатный урок CUDA Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения CUDA Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс CUDA Academy содержит 4 уроков всего.

Части этого урока еще не переведены и отображаются на английском.

Checking Every Call Is Tedious

Writing an if-statement after every CUDA call clutters your code fast. A reusable CUDA_CHECK macro fixes that with one clean line. 🧹

The Goal of the Macro

You want to wrap any call, grab its return code, and bail out loudly if it failed. One macro can do this everywhere.

CUDA_CHECK(cudaMalloc(&d, n));

Capturing the Result

Inside, the macro stores the call result in a local cudaError_t so it can be inspected once without calling twice.

cudaError_t e = (call);

Comparing to Success

It then tests the code against cudaSuccess. If they match, nothing happens and your program flows on as normal.

if (e != cudaSuccess) { /* report */ }

Printing Where It Failed

On failure it prints a readable message using __FILE__ and __LINE__, so you jump straight to the offending line.

printf("CUDA error %s at %s:%d\n", msg, __FILE__, __LINE__);

The do-while(0) Trick

The body is wrapped in a do-while(0). This makes the macro a single statement that works safely even inside an unbraced if.

#define CUDA_CHECK(c) do { /* ... */ } while(0)

A Full Macro Sketch

Put it together and you get a compact, reusable safety net you can paste into any CUDA project header.

#define CUDA_CHECK(c) do { cudaError_t e=(c); if(e) exit(1); } while(0)

Wrapping API Calls

Use it on any call that returns a code: cudaMalloc, cudaMemcpy, cudaFree. One wrapper guards them all uniformly.

CUDA_CHECK(cudaMemcpy(d, h, n, cudaMemcpyHostToDevice));

Also Guard the Launch

Kernels return nothing, so wrap cudaGetLastError and a sync after the launch instead of wrapping the launch line itself.

kernel<<<g, b>>>();
CUDA_CHECK(cudaGetLastError());

Keep It in a Header

Drop the macro in a shared header so every file uses the same check. Consistency here saves hours of confusing debugging.

Fail Fast, Fail Clearly

The big win is failing fast: the instant a call breaks, you get a precise file, line, and message instead of silent garbage.

Quick Check

Test your grasp of the CUDA_CHECK macro.

Recap: One Macro to Guard Them All

A CUDA_CHECK macro captures the code, compares to success, and prints file and line on failure. Define it once, use it everywhere. 🎉

Часто задаваемые вопросы

Урок «Универсальный макрос CUDA_CHECK» бесплатный?

Да — полный текст урока «Универсальный макрос CUDA_CHECK» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс CUDA Academy, подпишись на CoddyKit PRO. Курс CUDA Academy содержит 4 уроков всего.

Чему я научусь в уроке «Универсальный макрос CUDA_CHECK»?

Оборачивайте каждый вызов для повышения безопасности. Ты практикуешь CUDA Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать CUDA Academy?

Предыдущий опыт не требуется. CUDA Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.

Сколько времени занимает урок «Универсальный макрос CUDA_CHECK»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке CUDA Academy?

Да. Каждый урок CUDA Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к CUDA Academy