AMSG is an C++ serialization library.
- Lightweight, fast and efficient serialization implementations
- Only one macro to register C++ struct, one line code that's all
- Header only, no need to build library, just three hpp files
- Support C++11
- Default support C++ built-in types and all std containters
struct person
{
std::string name;
int age;
bool operator==(person const& rhs) const
{
return name == rhs.name && age == rhs.age;
}
};
AMSG(person, (name)(age));
#define ENOUGH_SIZE 4096
unsigned char buf[ENOUGH_SIZE];
// serialize
person src;
src.name = "lordoffox"
src.age = 33
amsg::zero_copy_buffer writer;
writer.set_write(buf, ENOUGH_SIZE);
amsg::write(writer, src);
assert(!writer.bad());
// deserialize
person des;
amsg::zero_copy_buffer reader;
reader.set_read(buf, ENOUGH_SIZE);
amsg::read(reader, des);
assert(!reader.bad());
assert(src == des);- CMake 2.8 and newer
- Boost 1.55.0 and newer (Header only)
- GCC >= 4.8
- VC >= 12.0 (sp1)
#include <amsg/all.hpp>
// C++11's forward_list
#include <forward_list>
std::forward_list<int> fwd_list = {1,2,3,4,5};
unsigned char buf[4096];
amsg::zero_copy_buffer writer;
writer.set_write(buf, 4096);
amsg::write(writer, fwd_list);
assert(!writer.bad());Using amsg::size_of to get object's serialize size
struct person
{
std::string name;
int age;
bool operator==(person const& rhs) const
{
return name == rhs.name && age == rhs.age;
}
};
AMSG(person, (name)(age));
person obj;
std::size_t size = amsg::size_of(obj);
std::cout << "person's serialize size: " << size << std::endl;Sometimes you want limit max size of an array of string:
struct person
{
std::string name;
int age;
bool operator==(person const& rhs) const
{
return name == rhs.name && age == rhs.age;
}
};
AMSG(person, (name&smax(30))(age)); // smax(30) limit name string max size is 30 bytesSometimes you want serialization size to be fixed:
struct person
{
std::string name;
boost::int32_t age;
bool operator==(person const& rhs) const
{
return name == rhs.name && age == rhs.age;
}
};
AMSG(person, (name)(age&sfix)); // sfix enforce age (int32_t) to be 4bytes after serializationIf no sfix, age will dependence its value: -128 to 127 --> 1byte -32,768 to 32,767 --> 2byte -2,147,483,648 to 2,147,483,647 --> 4byte
note: sfix only effect built-in types(int, short, long, char, float, double and so on).
Change list: V2.0:
1.refact with C++11, less and clean code for human readable.
2.add forwards and backwards compatibility.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent