0Pricing
Zig Academy · Pelajaran

Validasi Comptime dan @compileError

Gagalkan build dengan pesan yang jelas.

Validasi Comptime dan @compileError adalah pelajaran Zig Academy gratis di CoddyKit. Ini adalah pelajaran 3 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Zig Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Zig Academy mencakup 4 pelajaran total.

Menangkap Kesalahan Sebelum Waktu Jalan

Zig memungkinkan Anda menolak penggunaan yang salah saat kode dikompilasi. Bawaan @compileError menghentikan build dengan pesan yang Anda tulis. 🛑

Gagal dengan Pesan yang Jelas

@compileError menerima string comptime dan membatalkan kompilasi, lalu mencetak teks tersebut persis agar pemanggil mengetahui kesalahannya.

@compileError("this type is not supported");

Melindungi Fungsi Generik

Di dalam percabangan comptime, Anda dapat menolak tipe yang tidak diinginkan. Di sini hanya bilangan bulat yang lolos; tipe lainnya mencapai @compileError di lokasi pemanggilan.

if (@typeInfo(T) != .Int) {
    @compileError("T must be an integer");
}

Kesalahan Menunjuk ke Pemanggil

Pemeriksaan comptime berjalan saat fungsi dibuat, sehingga error muncul di tempat tipe yang salah benar-benar diberikan.

Menegaskan Fakta dengan comptime

Untuk invarian sederhana, comptime assert menghentikan build saat kondisi bernilai salah, mirip dengan assert saat waktu jalan, tetapi dilakukan lebih awal.

comptime std.debug.assert(@sizeOf(T) <= 8);

Memeriksa Deklarasi

Gunakan @hasDecl untuk memastikan sebuah tipe menyediakan metode atau konstanta sebelum Anda memanggilnya, lalu gagalkan dengan jelas jika tidak tersedia.

if (!@hasDecl(T, "init")) {
    @compileError("T needs an init function");
}

Memeriksa Bidang

Demikian pula, @hasField memberi tahu apakah sebuah struktur memiliki bidang bernama tertentu, yang berguna saat memvalidasi bentuk pada waktu kompilasi.

const ok = @hasField(Config, "port");

Membuat Pesan dari Nama Tipe

Gabungkan @typeName dengan std.fmt untuk menyertakan tipe yang bermasalah dalam pesan, sehingga pemanggil mendapatkan error yang tepat dan mudah dibaca.

@compileError("unsupported type: " ++ @typeName(T));

String Digabungkan Saat Waktu Kompilasi

Operator ++ menggabungkan string comptime, sehingga Anda dapat menyusun teks error yang terperinci tanpa alokasi heap.

Tanpa Biaya Saat Waktu Jalan

Semua validasi ini berlangsung selama kompilasi. Program yang berhasil dibangun memiliki tidak ada overhead pemeriksaan saat waktu jalan. ⚡

Lebih Baik daripada Crash Saat Waktu Jalan

Validasi comptime mengubah kemungkinan crash menjadi pesan build yang bersahabat, sehingga penyalahgunaan tertangkap lebih awal dan dijelaskan dengan baik.

Pemeriksaan Singkat

Anda ingin membatalkan build dengan pesan khusus saat suatu tipe tidak didukung. Apa yang harus Anda panggil?

Ringkasan

@compileError bersama pemeriksaan seperti @hasDecl dan comptime assert menolak penggunaan yang salah selama build, tanpa biaya saat waktu jalan. 🎯

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Validasi Comptime dan @compileError” gratis?

Ya — teks lengkap “Validasi Comptime dan @compileError” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Zig Academy, upgrade ke CoddyKit PRO. Kursus Zig Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Validasi Comptime dan @compileError”?

Gagalkan build dengan pesan yang jelas. Kamu berlatih Zig Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Zig Academy?

Tidak diperlukan pengalaman sebelumnya. Zig Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 3 dari 4.

Berapa lama pelajaran “Validasi Comptime dan @compileError” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Zig Academy ini?

Ya. Setiap pelajaran Zig Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

  1. Mencerminkan Field dengan @typeInfo
  2. Membangun Tipe dengan @Type
  3. Validasi Comptime dan @compileError
  4. Membuat Kode dengan comptime
← Kembali ke Zig Academy