Funzionalità libreria CRTCRT Library Features

Questo argomento descrive i vari file lib che formano le librerie di runtime C, nonché le opzioni del compilatore associate e le direttive del preprocessore.This topic discusses the various .lib files that comprise the C run-time libraries as well as their associated compiler options and preprocessor directives.

Librerie di runtime C (CRT)C Run-Time Libraries (CRT)

La libreria di runtime C (CRT) fa parte della libreria standard C++ che incorpora la libreria standard ISO C99.The C Run-time Library (CRT) is the part of the C++ Standard Library that incorporates the ISO C99 standard library. Le librerie Visual C++ che implementano la libreria CRT supportano lo sviluppo del codice nativo, il codice nativo e gestito misto e il codice gestito pure per lo sviluppo di .NET.The Visual C++ libraries that implement the CRT support native code development, and both mixed native and managed code, and pure managed code for .NET development. Tutte le versioni della libreria CRT supportano lo sviluppo multithread.All versions of the CRT support multi-threaded development. La maggior parte delle librerie supporta il collegamento statico, per collegare la libreria direttamente al codice, oppure il collegamento dinamico, in modo che il codice usi file DLL comuni.Most of the libraries support both static linking, to link the library directly into your code, or dynamic linking to let your code use common DLL files.

A partire da Visual Studio 2015 la libreria CRT è stata sottoposta a refactoring in nuovi file binari.Starting in Visual Studio 2015, the CRT has been refactored into new binaries. La libreria CRT universale (UCRT) contiene le funzioni e le variabili globali esportate dalla libreria CRT C99 standard.The Universal CRT (UCRT) contains the functions and globals exported by the standard C99 CRT library. La libreria UCRT è ora un componente di Windows ed è inclusa in Windows 10.The UCRT is now a Windows component, and ships as part of Windows 10. La libreria statica, la libreria di importazione DLL e i file di intestazione per la libreria UCRT si trovano ora in Windows 10 SDK.The static library, DLL import library, and header files for the UCRT are now found in the Windows 10 SDK. Quando si installa Visual C++, Visual Studio installato il subset di Windows 10 SDK richiesto per usare la libreria UCRT.When you install Visual C++, Visual Studio setup installs the subset of the Windows 10 SDK required to use the UCRT. È possibile usare la libreria UCRT in qualsiasi versione di Windows supportata da Visual Studio 2015 e versioni successive.You can use the UCRT on any version of Windows supported by Visual Studio 2015 and later versions. È possibile ridistribuirla usando vcredist per le versioni supportate di Windows diverse da Windows 10.You can redistribute it using vcredist for supported versions of Windows other than Windows 10. Per altre informazioni, vedere Redistributing Visual C++ Files.For more information, see Redistributing Visual C++ Files.

La tabella seguente elenca le librerie che implementano le librerie UCRT.The following table lists the libraries that implement the UCRT.

LibreriaLibrary DLL associataAssociated DLL CaratteristicheCharacteristics OpzioneOption Direttive per il preprocessorePreprocessor directives
libucrt.liblibucrt.lib nessunoNone Collega in modo statico la libreria UCRT al codice.Statically links the UCRT into your code. /MT/MT _MT_MT
libucrtd.liblibucrtd.lib nessunoNone Versione di debug della libreria UCRT per il collegamento statico.Debug version of the UCRT for static linking. Non ridistribuibile.Not redistributable. /MTd/MTd _DEBUG, _MT_DEBUG, _MT
ucrt.libucrt.lib ucrtbase.dllucrtbase.dll Libreria di importazione DLL per la libreria UCRT.DLL import library for the UCRT. /MD/MD _MT, _DLL_MT, _DLL
ucrtd.libucrtd.lib ucrtbased.dllucrtbased.dll Libreria di importazione DLL per la versione di debug della libreria UCRT.DLL import library for the Debug version of the UCRT. Non ridistribuibile.Not redistributable. /MDd/MDd _DEBUG, _MT, _DLL_DEBUG, _MT, _DLL

La libreria vcruntime contiene codice specifico dell'implementazione della libreria CRT di Visual C++, come il supporto di gestione e debug delle eccezioni, i controlli runtime e le informazioni sui tipi, i dettagli di implementazione e alcune funzioni estese della libreria.The vcruntime library contains Visual C++ CRT implementation-specific code, such as exception handling and debugging support, runtime checks and type information, implementation details and certain extended library functions. Questa libreria è specifica per la versione usata dal compilatore.This library is specific to the version of the compiler used.

