Protocol Buffers - Google's data interchange format (grpc依赖)
https://developers.google.com/protocol-buffers/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
146 lines
5.8 KiB
146 lines
5.8 KiB
// Protocol Buffers - Google's data interchange format |
|
// Copyright 2008 Google Inc. All rights reserved. |
|
// https://developers.google.com/protocol-buffers/ |
|
// |
|
// Redistribution and use in source and binary forms, with or without |
|
// modification, are permitted provided that the following conditions are |
|
// met: |
|
// |
|
// * Redistributions of source code must retain the above copyright |
|
// notice, this list of conditions and the following disclaimer. |
|
// * Redistributions in binary form must reproduce the above |
|
// copyright notice, this list of conditions and the following disclaimer |
|
// in the documentation and/or other materials provided with the |
|
// distribution. |
|
// * Neither the name of Google Inc. nor the names of its |
|
// contributors may be used to endorse or promote products derived from |
|
// this software without specific prior written permission. |
|
// |
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
|
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
|
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
|
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
|
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
|
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
|
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
|
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
|
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
|
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
|
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
|
|
|
/** |
|
* The Objective C runtime has complete enough info that most protos don’t end |
|
* up using this, so leaving it on is no cost or very little cost. If you |
|
* happen to see it causing bloat, this is the way to disable it. If you do |
|
* need to disable it, try only disabling it for Release builds as having |
|
* full TextFormat can be useful for debugging. |
|
**/ |
|
#ifndef GPBOBJC_SKIP_MESSAGE_TEXTFORMAT_EXTRAS |
|
#define GPBOBJC_SKIP_MESSAGE_TEXTFORMAT_EXTRAS 0 |
|
#endif |
|
|
|
// Used in the generated code to give sizes to enums. int32_t was chosen based |
|
// on the fact that Protocol Buffers enums are limited to this range. |
|
#if !__has_feature(objc_fixed_enum) |
|
#error All supported Xcode versions should support objc_fixed_enum. |
|
#endif |
|
|
|
// If the headers are imported into Objective-C++, we can run into an issue |
|
// where the definition of NS_ENUM (really CF_ENUM) changes based on the C++ |
|
// standard that is in effect. If it isn't C++11 or higher, the definition |
|
// doesn't allow us to forward declare. We work around this one case by |
|
// providing a local definition. The default case has to use NS_ENUM for the |
|
// magic that is Swift bridging of enums. |
|
#if (defined(__cplusplus) && __cplusplus && __cplusplus < 201103L) |
|
#define GPB_ENUM(X) enum X : int32_t X; enum X : int32_t |
|
#else |
|
#define GPB_ENUM(X) NS_ENUM(int32_t, X) |
|
#endif |
|
|
|
/** |
|
* GPB_ENUM_FWD_DECLARE is used for forward declaring enums, for example: |
|
* |
|
* ``` |
|
* GPB_ENUM_FWD_DECLARE(Foo_Enum) |
|
* |
|
* @interface BarClass : NSObject |
|
* @property (nonatomic) enum Foo_Enum value; |
|
* - (void)bazMethod:(enum Foo_Enum):value; |
|
* @end |
|
* ``` |
|
**/ |
|
#define GPB_ENUM_FWD_DECLARE(X) enum X : int32_t |
|
|
|
/** |
|
* Based upon CF_INLINE. Forces inlining in non DEBUG builds. |
|
**/ |
|
#if !defined(DEBUG) |
|
#define GPB_INLINE static __inline__ __attribute__((always_inline)) |
|
#else |
|
#define GPB_INLINE static __inline__ |
|
#endif |
|
|
|
/** |
|
* For use in public headers that might need to deal with ARC. |
|
**/ |
|
#ifndef GPB_UNSAFE_UNRETAINED |
|
#if __has_feature(objc_arc) |
|
#define GPB_UNSAFE_UNRETAINED __unsafe_unretained |
|
#else |
|
#define GPB_UNSAFE_UNRETAINED |
|
#endif |
|
#endif |
|
|
|
/** |
|
* Attribute used for Objective-C proto interface deprecations without messages. |
|
**/ |
|
#ifndef GPB_DEPRECATED |
|
#define GPB_DEPRECATED __attribute__((deprecated)) |
|
#endif |
|
|
|
/** |
|
* Attribute used for Objective-C proto interface deprecations with messages. |
|
**/ |
|
#ifndef GPB_DEPRECATED_MSG |
|
#if __has_extension(attribute_deprecated_with_message) |
|
#define GPB_DEPRECATED_MSG(msg) __attribute__((deprecated(msg))) |
|
#else |
|
#define GPB_DEPRECATED_MSG(msg) __attribute__((deprecated)) |
|
#endif |
|
#endif |
|
|
|
// If property name starts with init we need to annotate it to get past ARC. |
|
// http://stackoverflow.com/questions/18723226/how-do-i-annotate-an-objective-c-property-with-an-objc-method-family/18723227#18723227 |
|
// |
|
// Meant to be used internally by generated code. |
|
#define GPB_METHOD_FAMILY_NONE __attribute__((objc_method_family(none))) |
|
|
|
// Prevent subclassing of generated proto classes. |
|
#ifndef GPB_FINAL |
|
#define GPB_FINAL __attribute__((objc_subclassing_restricted)) |
|
#endif // GPB_FINAL |
|
|
|
// ---------------------------------------------------------------------------- |
|
// These version numbers are all internal to the ObjC Protobuf runtime; they |
|
// are used to ensure compatibility between the generated sources and the |
|
// headers being compiled against and/or the version of sources being run |
|
// against. |
|
// |
|
// They are all #defines so the values are captured into every .o file they |
|
// are used in and to allow comparisons in the preprocessor. |
|
|
|
// Current library runtime version. |
|
// - Gets bumped when the runtime makes changes to the interfaces between the |
|
// generated code and runtime (things added/removed, etc). |
|
#define GOOGLE_PROTOBUF_OBJC_VERSION 30004 |
|
|
|
// Minimum runtime version supported for compiling/running against. |
|
// - Gets changed when support for the older generated code is dropped. |
|
#define GOOGLE_PROTOBUF_OBJC_MIN_SUPPORTED_VERSION 30001 |
|
|
|
|
|
// This is a legacy constant now frozen in time for old generated code. If |
|
// GOOGLE_PROTOBUF_OBJC_MIN_SUPPORTED_VERSION ever gets moved above 30001 then |
|
// this should also change to break code compiled with an old runtime that |
|
// can't be supported any more. |
|
#define GOOGLE_PROTOBUF_OBJC_GEN_VERSION 30001
|
|
|