CUDA Academy · บทเรียน

มาโคร CUDA_CHECK ที่นำกลับมาใช้ซ้ำได้

ครอบทุกการเรียกใช้เพื่อความปลอดภัย

บทเรียน 3 จาก 413 ขั้นตอน

มาโคร CUDA_CHECK ที่นำกลับมาใช้ซ้ำได้ เป็นบทเรียน CUDA Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 3 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน CUDA Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส CUDA Academy มีบทเรียนทั้งหมด 4 บทเรียน

การตรวจสอบทุกการเรียกใช้นั้นน่าเบื่อ

การเขียนคำสั่ง if หลังการเรียกใช้ CUDA ทุกครั้งทำให้โค้ดรกอย่างรวดเร็ว มาโคร CUDA_CHECK ที่นำกลับมาใช้ใหม่ได้ช่วยแก้ปัญหานี้ด้วยบรรทัดเดียวที่สะอาดตา 🧹

เป้าหมายของมาโคร

คุณต้องการห่อหุ้มการเรียกใช้ใด ๆ รับ รหัสที่ส่งคืน ของมัน และหยุดการทำงานพร้อมรายงานอย่างชัดเจนหากเกิดความล้มเหลว มาโครเดียวก็ทำสิ่งนี้ได้ทุกที่

CUDA_CHECK(cudaMalloc(&d, n));

เก็บผลลัพธ์

ภายในมาโคร จะเก็บผลลัพธ์ของการเรียกใช้ไว้ในตัวแปรเฉพาะที่ชนิด cudaError_t เพื่อให้ตรวจสอบได้ครั้งเดียวโดยไม่ต้องเรียกใช้ซ้ำ

cudaError_t e = (call);

เปรียบเทียบกับค่าความสำเร็จ

จากนั้นมาโครจะตรวจสอบรหัสกับ cudaSuccess หากตรงกันก็จะไม่ทำอะไร และโปรแกรมจะทำงานต่อไปตามปกติ

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

พิมพ์ตำแหน่งที่เกิดความล้มเหลว

เมื่อเกิดความล้มเหลว มาโครจะพิมพ์ข้อความที่อ่านเข้าใจได้โดยใช้ __FILE__ และ __LINE__ เพื่อให้คุณไปยังบรรทัดที่ก่อปัญหาได้โดยตรง

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

เทคนิค do-while(0)

เนื้อหาของมาโครถูกห่อหุ้มด้วย do-while(0) วิธีนี้ทำให้มาโครเป็นคำสั่งเดียวที่ทำงานได้อย่างปลอดภัย แม้อยู่ภายใน if ที่ไม่มีวงเล็บปีกกา

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

โครงร่างมาโครฉบับเต็ม

เมื่อนำมาประกอบกัน คุณจะได้ ตาข่ายนิรภัย ที่กระชับและนำกลับมาใช้ใหม่ได้ ซึ่งสามารถวางไว้ในส่วนหัวของโปรเจกต์ CUDA ใดก็ได้

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

ห่อหุ้มการเรียกใช้ API

ใช้มาโครนี้กับการเรียกใช้ใด ๆ ที่ส่งคืนรหัส เช่น cudaMalloc, cudaMemcpy และ cudaFree ตัวห่อหุ้มเดียวจะป้องกันทั้งหมดในรูปแบบเดียวกัน

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

ป้องกันการเรียกใช้เคอร์เนลด้วย

เคอร์เนลไม่ส่งคืนค่า ดังนั้นให้ห่อหุ้ม cudaGetLastError และการรอให้เสร็จไว้หลังการเรียกใช้ แทนที่จะห่อหุ้มบรรทัดเรียกใช้เคอร์เนลโดยตรง

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

เก็บไว้ในส่วนหัว

ใส่มาโครไว้ใน ส่วนหัว ที่ใช้ร่วมกัน เพื่อให้ทุกไฟล์ใช้การตรวจสอบแบบเดียวกัน ความสม่ำเสมอในจุดนี้ช่วยประหยัดเวลาในการแก้ไขข้อผิดพลาดที่สับสนได้หลายชั่วโมง

