NullTerminated

Aktualisiert: November 2007

Mit der NullTerminated-Eigenschaft wird angegeben, dass das letzte verwendbare Element eines Arrays oder eines Puffers, auf den mit einem Zeiger verwiesen wird, den Wert 0 (null) aufweist. Diese Eigenschaft kann mit dem Pre-Attribut und dem Post-Attribut verwendet werden. Sie ist für T* und T [] zulässig, wobei T einen ganzzahligen Typ oder Zeigertyp aufweist.

Die NullTerminated-Eigenschaft muss auf einen der folgenden Werte festgelegt werden:

  • SA_Yes – das Array endet mit 0 (null).

  • SA_No – das Array endet nicht mit 0 (null).

  • SA_Maybe – das Array endet möglicherweise mit 0 (null).

Hinweis:

In C++ ist das SA_-Präfix optional.

Beispiel

Der folgende Code zeigt, wie die NullTerminated-Eigenschaft verwendet wird:

// C 
#include <CodeAnalysis\SourceAnnotations.h>
void f([SA_Pre(NullTerminated=SA_Yes)] char* pc);

// C++
#include <CodeAnalysis\SourceAnnotations.h>
using namespace vc_attributes;
void f([Pre(NullTerminated=Yes)] char* pc);

Die NullTerminated-Eigenschaft kann nicht auf einen Funktionszeiger angewendet werden.

Siehe auch

Konzepte

Übersicht über Anmerkungen

Weitere Ressourcen

Anmerkungseigenschaften