/Yu (Önceden derlenmiş üst bilgi dosyasını kullan)

  • Makale

Derleyiciye, geçerli derlemede var olan bir önceden derlenmiş üst bilgi (.pch) dosyasını kullanmasını ister.

Sözdizimi

/Yu[dosyaadı]

Bağımsız değişkenler

filename
Ön işlemci yönergesi kullanılarak kaynak dosyaya eklenen üst #include bilgi dosyasının adı.

Açıklamalar

Ekleme dosyasının adı hem önceden derlenmiş üst bilgiyi oluşturan seçenek hem de /Yc önceden derlenmiş üst bilginin kullanımını gösteren sonraki /Yu seçenekler için aynı olmalıdır.

için/Yc, dosyaadı ön derlemenin durduğu noktayı belirtir; derleyici dosya adı olsa da tüm kodu önceden derler ve ekleme dosyasının temel adını ve uzantısını kullanarak sonuçta elde edilen önceden derlenmiş üst bilgiyi adlandırıyor.pch.

Dosya .pch kullanılarak /Ycoluşturulmuş olmalıdır.

Derleyici, .h dosyasından önce oluşan tüm kodları önceden derlenmiş olarak ele alır. Dosyayla ilişkili yönergenin #include hemen ötesine .h atlar, dosyada bulunan kodu kullanır ve ardından dosya adından .pchsonraki tüm kodları derler.

Komut satırında, ve dosya adı arasında /Yu boşluk yoktur.

Dosya adı olmadan seçeneğini belirttiğinizde/Yu, kaynak programınız önceden derlenmiş üst bilgi .pch olan dosyanın dosya adını belirten bir #pragma hdrstop pragma içermelidir. Bu durumda, derleyici tarafından /Fp (Name .pch file)adlandırılan önceden derlenmiş üst bilgiyi (.pch dosya) kullanır. Derleyici bu pragmanın konumuna atlar ve derlenmiş durumu belirtilen önceden derlenmiş üst bilgi dosyasından geri yükler. Ardından yalnızca pragması izleyen kodu derler. #pragma hdrstop Bir dosya adı belirtmezse, derleyici uzantılı kaynak dosyanın temel adından türetilmiş bir ada sahip bir .pch dosya arar. Seçeneğini .pch farklı bir dosya belirtmek için de kullanabilirsiniz/Fp.

Dosya adı olmadan seçeneğini belirtir /Yu ve pragma belirtemezseniz hdrstop , bir hata iletisi oluşturulur ve derleme başarısız olur.

Dosya adı ve/Yu dosya adı seçenekleri aynı komut satırında yer alıyorsa ve her ikisi de aynı dosya adına başvuruda bulunursa, /Ycdosya adı önceliklidir ve adlandırılmış dosyaya kadar olan ve dahil olan tüm kodları önceden derler./Yc Bu özellik, derleme dosyalarının yaz olmasını kolaylaştırır.

.pch Dosyalar makine ortamı ve programla ilgili bellek adresi bilgileri içerdiğinden, yalnızca oluşturulduğu makinede bir .pch dosya kullanmanız gerekir.

Önceden derlenmiş üst bilgiler hakkında daha fazla bilgi için bkz:

Bu derleyici seçeneğini Visual Studio geliştirme ortamında ayarlamak için

  1. Projenizdeki bir .cpp dosyasında (Önceden derlenmiş üst bilgi dosyası oluştur) belirtin /Yc .

  2. Projenin Özellik Sayfaları iletişim kutusunu açın. Ayrıntılar için bkz . Visual Studio'da C++ derleyicisi ve derleme özelliklerini ayarlama.

  3. Yapılandırma Özellikleri>C/C++>Önceden Derlenmiş Üst Bilgiler özellik sayfasını seçin.

  4. Önceden Derlenmiş Üst Bilgi özelliğini, Dosya Aracılığıyla PCH Oluştur/Kullan özelliğini veya Önceden Derlenmiş Üst Bilgi Oluştur/Kullan özelliğini değiştirin.

Bu derleyici seçeneğini program üzerinden ayarlamak için

Örnek

Aşağıdaki kod ise:

#include <afxwin.h>   // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h"    // Include information specific to this app
...

, komut satırı CL /YuMYAPP.H PROG.CPPkullanılarak derlenmiştir, derleyici üç include deyimini işlemez. Bunun yerine, dosyasından MYAPP.pchönceden derlenmiş kodu kullanır. Bu kod, dosyaların üçünü de (ve içerebilecekleri tüm dosyaları) ön işlemeye zaman kazandırır.

Aşağıdaki örnekte olduğu gibi, dosya adı bağımsız değişkeninden /Yc veya kaynak dosyanın temel adından .pch farklıysa, dosyanın adını belirtme seçeneğiyle birlikte /Yu seçeneğini kullanabilirsiniz/Fp (Name .pch file):

CL /YuMYAPP.H /FpMYPCH.pch PROG.CPP

Bu komut, adlı MYPCH.pchönceden derlenmiş bir üst bilgi dosyası belirtir. Derleyici, içeriğini kullanarak ve dahil olmak üzere MYAPP.htüm üst bilgi dosyalarının önceden derlenmiş durumunu geri yükler. Derleyici daha sonra * yönergesi #include "MYAPP.h"sonrasında oluşan kodu derler.

Ayrıca bkz.

MSVC derleyici seçenekleri
MSVC derleyicisi komut satırı söz dizimi