Chemical Data Processing Library C++ API - Version 1.2.0
Variables
CDPL::Chem::BondDirection Namespace Reference

Provides constants for the specification of directional bonds in Daylight SMILES and SMARTS strings. More...

Variables

constexpr unsigned int NONE = 0x0
 Specifies that the bond has no associated direction. More...
 
constexpr unsigned int UP = 0x1
 Specifies that the bond is directed upwards. More...
 
constexpr unsigned int DOWN = 0x2
 Specifies that the bond is directed downwards. More...
 
constexpr unsigned int UNSPECIFIED = 0x4
 In a substructure search query pattern this flag indicates that the specified query bond direction is not mandatory and that target bonds with an unspecified direction shall also be considered as a match. More...
 

Detailed Description

Provides constants for the specification of directional bonds in Daylight SMILES and SMARTS strings.

Directional bonds in Daylight SMILES or SMARTS strings are used to specify the configuration around a double bond by indicating the relative direction of the bonds to its substituent atoms. They have only a meaning when they occur on both sides of the double bond (see [SMILES, SMARTS]).

Variable Documentation

◆ NONE

constexpr unsigned int CDPL::Chem::BondDirection::NONE = 0x0
constexpr

Specifies that the bond has no associated direction.

◆ UP

constexpr unsigned int CDPL::Chem::BondDirection::UP = 0x1
constexpr

Specifies that the bond is directed upwards.

In SMILES and SMARTS strings up bonds are specified by a slash '/'.

◆ DOWN

constexpr unsigned int CDPL::Chem::BondDirection::DOWN = 0x2
constexpr

Specifies that the bond is directed downwards.

In SMILES and SMARTS strings down bonds are specified by a backslash '\'.

◆ UNSPECIFIED

constexpr unsigned int CDPL::Chem::BondDirection::UNSPECIFIED = 0x4
constexpr

In a substructure search query pattern this flag indicates that the specified query bond direction is not mandatory and that target bonds with an unspecified direction shall also be considered as a match.

The flag only has a meaning for directional bonds in SMARTS patterns where

  • its resulting bitwise OR combination with BondDirection::UP specifies that a matching target bond is required to have an upward or unspecified direction
  • and its combination with BondDirection::DOWN specifies that a target bond must have a downward or unspecified direction to be considered as a match.