/iOS/Framework/AppBlade/CrashReporter/Dependencies/protobuf-2.0.3/src/protobuf-c.h
C Header | 318 lines | 238 code | 47 blank | 33 comment | 2 complexity | 35152f2bb12cda79fdc999caeafbb52e MD5 | raw file
Possible License(s): CC-BY-SA-3.0, Apache-2.0
- /* --- protobuf-c.h: public protobuf c runtime api --- */
- /*
- * Copyright 2008, Dave Benson.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with
- * the License. You may obtain a copy of the License
- * at http://www.apache.org/licenses/LICENSE-2.0 Unless
- * required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on
- * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied. See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
- #ifndef __PROTOBUF_C_RUNTIME_H_
- #define __PROTOBUF_C_RUNTIME_H_
- #include <inttypes.h>
- #include <stddef.h>
- #include <assert.h>
- #ifdef __cplusplus
- # define PROTOBUF_C_BEGIN_DECLS extern "C" {
- # define PROTOBUF_C_END_DECLS }
- #else
- # define PROTOBUF_C_BEGIN_DECLS
- # define PROTOBUF_C_END_DECLS
- #endif
- PROTOBUF_C_BEGIN_DECLS
- typedef enum
- {
- PROTOBUF_C_LABEL_REQUIRED,
- PROTOBUF_C_LABEL_OPTIONAL,
- PROTOBUF_C_LABEL_REPEATED
- } ProtobufCLabel;
- typedef enum
- {
- PROTOBUF_C_TYPE_INT32,
- PROTOBUF_C_TYPE_SINT32,
- PROTOBUF_C_TYPE_SFIXED32,
- PROTOBUF_C_TYPE_INT64,
- PROTOBUF_C_TYPE_SINT64,
- PROTOBUF_C_TYPE_SFIXED64,
- PROTOBUF_C_TYPE_UINT32,
- PROTOBUF_C_TYPE_FIXED32,
- PROTOBUF_C_TYPE_UINT64,
- PROTOBUF_C_TYPE_FIXED64,
- PROTOBUF_C_TYPE_FLOAT,
- PROTOBUF_C_TYPE_DOUBLE,
- PROTOBUF_C_TYPE_BOOL,
- PROTOBUF_C_TYPE_ENUM,
- PROTOBUF_C_TYPE_STRING,
- PROTOBUF_C_TYPE_BYTES,
- //PROTOBUF_C_TYPE_GROUP, // NOT SUPPORTED
- PROTOBUF_C_TYPE_MESSAGE,
- } ProtobufCType;
- typedef int protobuf_c_boolean;
- #define PROTOBUF_C_OFFSETOF(struct, member) offsetof(struct, member)
- #define PROTOBUF_C_ASSERT(condition) assert(condition)
- #define PROTOBUF_C_ASSERT_NOT_REACHED() assert(0)
- typedef struct _ProtobufCBinaryData ProtobufCBinaryData;
- struct _ProtobufCBinaryData
- {
- size_t len;
- uint8_t *data;
- };
- typedef struct _ProtobufCIntRange ProtobufCIntRange; /* private */
- /* --- memory management --- */
- typedef struct _ProtobufCAllocator ProtobufCAllocator;
- struct _ProtobufCAllocator
- {
- void *(*alloc)(void *allocator_data, size_t size);
- void (*free)(void *allocator_data, void *pointer);
- void *(*tmp_alloc)(void *allocator_data, size_t size);
- unsigned max_alloca;
- void *allocator_data;
- };
- extern ProtobufCAllocator protobuf_c_default_allocator; /* settable */
- extern ProtobufCAllocator protobuf_c_system_allocator; /* use malloc, free etc */
- extern void (*protobuf_c_out_of_memory) (void);
- /* --- append-only data buffer --- */
- typedef struct _ProtobufCBuffer ProtobufCBuffer;
- struct _ProtobufCBuffer
- {
- void (*append)(ProtobufCBuffer *buffer,
- size_t len,
- const uint8_t *data);
- };
- /* --- enums --- */
- typedef struct _ProtobufCEnumValue ProtobufCEnumValue;
- typedef struct _ProtobufCEnumValueIndex ProtobufCEnumValueIndex;
- typedef struct _ProtobufCEnumDescriptor ProtobufCEnumDescriptor;
- struct _ProtobufCEnumValue
- {
- const char *name;
- const char *c_name;
- int value;
- };
- struct _ProtobufCEnumDescriptor
- {
- uint32_t magic;
- const char *name;
- const char *short_name;
- const char *c_name;
- const char *package_name;
- /* sorted by value */
- unsigned n_values;
- const ProtobufCEnumValue *values;
- /* sorted by name */
- unsigned n_value_names;
- const ProtobufCEnumValueIndex *values_by_name;
- /* value-ranges, for faster lookups by number */
- unsigned n_value_ranges;
- const ProtobufCIntRange *value_ranges;
- void *reserved1;
- void *reserved2;
- void *reserved3;
- void *reserved4;
- };
- /* --- messages --- */
- typedef struct _ProtobufCMessageDescriptor ProtobufCMessageDescriptor;
- typedef struct _ProtobufCFieldDescriptor ProtobufCFieldDescriptor;
- struct _ProtobufCFieldDescriptor
- {
- const char *name;
- uint32_t id;
- ProtobufCLabel label;
- ProtobufCType type;
- unsigned quantifier_offset;
- unsigned offset;
- const void *descriptor; /* for MESSAGE and ENUM types */
- const void *default_value; /* or NULL if no default-value */
- void *reserved1;
- void *reserved2;
- };
- struct _ProtobufCMessageDescriptor
- {
- uint32_t magic;
- const char *name;
- const char *short_name;
- const char *c_name;
- const char *package_name;
- size_t sizeof_message;
- /* sorted by field-id */
- unsigned n_fields;
- const ProtobufCFieldDescriptor *fields;
- const unsigned *fields_sorted_by_name;
- /* ranges, optimization for looking up fields */
- unsigned n_field_ranges;
- const ProtobufCIntRange *field_ranges;
- void *reserved1;
- void *reserved2;
- void *reserved3;
- void *reserved4;
- };
- typedef struct _ProtobufCMessage ProtobufCMessage;
- typedef struct _ProtobufCMessageUnknownField ProtobufCMessageUnknownField;
- struct _ProtobufCMessage
- {
- const ProtobufCMessageDescriptor *descriptor;
- unsigned n_unknown_fields;
- ProtobufCMessageUnknownField *unknown_fields;
- };
- #define PROTOBUF_C_MESSAGE_INIT(descriptor) { descriptor, 0, NULL }
- size_t protobuf_c_message_get_packed_size(const ProtobufCMessage *message);
- size_t protobuf_c_message_pack (const ProtobufCMessage *message,
- uint8_t *out);
- size_t protobuf_c_message_pack_to_buffer (const ProtobufCMessage *message,
- ProtobufCBuffer *buffer);
- ProtobufCMessage *
- protobuf_c_message_unpack (const ProtobufCMessageDescriptor *,
- ProtobufCAllocator *allocator,
- size_t len,
- const uint8_t *data);
- void protobuf_c_message_free_unpacked (ProtobufCMessage *message,
- ProtobufCAllocator *allocator);
- /* WARNING: 'to_init' must be a block of memory
- of size description->sizeof_message. */
- size_t protobuf_c_message_init (const ProtobufCMessageDescriptor *,
- ProtobufCMessage *to_init);
- /* --- services --- */
- typedef struct _ProtobufCMethodDescriptor ProtobufCMethodDescriptor;
- typedef struct _ProtobufCServiceDescriptor ProtobufCServiceDescriptor;
- struct _ProtobufCMethodDescriptor
- {
- const char *name;
- const ProtobufCMessageDescriptor *input;
- const ProtobufCMessageDescriptor *output;
- };
- struct _ProtobufCServiceDescriptor
- {
- uint32_t magic;
- const char *name;
- const char *short_name;
- const char *c_name;
- const char *package;
- unsigned n_methods;
- const ProtobufCMethodDescriptor *methods; // sorted by name
- };
- typedef struct _ProtobufCService ProtobufCService;
- typedef void (*ProtobufCClosure)(const ProtobufCMessage *message,
- void *closure_data);
- struct _ProtobufCService
- {
- const ProtobufCServiceDescriptor *descriptor;
- void (*invoke)(ProtobufCService *service,
- unsigned method_index,
- const ProtobufCMessage *input,
- ProtobufCClosure closure,
- void *closure_data);
- void (*destroy) (ProtobufCService *service);
- };
- void protobuf_c_service_destroy (ProtobufCService *);
- /* --- querying the descriptors --- */
- const ProtobufCEnumValue *
- protobuf_c_enum_descriptor_get_value_by_name
- (const ProtobufCEnumDescriptor *desc,
- const char *name);
- const ProtobufCEnumValue *
- protobuf_c_enum_descriptor_get_value
- (const ProtobufCEnumDescriptor *desc,
- int value);
- const ProtobufCFieldDescriptor *
- protobuf_c_message_descriptor_get_field_by_name
- (const ProtobufCMessageDescriptor *desc,
- const char *name);
- const ProtobufCFieldDescriptor *
- protobuf_c_message_descriptor_get_field
- (const ProtobufCMessageDescriptor *desc,
- unsigned value);
- const ProtobufCMethodDescriptor *
- protobuf_c_service_descriptor_get_method_by_name
- (const ProtobufCServiceDescriptor *desc,
- const char *name);
- /* --- wire format enums --- */
- typedef enum
- {
- PROTOBUF_C_WIRE_TYPE_VARINT,
- PROTOBUF_C_WIRE_TYPE_64BIT,
- PROTOBUF_C_WIRE_TYPE_LENGTH_PREFIXED,
- PROTOBUF_C_WIRE_TYPE_START_GROUP, /* unsupported */
- PROTOBUF_C_WIRE_TYPE_END_GROUP, /* unsupported */
- PROTOBUF_C_WIRE_TYPE_32BIT
- } ProtobufCWireType;
- /* --- unknown message fields --- */
- struct _ProtobufCMessageUnknownField
- {
- uint32_t tag;
- ProtobufCWireType wire_type;
- size_t len;
- uint8_t *data;
- };
- /* --- extra (superfluous) api: trivial buffer --- */
- typedef struct _ProtobufCBufferSimple ProtobufCBufferSimple;
- struct _ProtobufCBufferSimple
- {
- ProtobufCBuffer base;
- size_t alloced;
- size_t len;
- uint8_t *data;
- protobuf_c_boolean must_free_data;
- };
- #define PROTOBUF_C_BUFFER_SIMPLE_INIT(array_of_bytes) \
- { { protobuf_c_buffer_simple_append }, \
- sizeof(array_of_bytes), 0, (array_of_bytes), 0 }
- #define PROTOBUF_C_BUFFER_SIMPLE_CLEAR(simp_buf) \
- do { if ((simp_buf)->must_free_data) \
- protobuf_c_default_allocator.free (&protobuf_c_default_allocator.allocator_data, (simp_buf)->data); } while (0)
- /* ====== private ====== */
- #include "protobuf-c-private.h"
- PROTOBUF_C_END_DECLS
- #endif /* __PROTOBUF_C_RUNTIME_H_ */