268 lines
11 KiB
C
268 lines
11 KiB
C
// Protocol Buffers - Google's data interchange format
|
|
// Copyright 2023 Google LLC. All rights reserved.
|
|
//
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file or at
|
|
// https://developers.google.com/open-source/licenses/bsd
|
|
|
|
#ifndef UPB_MESSAGE_ACCESSORS_H_
|
|
#define UPB_MESSAGE_ACCESSORS_H_
|
|
|
|
#include "upb/base/string_view.h"
|
|
#include "upb/mem/arena.h"
|
|
#include "upb/message/array.h"
|
|
#include "upb/message/internal/accessors.h"
|
|
#include "upb/message/map.h"
|
|
#include "upb/message/message.h"
|
|
#include "upb/message/tagged_ptr.h"
|
|
#include "upb/message/value.h"
|
|
#include "upb/mini_table/extension.h"
|
|
#include "upb/mini_table/field.h"
|
|
#include "upb/mini_table/message.h"
|
|
|
|
// Must be last.
|
|
#include "upb/port/def.inc"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
// Functions ending in BaseField() take a (upb_MiniTableField*) argument
|
|
// and work only on non-extension fields.
|
|
//
|
|
// Functions ending in Extension() take a (upb_MiniTableExtension*) argument
|
|
// and work only on extensions.
|
|
|
|
UPB_API_INLINE void upb_Message_Clear(upb_Message* msg, const upb_MiniTable* m);
|
|
|
|
UPB_API_INLINE void upb_Message_ClearBaseField(upb_Message* msg,
|
|
const upb_MiniTableField* f);
|
|
|
|
UPB_API_INLINE void upb_Message_ClearExtension(upb_Message* msg,
|
|
const upb_MiniTableExtension* e);
|
|
|
|
UPB_API_INLINE void upb_Message_ClearOneof(upb_Message* msg,
|
|
const upb_MiniTable* m,
|
|
const upb_MiniTableField* f);
|
|
|
|
UPB_API_INLINE bool upb_Message_HasBaseField(const upb_Message* msg,
|
|
const upb_MiniTableField* f);
|
|
|
|
UPB_API_INLINE bool upb_Message_HasExtension(const upb_Message* msg,
|
|
const upb_MiniTableExtension* e);
|
|
|
|
UPB_API_INLINE upb_MessageValue
|
|
upb_Message_GetField(const upb_Message* msg, const upb_MiniTableField* f,
|
|
upb_MessageValue default_val);
|
|
|
|
UPB_API_INLINE upb_TaggedMessagePtr upb_Message_GetTaggedMessagePtr(
|
|
const upb_Message* msg, const upb_MiniTableField* field,
|
|
upb_Message* default_val);
|
|
|
|
UPB_API_INLINE const upb_Array* upb_Message_GetArray(
|
|
const upb_Message* msg, const upb_MiniTableField* f);
|
|
|
|
UPB_API_INLINE bool upb_Message_GetBool(const upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
bool default_val);
|
|
|
|
UPB_API_INLINE double upb_Message_GetDouble(const upb_Message* msg,
|
|
const upb_MiniTableField* field,
|
|
double default_val);
|
|
|
|
UPB_API_INLINE float upb_Message_GetFloat(const upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
float default_val);
|
|
|
|
UPB_API_INLINE int32_t upb_Message_GetInt32(const upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
int32_t default_val);
|
|
|
|
UPB_API_INLINE int64_t upb_Message_GetInt64(const upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
int64_t default_val);
|
|
|
|
UPB_API_INLINE const upb_Map* upb_Message_GetMap(const upb_Message* msg,
|
|
const upb_MiniTableField* f);
|
|
|
|
UPB_API_INLINE const upb_Message* upb_Message_GetMessage(
|
|
const upb_Message* msg, const upb_MiniTableField* f);
|
|
|
|
UPB_API_INLINE upb_Array* upb_Message_GetMutableArray(
|
|
upb_Message* msg, const upb_MiniTableField* f);
|
|
|
|
UPB_API_INLINE upb_Map* upb_Message_GetMutableMap(upb_Message* msg,
|
|
const upb_MiniTableField* f);
|
|
|
|
UPB_API_INLINE upb_Message* upb_Message_GetMutableMessage(
|
|
upb_Message* msg, const upb_MiniTableField* f);
|
|
|
|
UPB_API_INLINE upb_Array* upb_Message_GetOrCreateMutableArray(
|
|
upb_Message* msg, const upb_MiniTableField* f, upb_Arena* arena);
|
|
|
|
UPB_API_INLINE upb_Map* upb_Message_GetOrCreateMutableMap(
|
|
upb_Message* msg, const upb_MiniTable* map_entry_mini_table,
|
|
const upb_MiniTableField* f, upb_Arena* arena);
|
|
|
|
UPB_API_INLINE upb_Message* upb_Message_GetOrCreateMutableMessage(
|
|
upb_Message* msg, const upb_MiniTable* mini_table,
|
|
const upb_MiniTableField* f, upb_Arena* arena);
|
|
|
|
UPB_API_INLINE upb_StringView
|
|
upb_Message_GetString(const upb_Message* msg, const upb_MiniTableField* field,
|
|
upb_StringView default_val);
|
|
|
|
UPB_API_INLINE uint32_t upb_Message_GetUInt32(const upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
uint32_t default_val);
|
|
|
|
UPB_API_INLINE uint64_t upb_Message_GetUInt64(const upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
uint64_t default_val);
|
|
|
|
UPB_API_INLINE void upb_Message_SetClosedEnum(
|
|
upb_Message* msg, const upb_MiniTable* msg_mini_table,
|
|
const upb_MiniTableField* f, int32_t value);
|
|
|
|
// BaseField Setters ///////////////////////////////////////////////////////////
|
|
|
|
UPB_API_INLINE void upb_Message_SetBaseField(upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
const void* val);
|
|
|
|
UPB_API_INLINE void upb_Message_SetBaseFieldBool(struct upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
bool value);
|
|
|
|
UPB_API_INLINE void upb_Message_SetBaseFieldDouble(struct upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
double value);
|
|
|
|
UPB_API_INLINE void upb_Message_SetBaseFieldFloat(struct upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
float value);
|
|
|
|
UPB_API_INLINE void upb_Message_SetBaseFieldInt32(struct upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
int32_t value);
|
|
|
|
UPB_API_INLINE void upb_Message_SetBaseFieldInt64(struct upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
int64_t value);
|
|
|
|
UPB_API_INLINE void upb_Message_SetBaseFieldString(struct upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
upb_StringView value);
|
|
|
|
UPB_API_INLINE void upb_Message_SetBaseFieldUInt32(struct upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
uint32_t value);
|
|
|
|
UPB_API_INLINE void upb_Message_SetBaseFieldUInt64(struct upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
uint64_t value);
|
|
|
|
// Extension Setters ///////////////////////////////////////////////////////////
|
|
|
|
UPB_API_INLINE bool upb_Message_SetExtension(upb_Message* msg,
|
|
const upb_MiniTableExtension* e,
|
|
const void* value, upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetExtensionBool(
|
|
struct upb_Message* msg, const upb_MiniTableExtension* e, bool value,
|
|
upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetExtensionDouble(
|
|
struct upb_Message* msg, const upb_MiniTableExtension* e, double value,
|
|
upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetExtensionFloat(
|
|
struct upb_Message* msg, const upb_MiniTableExtension* e, float value,
|
|
upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetExtensionInt32(
|
|
struct upb_Message* msg, const upb_MiniTableExtension* e, int32_t value,
|
|
upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetExtensionInt64(
|
|
struct upb_Message* msg, const upb_MiniTableExtension* e, int64_t value,
|
|
upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetExtensionString(
|
|
struct upb_Message* msg, const upb_MiniTableExtension* e,
|
|
upb_StringView value, upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetExtensionUInt32(
|
|
struct upb_Message* msg, const upb_MiniTableExtension* e, uint32_t value,
|
|
upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetExtensionUInt64(
|
|
struct upb_Message* msg, const upb_MiniTableExtension* e, uint64_t value,
|
|
upb_Arena* a);
|
|
|
|
// Universal Setters ///////////////////////////////////////////////////////////
|
|
|
|
UPB_API_INLINE bool upb_Message_SetBool(upb_Message* msg,
|
|
const upb_MiniTableField* f, bool value,
|
|
upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetDouble(upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
double value, upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetFloat(upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
float value, upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetInt32(upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
int32_t value, upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetInt64(upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
int64_t value, upb_Arena* a);
|
|
|
|
UPB_API_INLINE void upb_Message_SetMessage(upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
upb_Message* value);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetString(upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
upb_StringView value, upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetUInt32(upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
uint32_t value, upb_Arena* a);
|
|
|
|
UPB_API_INLINE bool upb_Message_SetUInt64(upb_Message* msg,
|
|
const upb_MiniTableField* f,
|
|
uint64_t value, upb_Arena* a);
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
UPB_API_INLINE void* upb_Message_ResizeArrayUninitialized(
|
|
upb_Message* msg, const upb_MiniTableField* f, size_t size,
|
|
upb_Arena* arena);
|
|
|
|
UPB_API_INLINE uint32_t upb_Message_WhichOneofFieldNumber(
|
|
const upb_Message* message, const upb_MiniTableField* oneof_field);
|
|
|
|
// For a field `f` which is in a oneof, return the field of that
|
|
// oneof that is actually set (or NULL if none).
|
|
UPB_API_INLINE const upb_MiniTableField* upb_Message_WhichOneof(
|
|
const upb_Message* msg, const upb_MiniTable* m,
|
|
const upb_MiniTableField* f);
|
|
|
|
// Updates a map entry given an entry message.
|
|
bool upb_Message_SetMapEntry(upb_Map* map, const upb_MiniTable* mini_table,
|
|
const upb_MiniTableField* field,
|
|
upb_Message* map_entry_message, upb_Arena* arena);
|
|
|
|
#ifdef __cplusplus
|
|
} /* extern "C" */
|
|
#endif
|
|
|
|
#include "upb/port/undef.inc"
|
|
|
|
#endif // UPB_MESSAGE_ACCESSORS_H_
|