nullptr (Extensiones de componentes de C++)

Artículo
02/19/2013

La palabra clave nullptr representa un valor de puntero null.Utilice un valor de puntero null para indicar que un controlador de objeto, un puntero interior, o un tipo de puntero nativo no señala a un objeto.

Utilice nullptr con código administrado o nativo.El compilador emite instrucciones correspondientes pero diferentes valores administrados y nativos de puntero NULL.Para obtener información sobre cómo utilizar la versión de C++ del estándar ISO de esta palabra clave, vea nullptr.

La palabra clave __nullptr es una palabra clave Microsoft- específica que tiene el mismo significado que nullptr, pero solo se aplica al código nativo.Si utiliza nullptr con código de C/C++ nativo y se compila con la opción del compilador /clr , el compilador no puede determinar si nullptr indica un nativo o un valor administrado del puntero NULL.Para clarificar la intención al compilador, utilice nullptr para especificar un valor administrado o __nullptr para especificar un valor nativo.

La palabra clave nullptr es equivalente a Nothing en Visual Basic y a null en C#.

Uso

La palabra clave nullptr se puede utilizar en cualquier lugar un identificador, puntero nativo, o el argumento de la función se puede utilizar.

La palabra clave nullptr no es un tipo y no se admite para su uso con:

sizeof
typeid
throw nullptr (aunque funcionará throw (Object^)nullptr; )

La palabra clave nullptr se puede utilizar en la inicialización de tipos de puntero siguientes:

Puntero nativo
Identificador del runtime de Windows
Identificador administrado
Puntero interior administrado

La palabra clave nullptr se puede utilizar para probar si una referencia de puntero o ID es null antes de utilizar la referencia.

Las llamadas de función entre los lenguajes que utilizan valores de puntero NULL para la comprobación de errores se deben interpretar correctamente.

No puede inicializar un identificador en cero; sólo nullptr puede utilizar.La asignación de la constante 0 a un controlador de objeto genera Int32 conversión boxing y una conversión a Object^.

Ejemplo

El ejemplo de código siguiente se muestra que la palabra clave nullptr se puede utilizar en cualquier parte que un identificador, puntero nativo, o argumento de la función se puede usar.Y el ejemplo muestra que la palabra clave nullptr se puede utilizar para comprobar una referencia antes de que se utilice.

// mcpp_nullptr.cpp
// compile with: /clr
value class V {};
ref class G {};
void f(System::Object ^) {}

int main() {
// Native pointer.
   int *pN = nullptr;
// Managed handle.
   G ^pG = nullptr;
   V ^pV1 = nullptr;
// Managed interior pointer.
   interior_ptr<V> pV2 = nullptr;
// Reference checking before using a pointer.
   if (pN == nullptr) {}
   if (pG == nullptr) {}
   if (pV1 == nullptr) {}
   if (pV2 == nullptr) {}
// nullptr can be used as a function argument.
   f(nullptr);   // calls f(System::Object ^)
}

Ejemplo

El ejemplo de código siguiente se muestra que nullptr y cero se puede utilizar también en punteros nativos.

// mcpp_nullptr_1.cpp
// compile with: /clr
class MyClass {
public:
   int i;
};

int main() {
   MyClass * pMyClass = nullptr;
   if ( pMyClass == nullptr)
      System::Console::WriteLine("pMyClass == nullptr");

   if ( pMyClass == 0)
      System::Console::WriteLine("pMyClass == 0");

   pMyClass = 0;
   if ( pMyClass == nullptr)
      System::Console::WriteLine("pMyClass == nullptr");

   if ( pMyClass == 0)
      System::Console::WriteLine("pMyClass == 0");
}

Output

Ejemplo

El ejemplo de código siguiente se muestra que nullptr se interpreta como un identificador a cualquier tipo o un puntero nativo ningún está escrito.En caso de función que sobrecarga con identificadores a tipos diferentes, un error de ambigüedad se generará.nullptr tendría que en se echado a un tipo.

// mcpp_nullptr_2.cpp
// compile with: /clr /LD
void f(int *){}
void f(int ^){}

void f_null() {
   f(nullptr);   // C2668
   // try one of the following lines instead
   f((int *) nullptr);
   f((int ^) nullptr);
}

Ejemplo

El ejemplo de código siguiente se muestra que el inicio nullptr está permitido y devuelve un puntero o un identificador a la conversión que contiene el valor nullptr .

// mcpp_nullptr_3.cpp
// compile with: /clr /LD
using namespace System;
template <typename T> 
void f(T) {}   // C2036 cannot deduce template type because nullptr can be any type

int main() {
   f((Object ^) nullptr);   // T = Object^, call f(Object ^)

   // Delete the following line to resolve.
   f(nullptr);

   f(0);   // T = int, call f(int)
}

Ejemplo

El ejemplo de código siguiente se muestra que nullptr se puede utilizar como un parámetro de la función.

// mcpp_nullptr_4.cpp
// compile with: /clr
using namespace System;
void f(Object ^ x) {
   Console::WriteLine("test");
}

int main() {
   f(nullptr);
}

Output

Ejemplo

El ejemplo de código siguiente muestra que cuando se declaran y no explícitamente se inicializan los identificadores, son default inicializados a nullptr.

// mcpp_nullptr_5.cpp
// compile with: /clr
using namespace System;
ref class MyClass {
public:
   void Test() {
      MyClass ^pMyClass;   // gc type
      if (pMyClass == nullptr)
         Console::WriteLine("NULL");
   }
};

int main() {
   MyClass ^ x = gcnew MyClass();
   x -> Test();
}

Output

Ejemplo

El ejemplo de código siguiente se muestra que nullptr se puede asignar a un puntero nativo cuando se compila con /clr.

// mcpp_nullptr_6.cpp
// compile with: /clr
int main() {
   int * i = 0;
   int * j = nullptr;
}

Requisitos

Opción del compilador: (No necesario; admite todas las opciones de generación de código, incluidos /ZW y /clr)

nullptr (Extensiones de componentes de C++)

Uso

Ejemplo

Requisitos

Vea también

Referencia

Conceptos

Recursos adicionales