CUDA Academy · Lekcja

Wielokrotnego użytku makro CUDA_CHECK

Opakowywać każde wywołanie dla bezpieczeństwa.

Lekcja 3 z 413 kroki

Wielokrotnego użytku makro CUDA_CHECK to bezpłatna lekcja CUDA Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej CUDA Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs CUDA Academy zawiera 4 lekcji w sumie.

Sprawdzanie każdego wywołania jest uciążliwe

Dodawanie instrukcji if po każdym wywołaniu CUDA szybko zaśmieca kod. Wielokrotnego użytku makro CUDA_CHECK rozwiązuje ten problem jednym przejrzystym wierszem. 🧹

Cel makra

Makro powinno opakować dowolne wywołanie, pobrać jego kod zwrotny i wyraźnie zakończyć działanie w razie błędu. Jedno makro może robić to wszędzie.

CUDA_CHECK(cudaMalloc(&d, n));

Pobieranie wyniku

Wewnątrz makro zapisuje wynik wywołania w lokalnej zmiennej typu cudaError_t, aby można go było sprawdzić bez dwukrotnego wywoływania funkcji.

cudaError_t e = (call);

Porównanie z powodzeniem

Następnie sprawdza kod względem cudaSuccess. Jeśli wartości są równe, nic się nie dzieje i program działa dalej jak zwykle.

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

Wyświetlanie miejsca błędu

W razie błędu makro wyświetla czytelny komunikat z użyciem __FILE__ i __LINE__, dzięki czemu można od razu przejść do problematycznego wiersza.

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

Sztuczka do-while(0)

Ciało makra jest opakowane w do-while(0). Dzięki temu makro staje się pojedynczą instrukcją, która działa bezpiecznie nawet wewnątrz instrukcji if bez nawiasów klamrowych.

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

Pełny szkic makra

Po połączeniu wszystkich elementów otrzymujesz kompaktową, wielokrotnego użytku siatkę bezpieczeństwa, którą można wkleić do nagłówka dowolnego projektu CUDA.

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

Opakowywanie wywołań API

Używaj makra dla każdego wywołania zwracającego kod: cudaMalloc, cudaMemcpy i cudaFree. Jedno opakowanie chroni je wszystkie w jednolity sposób.

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

Zabezpiecz także uruchomienie

Jądra niczego nie zwracają, dlatego po uruchomieniu opakuj cudaGetLastError i synchronizację, zamiast opakowywać sam wiersz uruchomienia.

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

Przechowuj je w nagłówku

Umieść makro we wspólnym nagłówku, aby każdy plik korzystał z tego samego sprawdzenia. Spójność w tym miejscu oszczędza wiele godzin dezorientującego debugowania.

Kończ szybko i jasno

Największą zaletą jest szybkie kończenie działania po błędzie: gdy tylko wywołanie zawiedzie, otrzymujesz dokładny plik, wiersz i komunikat zamiast cichych bezwartościowych danych.

Szybka kontrola

Sprawdź, czy rozumie Pan/Pani działanie makra CUDA_CHECK.

Odpowiedz w interaktywnej lekcji

Podsumowanie: jedno makro chroni je wszystkie

Makro CUDA_CHECK pobiera kod, porównuje go z wartością oznaczającą powodzenie i w razie błędu wyświetla plik oraz wiersz. Zdefiniuj je raz i używaj wszędzie. 🎉

Bezpłatny start

Ucz się C++ dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy: 30
Lekcje: 120

Zacznij naukę bezpłatnie Wyświetl pełny kurs

Często zadawane pytania

Czy lekcja „Wielokrotnego użytku makro CUDA_CHECK” jest bezpłatna?

Tak — pełny tekst „Wielokrotnego użytku makro CUDA_CHECK” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu CUDA Academy, przejdź na CoddyKit PRO. Kurs CUDA Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Wielokrotnego użytku makro CUDA_CHECK”?

Opakowywać każde wywołanie dla bezpieczeństwa. Ćwiczysz CUDA Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć CUDA Academy?

Nie wymagamy żadnego doświadczenia. CUDA Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Wielokrotnego użytku makro CUDA_CHECK”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji CUDA Academy?

Tak. Każda lekcja CUDA Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do CUDA Academy