SeqAn3  3.0.3
The Modern C++ library for sequence analysis.
cigar.hpp
Go to the documentation of this file.
1 // -----------------------------------------------------------------------------------------------------
2 // Copyright (c) 2006-2020, Knut Reinert & Freie Universität Berlin
3 // Copyright (c) 2016-2020, Knut Reinert & MPI für molekulare Genetik
4 // This file may be used, modified and/or redistributed under the terms of the 3-clause BSD-License
5 // shipped with this file and also available at: https://github.com/seqan/seqan3/blob/master/LICENSE.md
6 // -----------------------------------------------------------------------------------------------------
7 
13 #pragma once
14 
20 #include <seqan3/std/charconv>
21 
22 // ------------------------------------------------------------------
23 // cigar
24 // ------------------------------------------------------------------
25 
26 namespace seqan3
27 {
28 
58 class cigar : public alphabet_tuple_base<cigar, uint32_t, exposition_only::cigar_operation>
59 {
60 private:
63 
65  friend base_t;
67 
68 public:
69 
99 
103  constexpr cigar() noexcept = default;
104  constexpr cigar(cigar const &) noexcept = default;
105  constexpr cigar(cigar &&) noexcept = default;
106  constexpr cigar & operator=(cigar const &) noexcept = default;
107  constexpr cigar & operator=(cigar &&) noexcept = default;
108  ~cigar() noexcept = default;
109 
110  // Inherit constructors from base
111  using base_t::base_t;
112 
121  SEQAN3_DOXYGEN_ONLY(( constexpr cigar(component_type const alph) noexcept {} ))
122 
131  SEQAN3_DOXYGEN_ONLY(( constexpr cigar & operator=(component_type const alph) noexcept {} ))
132 
133  // Inherit operators from base
134  using base_t::operator=;
136 
144  small_string<11> to_string() const noexcept
145  {
146  small_string<11> ret{}; // maximum number of digits for uint32_t + 1 char for the cigar operation
147  ret.resize(11);
148 
149  auto [ ptr, errc ] = std::to_chars(ret.data(), ret.data() + 10, get<0>(*this));
150 
151  *ptr = seqan3::to_char(get<1>(*this));
152  (void)errc;
153 
154  ret.resize(ptr - ret.data() + 1);
155  return ret;
156  }
158 
167  {
168  uint32_t num{};
169  auto [ ptr, errc ] = std::from_chars(s.data(), s.data() + 10, num);
170 
171  if ((errc != std::errc{}) || (!char_is_valid_for<operation>(*ptr)) || (*(ptr + 1) != 0))
172  {
173  get<0>(*this) = 0;
174  assign_char_to('P', get<1>(*this));
175  }
176  else
177  {
178  get<0>(*this) = num;
179  assign_char_to(*ptr, get<1>(*this));
180  }
181 
182  return *this;
183  }
185 
195  SEQAN3_DOXYGEN_ONLY(( friend template <size_t index> constexpr auto get(cigar & l) noexcept {} ))
196 
197 
205  SEQAN3_DOXYGEN_ONLY(( friend template <typename type> constexpr auto get(cigar & l) noexcept {} ))
207 };
208 
210 template <typename char_t>
211 inline debug_stream_type<char_t> & operator<<(debug_stream_type<char_t> & s, cigar const c)
212 {
213  s << c.to_string();
214  return s;
215 }
216 
217 // ------------------------------------------------------------------
218 // literals
219 // ------------------------------------------------------------------
220 
231 inline cigar::operation operator""_cigar_operation(char const c) noexcept
232 {
233  return cigar::operation{}.assign_char(c);
234 }
235 
237 SEQAN3_DEPRECATED_310 inline cigar::operation operator""_cigar_op(char const c) noexcept
238 {
239  return cigar::operation{}.assign_char(c);
240 }
242 
243 } // namespace seqan3
Provides seqan3::alphabet_tuple_base.
Introduces the seqan3::exposition_only::cigar_operation alphabet.
constexpr derived_type & assign_char(char_type const chr) noexcept
Assign from a character, implicitly converts invalid characters.
Definition: alphabet_base.hpp:211
The CRTP base for a combined alphabet that contains multiple values of different alphabets at the sam...
Definition: alphabet_tuple_base.hpp:124
The seqan3::cigar semialphabet pairs a counter with a seqan3::cigar::operation letter.
Definition: cigar.hpp:59
constexpr friend auto get(cigar &l) noexcept
Tuple-like access to the contained components.
Definition: cigar.hpp:195
small_string< 11 > to_string() const noexcept
Return the string representation.
Definition: cigar.hpp:144
constexpr cigar() noexcept=default
Defaulted.
alphabet_tuple_base< cigar, uint32_t, exposition_only::cigar_operation > base_t
The base class.
Definition: cigar.hpp:62
cigar & assign_string(small_string< 11 > const s) noexcept
Assign from the string representation.
Definition: cigar.hpp:166
The actual implementation of seqan3::cigar::operation for documentation purposes only.
Definition: cigar_operation.hpp:48
Implements a small string that can be used for compile time computations.
Definition: small_string.hpp:44
constexpr void resize(size_type const count) noexcept
Resizes the container to contain count elements.
Definition: small_string.hpp:233
Provides seqan3::debug_stream and related types.
T from_chars(T... args)
debug_stream_type< char_t > & operator<<(debug_stream_type< char_t > &stream, alignment_t &&alignment)
Stream operator for alignments, which are represented as tuples of aligned sequences.
Definition: debug_stream_alignment.hpp:103
constexpr auto assign_char_to
Assign a character to an alphabet object.
Definition: concept.hpp:523
constexpr auto to_char
Return the char representation of an alphabet object.
Definition: concept.hpp:384
The main SeqAn3 namespace.
Definition: aligned_sequence_concept.hpp:29
#define SEQAN3_DEPRECATED_310
Deprecation message for SeqAn 3.1.0 release.
Definition: platform.hpp:202
A constexpr string implementation to manipulate string literals at compile time.
Provides std::from_chars and std::to_chars if not defined in the stdlib <charconv> header.
T to_chars(T... args)
Provides alphabet adaptations for standard uint types.