/* * Copyright 2014 Google Inc. All rights reserved. * * 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 FLATBUFFERS_CODE_GENERATORS_H_ #define FLATBUFFERS_CODE_GENERATORS_H_ #include #include #include "flatbuffers/idl.h" namespace flatbuffers { // Utility class to assist in generating code through use of text templates. // // Example code: // CodeWriter code("\t"); // code.SetValue("NAME", "Foo"); // code += "void {{NAME}}() { printf("%s", "{{NAME}}"); }"; // code.SetValue("NAME", "Bar"); // code += "void {{NAME}}() { printf("%s", "{{NAME}}"); }"; // std::cout << code.ToString() << std::endl; // // Output: // void Foo() { printf("%s", "Foo"); } // void Bar() { printf("%s", "Bar"); } class CodeWriter { public: CodeWriter(std::string pad = std::string()) : pad_(pad), cur_ident_lvl_(0), ignore_ident_(false) {} // Clears the current "written" code. void Clear() { stream_.str(""); stream_.clear(); } // Associates a key with a value. All subsequent calls to operator+=, where // the specified key is contained in {{ and }} delimiters will be replaced by // the given value. void SetValue(const std::string &key, const std::string &value) { value_map_[key] = value; } std::string GetValue(const std::string &key) const { const auto it = value_map_.find(key); return it == value_map_.end() ? "" : it->second; } // Appends the given text to the generated code as well as a newline // character. Any text within {{ and }} delimiters is replaced by values // previously stored in the CodeWriter by calling SetValue above. The newline // will be suppressed if the text ends with the \\ character. void operator+=(std::string text); // Returns the current contents of the CodeWriter as a std::string. std::string ToString() const { return stream_.str(); } // Increase ident level for writing code void IncrementIdentLevel() { cur_ident_lvl_++; } // Decrease ident level for writing code void DecrementIdentLevel() { if (cur_ident_lvl_) cur_ident_lvl_--; } void SetPadding(const std::string &padding) { pad_ = padding; } private: std::map value_map_; std::stringstream stream_; std::string pad_; int cur_ident_lvl_; bool ignore_ident_; // Add ident padding (tab or space) based on ident level void AppendIdent(std::stringstream &stream); }; class BaseGenerator { public: virtual bool generate() = 0; static std::string NamespaceDir(const Parser &parser, const std::string &path, const Namespace &ns, const bool dasherize = false); std::string GeneratedFileName(const std::string &path, const std::string &file_name, const IDLOptions &options) const; protected: BaseGenerator(const Parser &parser, const std::string &path, const std::string &file_name, std::string qualifying_start, std::string qualifying_separator, std::string default_extension) : parser_(parser), path_(path), file_name_(file_name), qualifying_start_(qualifying_start), qualifying_separator_(qualifying_separator), default_extension_(default_extension) {} virtual ~BaseGenerator() {} // No copy/assign. BaseGenerator &operator=(const BaseGenerator &); BaseGenerator(const BaseGenerator &); std::string NamespaceDir(const Namespace &ns, const bool dasherize = false) const; static const char *FlatBuffersGeneratedWarning(); static std::string FullNamespace(const char *separator, const Namespace &ns); static std::string LastNamespacePart(const Namespace &ns); // tracks the current namespace for early exit in WrapInNameSpace // c++, java and csharp returns a different namespace from // the following default (no early exit, always fully qualify), // which works for js and php virtual const Namespace *CurrentNameSpace() const { return nullptr; } // Ensure that a type is prefixed with its namespace even within // its own namespace to avoid conflict between generated method // names and similarly named classes or structs std::string WrapInNameSpace(const Namespace *ns, const std::string &name) const; std::string WrapInNameSpace(const Definition &def, const std::string &suffix = "") const; std::string GetNameSpace(const Definition &def) const; const Parser &parser_; const std::string &path_; const std::string &file_name_; const std::string qualifying_start_; const std::string qualifying_separator_; const std::string default_extension_; }; struct CommentConfig { const char *first_line; const char *content_line_prefix; const char *last_line; }; extern void GenComment(const std::vector &dc, std::string *code_ptr, const CommentConfig *config, const char *prefix = ""); class FloatConstantGenerator { public: virtual ~FloatConstantGenerator() {} std::string GenFloatConstant(const FieldDef &field) const; private: virtual std::string Value(double v, const std::string &src) const = 0; virtual std::string Inf(double v) const = 0; virtual std::string NaN(double v) const = 0; virtual std::string Value(float v, const std::string &src) const = 0; virtual std::string Inf(float v) const = 0; virtual std::string NaN(float v) const = 0; template std::string GenFloatConstantImpl(const FieldDef &field) const; }; class SimpleFloatConstantGenerator : public FloatConstantGenerator { public: SimpleFloatConstantGenerator(const char *nan_number, const char *pos_inf_number, const char *neg_inf_number); private: std::string Value(double v, const std::string &src) const FLATBUFFERS_OVERRIDE; std::string Inf(double v) const FLATBUFFERS_OVERRIDE; std::string NaN(double v) const FLATBUFFERS_OVERRIDE; std::string Value(float v, const std::string &src) const FLATBUFFERS_OVERRIDE; std::string Inf(float v) const FLATBUFFERS_OVERRIDE; std::string NaN(float v) const FLATBUFFERS_OVERRIDE; const std::string nan_number_; const std::string pos_inf_number_; const std::string neg_inf_number_; }; // C++, C#, Java like generator. class TypedFloatConstantGenerator : public FloatConstantGenerator { public: TypedFloatConstantGenerator(const char *double_prefix, const char *single_prefix, const char *nan_number, const char *pos_inf_number, const char *neg_inf_number = ""); private: std::string Value(double v, const std::string &src) const FLATBUFFERS_OVERRIDE; std::string Inf(double v) const FLATBUFFERS_OVERRIDE; std::string NaN(double v) const FLATBUFFERS_OVERRIDE; std::string Value(float v, const std::string &src) const FLATBUFFERS_OVERRIDE; std::string Inf(float v) const FLATBUFFERS_OVERRIDE; std::string NaN(float v) const FLATBUFFERS_OVERRIDE; std::string MakeNaN(const std::string &prefix) const; std::string MakeInf(bool neg, const std::string &prefix) const; const std::string double_prefix_; const std::string single_prefix_; const std::string nan_number_; const std::string pos_inf_number_; const std::string neg_inf_number_; }; } // namespace flatbuffers #endif // FLATBUFFERS_CODE_GENERATORS_H_