SeqAn3  3.0.3
The Modern C++ library for sequence analysis.
seqan3::dna15 Class Reference

The 15 letter DNA alphabet, containing all IUPAC smybols minus the gap. More...

#include <seqan3/alphabet/nucleotide/dna15.hpp>

+ Inheritance diagram for seqan3::dna15:

Public Member Functions

Constructors, destructor and assignment
constexpr dna15 () noexcept=default
 Defaulted.
 
constexpr dna15 (dna15 const &) noexcept=default
 Defaulted.
 
constexpr dna15 (dna15 &&) noexcept=default
 Defaulted.
 
constexpr dna15operator= (dna15 const &) noexcept=default
 Defaulted.
 
constexpr dna15operator= (dna15 &&) noexcept=default
 Defaulted.
 
 ~dna15 () noexcept=default
 Defaulted.
 
template<std::same_as< rna15 > t>
constexpr dna15 (t const &r) noexcept
 Allow implicit construction from dna/rna of the same size.
 
- Public Member Functions inherited from seqan3::nucleotide_base< dna15, 15 >
constexpr dna15 complement () const noexcept
 Return the complement of the letter. More...
 
constexpr nucleotide_base (other_nucl_type const &other) noexcept
 Allow explicit construction from any other nucleotide type and convert via the character representation.
 
- Public Member Functions inherited from seqan3::alphabet_base< derived_type, size, char_t >
constexpr alphabet_base () noexcept=default
 Defaulted.
 
constexpr alphabet_base (alphabet_base const &) noexcept=default
 Defaulted.
 
constexpr alphabet_base (alphabet_base &&) noexcept=default
 Defaulted.
 
constexpr alphabet_baseoperator= (alphabet_base const &) noexcept=default
 Defaulted.
 
constexpr alphabet_baseoperator= (alphabet_base &&) noexcept=default
 Defaulted.
 
 ~alphabet_base () noexcept=default
 Defaulted.
 
constexpr char_type to_char () const noexcept
 Return the letter as a character of char_type. More...
 
constexpr rank_type to_rank () const noexcept
 Return the letter's numeric value (rank in the alphabet). More...
 
constexpr derived_type & assign_char (char_type const c) noexcept
 Assign from a character, implicitly converts invalid characters. More...
 
constexpr derived_type & assign_rank (rank_type const c) noexcept
 Assign from a numeric value. More...
 

Private Types

using base_t = nucleotide_base< dna15, 15 >
 The base class.
 

Private Attributes

friend base_t
 Befriend seqan3::nucleotide_base.
 
friend rna15
 Befriend seqan3::rna15 so it can copy char_to_rank.
 

Static Private Attributes

static constexpr std::array< rank_type, 256 > char_to_rank
 Char to value conversion table. More...
 
static const std::array< dna15, alphabet_sizecomplement_table
 The complement table. More...
 
static constexpr char_type rank_to_char [alphabet_size]
 Value to char conversion table. More...
 

Related Functions

(Note that these are not member functions.)

using dna15_vector = std::vector< dna15 >
 Alias for an std::vector of seqan3::dna15.
 
Literals
constexpr dna15 operator""_dna15 (char const c) noexcept
 The seqan3::dna15 char literal. More...
 
dna15_vector operator""_dna15 (char const *s, std::size_t n)
 The seqan3::dna15 string literal. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from seqan3::nucleotide_base< dna15, 15 >
static constexpr bool char_is_valid (char_type const c) noexcept
 Validate whether a character value has a one-to-one mapping to an alphabet value. More...
 
- Static Public Attributes inherited from seqan3::alphabet_base< derived_type, size, char_t >
static constexpr detail::min_viable_uint_t< size > alphabet_size = size
 The size of the alphabet, i.e. the number of different values it can take. More...
 
- Protected Types inherited from seqan3::alphabet_base< derived_type, size, char_t >
using char_type = std::conditional_t< std::same_as< char_t, void >, char, char_t >
 The char representation; conditional needed to make semi alphabet definitions legal. More...
 