Questa tabella elenca le librerie che implementano la libreria vcruntime.This table lists the libraries that implement the vcruntime library.

LibreriaLibrary DLL associataAssociated DLL CaratteristicheCharacteristics OpzioneOption Direttive per il preprocessorePreprocessor directives
libvcruntime.liblibvcruntime.lib nessunoNone Collegata in modo statico al codice.Statically linked into your code. /MT/MT _MT_MT
libvcruntimed.liblibvcruntimed.lib nessunoNone Versione di debug per il collegamento statico.Debug version for static linking. Non ridistribuibile.Not redistributable. /MTd/MTd _MT, _DEBUG_MT, _DEBUG
vcruntime.libvcruntime.lib vcruntime<version>.dllvcruntime<version>.dll Libreria di importazione DLL per la libreria vcruntime.DLL import library for the vcruntime. /MD/MD _MT, _DLL_MT, _DLL
vcruntimed.libvcruntimed.lib vcruntime<version>d.dllvcruntime<version>d.dll Libreria di importazione DLL per la libreria vcruntime di debug.DLL import library for the Debug vcruntime. Non ridistribuibile.Not redistributable. /MDd/MDd _DEBUG, _MT, _DLL_DEBUG, _MT, _DLL

Il codice che inizializza la libreria CRT è in una di svariate librerie, a seconda che la libreria CRT sia collegata in modo statico o dinamico, o in codice nativo, gestito o misto.The code that initializes the CRT is in one of several libraries, based on whether the CRT library is statically or dynamically linked, or native, managed, or mixed code. Questo codice gestisce l'avvio della libreria CRT, l'inizializzazione e la chiusura dei dati per thread.This code handles CRT startup, internal per-thread data initialization, and termination. È specifica per la versione usata dal compilatore.It is specific to the version of the compiler used. Questa libreria è sempre collegata in modo statico, anche quando si usa una libreria UCRT collegata in modo dinamico.This library is always statically linked, even when using a dynamically linked UCRT.

Questa tabella elenca le librerie che implementano l'inizializzazione e la chiusura della libreria CRT.This table lists the libraries that implement CRT initialization and termination.

LibreriaLibrary CaratteristicheCharacteristics OpzioneOption Direttive per il preprocessorePreprocessor directives
LIBCMT.liblibcmt.lib Collega in modo statico l'avvio della libreria UCRT nativa nel codice.Statically links the native CRT startup into your code. /MT/MT _MT_MT
libcmtd.liblibcmtd.lib Collega in modo statico la versione di Debug dell'avvio della libreria CRT nativa.Statically links the Debug version of the native CRT startup. Non ridistribuibile.Not redistributable. /MTd/MTd _DEBUG, _MT_DEBUG, _MT
msvcrt.libmsvcrt.lib Libreria statica per l'avvio della libreria CRT nativa per l'uso con DLL UCRT e vcruntime.Static library for the native CRT startup for use with DLL UCRT and vcruntime. /MD/MD _MT, _DLL_MT, _DLL
msvcrtd.libmsvcrtd.lib Libreria statica per la versione di debug per l'avvio della libreria CRT nativa da usare con DLL UCRT e vcruntime.Static library for the Debug version of the native CRT startup for use with DLL UCRT and vcruntime. Non ridistribuibile.Not redistributable. /MDd/MDd _DEBUG, _MT, _DLL_DEBUG, _MT, _DLL
msvcmrt.libmsvcmrt.lib Libreria statica per l'avvio della libreria CRT nativa e gestita mista per l'uso con DLL UCRT e vcruntime.Static library for the mixed native and managed CRT startup for use with DLL UCRT and vcruntime. /clr/clr
msvcmrtd.libmsvcmrtd.lib Libreria statica per la versione di debug dell'avvio della libreria CRT nativa e gestita mista per l'uso con DLL UCRT e vcruntime.Static library for the Debug version of the mixed native and managed CRT startup for use with DLL UCRT and vcruntime. Non ridistribuibile.Not redistributable. /clr/clr
msvcurt.libmsvcurt.lib Deprecata Libreria statica per la libreria CRT gestita pure.Deprecated Static library for the pure managed CRT. /clr:pure/clr:pure
msvcurtd.libmsvcurtd.lib Deprecata Libreria statica per la versione di debug della libreria CRT gestita pure.Deprecated Static library for the Debug version of the pure managed CRT. Non ridistribuibile.Not redistributable. /clr:pure/clr:pure

