Komentar C++: Satu Baris // dan Banyak Baris /* */

Untuk Apa Komentar

Komentar adalah teks di source code yang sepenuhnya diabaikan oleh compiler C++. Komentar tidak pernah sampai ke program hasil kompilasi; ia ada murni untuk manusia yang membaca kodenya. Kamu memakai komentar untuk menjelaskan kenapa sesuatu dikerjakan dengan cara tertentu, meninggalkan pengingat, atau menonaktifkan kode sementara tanpa menghapusnya.

Melanjutkan sintaks C++ yang sudah kamu kenal, komentar adalah salah satu dari sedikit hal yang bisa kamu taruh hampir di mana saja, dan compiler akan melewatinya begitu saja. C++ punya dua jenis: komentar satu baris (//) dan komentar blok banyak baris (/* */).

Komentar Satu Baris

Dua garis miring (//) memulai komentar yang berlanjut sampai akhir baris tersebut. Compiler melewati semua yang ada mulai dari // sampai pergantian baris.

#include <iostream>
using namespace std;

int main() {
    // Print a greeting to the console
    cout << "Hello, C++!" << endl;

    int score = 90; // a comment can also sit after code
    cout << score << endl;
    return 0;
}

Perhatikan bahwa komentar kedua berada di baris yang sama dengan kode sungguhan. Semua yang ada sebelum // tetap dijalankan; hanya bagian sesudahnya yang diabaikan. Ini gaya komentar paling umum untuk catatan singkat.

Komentar Blok Banyak Baris

Kalau catatanmu membentang beberapa baris, komentar blok lebih rapi daripada menambahkan // di depan setiap baris. Komentar blok dimulai dengan /* dan diakhiri dengan */. Semua yang ada di antara keduanya, berapa pun jumlah barisnya, diabaikan.

#include <iostream>
using namespace std;

int main() {
    /*
     * This program shows a block comment.
     * The leading asterisks on each line are just a
     * convention for readability - they are not required.
     */
    cout << "Block comments are handy." << endl;
    return 0;
}

Karakter * yang berjajar di tepi depan hanyalah konvensi gaya, bukan aturan. Satu-satunya bagian yang benar-benar penting adalah pembuka /* dan penutup */. Komentar blok bahkan bisa berada di tengah baris, misalnya int x = 5 /* width */ + 2; itu valid, meskipun cepat jadi sulit dibaca.

Menonaktifkan Kode dengan Komentar

Komentar adalah cara standar untuk menonaktifkan kode saat kamu bereksperimen, tanpa menghapusnya. Pakai // untuk satu baris, atau komentar blok untuk mematikan beberapa baris sekaligus.

#include <iostream>
using namespace std;

int main() {
    cout << "This line runs." << endl;

    // cout << "This line is disabled." << endl;

    /*
    cout << "So is this one," << endl;
    cout << "and this one too." << endl;
    */

    cout << "This line runs as well." << endl;
    return 0;
}

Jalankan dan kamu hanya akan melihat dua baris "runs" yang tercetak. Pernyataan cout yang dijadikan komentar tidak terlihat oleh compiler.

Jebakan Komentar Bersarang

Jebakan yang sering menjebak pemula: komentar blok tidak bisa bersarang. */ yang pertama menutup komentar, berapa pun banyaknya /* sebelumnya. Jadi kamu tidak bisa membungkus blok /* ... */ di dalam blok /* ... */ lain: */ bagian dalam mengakhiri semuanya, dan semua yang ada setelahnya kembali menjadi kode (biasanya berujung syntax error).

/*  Trying to disable a region that already has a block comment...
    int n = 10; /* the width */
    cout << n;
*/  // the first */ above already closed the comment - this line is now stray code

Komentar luar berakhir di */ setelah the width, jadi sisanya tidak lagi menjadi komentar dan compiler tersandung pada */ di bagian akhir. Kalau kamu perlu menonaktifkan bagian yang sudah berisi komentar blok, pakai // di setiap baris. Sebagian besar editor bisa mengaktifkan atau mematikan komentar baris pada seluruh pilihan dengan satu shortcut keyboard, sehingga masalah ini terhindar sepenuhnya.

Komentar yang Baik vs. Gangguan

Komentar seharusnya menjelaskan sesuatu yang tidak bisa dikatakan oleh kode itu sendiri. Komentar yang hanya mengulang kode menambah keramaian dan cenderung jadi usang saat kodenya berubah.

// Bad: just repeats what the code obviously does
i = i + 1; // add one to i

// Better: explains the reason, which the code can't show
retries++; // back off and retry; the API is rate-limited at 5 req/sec

Usahakan agar kode-nya mudah dibaca lewat nama dan struktur yang jelas, dan simpan komentar untuk alasannya: maksud, pertimbangan, kasus tepi, dan tautan ke konteks. Kalau kamu sampai menulis komentar untuk menjelaskan baris yang membingungkan, itu sering menjadi tanda untuk mengganti nama variabel atau memecah logikanya menjadi fungsi dengan nama yang jelas.

Berikutnya: Variabel

Sekarang setelah kamu bisa memberi catatan pada kodemu, bagian berikutnya adalah menyimpan data di dalamnya. Halaman berikutnya membahas variabel: cara mendeklarasikannya, tipe bawaan yang bisa disimpannya, dan aturan yang diterapkan C++ karena bahasa ini bertipe statis.