# include yönergesini (c/C++)
#include Bu içeriği kaynak programda göründüğü yönergesi noktada göründü gibi belirli bir dosyanın içeriğini işlemek için Önişlemci yönergesi söyler.
#include "path-spec"
#include <path-spec>
Notlar
İçerik dosyalarına sabit ve makro tanımlarını düzenleyebilir ve daha sonra #include bu tanımları herhangi bir kaynak dosyasına eklemek için yönergeleri. Dahil dosyaları ayrıca harici değişkenler ve karmaşık veri türleri ile ilgili bildirimler için yararlı. Tanımlamak ve bu amaçla oluşturulan bir içerme dosyasında yalnızca bir kez türleri adı gerekir.
Yolu spec bir dosya adı dizin belirtimi tarafından isteğe bağlı olarak gelir. Dosya adı varolan bir dosya adı olmalıdır. Sözdizimi yol spec program derlendiğinde işletim sistemine bağlıdır.
Başvuru derlemesi ile derlenmiş bir C++ uygulamasında nasıl hakkında bilgi için /clr, bkz: # kullanarak.
Her iki sözdizimi biçimi değiştirme o yönergesi tarafından belirtilen içeren dosyanın tüm içeriğini neden. İki form arasındaki fark, yolu tam olarak belirtildiğinde, Önişlemci üstbilgi dosyaları arar sıradır. Aşağıdaki tabloda iki sözdizimi biçimi arasındaki farkı gösterir:
Syntax formu |
Eylem |
|---|---|
Teklif formu |
Önişlemci Ekle dosyaları aşağıdaki sırayla arar:
|
Açılı ayraç formu |
Önişlemci Ekle dosyaları aşağıdaki sırayla arar:
|
Verilen ada sahip bir dosyayı bulur gibi arama Önişlemci durdurur. Tam, belirli yol belirtimi için çift tırnak işareti içerme dosyası belirtirseniz, (""), Önişlemci yalnızca o yol belirtimi arar ve standart dizinler yok sayar.
Önişlemci ilk dosya adı çift tırnak işareti içine alınmış bir eksik yol belirtimi, "üst" dosya dizini arar. Üst dosyası içeren #include yönergesi. Adlı bir dosya içerir, örneğin, file2 adlı bir dosya içinde file1, file1 ana dosyasıdır.
Dosyalar "yuvalanabilir"; diğer bir deyişle, bir #include yönergesi tarafından başka adlı bir dosyada görünür #include yönergesi. Örneğin, file2, yukarıdaki içerebilir file3. Bu durumda, file1 hala üst olurdu file2 , "grandparent" olacaktır, ancak file3.
Ne zaman dahil dosyaları iç içe ve komut satırından derlerken, dizin arama ana dosya dizinleri ile başlar ve grandparent dosyaları dizinleri ile devam eder. Bu nedenle, arama şu anda işlenen kaynağını içeren dizine göre başlar. Dosya bulunamazsa, arama tarafından /I derleyici seçeneği belirtilen dizinler taşır. Son olarak, INCLUDE çevre değişkeni tarafından belirtilen dizin aranır.
Geliştirme ortamında dan INCLUDE çevre değişkeni göz ardı edilir. (Bu bilgiler, LIB ortam değişkeni.) dosyaları Ekle aradığınız dizinlerin ayarlamak için bkz: vC++ dizinleri, projeler, Seçenekler iletişim kutusunun.
Aşağıdaki örnek, açılı ayraçlar kullanılarak dosya içerme gösterir:
#include <stdio.h>
Bu örnek, STDIO adlı dosyanın içeriğini ekler.Kaynak programda h. Açılı ayraçlar STDIO için INCLUDE çevre değişkeni tarafından belirtilen dizini arayacağını Önişlemci neden.H, /ı derleyici seçeneği tarafından belirtilen dizinlerinde arama sonra.
Aşağıdaki örnek dosya eklenmesi teklif formunu kullanarak gösterir:
#include "defs.h"
Bu örnek, defs tarafından belirtilen dosyanın içeriğini ekler.Kaynak programda h. Çift tırnak işareti Önişlemci ilk ana kaynak dosyasını içeren dizini arar anlamına gelir.
İç içe geçmiş dosyaları Ekle, en çok 10 düzeyleri devam edebilirsiniz. Bir kez yuvalanmış #include olan işlenen, Önişlemci kapsayan içerme dosyası özgün kaynak dosyasına eklemek devam eder.
Microsoft özel
İncludable kaynak dosyaları bulmak için Önişlemci ilk arama dizinleri /I derleyici seçeneği tarafından belirtilen. /I seçeneği yoksa veya başarısız olursa, Önişlemci köşeli ayraç içindeki herhangi bir içerik dosyaları bulmak için INCLUDE çevre değişkeni kullanır. INCLUDE ortam değişkeni ve /I derleyici seçeneği birden fazla yolu aralarına noktalı virgül koyarak içerebilir (;). Birden fazla dizin bölümü /ı seçeneği veya INCLUDE çevre değişkeni içinde görünüyorsa, Önişlemci bunları göründükleri sırayla arar.
Örneğin, komut
CL /ID:\MSVC\INCLUDE MYPROG.C
D:\MSVC\INCLUDE dosyaları için bir dizin Ekle STDIO gibi aramak Önişlemci neden olur.H. Komutları
SET INCLUDE=D:\MSVC\INCLUDE
CL MYPROG.C
aynı etkiye sahiptir. Her iki arama başarısız olursa, önemli derleyici bir hata oluşturulur.
Bir iki nokta üst üste (örneğin, F:\MSVC\SPECIAL\INCL\TEST. içeren bir yolu ile bir içerme dosyası için dosya adı tam olarak belirtilen,h) Önişlemci yolunu izler.
Include dosya olarak belirtilen #include**"yol spec"**, dizin arama ana dosya dizini ile başlar ve grandparent dosyaları dizinleri ile devam eder. Bu nedenle, kaynak dosya içeren içeren dizine göre aramaya başlar #include yönergesi işleniyor. Dosya adı, açılı ayraçlar içine gibi hiçbir grandparent dosyası ve dosyanın bulunmaması, aramaya devam eder.
SON Microsoft özel