voxelcoreprojects/voxelcore
1
0
Fork 0
mirror of https://github.com/MihailRis/voxelcore.git synced 2026-10-05 11:01:49 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

add StructMapping::setUnicode

Browse source
This commit is contained in:
MihailRis 2024-08-29 15:10:51 +03:00
parent 4343e81e00
commit 77229b8d9a
3 changed files with 108 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

69
src/data/StructMapper.hpp
View file

@ -44,6 +44,9 @@ namespace data {
indices(std::move(indices))
{}
/// @brief Get field by name. Returns nullptr if field not found.
/// @param name field name
/// @return nullable field pointer
const Field* getField(const std::string& name) const {
auto found = indices.find(name);
if (found == indices.end()) {
@ -53,16 +56,78 @@ namespace data {
return &fields.at(found->second);
}
/// @brief Get field by name
/// @throws std::runtime_exception - field not found
/// @param name field name
/// @return read-only field reference
const Field& requreField(const std::string& name) const;
/// @brief Get integer from specified field.
/// Types: (i8, i16, i32, i64, char)
/// @throws std::runtime_exception - field not found
/// @throws std::out_of_range - index is out of range [0, elements-1]
/// @param src source buffer
/// @param name field name
/// @param index array index
/// @return field value
[[nodiscard]]
integer_t getInteger(const ubyte* src, const std::string& name, int index=0) const;
/// @brief Get floating-point number from specified field.
/// Types: (f32, f64, i8, i16, i32, i64, char)
/// @throws std::runtime_exception - field not found
/// @throws std::out_of_range - index is out of range [0, elements-1]
/// @param src source buffer
/// @param name field name
/// @param index array index
/// @return field value
[[nodiscard]]
number_t getNumber(const ubyte* src, const std::string& name, int index=0) const;
/// @brief Get read-only chars array as string_view.
/// @param src source buffer
/// @param name field name
[[nodiscard]]
std::string_view getChars(const ubyte* src, const std::string& name) const;
/// @brief Set field integer value.
/// Types: (i8, i16, i32, i64, f32, f64, char)
/// @throws std::runtime_exception - field not found
/// @throws std::out_of_range - index is out of range [0, elements-1]
/// @param dst destination buffer
/// @param value value
/// @param name field name
/// @param index array index
void setInteger(ubyte* dst, integer_t value, const std::string& name, int index=0);
void setNumber(ubyte* dst, number_t value, const std::string& name, int index=0);
void setChars(ubyte* dst, std::string_view value, const std::string& name);
/// @brief Set field numeric value.
/// Types: (f32, f64)
/// @throws std::runtime_exception - field not found
/// @throws std::out_of_range - index is out of range [0, elements-1]
/// @param dst destination buffer
/// @param value value
/// @param name field name
/// @param index array index
void setNumber(ubyte* dst, number_t value, const std::string& name, int index=0);
/// @brief Replace chars array to given ASCII string
/// @throws std::runtime_exception - field not found
/// @see StructMapper::setUnicode - utf-8 version of setChars
/// @param dst destination buffer
/// @param value ASCII string
/// @param name field name
/// @return number of written string chars
size_t setChars(ubyte* dst, std::string_view value, const std::string& name);
/// @brief Unicode-safe version of setChars
/// @throws std::runtime_exception - field not found
/// @param dst destination buffer
/// @param value utf-8 string
/// @param name field name
/// @return number of written string chars
size_t setUnicode(ubyte* dst, std::string_view value, const std::string& name);
/// @return total structure size (bytes)
int size() const {
return totalSize;
}