Fn<> Is
Returns whether a concept is fulfilled.

Defined in <seqan/basic.h>
Signature Is<TConcept>::Type Is<TConcept>::VALUE

Template Parameters

TConcept A concept that is specialized with type(s) that should be tested for fulfilling the concept.

Return Values

Type True/true if TConcept is a fulfilled concept, otherwise False/false.

Detailed Description

The Is-metafunction can be used to test types for fulfilling a concept without causing compilation errors. If True or true is returned, TConcept must pass the concept test via SEQAN_CONCEPT_ASSERT. It can be used to switch between different implementations depending on the concept of a type, or in combination with SEQAN_FUNC_ENABLE_IF to make a function only visible to types of certain concepts.

Examples

Is<StringConcept<TSeq> >::Type
IfC<Is<ContainerConcept<TSeq> >::VALUE, T1, T2>::Type

std::cout << Is<IntegerConcept<int> >::VALUE << std::endl;     // 1
std::cout << Is<IntegerConcept<double> >::VALUE << std::endl;  // 0

Define a hierarchy of concepts and two models Alice and Bob that implements some of them. Is determines which concepts are explicitly or implicitly fulfilled.

struct Alice {};
struct Bob {};

SEQAN_CONCEPT(ConceptA, (T)) {};
SEQAN_CONCEPT(ConceptB, (T)) {};
SEQAN_CONCEPT_REFINE(ConceptC, (T), (ConceptA)(ConceptB)) {};
SEQAN_CONCEPT_REFINE(ConceptD, (T), (ConceptC)) {};

template<>   // Alice has no template arguments
SEQAN_CONCEPT_IMPL(Alice, (ConceptA)(ConceptB));

template<>   // Bob has no template arguments
SEQAN_CONCEPT_IMPL(Bob, (ConceptC));

std::cout << Is< ConceptA<Alice> >::VALUE << std::endl; // 1
std::cout << Is< ConceptB<Alice> >::VALUE << std::endl; // 1
std::cout << Is< ConceptC<Alice> >::VALUE << std::endl; // 0
std::cout << Is< ConceptD<Alice> >::VALUE << std::endl; // 0

std::cout << Is< ConceptA<Bob> >::VALUE << std::endl;   // 1
std::cout << Is< ConceptB<Bob> >::VALUE << std::endl;   // 1
std::cout << Is< ConceptC<Bob> >::VALUE << std::endl;   // 1
std::cout << Is< ConceptD<Bob> >::VALUE << std::endl;   // 0

See Also