Se si collega il programma dalla riga di comando senza un'opzione del compilatore che specifichi una libreria di runtime C, il linker userà le librerie CRT collegate in modo statico: libcmt.lib, libvcruntime.lib e libucrt.lib.If you link your program from the command line without a compiler option that specifies a C run-time library, the linker will use the statically linked CRT libraries: libcmt.lib, libvcruntime.lib, and libucrt.lib.

L'uso di una libreria CRT collegata in modo statico implica che tutte le informazioni di stato salvate dalla libreria di runtime C saranno locali in questa istanza della libreria CRT.Using the statically linked CRT implies that any state information saved by the C runtime library will be local to that instance of the CRT. Ad esempio, se si usano strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l con una libreria CRT collegata staticamente, la posizione del parser strtok non è correlata allo stato strtok usato nel codice dello stesso processo (ma in un file DLL o EXE diverso) collegato a un'altra istanza della libreria CRT statica.For example, if you use strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l when using a statically linked CRT, the position of the strtok parser is unrelated to the strtok state used in code in the same process (but in a different DLL or EXE) that is linked to another instance of the static CRT. Al contrario, la libreria CRT collegata in modo dinamico condivide lo stato per tutto il codice all'interno di un processo collegato in modo dinamico alla libreria CRT.In contrast, the dynamically linked CRT shares state for all code within a process that is dynamically linked to the CRT. Questa osservazione non si applica se si usano le nuove versioni più sicure di queste funzioni, ad esempio strtok_s non è interessato da questo problema.This concern does not apply if you use the new more secure versions of these functions; for example, strtok_s does not have this problem.

Poiché una DLL compilata con un collegamento a una libreria CRT statica avrà un proprio stato CRT, non si consiglia di effettuare un collegamento statico alla libreria CRT in una DLL a meno che gli effetti di questa azione non siano quelli desiderati e non siano compresi appieno.Because a DLL built by linking to a static CRT will have its own CRT state, it is not recommended to link statically to the CRT in a DLL unless the consequences of this are specifically desired and understood. Ad esempio, se si chiama _set_se_translator in un file eseguibile che carica la DLL collegata alla relativa libreria CRT statica, le eccezioni hardware generate dal codice nella DLL non saranno rilevate dal convertitore, mentre saranno rilevate le eccezioni hardware generate dal codice nel file eseguibile principale.For example, if you call _set_se_translator in an executable that loads the DLL linked to its own static CRT, any hardware exceptions generated by the code in the DLL will not be caught by the translator, but hardware exceptions generated by code in the main executable will be caught.

Se si usa l'opzione del compilatore /clr , il codice sarà collegato a una libreria statica, msvcmrt.lib.If you are using the /clr compiler switch, your code will be linked with a static library, msvcmrt.lib. La libreria statica fornisce un proxy tra il codice gestito e la libreria CRT nativa.The static library provides a proxy between your managed code and the native CRT. Non è possibile usare la libreria collegata staticamente CRT (opzioni /MT o /MTd ) con /clr.You cannot use the statically linked CRT ( /MT or /MTd options) with /clr. Usare invece le librerie collegate in modo dinamico (/MD o /MDd).Use the dynamically-linked libraries (/MD or /MDd) instead.

Se si usa l'opzione del compilatore /clr:pure , il codice sarà collegato alla libreria statica msvcurt.lib.If you are using the /clr:pure compiler switch, your code will be linked with the static library msvcurt.lib. Analogamente a /clr, non è possibile effettuare il collegamento alla libreria collegata in modo statico.As with /clr, you cannot link with the statically linked library. Le opzioni del compilatore /clr:pure e /clr:safe sono deprecate a partire da Visual Studio 2015.The /clr:pure and /clr:safe compiler options are deprecated starting in Visual Studio 2015.

Per altre informazioni sull'uso di CRT con /clr, vedere Assembly misti (nativi e gestiti); per /clr:pure, vedere Codice pure e verificabile (C++/CLI).For more information on using the CRT with /clr, see Mixed (Native and Managed) Assemblies; for /clr:pure, see Pure and Verifiable Code (C++/CLI).

Per compilare una versione di debug dell'applicazione, è necessario definire il flag _DEBUG e collegare l'applicazione a una versione di debug di una di queste librerie.To build a debug version of your application, the _DEBUG flag must be defined and the application must be linked with a debug version of one of these libraries. Per altre informazioni sull'uso delle versioni di debug dei file della libreria, vedere Tecniche di debug CRT.For more information about using the debug versions of the library files, see CRT Debugging Techniques.

