Skip to content

Latest commit

 

History

History
120 lines (88 loc) · 2.59 KB

if-exists-statement.md

File metadata and controls

120 lines (88 loc) · 2.59 KB
descriptiontitlems.datef1_keywordshelpviewer_keywordsms.assetid
Learn more about: __if_exists Statement
__if_exists Statement
11/04/2016
__if_exists_cpp
identifiers, testing for existence
symbols, testing for existence
__if_exists keyword [C++]
d3eb34b6-f3a9-4063-a286-b62a28c0c7fa

__if_exists Statement

The __if_exists statement tests whether the specified identifier exists. If the identifier exists, the specified statement block is executed.

Syntax

__if_exists ( identifier ) { statements }; 

Parameters

identifier
The identifier whose existence you want to test.

statements
One or more statements to execute if identifier exists.

Remarks

Caution

To achieve the most reliable results, use the __if_exists statement under the following constraints.

  • Apply the __if_exists statement to only simple types, not templates.

  • Apply the __if_exists statement to identifiers both inside or outside a class. Do not apply the __if_exists statement to local variables.

  • Use the __if_exists statement only in the body of a function. Outside of the body of a function, the __if_exists statement can test only fully defined types.

  • When you test for overloaded functions, you cannot test for a specific form of the overload.

The complement to the __if_exists statement is the __if_not_exists statement.

Example

Notice that this example uses templates, which is not advised.

// the__if_exists_statement.cpp// compile with: /EHsc #include<iostream>template<typename T> classX : publicT { public:voidDump() { std::cout << "In X<T>::Dump()" << std::endl; __if_exists(T::Dump) { T::Dump(); } __if_not_exists(T::Dump) { std::cout << "T::Dump does not exist" << std::endl; } } }; classA { public:voidDump() { std::cout << "In A::Dump()" << std::endl; } }; classB {}; bool g_bFlag = true; classC { public:voidf(int); voidf(double); }; intmain() { X<A> x1; X<B> x2; x1.Dump(); x2.Dump(); __if_exists(::g_bFlag) { std::cout << "g_bFlag = " << g_bFlag << std::endl; } __if_exists(C::f) { std::cout << "C::f exists" << std::endl; } return0; }

Output

In X<T>::Dump() In A::Dump() In X<T>::Dump() T::Dump does not exist g_bFlag = 1 C::f exists 

See also

Selection Statements
Keywords
__if_not_exists Statement

close