using rank_type = detail::min_viable_uint_t< size - 1 >
 The type of the alphabet when represented as a number (e.g. via to_rank()). More...
 

Detailed Description

The 15 letter DNA alphabet, containing all IUPAC smybols minus the gap.

Note that you can assign 'U' as a character to dna15 and it will silently be converted to 'T'.

Like most alphabets, this alphabet cannot be initialised directly from its character representation. Instead initialise/assign from the character literal or use the function seqan3::dna15::assign_char().

int main()
{
using seqan3::operator""_dna15;
seqan3::dna15 my_letter{'A'_dna15};
my_letter.assign_char('C');
my_letter.assign_char('F'); // unknown characters are implicitly converted to N.
if (my_letter.to_char() == 'N')
seqan3::debug_stream << "yeah\n"; // "yeah";
}
constexpr derived_type & assign_char(char_type const c) noexcept
Assign from a character, implicitly converts invalid characters.
Definition: alphabet_base.hpp:159
The 15 letter DNA alphabet, containing all IUPAC smybols minus the gap.
Definition: dna15.hpp:49
Provides seqan3::debug_stream and related types.
Provides seqan3::dna15, container aliases and string literals.
debug_stream_type debug_stream
A global instance of seqan3::debug_stream_type.
Definition: debug_stream.hpp:42

Friends And Related Function Documentation

◆ operator""_dna15() [1/2]

dna15_vector operator""_dna15 ( char const *  s,
std::size_t  n 
)
related

The seqan3::dna15 string literal.

Returns
seqan3::dna15_vector

You can use this string literal to easily assign to dna15_vector:

int main()
{
using seqan3::operator""_dna15;
seqan3::dna15_vector foo{"ACGTTA"_dna15};
seqan3::dna15_vector bar = "ACGTTA"_dna15;
auto bax = "ACGTTA"_dna15;
}

◆ operator""_dna15() [2/2]

constexpr dna15 operator""_dna15 ( char const  c)
related

The seqan3::dna15 char literal.

Returns
seqan3::dna15

Member Data Documentation

◆ char_to_rank

constexpr std::array<rank_type, 256> seqan3::dna15::char_to_rank
staticconstexprprivate
Initial value:
{
[] () constexpr
{
for (auto & c : ret)
c = 8;
for (size_t rnk = 0u; rnk < alphabet_size; ++rnk)
{
ret[ rank_to_char[rnk] ] = rnk;
ret[to_lower(rank_to_char[rnk])] = rnk;
}
ret['U'] = ret['T']; ret['u'] = ret['t'];
return ret;
}()
}
static constexpr detail::min_viable_uint_t< size > alphabet_size
The size of the alphabet, i.e. the number of different values it can take.
Definition: alphabet_base.hpp:198
static constexpr char_type rank_to_char[alphabet_size]
Value to char conversion table.
Definition: dna15.hpp:88
constexpr char_type to_lower(char_type const c) noexcept
Converts 'A'-'Z' to 'a'-'z' respectively; other characters are returned as is.
Definition: transform.hpp:81

Char to value conversion table.

◆ complement_table

constexpr std::array< dna15, dna15::alphabet_size > seqan3::dna15::complement_table
staticconstexprprivate
Initial value:
{
'T'_dna15,
'V'_dna15,
'G'_dna15,
'H'_dna15,
'C'_dna15,
'D'_dna15,
'M'_dna15,
'K'_dna15,
'N'_dna15,
'Y'_dna15,
'S'_dna15,
'A'_dna15,
'B'_dna15,
'W'_dna15,
'R'_dna15
}

The complement table.

◆ rank_to_char

constexpr char_type seqan3::dna15::rank_to_char[alphabet_size]
staticconstexprprivate
Initial value:
{
'A',
'B',
'C',
'D',
'G',
'H',
'K',
'M',
'N',
'R',
'S',
'T',
'V',
'W',
'Y'
}

Value to char conversion table.


The documentation for this class was generated from the following file: