Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chokobole/data_view
c++ version of js DataView
https://github.com/chokobole/data_view
bazel-support cpp cpp-library cpp14 cpp14-library dataview endian
Last synced: about 2 months ago
JSON representation
c++ version of js DataView
- Host: GitHub
- URL: https://github.com/chokobole/data_view
- Owner: chokobole
- License: bsd-3-clause
- Created: 2019-12-27T18:21:10.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-11T20:43:42.000Z (8 months ago)
- Last Synced: 2024-04-12T00:53:55.666Z (8 months ago)
- Topics: bazel-support, cpp, cpp-library, cpp14, cpp14-library, dataview, endian
- Language: C++
- Size: 8.79 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DataView
`DataView` is similar to javascript [DataView](https://developer.mozilla.org/ko/docs/Web/JavaScript/Reference/Global_Objects/DataView). It can read or write by from `uint8` to `double`.
## Contents
- [DataView](#dataview)
- [Contents](#contents)
- [How to use](#how-to-use)
- [Examples](#examples)
- [Usages](#usages)
- [DataView](#dataview-1)
- [Read](#read)
- [Write](#write)
## How to use
To use `data_view`, add the followings to your `WORKSPACE` file.
```python
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
name = "data_view",
sha256 = "",
strip_prefix = "data_view-",
urls = [
"https://github.com/chokobole/data_view/archive/.tar.gz",
],
)
```
Then, in your `BUILD` files, import and use the rules.
```python
load("@data_view//bazel:data_view_cc.bzl", "data_view_copts")
cc_library(
name = "...",
copts = data_view_copts(),
deps = [
"@data_view",
]
)
```
## Examples
Build example.
```bash
bazel run //examples:example
```
```c++
#include
#include "data_view/data_view.h"
int main() {
const char buf[] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11};
size_t buf_len = sizeof(buf);
data_view::ConstDataView data_view(buf, buf_len);
uint16_t v;
data_view.Read(0, &v, true);
std::cout << v << std::endl; // 256
data_view.Read(0, &v, false);
std::cout << v << std::endl; // 1
return 0;
}
```
## Usages
### DataView
If you want to just read bytes, then use `ConstDataView`. If you want to modify bytes, then use `DataView`.
### Read
Signature of `Read` is like below.
```c++
// Returns true if succeeded to read. (offset + sizeof(T) <= |length_|)
template
bool Read(size_t offset, T* value, bool little_endian) const;
```
* `offset`: byte offset to read from.
* `value`
* `little_endian`: If set true, read as little endian, Otherwise read as big endian.
For example,
```c++
data_view::ConstDataView data_view;
uint16_t v;
data_view.Read(0, &v, true);
```
### Write
Signature of `Write` is like below.
```c++
// Returns true if succeeded to write. (offset + sizeof(T) <= |length_|)
template
bool Write(size_t offset, T value, bool little_endian);
```
* `offset`: byte offset to write to.
* `value`
* `little_endian`: If set true, write as little endian, Otherwise write as big endian.
For example,
```c++
char buf[16] = {0,};
size_t buf_len = sizeof(buf);
data_view::DataView data_view(buf, buf_len);
data_view.Write(0, 127, true);
```