_ITERATOR_DEBUG_LEVEL

La macro _ITERATOR_DEBUG_LEVEL controlla se gli iteratori verificati e il supporto del debug degli iteratori sono abilitati. Questa macro sostituisce e combina la funzionalità delle macro _SECURE_SCL e _HAS_ITERATOR_DEBUGGING precedenti.

Valori della macro

La tabella seguente contiene un riepilogo dei possibili valori della macro _ITERATOR_DEBUG_LEVEL.

Modalità di compilazione	Valore della macro	Descrizione
Debug
	0	Disabilita gli iteratori verificati e il debug degli iteratori.
	1	Abilita gli iteratori verificati e il debug degli iteratori.
	2 (predefinito)	Abilita il debug degli iteratori. Gli iteratori verificati non sono pertinenti.
Versione
	0 (Predefinito)	Disabilita gli iteratori verificati.
	1	Abilita gli iteratori verificati. Il debug degli iteratori non è pertinente.

In modalità di rilascio il compilatore genera un errore se si specifica _ITERATOR_DEBUG_LEVEL come 2.

Osservazioni:

La macro _ITERATOR_DEBUG_LEVEL controlla se gli iteratori verificati sono abilitati e, in modalità di debug, se il supporto del debug degli iteratori è abilitato. Se _ITERATOR_DEBUG_LEVEL è definito come 1 o 2, gli iteratori verificati assicurano che i limiti dei contenitori non vengano sovrascritti. Se _ITERATOR_DEBUG_LEVEL è 0, gli iteratori non vengono verificati. Quando _ITERATOR_DEBUG_LEVEL è definito come 1, l'uso di un iteratore non sicuro causa un errore di runtime e il programma viene terminato. Quando _ITERATOR_DEBUG_LEVEL è definito come 2, l'uso di un iteratore non sicuro determina la visualizzazione di un'asserzione e di una finestra di dialogo di errore di runtime che consente di accedere al debugger.

Poiché la macro _ITERATOR_DEBUG_LEVEL supporta una funzionalità simile a quella delle macro _SECURE_SCL e _HAS_ITERATOR_DEBUGGING, può non essere facile identificare con certezza la macro e il relativo valore da usare in una determinata situazione. Per evitare confusione, è consigliabile usare solo la macro _ITERATOR_DEBUG_LEVEL. Questa tabella descrive il valore equivalente della macro _ITERATOR_DEBUG_LEVEL da usare per diversi valori di _SECURE_SCL e _HAS_ITERATOR_DEBUGGING nel codice esistente.

_ITERATOR_DEBUG_LEVEL	_SECURE_SCL	_HAS_ITERATOR_DEBUGGING
0 (impostazione predefinita in modalità di rilascio)	0 (disabilitata)	0 (disabilitata)
1	1 (abilitata)	0 (disabilitata)
2 (impostazione predefinita in modalità di debug)	(non pertinente)	1 (abilitata in modalità di debug)

Per informazioni su come disabilitare gli avvisi relativi agli iteratori controllati, vedere _SCL_SECURE_NO_WARNINGS.

Esempio

Per specificare un valore per la macro, usare un'opzione /D del _ITERATOR_DEBUG_LEVEL compilatore per definirla nella riga di comando o usare #define prima che le intestazioni della libreria standard C++ siano incluse nei file di origine. Ad esempio, nella riga di comando, per compilare sample.cpp in modalità di debug e usare il supporto del debug degli iteratori, è possibile specificare la definizione di macro _ITERATOR_DEBUG_LEVEL:

cl /EHsc /Zi /MDd /D_ITERATOR_DEBUG_LEVEL=1 sample.cpp

In un file di origine specificare la macro prima delle intestazioni della libreria standard che definiscono gli iteratori.

// sample.cpp

#define _ITERATOR_DEBUG_LEVEL 1

#include <vector>

// ...

Vedi anche

Checked Iterators
Supporto degli iteratori di debug
Librerie protette: libreria standard C++