seqan3::format_fasta Class Reference

The FastA format. More...

#include <seqan3/io/sequence_file/format_fasta.hpp>

Inheritance diagram for seqan3::format_fasta:

Public Member Functions
Constructors, destructor and assignment
	format_fasta () noexcept=default
	Defaulted.
	format_fasta (format_fasta const &) noexcept=default
	Defaulted.
format_fasta &	operator= (format_fasta const &) noexcept=default
	Defaulted.
	format_fasta (format_fasta &&) noexcept=default
	Defaulted.
format_fasta &	operator= (format_fasta &&) noexcept=default
	Defaulted.
	~format_fasta () noexcept=default
	Defaulted.

Static Public Attributes
static std::vector< std::string >	file_extensions
	The valid file extensions for this format; note that you can modify this value. More...

Protected Member Functions
template<typename stream_type , typename legal_alph_type , typename seq_type , typename id_type , typename qual_type >
void	read_sequence_record (stream_type &stream, sequence_file_input_options< legal_alph_type > const &options, seq_type &sequence, id_type &id, qual_type &qualities)
	Read from the specified stream and back-insert into the given field buffers. More...
template<typename stream_type , typename seq_type , typename id_type , typename qual_type >
void	write_sequence_record (stream_type &stream, sequence_file_output_options const &options, seq_type &&sequence, id_type &&id, qual_type &&qualities)
	Write the given fields to the specified stream. More...

Additional Inherited Members
Related Functions inherited from sequence_file_input_format
void	read_sequence_record (stream_type &stream, seqan3::sequence_file_input_options const &options, seq_type &sequence, id_type &id, qual_type &qualities)
	Read from the specified stream and back-insert into the given field buffers. More...
static inline std::vector< std::string >	file_extensions
	The format type is required to provide a vector of all supported file extensions.
Related Functions inherited from sequence_file_output_format
static inline std::vector< std::string >	file_extensions
	The format type is required to provide a vector of all supported file extensions.

Detailed Descriptionno-api

The FastA format.

Introduction

FastA is the de-facto-standard for sequence storage in bionformatics. See the article on wikipedia for a an in-depth description of the format.

fields_specialisation

The FastA format provides the fields seqan3::field::seq and seqan3::field::id. Both fields are required when writing.

Implementation notes

When reading the ID-line the identifier (either ; or >) and any blank characters before the actual ID are stripped.

This implementation supports the following less known and optional features of the format:

• ID lines beginning with ; instead of >
• line breaks and other whitespace characters in any part of the sequence
• character counts within the sequence (they are simply ignored)

The following optional features are currently not supported:

• Multiple comment lines (starting with either ; or >), only one ID line before the sequence line is accepted

Remarks

For a complete overview, take a look at Sequence File

Member Function Documentation

read_sequence_record() [no-api]

template<typename stream_type , typename legal_alph_type , typename seq_type , typename id_type , typename qual_type >

void seqan3::format_fasta::read_sequence_record ( stream_type &  stream, sequence_file_input_options< legal_alph_type > const &  options, seq_type &  sequence, id_type &  id, qual_type &  qualities  )

no-apiinlineprotected

Read from the specified stream and back-insert into the given field buffers.

Template Parameters

stream_type	Input stream, must satisfy seqan3::input_stream_over with char.
seq_type	Type of the seqan3::field::seq input; must satisfy std::ranges::output_range over a seqan3::alphabet.
id_type	Type of the seqan3::field::id input; must satisfy std::ranges::output_range over a seqan3::alphabet.
qual_type	Type of the seqan3::field::qual input; must satisfy std::ranges::output_range over a seqan3::writable_quality_alphabet.

Parameters

[in,out]	stream	The input stream to read from.
[in]	options	File specific options passed to the format.
[out]	sequence	The buffer for seqan3::field::seq input, i.e. the "sequence".
[out]	id	The buffer for seqan3::field::id input, e.g. the header line in FastA.
[out]	qualities	The buffer for seqan3::field::qual input.

Additional requirements

• The function must also accept std::ignore as parameter for any of the fields. [This is enforced by the concept checker!]
• In this case the data read for that field shall be discarded by the format.

write_sequence_record() [no-api]

template<typename stream_type , typename seq_type , typename id_type , typename qual_type >

void seqan3::format_fasta::write_sequence_record ( stream_type &  stream, sequence_file_output_options const &  options, seq_type &&  sequence, id_type &&  id, qual_type &&  qualities  )

no-apiinlineprotected

Write the given fields to the specified stream.

Template Parameters

stream_type	Output stream, must satisfy seqan3::output_stream_over with char.
seq_type	Type of the seqan3::field::seq output; must satisfy std::ranges::output_range over a seqan3::alphabet.
id_type	Type of the seqan3::field::id output; must satisfy std::ranges::output_range over a seqan3::alphabet.
qual_type	Type of the seqan3::field::qual output; must satisfy std::ranges::output_range over a seqan3::quality_alphabet.

Parameters

[in,out]	stream	The output stream to write into.
[in]	options	File specific options passed to the format.
[in]	sequence	The data for seqan3::field::seq, i.e. the "sequence".
[in]	id	The data for seqan3::field::id, e.g. the header line in FastA.
[in]	qualities	The data for seqan3::field::qual.

Additional requirements

• The format must also accept std::ignore as parameter for any of the fields, however it shall throw an exception if one of the fields required for writing the format is marked as such. [this shall be checked inside the function]

Implements sequence_file_output_format.

Member Data Documentation

file_extensions [no-api]

std::vector<std::string> seqan3::format_fasta::file_extensions

no-apiinlinestatic

Initial value:

{
        { "fasta" },
        { "fa"    },
        { "fna"   },
        { "ffn"   },
        { "faa"   },
        { "frn"   },
        { "fas"   },
    }

The valid file extensions for this format; note that you can modify this value.

---

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

• seqan3/io/sequence_file/format_fasta.hpp