/* * This file is part of the TrinityCore Project. See AUTHORS file for Copyright information * * This program is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License as published by the * Free Software Foundation; either version 2 of the License, or (at your * option) any later version. * * This program is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for * more details. * * You should have received a copy of the GNU General Public License along * with this program. If not, see . */ #ifndef TRINITYCORE_BYTE_BUFFER_H #define TRINITYCORE_BYTE_BUFFER_H #include "Define.h" #include "ByteConverter.h" #include #include #include #include class MessageBuffer; // Root of ByteBuffer exception hierarchy class TC_SHARED_API ByteBufferException : public std::exception { public: explicit ByteBufferException() = default; explicit ByteBufferException(std::string&& message) noexcept : msg_(std::move(message)) { } char const* what() const noexcept override { return msg_.c_str(); } protected: std::string msg_; }; class TC_SHARED_API ByteBufferPositionException : public ByteBufferException { public: ByteBufferPositionException(size_t pos, size_t size, size_t valueSize); }; class TC_SHARED_API ByteBufferInvalidValueException : public ByteBufferException { public: ByteBufferInvalidValueException(char const* type, std::string_view value); }; class TC_SHARED_API ByteBuffer { public: constexpr static size_t DEFAULT_SIZE = 0x1000; constexpr static uint8 InitialBitPos = 8; // constructor ByteBuffer() : _rpos(0), _wpos(0), _bitpos(InitialBitPos), _curbitval(0) { _storage.reserve(DEFAULT_SIZE); } // reserve/resize tag struct Reserve { }; struct Resize { }; ByteBuffer(size_t size, Reserve) : _rpos(0), _wpos(0), _bitpos(InitialBitPos), _curbitval(0) { _storage.reserve(size); } ByteBuffer(size_t size, Resize) : _rpos(0), _wpos(size), _bitpos(InitialBitPos), _curbitval(0) { _storage.resize(size); } ByteBuffer(ByteBuffer&& buf) noexcept : _rpos(buf._rpos), _wpos(buf._wpos), _bitpos(buf._bitpos), _curbitval(buf._curbitval), _storage(buf.Move()) { } ByteBuffer(ByteBuffer const& right) = default; ByteBuffer(MessageBuffer&& buffer); std::vector&& Move() noexcept { _rpos = 0; _wpos = 0; _bitpos = InitialBitPos; _curbitval = 0; return std::move(_storage); } ByteBuffer& operator=(ByteBuffer const& right) { if (this != &right) { _rpos = right._rpos; _wpos = right._wpos; _bitpos = right._bitpos; _curbitval = right._curbitval; _storage = right._storage; } return *this; } ByteBuffer& operator=(ByteBuffer&& right) noexcept { if (this != &right) { _rpos = right._rpos; _wpos = right._wpos; _bitpos = right._bitpos; _curbitval = right._curbitval; _storage = right.Move(); } return *this; } virtual ~ByteBuffer() = default; void clear() { _rpos = 0; _wpos = 0; _bitpos = InitialBitPos; _curbitval = 0; _storage.clear(); } template void append(T value) { static_assert(std::is_trivially_copyable_v, "append(T) must be used with trivially copyable types"); EndianConvert(value); append(reinterpret_cast(&value), sizeof(value)); } bool HasUnfinishedBitPack() const { return _bitpos != 8; } void FlushBits() { if (_bitpos == 8) return; _bitpos = 8; append(&_curbitval, sizeof(uint8)); _curbitval = 0; } void ResetBitPos() { _bitpos = 8; _curbitval = 0; } bool WriteBit(bool bit) { --_bitpos; if (bit) _curbitval |= (1 << (_bitpos)); if (_bitpos == 0) { _bitpos = 8; append(&_curbitval, sizeof(_curbitval)); _curbitval = 0; } return bit; } bool ReadBit() { if (_bitpos >= 8) { read(&_curbitval, 1); _bitpos = 0; } return ((_curbitval >> (8 - ++_bitpos)) & 1) != 0; } void WriteBits(uint64 value, int32 bits) { // remove bits that don't fit value &= (UI64LIT(1) << bits) - 1; if (bits > int32(_bitpos)) { // first write to fill bit buffer _curbitval |= value >> (bits - _bitpos); bits -= _bitpos; _bitpos = 8; // required "unneccessary" write to avoid double flushing append(&_curbitval, sizeof(_curbitval)); // then append as many full bytes as possible while (bits >= 8) { bits -= 8; append(value >> bits); } // store remaining bits in the bit buffer _bitpos = 8 - bits; _curbitval = (value & ((UI64LIT(1) << bits) - 1)) << _bitpos; } else { // entire value fits in the bit buffer _bitpos -= bits; _curbitval |= value << _bitpos; if (_bitpos == 0) { _bitpos = 8; append(&_curbitval, sizeof(_curbitval)); _curbitval = 0; } } } uint32 ReadBits(int32 bits) { uint32 value = 0; if (bits > 8 - int32(_bitpos)) { // first retrieve whatever is left in the bit buffer int32 bitsInBuffer = 8 - _bitpos; value = (_curbitval & ((UI64LIT(1) << bitsInBuffer) - 1)) << (bits - bitsInBuffer); bits -= bitsInBuffer; // then read as many full bytes as possible while (bits >= 8) { bits -= 8; value |= read() << bits; } // and finally any remaining bits if (bits) { read(&_curbitval, 1); value |= (_curbitval >> (8 - bits)) & ((UI64LIT(1) << bits) - 1); _bitpos = bits; } } else { // entire value is in the bit buffer value = (_curbitval >> (8 - _bitpos - bits)) & ((UI64LIT(1) << bits) - 1); _bitpos += bits; } return value; } template void put(std::size_t pos, T value) { static_assert(std::is_trivially_copyable_v, "put(size_t, T) must be used with trivially copyable types"); EndianConvert(value); put(pos, reinterpret_cast(&value), sizeof(value)); } /** * @name PutBits * @brief Places specified amount of bits of value at specified position in packet. * To ensure all bits are correctly written, only call this method after * bit flush has been performed * @param pos Position to place the value at, in bits. The entire value must fit in the packet * It is advised to obtain the position using bitwpos() function. * @param value Data to write. * @param bitCount Number of bits to store the value on. */ void PutBits(std::size_t pos, std::size_t value, uint32 bitCount); ByteBuffer& operator<<(uint8 value) { append(value); return *this; } ByteBuffer& operator<<(uint16 value) { append(value); return *this; } ByteBuffer& operator<<(uint32 value) { append(value); return *this; } ByteBuffer& operator<<(uint64 value) { append(value); return *this; } // signed as in 2e complement ByteBuffer& operator<<(int8 value) { append(value); return *this; } ByteBuffer& operator<<(int16 value) { append(value); return *this; } ByteBuffer& operator<<(int32 value) { append(value); return *this; } ByteBuffer& operator<<(int64 value) { append(value); return *this; } // floating points ByteBuffer& operator<<(float value) { append(value); return *this; } ByteBuffer& operator<<(double value) { append(value); return *this; } ByteBuffer& operator<<(std::string_view value) { if (size_t len = value.length()) append(reinterpret_cast(value.data()), len); append(static_cast(0)); return *this; } ByteBuffer& operator<<(std::string const& str) { return operator<<(std::string_view(str)); } ByteBuffer& operator<<(char const* str) { return operator<<(std::string_view(str ? str : "")); } ByteBuffer& operator>>(bool& value) { value = read() > 0; return *this; } ByteBuffer& operator>>(uint8& value) { read(&value, 1); return *this; } ByteBuffer& operator>>(uint16& value) { read(&value, 1); return *this; } ByteBuffer& operator>>(uint32& value) { read(&value, 1); return *this; } ByteBuffer& operator>>(uint64& value) { read(&value, 1); return *this; } //signed as in 2e complement ByteBuffer& operator>>(int8& value) { read(&value, 1); return *this; } ByteBuffer& operator>>(int16& value) { read(&value, 1); return *this; } ByteBuffer& operator>>(int32& value) { read(&value, 1); return *this; } ByteBuffer& operator>>(int64& value) { read(&value, 1); return *this; } ByteBuffer& operator>>(float& value); ByteBuffer& operator>>(double& value); ByteBuffer& operator>>(std::string& value) { value = ReadCString(true); return *this; } uint8& operator[](size_t const pos) { if (pos >= size()) throw ByteBufferPositionException(pos, 1, size()); return _storage[pos]; } uint8 const& operator[](size_t const pos) const { if (pos >= size()) throw ByteBufferPositionException(pos, 1, size()); return _storage[pos]; } size_t rpos() const { return _rpos; } size_t rpos(size_t rpos_) { _rpos = rpos_; return _rpos; } void rfinish() { _rpos = wpos(); } size_t wpos() const { return _wpos; } size_t wpos(size_t wpos_) { _wpos = wpos_; return _wpos; } /// Returns position of last written bit size_t bitwpos() const { return _wpos * 8 + 8 - _bitpos; } size_t bitwpos(size_t newPos) { _wpos = newPos / 8; _bitpos = 8 - (newPos % 8); return _wpos * 8 + 8 - _bitpos; } template void read_skip() { read_skip(sizeof(T)); } void read_skip(size_t skip) { if (_rpos + skip > size()) throw ByteBufferPositionException(_rpos, skip, size()); ResetBitPos(); _rpos += skip; } template T read() { ResetBitPos(); T r = read(_rpos); _rpos += sizeof(T); return r; } template T read(size_t pos) const { if (pos + sizeof(T) > size()) throw ByteBufferPositionException(pos, sizeof(T), size()); T val; std::memcpy(&val, &_storage[pos], sizeof(T)); EndianConvert(val); return val; } template void read(T* dest, size_t count) { static_assert(std::is_trivially_copyable_v, "read(T*, size_t) must be used with trivially copyable types"); read(reinterpret_cast(dest), count * sizeof(T)); #if TRINITY_ENDIAN == TRINITY_BIGENDIAN for (size_t i = 0; i < count; ++i) EndianConvert(dest[i]); #endif } void read(uint8* dest, size_t len) { if (_rpos + len > size()) throw ByteBufferPositionException(_rpos, len, size()); ResetBitPos(); std::memcpy(dest, &_storage[_rpos], len); _rpos += len; } template void read(std::array& arr) { read(arr.data(), Size); } void ReadPackedUInt64(uint64& guid) { guid = 0; ReadPackedUInt64(read(), guid); } void ReadPackedUInt64(uint8 mask, uint64& value) { for (uint32 i = 0; i < 8; ++i) if (mask & (uint8(1) << i)) value |= (uint64(read()) << (i * 8)); } //! Method for writing strings that have their length sent separately in packet //! without null-terminating the string void WriteString(std::string const& str) { if (size_t len = str.length()) append(str.c_str(), len); } void WriteString(std::string_view str) { if (size_t len = str.length()) append(str.data(), len); } void WriteString(char const* str, size_t len) { if (len) append(str, len); } std::string_view ReadCString(bool requireValidUtf8 = true); std::string_view ReadString(uint32 length, bool requireValidUtf8 = true); uint8* data() { return _storage.data(); } uint8 const* data() const { return _storage.data(); } size_t size() const { return _storage.size(); } bool empty() const { return _storage.empty(); } void resize(size_t newsize) { _storage.resize(newsize, 0); _rpos = 0; _wpos = size(); } void reserve(size_t ressize) { if (ressize > size()) _storage.reserve(ressize); } void shrink_to_fit() { _storage.shrink_to_fit(); } template void append(T const* src, size_t cnt) { #if TRINITY_ENDIAN == TRINITY_LITTLEENDIAN append(reinterpret_cast(src), cnt * sizeof(T)); #else for (size_t i = 0; i < cnt; ++i) append(src[i]); #endif } void append(uint8 const* src, size_t cnt); void append(ByteBuffer const& buffer) { if (!buffer.empty()) append(buffer.data(), buffer.size()); } template void append(std::array const& arr) { append(arr.data(), Size); } // can be used in SMSG_MONSTER_MOVE opcode void appendPackXYZ(float x, float y, float z) { uint32 packed = 0; packed |= ((int)(x / 0.25f) & 0x7FF); packed |= ((int)(y / 0.25f) & 0x7FF) << 11; packed |= ((int)(z / 0.25f) & 0x3FF) << 22; *this << packed; } void AppendPackedUInt64(uint64 guid) { uint8 mask = 0; size_t pos = wpos(); *this << uint8(mask); uint8 packed[8]; if (size_t packedSize = PackUInt64(guid, &mask, packed)) append(packed, packedSize); put(pos, mask); } static size_t PackUInt64(uint64 value, uint8* mask, uint8* result) { size_t resultSize = 0; *mask = 0; memset(result, 0, 8); for (uint8 i = 0; value != 0; ++i) { if (value & 0xFF) { *mask |= uint8(1 << i); result[resultSize++] = uint8(value & 0xFF); } value >>= 8; } return resultSize; } void put(size_t pos, uint8 const* src, size_t cnt); void print_storage() const; void textlike() const; void hexlike() const; protected: size_t _rpos, _wpos; uint8 _bitpos; uint8 _curbitval; std::vector _storage; }; template <> inline std::string ByteBuffer::read() { return std::string(ReadCString()); } template <> inline void ByteBuffer::read_skip() { (void)ReadCString(); } template <> inline void ByteBuffer::read_skip() { read_skip(); } template <> inline void ByteBuffer::read_skip() { read_skip(); } extern template uint8 ByteBuffer::read(); extern template uint16 ByteBuffer::read(); extern template uint32 ByteBuffer::read(); extern template uint64 ByteBuffer::read(); extern template int8 ByteBuffer::read(); extern template int16 ByteBuffer::read(); extern template int32 ByteBuffer::read(); extern template int64 ByteBuffer::read(); extern template float ByteBuffer::read(); extern template double ByteBuffer::read(); #endif