bsa::tes3::archive class final
#include <bsa/tes3.hpp>

Represents the TES3 revision of the bsa format.

Base classes

template<class T, bool RECURSE>
class bsa::components::hashmap<file>
Establishes a basic mapping between a key and its associated files.

Capacity

auto empty() const -> bool noexcept
Checks if the container is empty.
auto size() const -> std::size_t noexcept
Returns the number of elements in the container.

Doxygen only

void doxygen_read() protected
Reads the contents of the source.
void doxygen_write() const protected
Writes the contents of the object to the destination.

Iterators

auto begin() -> iterator noexcept
Obtains an interator to the beginning of the container.
auto begin() const -> const_iterator noexcept
Obtains an interator to the beginning of the container.
auto cbegin() const -> const_iterator noexcept
Obtains an interator to the beginning of the container.
auto cend() const -> const_iterator noexcept
Obtains an iterator to the end of the container.
auto end() -> iterator noexcept
Obtains an iterator to the end of the container.
auto end() const -> const_iterator noexcept
Obtains an iterator to the end of the container.

Lookup

auto find(const key_type& a_key) -> iterator noexcept
Finds a value_type with the given key within the container.
auto find(const key_type& a_key) const -> const_iterator noexcept
Finds a value_type with the given key within the container.
auto operator[](const key_type& a_key) -> index noexcept
Obtains a proxy to the underlying mapped_type. The validity of the proxy depends on the presence of the key within the container.
auto operator[](const key_type& a_key) const -> const_index noexcept
Obtains a proxy to the underlying mapped_type. The validity of the proxy depends on the presence of the key within the container.

Member types

using const_index = index_t<const mapped_type>
using const_iterator = typename container_type::const_iterator
using index = index_t<mapped_type>
using iterator = typename container_type::iterator
using key_compare = typename container_type::key_compare
using key_type = typename T::key
using mapped_type = file
using value_type = std::pair<const key_type, mapped_type>

Modifiers

void clear() noexcept
Clears the contents of the archive.
auto erase(const key_type& a_key) -> bool noexcept
Erases any element with the given key from the container.
auto insert(key_type a_key, mapped_type a_value) -> std::pair<iterator, bool> noexcept
Inserts a_value into the container with the given a_key.

Reading

void read(std::filesystem::path a_path)
Reads the contents of the source.
void read(std::span<const std::byte> a_src, copy_type a_copy = copy_type::deep)
Reads the contents of the source.

Validation

auto verify_offsets() const -> bool noexcept
Verifies that offsets within the archive will be valid when written to disk.

Writing

void write(std::filesystem::path a_path) const
Writes the contents of the object to the destination.
void write(binary_io::any_ostream& a_dst) const
Writes the contents of the object to the destination.

Typedef documentation

using bsa::tes3::archive::const_index = index_t<const mapped_type>
#include <bsa/detail/common.hpp>

using bsa::tes3::archive::const_iterator = typename container_type::const_iterator
#include <bsa/detail/common.hpp>

using bsa::tes3::archive::index = index_t<mapped_type>
#include <bsa/detail/common.hpp>

using bsa::tes3::archive::iterator = typename container_type::iterator
#include <bsa/detail/common.hpp>

using bsa::tes3::archive::key_compare = typename container_type::key_compare
#include <bsa/detail/common.hpp>

using bsa::tes3::archive::key_type = typename T::key
#include <bsa/detail/common.hpp>

using bsa::tes3::archive::mapped_type = file
#include <bsa/detail/common.hpp>

using bsa::tes3::archive::value_type = std::pair<const key_type, mapped_type>
#include <bsa/detail/common.hpp>

Function documentation

bool bsa::tes3::archive::empty() const noexcept
#include <bsa/detail/common.hpp>

Checks if the container is empty.

std::size_t bsa::tes3::archive::size() const noexcept
#include <bsa/detail/common.hpp>

Returns the number of elements in the container.

void bsa::tes3::archive::doxygen_read() protected

Reads the contents of the source.

Exceptions
binary_io::buffer_exhausted Thrown when reads index out of bounds.
bsa::exception Thrown when archive parsing errors are encountered.

