abstract (C++/CLI and C++/CX)

The abstract keyword declares either:

  • A type can be used as a base type, but the type itself cannot be instantiated.

  • A type member function can be defined only in a derived type.

All Platforms

Syntax

class-declaration class-identifier abstract {}

virtual return-type member-function-identifier () abstract ;

Remarks

The first example syntax declares a class to be abstract. The class-declaration component can be either a native C++ declaration (class or struct), or a C++ extension declaration (ref class or ref struct) if the /ZW or /clr compiler option is specified.

The second example syntax declares a virtual member function to be abstract. Declaring a function abstract is the same as declaring it a pure virtual function. Declaring a member function abstract also causes the enclosing class to be declared abstract.

The abstract keyword is supported in native and platform-specific code; that is, it can be compiled with or without the /ZW or /clr compiler option.

You can detect at compile time if a type is abstract with the __is_abstract(type) type trait. For more information, see Compiler Support for Type Traits.

The abstract keyword is a context-sensitive override specifier. For more information about context-sensitive keywords, see Context-Sensitive Keywords. For more information about override specifiers, see How to: Declare Override Specifiers in Native Compilations.

Windows Runtime

For more information, see Ref classes and structs.

Requirements

Compiler option: /ZW

Common Language Runtime

Requirements

Compiler option: /clr

Examples

The following code example generates an error because class X is marked abstract.

// abstract_keyword.cpp
// compile with: /clr
ref class X abstract {
public:
   virtual void f() {}
};

int main() {
   X ^ MyX = gcnew X;   // C3622
}

The following code example generates an error because it instantiates a native class that is marked abstract. This error will occur with or without the /clr compiler option.

// abstract_keyword_2.cpp
class X abstract {
public:
   virtual void f() {}
};

int main() {
   X * MyX = new X; // C3622: 'X': a class declared as 'abstract'
                    // cannot be instantiated. See declaration of 'X'}

The following code example generates an error because function f includes a definition but is marked abstract. The final statement in the example shows that declaring an abstract virtual function is equivalent to declaring a pure virtual function.

// abstract_keyword_3.cpp
// compile with: /clr
ref class X {
public:
   virtual void f() abstract {}   // C3634
   virtual void g() = 0 {}   // C3634
};

See also

Component Extensions for .NET and UWP