หยุดเร็ว รายงานชัดเจน

ข้อดีสำคัญคือ หยุดทันทีเมื่อเกิดความล้มเหลว เมื่อการเรียกใช้ใดเสีย คุณจะได้รับไฟล์ บรรทัด และข้อความที่แม่นยำ แทนที่จะได้ข้อมูลขยะอย่างเงียบ ๆ

ตรวจสอบอย่างรวดเร็ว

ทดสอบความเข้าใจเกี่ยวกับมาโคร CUDA_CHECK

สรุป: มาโครเดียวป้องกันทุกการเรียกใช้

มาโคร CUDA_CHECK เก็บรหัสไว้ เปรียบเทียบกับค่าความสำเร็จ และพิมพ์ไฟล์กับบรรทัดเมื่อเกิดความล้มเหลว กำหนดมาโครครั้งเดียว แล้วใช้ได้ทุกที่ 🎉

เริ่มต้นได้ฟรี

เรียนรู้ C++ ด้วย AI tutor — ฟรี

เขียนและเรียกใช้โค้ดจริงในเบราว์เซอร์ของคุณ รับความช่วยเหลือทันทีจาก AI tutor 24/7 และเรียนรู้ต่อจากที่คุณหยุดบนเว็บหรือในแอป

คอร์ส
30
บทเรียน
120

คำถามที่พบบ่อย

บทเรียน “มาโคร CUDA_CHECK ที่นำกลับมาใช้ซ้ำได้” ฟรีหรือไม่

ใช่ — ข้อความเต็มของ “มาโคร CUDA_CHECK ที่นำกลับมาใช้ซ้ำได้” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส CUDA Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส CUDA Academy มีบทเรียนทั้งหมด 4 บทเรียน

คุณจะเรียนรู้อะไรในบทเรียน “มาโคร CUDA_CHECK ที่นำกลับมาใช้ซ้ำได้”

ครอบทุกการเรียกใช้เพื่อความปลอดภัย คุณปฏิบัติ CUDA Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 24/7 ตอบคำถามของคุณขณะที่คุณไปผ่านบทเรียน

คุณต้องมีประสบการณ์ก่อนที่จะเริ่มเรียน CUDA Academy หรือไม่

ไม่จำเป็นต้องมีประสบการณ์มาก่อน CUDA Academy บน CoddyKit ออกแบบมาสำหรับผู้เริ่มต้นไปจนถึงผู้เรียนขั้นสูง คุณสามารถเริ่มต้นที่นี่หรือเริ่มจากตัวแรกและเรียนด้วยความเร็วของคุณเอง นี่คือบทเรียนที่ 3 จากทั้งหมด 4 บทเรียน

บทเรียน “มาโคร CUDA_CHECK ที่นำกลับมาใช้ซ้ำได้” ใช้เวลานานแค่ไหน

บทเรียน CoddyKit ส่วนใหญ่ใช้เวลาประมาณ 5–10 นาที แต่ละบทเรียนจึงสั้นและเป็นแบบโต้ตอบ คุณสามารถก้าวหน้าอย่างต่อเนื่องและกลับมาเรียนต่อจากตรงที่เพิ่งหยุดบนเว็บและแอปได้เลย

ฉันเขียนและรันโค้ดในบทเรียน CUDA Academy นี้ได้ไหม

ได้ บทเรียน CUDA Academy ทุกบทมีตัวแก้ไขโค้ดในตัว คุณจึงเขียนและรันโค้ดจริงได้เลยในเบราว์เซอร์ และได้รับข้อเสนอแนะจาก AI ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ

บทเรียนทั้งหมดในหลักสูตรนี้

  1. รหัสส่งกลับเทียบกับข้อผิดพลาดแบบอะซิงโครนัส
  2. ใช้ cudaGetLastError หลังการเรียกใช้
  3. มาโคร CUDA_CHECK ที่นำกลับมาใช้ซ้ำได้
  4. ถอดรหัส cudaGetErrorString
← กลับไปที่ CUDA Academy