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.
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_typewith the given key within the container. -
auto find(const key_
type& a_key) const -> const_ iterator noexcept - Finds a
value_typewith 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_valueinto the container with the givena_key.
Reading
-
void read(read_
source a_source) - 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(write_
sink a_sink) const - Writes the contents of the object to the destination.
Typedef documentation
using bsa::
using bsa::
using bsa::
using bsa::
using bsa::
using bsa::
using bsa::
using bsa::
Function documentation
bool bsa::
Checks if the container is empty.
std::
Returns the number of elements in the container.
iterator bsa::
Obtains an interator to the beginning of the container.
const_
Obtains an interator to the beginning of the container.
const_
Obtains an interator to the beginning of the container.
const_
Obtains an iterator to the end of the container.
iterator bsa::
Obtains an iterator to the end of the container.
const_
Obtains an iterator to the end of the container.
iterator bsa::
Finds a value_type with the given key within the container.
const_
Finds a value_type with the given key within the container.
index bsa::
Obtains a proxy to the underlying mapped_type. The validity of the proxy depends on the presence of the key within the container.
const_
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::
Erases any element with the given key from the container.
| Returns | Returns true if the element was successfully deleted, false otherwise. |
|---|
std::
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::
Reads the contents of the source.
| Parameters | |
|---|---|
| a_source | Where/how to read the given archive. |
| Exceptions | |
| binary_io::buffer_exhausted | Thrown when reads index out of bounds. |
| bsa:: |
Thrown when archive parsing errors are encountered. |
bool bsa::
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::
Writes the contents of the object to the destination.
| Parameters | |
|---|---|
| a_sink | Where/how to write the given archive. |
| Exceptions | |
| std:: |
Thrown when filesystem errors are encountered. |
| binary_io::buffer_exhausted | Thrown when the output buffer is exhausted. |