Questa versione della libreria CRT non è completamente conforme allo standard C99.This version of the CRT is not fully conformant with the C99 standard. In particolare, l'intestazione <tgmath.h> e le macro pragma CX_LIMITED_RANGE/FP_CONTRACT non sono supportate.In particular, the <tgmath.h> header and the CX_LIMITED_RANGE/FP_CONTRACT pragma macros are not supported. Alcuni elementi, ad esempio il significato degli identificatori di parametro nelle funzioni I/O standard usano interpretazioni legacy per impostazione predefinita.Certain elements such as the meaning of parameter specifiers in standard IO functions use legacy interpretations by default. È possibile usare le opzioni di conformità del compilatore /Zc e specificare le opzioni del linker per controllare alcuni aspetti di conformità della libreria.You can use /Zc compiler conformance options and specify linker options to control some aspects of library conformance,

Libreria standard C++C++ Standard Library

Libreria standard C++C++ Standard Library CaratteristicheCharacteristics OpzioneOption Direttive per il preprocessorePreprocessor directives
LIBCPMT.libLIBCPMT.LIB Multithreading, collegamento staticoMultithreaded, static link /MT/MT _MT_MT
MSVCPRT.LIBMSVCPRT.LIB Multithreading, collegamento dinamico (libreria di importazione per MSVCP<version>.dll)Multithreaded, dynamic link (import library for MSVCP<version>.dll) /MD/MD _MT, _DLL_MT, _DLL
LIBCPMTD.LIBLIBCPMTD.LIB Multithreading, collegamento staticoMultithreaded, static link /MTd/MTd _DEBUG, _MT_DEBUG, _MT
MSVCPRTD.LIBMSVCPRTD.LIB Multithreading, collegamento dinamico (libreria di importazione per MSVCP<version>D.DLL)Multithreaded, dynamic link (import library for MSVCP<version>D.DLL) /MDd/MDd _DEBUG, _MT, _DLL_DEBUG, _MT, _DLL

Quando si compila una versione di rilascio del progetto, una delle librerie di runtime C di base (LIBCMT.LIB, MSVCMRT.LIB, MSVCRT.LIB) viene collegata per impostazione predefinita, a seconda dell'opzione del compilatore scelta (multithreading, DLL, /clr).When you build a release version of your project, one of the basic C run-time libraries (LIBCMT.LIB, MSVCMRT.LIB, MSVCRT.LIB) is linked by default, depending on the compiler option you choose (multithreaded, DLL, /clr). Se si include uno dei file di intestazione della libreria standard di C++ nel codice, Visual C++ collegherà automaticamente una libreria C++ standard in fase di compilazione.If you include one of the C++ Standard Library header files in your code, a C++ Standard Library will be linked in automatically by Visual C++ at compile time. Ad esempio:For example:

#include <ios>   

Quali problemi si verificano se un'applicazione usa più di una versione CRT?What problems exist if an application uses more than one CRT version?

Se sono presenti più file DLL o EXE, possono esistere più librerie CRT, indipendentemente dal fatto che si usino versioni diverse di Visual C++.If you have more than one DLL or EXE, then you may have more than one CRT, whether or not you are using different versions of Visual C++. Ad esempio, il collegamento statico della libreria CRT a più DLL può produrre lo stesso problema.For example, statically linking the CRT into multiple DLLs can present the same problem. Agli sviluppatori che rilevano questo problema con le librerie CRT statiche sono state fornite istruzioni per eseguire la compilazione con /MD per usare la DLL di CRT.Developers encountering this problem with static CRTs have been instructed to compile with /MD to use the CRT DLL. Se le DLL passano le risorse CRT tra i limiti DLL, potrebbe verificarsi lo stesso problema con le librerie CRT senza corrispondenza e sarà necessario ricompilare il progetto Visual C++.If your DLLs pass CRT resources across the DLL boundary, you may encounter issues with mismatched CRTs and need to recompile your project with Visual C++.

Se il programma usa più versioni della libreria CRT, è necessario prestare attenzione quando si passano determinati oggetti CRT (ad esempio, handle di file, impostazioni locali e variabili di ambiente) tra i limiti DLL.If your program is using more than one version of the CRT, some care is needed when passing certain CRT objects (such as file handles, locales and environment variables) across DLL boundaries. Per altre informazioni su questi problemi e su come risolverli, vedere Potenziali errori di passaggio di oggetti CRT attraverso i limiti DLL.For more information on the issues involved and how to resolve them, see Potential Errors Passing CRT Objects Across DLL Boundaries.

Vedere ancheSee Also

Riferimenti della libreria di runtime di CC Run-Time Library Reference