void bsa::tes3::archive::doxygen_write() const protected

Writes the contents of the object to the destination.

Exceptions
std::system_error Thrown when filesystem errors are encountered.
binary_io::buffer_exhausted Thrown when the output buffer is exhausted.

iterator bsa::tes3::archive::begin() noexcept
#include <bsa/detail/common.hpp>

Obtains an interator to the beginning of the container.

const_iterator bsa::tes3::archive::begin() const noexcept
#include <bsa/detail/common.hpp>

Obtains an interator to the beginning of the container.

const_iterator bsa::tes3::archive::cbegin() const noexcept
#include <bsa/detail/common.hpp>

Obtains an interator to the beginning of the container.

const_iterator bsa::tes3::archive::cend() const noexcept
#include <bsa/detail/common.hpp>

Obtains an iterator to the end of the container.

iterator bsa::tes3::archive::end() noexcept
#include <bsa/detail/common.hpp>

Obtains an iterator to the end of the container.

const_iterator bsa::tes3::archive::end() const noexcept
#include <bsa/detail/common.hpp>

Obtains an iterator to the end of the container.

iterator bsa::tes3::archive::find(const key_type& a_key) noexcept
#include <bsa/detail/common.hpp>

Finds a value_type with the given key within the container.

const_iterator bsa::tes3::archive::find(const key_type& a_key) const noexcept
#include <bsa/detail/common.hpp>

Finds a value_type with the given key within the container.

index bsa::tes3::archive::operator[](const key_type& a_key) noexcept
#include <bsa/detail/common.hpp>

Obtains a proxy to the underlying mapped_type. The validity of the proxy depends on the presence of the key within the container.

const_index bsa::tes3::archive::operator[](const key_type& a_key) const noexcept
#include <bsa/detail/common.hpp>

Obtains a proxy to the underlying mapped_type. The validity of the proxy depends on the presence of the key within the container.

bool bsa::tes3::archive::erase(const key_type& a_key) noexcept
#include <bsa/detail/common.hpp>

Erases any element with the given key from the container.

Returns Returns true if the element was successfully deleted, false otherwise.

std::pair<iterator, bool> bsa::tes3::archive::insert(key_type a_key, mapped_type a_value) noexcept
#include <bsa/detail/common.hpp>

Inserts a_value into the container with the given a_key.

Parameters
a_key The key of the value_type.
a_value The value of the value_type.
Returns Returns an iterator to the position at which the given value_type was inserted, and a bool to indicate if the insertion was successful.

void bsa::tes3::archive::read(std::filesystem::path a_path)

Reads the contents of the source.

Parameters
a_path The path to the given archive on the native filesystem.
Exceptions
binary_io::buffer_exhausted Thrown when reads index out of bounds.
bsa::exception Thrown when archive parsing errors are encountered.
std::system_error Thrown when filesystem errors are encountered.

void bsa::tes3::archive::read(std::span<const std::byte> a_src, copy_type a_copy = copy_type::deep)

Reads the contents of the source.

Parameters
a_src The source to read from.
a_copy The method to use when copying data from a_src.
Exceptions
binary_io::buffer_exhausted Thrown when reads index out of bounds.
bsa::exception Thrown when archive parsing errors are encountered.

bool bsa::tes3::archive::verify_offsets() const noexcept

Verifies that offsets within the archive will be valid when written to disk.

Returns Returns true is the archive passes validation, false otherwise.

void bsa::tes3::archive::write(std::filesystem::path a_path) const

Writes the contents of the object to the destination.

Parameters
a_path The path to write the archive to on the native filesystem.
Exceptions
std::system_error Thrown when filesystem errors are encountered.
binary_io::buffer_exhausted Thrown when the output buffer is exhausted.

void bsa::tes3::archive::write(binary_io::any_ostream& a_dst) const

Writes the contents of the object to the destination.

Parameters
a_dst The stream to write the archive to.
Exceptions
std::system_error Thrown when filesystem errors are encountered.
binary_io::buffer_exhausted Thrown when the output buffer is exhausted.