| // 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 |
| |
| /* |
| ** Our memory representation for parsing tables and messages themselves. |
| ** Functions in this file are used by generated code and possibly reflection. |
| ** |
| ** The definitions in this file are internal to upb. |
| **/ |
| |
| #ifndef UPB_MESSAGE_INTERNAL_MESSAGE_H_ |
| #define UPB_MESSAGE_INTERNAL_MESSAGE_H_ |
| |
| #include <stdlib.h> |
| #include <string.h> |
| |
| #include "upb/mem/arena.h" |
| #include "upb/message/internal/extension.h" |
| #include "upb/mini_table/message.h" |
| |
| // Must be last. |
| #include "upb/port/def.inc" |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| extern const float kUpb_FltInfinity; |
| extern const double kUpb_Infinity; |
| extern const double kUpb_NaN; |
| |
| // Internal members of a upb_Message that track unknown fields and/or |
| // extensions. We can change this without breaking binary compatibility. |
| |
| typedef struct upb_Message_Internal { |
| // Total size of this structure, including the data that follows. |
| // Must be aligned to 8, which is alignof(upb_Extension) |
| uint32_t size; |
| |
| /* Offsets relative to the beginning of this structure. |
| * |
| * Unknown data grows forward from the beginning to unknown_end. |
| * Extension data grows backward from size to ext_begin. |
| * When the two meet, we're out of data and have to realloc. |
| * |
| * If we imagine that the final member of this struct is: |
| * char data[size - overhead]; // overhead = sizeof(upb_Message_Internal) |
| * |
| * Then we have: |
| * unknown data: data[0 .. (unknown_end - overhead)] |
| * extensions data: data[(ext_begin - overhead) .. (size - overhead)] */ |
| uint32_t unknown_end; |
| uint32_t ext_begin; |
| // Data follows, as if there were an array: |
| // char data[size - sizeof(upb_Message_Internal)]; |
| } upb_Message_Internal; |
| |
| #ifdef UPB_TRACING_ENABLED |
| UPB_API void upb_Message_LogNewMessage(const upb_MiniTable* m, |
| const upb_Arena* arena); |
| UPB_API void upb_Message_SetNewMessageTraceHandler( |
| void (*handler)(const upb_MiniTable*, const upb_Arena*)); |
| #endif // UPB_TRACING_ENABLED |
| |
| // Inline version upb_Message_New(), for internal use. |
| UPB_INLINE struct upb_Message* _upb_Message_New(const upb_MiniTable* m, |
| upb_Arena* a) { |
| #ifdef UPB_TRACING_ENABLED |
| upb_Message_LogNewMessage(m, a); |
| #endif // UPB_TRACING_ENABLED |
| |
| const int size = m->UPB_PRIVATE(size); |
| struct upb_Message* msg = (struct upb_Message*)upb_Arena_Malloc(a, size); |
| if (UPB_UNLIKELY(!msg)) return NULL; |
| memset(msg, 0, size); |
| return msg; |
| } |
| |
| // Discards the unknown fields for this message only. |
| void _upb_Message_DiscardUnknown_shallow(struct upb_Message* msg); |
| |
| // Adds unknown data (serialized protobuf data) to the given message. |
| // The data is copied into the message instance. |
| bool UPB_PRIVATE(_upb_Message_AddUnknown)(struct upb_Message* msg, |
| const char* data, size_t len, |
| upb_Arena* arena); |
| |
| bool UPB_PRIVATE(_upb_Message_Realloc)(struct upb_Message* msg, size_t need, |
| upb_Arena* arena); |
| |
| #ifdef __cplusplus |
| } /* extern "C" */ |
| #endif |
| |
| #include "upb/port/undef.inc" |
| |
| #endif /* UPB_MESSAGE_INTERNAL_MESSAGE_H_ */ |