Files
react-native/ReactCommon/react/renderer/mapbuffer/MapBuffer.h
T
Andrei Shikov d287598d23 Allow random stores and accesses to MapBuffer values
Summary:
Removes the need to store keys in incremental order by sorting them after before inserting into MapBuffer.
Updates MapBuffer to support random access on C++ side, actually retrieving values by keys and not bucket index.

Changelog: [Internal]

Reviewed By: mdvacca

Differential Revision: D33611758

fbshipit-source-id: c81e970613c8ecc688bfacb29ba038bf081a0c0f
2022-01-20 12:57:22 -08:00

81 lines
2.1 KiB
C++

/*
* Copyright (c) Meta Platforms, Inc. and affiliates.
*
* This source code is licensed under the MIT license found in the
* LICENSE file in the root directory of this source tree.
*/
#pragma once
#include <react/debug/react_native_assert.h>
#include <react/renderer/mapbuffer/primitives.h>
#include <limits>
namespace facebook {
namespace react {
class ReadableMapBuffer;
/**
* MapBuffer is an optimized map format for transferring data like props between
* C++ and other platforms The implementation of this map is optimized to:
* - be compact to optimize space when sparse (sparse is the common case).
* - be accessible through JNI with zero/minimal copying via ByteBuffer.
* - be Have excellent C++ single-write and many-read performance by maximizing
* CPU cache performance through compactness, data locality, and fixed offsets
* where possible.
* - be optimized for iteration and intersection against other maps, but with
* reasonably good random access as well.
* - Work recursively for nested maps/arrays.
* - Supports dynamic types that map to JSON.
* - Don't require mutability - single-write on creation.
* - have minimal APK size and build time impact.
*/
class MapBuffer {
friend ReadableMapBuffer;
private:
// Buffer and its size
std::vector<uint8_t> const bytes_;
// amount of items in the MapBuffer
uint16_t count_ = 0;
// returns the relative offset of the first byte of dynamic data
int32_t getDynamicDataOffset() const;
uint32_t getKeyBucket(Key key) const;
public:
explicit MapBuffer(std::vector<uint8_t> data);
MapBuffer(MapBuffer const &buffer) = delete;
MapBuffer &operator=(MapBuffer other) = delete;
MapBuffer(MapBuffer &&buffer) = default;
int32_t getInt(Key key) const;
bool getBool(Key key) const;
double getDouble(Key key) const;
std::string getString(Key key) const;
// TODO T83483191: review this declaration
MapBuffer getMapBuffer(Key key) const;
bool isNull(Key key) const;
uint32_t size() const;
uint8_t const *data() const;
uint16_t count() const;
};
} // namespace react
} // namespace facebook