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-2021, Knut Reinert & Freie Universität Berlin
3 // Copyright (c) 2016-2021, 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 
15 #include <seqan3/std/charconv>
16 
22 
23 // ------------------------------------------------------------------
24 // cigar
25 // ------------------------------------------------------------------
26 
27 namespace seqan3
28 {
29 
59 class cigar : public alphabet_tuple_base<cigar, uint32_t, exposition_only::cigar_operation>
60 {
61 private:
64 
66  friend base_t;
68 
69 public:
70 
100 
104  constexpr cigar() noexcept = default;
105  constexpr cigar(cigar const &) noexcept = default;
106  constexpr cigar(cigar &&) noexcept = default;
107  constexpr cigar & operator=(cigar const &) noexcept = default;
108  constexpr cigar & operator=(cigar &&) noexcept = default;
109  ~cigar() noexcept = default;
110 
111  // Inherit constructors from base
112  using base_t::base_t;
113 
122  SEQAN3_DOXYGEN_ONLY(( constexpr cigar(component_type const alph) noexcept {} ))
123 
132  SEQAN3_DOXYGEN_ONLY(( constexpr cigar & operator=(component_type const alph) noexcept {} ))
133 
134  // Inherit operators from base
135  using base_t::operator=;
137 
145  small_string<11> to_string() const noexcept
146  {
147  small_string<11> ret{}; // maximum number of digits for uint32_t + 1 char for the cigar operation
148  ret.resize(11);
149 
150  auto [ ptr, errc ] = std::to_chars(ret.data(), ret.data() + 10, get<0>(*this));
151 
152  *ptr = seqan3::to_char(get<1>(*this));
153  (void)errc;
154 
155  ret.resize(ptr - ret.data() + 1);
156  return ret;
157  }
159 
168  {
169  uint32_t num{};
170  auto [ ptr, errc ] = std::from_chars(s.data(), s.data() + 10, num);
171 
172  if ((errc != std::errc{}) || (!char_is_valid_for<operation>(*ptr)) || (*(ptr + 1) != 0))
173  {
174  get<0>(*this) = 0;
175  assign_char_to('P', get<1>(*this));
176  }
177  else
178  {
179  get<0>(*this) = num;
180  assign_char_to(*ptr, get<1>(*this));
181  }
182 
183  return *this;
184  }
186 
196  SEQAN3_DOXYGEN_ONLY(( friend template <size_t index> constexpr auto get(cigar & l) noexcept {} ))
197 
198 
206  SEQAN3_DOXYGEN_ONLY(( friend template <typename type> constexpr auto get(cigar & l) noexcept {} ))
208 };
209 
211 template <typename char_t>
212 inline debug_stream_type<char_t> & operator<<(debug_stream_type<char_t> & s, cigar const c)
213 {
214  s << c.to_string();
215  return s;
216 }
217 
218 inline namespace literals
219 {
220 
221 // ------------------------------------------------------------------
222 // literals
223 // ------------------------------------------------------------------
224 
238 inline cigar::operation operator""_cigar_operation(char const c) noexcept
239 {
240  return cigar::operation{}.assign_char(c);
241 }
242 
243 #ifdef SEQAN3_DEPRECATED_310
245 SEQAN3_DEPRECATED_310 inline cigar::operation operator""_cigar_op(char const c) noexcept
246 {
247  return cigar::operation{}.assign_char(c);
248 }
249 #endif // SEQAN3_DEPRECATED_310
251 
252 } // inline namespace literals
253 
254 } // 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:60
constexpr friend auto get(cigar &l) noexcept
Tuple-like access to the contained components.
Definition: cigar.hpp:196
small_string< 11 > to_string() const noexcept
Return the string representation.
Definition: cigar.hpp:145
constexpr cigar() noexcept=default
Defaulted.
cigar & assign_string(small_string< 11 > const s) noexcept
Assign from the string representation.
Definition: cigar.hpp:167
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:101
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:203
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.
A constexpr string implementation to manipulate string literals at compile time.