| // Protocol Buffers - Google's data interchange format |
| // Copyright 2008 Google Inc. |
| // http://code.google.com/p/protobuf/ |
| // |
| // 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. |
| |
| // Author: kenton@google.com (Kenton Varda) |
| // Based on original Protocol Buffers design by |
| // Sanjay Ghemawat, Jeff Dean, and others. |
| |
| #ifndef GOOGLE_PROTOBUF_COMPILER_CPP_HELPERS_H__ |
| #define GOOGLE_PROTOBUF_COMPILER_CPP_HELPERS_H__ |
| |
| #include <string> |
| #include <google/protobuf/descriptor.h> |
| |
| namespace google { |
| namespace protobuf { |
| namespace compiler { |
| namespace cpp { |
| |
| // Commonly-used separator comments. Thick is a line of '=', thin is a line |
| // of '-'. |
| extern const char kThickSeparator[]; |
| extern const char kThinSeparator[]; |
| |
| // Returns the non-nested type name for the given type. If "qualified" is |
| // true, prefix the type with the full namespace. For example, if you had: |
| // package foo.bar; |
| // message Baz { message Qux {} } |
| // Then the qualified ClassName for Qux would be: |
| // ::foo::bar::Baz_Qux |
| // While the non-qualified version would be: |
| // Baz_Qux |
| string ClassName(const Descriptor* descriptor, bool qualified); |
| string ClassName(const EnumDescriptor* enum_descriptor, bool qualified); |
| |
| // Get the (unqualified) name that should be used for this field in C++ code. |
| // The name is coerced to lower-case to emulate proto1 behavior. People |
| // should be using lowercase-with-underscores style for proto field names |
| // anyway, so normally this just returns field->name(). |
| string FieldName(const FieldDescriptor* field); |
| |
| // Returns the scope where the field was defined (for extensions, this is |
| // different from the message type to which the field applies). |
| inline const Descriptor* FieldScope(const FieldDescriptor* field) { |
| return field->is_extension() ? |
| field->extension_scope() : field->containing_type(); |
| } |
| |
| // Strips ".proto" or ".protodevel" from the end of a filename. |
| string StripProto(const string& filename); |
| |
| // Get the C++ type name for a primitive type (e.g. "double", "::google::protobuf::int32", etc.). |
| // Note: non-built-in type names will be qualified, meaning they will start |
| // with a ::. If you are using the type as a template parameter, you will |
| // need to insure there is a space between the < and the ::, because the |
| // ridiculous C++ standard defines "<:" to be a synonym for "[". |
| const char* PrimitiveTypeName(FieldDescriptor::CppType type); |
| |
| // Get the declared type name in CamelCase format, as is used e.g. for the |
| // methods of WireFormat. For example, TYPE_INT32 becomes "Int32". |
| const char* DeclaredTypeMethodName(FieldDescriptor::Type type); |
| |
| // Convert a file name into a valid identifier. |
| string FilenameIdentifier(const string& filename); |
| |
| // Return the name of the BuildDescriptors() function for a given file. |
| string GlobalBuildDescriptorsName(const string& filename); |
| |
| } // namespace cpp |
| } // namespace compiler |
| } // namespace protobuf |
| |
| } // namespace google |
| #endif // GOOGLE_PROTOBUF_COMPILER_CPP_HELPERS_H__ |