Pengawal Include

Pengepala sering menyertakan pengepala lain. Satu pengepala boleh termasuk dua kali dalam fail sumber yang sama dengan mudah.

Apabila hal ini berlaku, setiap pengisytiharan di dalamnya muncul dua kali. Bagi takrif jenis seperti struct atau typedef, ini ialah ralat penyusunan: sesuatu jenis tidak boleh ditakrifkan lebih daripada sekali.

Katakan a.h dan b.h kedua-duanya menyertakan types.h. Fail sumber yang menyertakan kedua-duanya akhirnya mempunyai types.h yang ditampal dua kali.

Prapemproses menyalin teks pengepala secara membuta tuli, lalu takrif dalam types.h menjadi pendua dan mencetuskan ralat pentakrifan semula.

Pengawal penyertaan ialah helah kecil prapemproses yang menjadikan pengepala selamat untuk disertakan berkali-kali.

Ia membungkus seluruh pengepala dalam syarat supaya badan hanya diproses pada kali pertama. Penyertaan seterusnya dilangkau sepenuhnya.

Pada kali pertama pengepala ditemui, TYPES_H belum ditakrifkan, jadi #ifndef adalah benar dan badan diproses. Kemudian #define menetapkan makro tersebut.

Pada mana-mana penyertaan seterusnya, TYPES_H sudah wujud, jadi #ifndef adalah palsu dan prapemproses melangkau terus ke #endif.

Berikut ialah pengepala yang realistik dengan pengawal yang melindungi takrif jenis.

Walaupun banyak fail menyertakan point.h secara langsung atau tidak langsung, struct Point ditakrifkan tepat sekali bagi setiap unit terjemahan.

Makro pengawal mestilah unik di seluruh projek anda, jika tidak dua pengepala boleh bertembung dan menyembunyikan satu sama lain secara senyap.

Konvensyen biasa menghasilkan nama daripada nama fail dalam huruf besar: point.h menjadi POINT_H, manakala net/socket.h menjadi NET_SOCKET_H.

Pengecam yang bermula dengan garis bawah diikuti huruf besar, atau yang mengandungi garis bawah berganda, dikhaskan untuk pengkompil dan pustaka standard.

Elakkan pengawal seperti __POINT_H__. Bentuk biasa dengan garis bawah di hujung seperti POINT_H adalah selamat dan jelas.

Kebanyakan pengkompil moden menyokong #pragma once, iaitu satu baris di bahagian atas pengepala yang menjalankan tugas yang sama.

Ia lebih ringkas dan mengelakkan pertembungan nama, tetapi bukan sebahagian daripada piawaian C. Pengawal #ifndef tradisional berfungsi di mana-mana.

Pengawal #ifndef mudah alih sepenuhnya dan mengikut piawaian, tetapi memerlukan makro unik bagi setiap pengepala.

#pragma once ringkas dan bebas pertembungan, tetapi bergantung pada sokongan pengkompil. Sesetengah projek menggunakan kedua-duanya: pragma bersama pengawal klasik untuk keselamatan maksimum.

Pengawal penyertaan menghalang penyertaan pendua dalam satu fail sumber semasa fail itu disusun.

Ia tidak menghalang pengepala daripada diproses sekali dalam setiap fail .c yang berasingan. Itu tidak mengapa kerana setiap fail sumber ialah unit terjemahan yang berbeza.

Tambahkan pengawal penyertaan pada setiap pengepala yang anda tulis, bermula dari baris pertama. Ia hanya menggunakan tiga baris dan menghalang pelbagai ralat yang mengelirukan.

Walaupun pengepala ringkas boleh disertakan secara tidak langsung melalui pengepala lain kemudian, melindunginya dari awal menjimatkan masalah.

Anda telah belajar mengapa menyertakan pengepala dua kali menyebabkan ralat pentakrifan semula dan cara pengawal penyertaan menghalangnya.

Gunakan #ifndef/#define/#endif dengan makro unik, atau #pragma once. Seterusnya, kita akan melihat cara berkongsi pemboleh ubah antara fail dengan extern.