---

dtool/src/interrogate/interrogateBuilder.h

Go to the documentation of this file.

// Filename: interrogateBuilder.h
// Created by:  drose (01Aug00)
//
////////////////////////////////////////////////////////////////////
//
// PANDA 3D SOFTWARE
// Copyright (c) 2001, Disney Enterprises, Inc.  All rights reserved
//
// All use of this software is subject to the terms of the Panda 3d
// Software license.  You should have received a copy of this license
// along with this source code; you will also find a current copy of
// the license at http://www.panda3d.org/license.txt .
//
// To contact the maintainers of this program write to
// panda3d@yahoogroups.com .
//
////////////////////////////////////////////////////////////////////

#ifndef INTERROGATEBUILDER_H
#define INTERROGATEBUILDER_H

#include <dtoolbase.h>

#include "interrogate_interface.h"
#include "interrogate_request.h"

#include <map>
#include <set>
#include <vector>

class CPPFunctionGroup;
class CPPInstance;
class CPPType;
class CPPSimpleType;
class CPPPointerType;
class CPPConstType;
class CPPExtensionType;
class CPPStructType;
class CPPEnumType;
class CPPFunctionType;
class CPPScope;
class CPPIdentifier;
class CPPNameComponent;
class CPPManifest;
class InterrogateType;
class InterrogateFunction;
class FunctionRemap;
class InterfaceMaker;

////////////////////////////////////////////////////////////////////
//       Class : InterrogateBuilder
// Description : This class builds up the InterrogateDatabase based on
//               the data indicated by CPPParser after reading the
//               source code.
////////////////////////////////////////////////////////////////////
class InterrogateBuilder {
public:
  void add_source_file(const string &filename);
  void read_command_file(istream &in);
  void do_command(const string &command, const string &params);
  void build();
  void write_code(ostream &out, InterrogateModuleDef *def);
  InterrogateModuleDef *make_module_def(int file_identifier);

  static string clean_identifier(const string &name);
  static string descope(const string &name);
  FunctionIndex get_destructor_for(CPPType *type);

  string get_preferred_name(CPPType *type);
  static string hash_string(const string &name, int shift_offset);

private:
  typedef set<string> Commands;
  typedef map<string, string> CommandParams;
  void insert_param_list(InterrogateBuilder::Commands &commands,
                         const string &params);

  bool in_forcetype(const string &name) const;
  string in_renametype(const string &name) const;
  bool in_ignoretype(const string &name) const;
  bool in_ignoreinvolved(const string &name) const;
  bool in_ignoreinvolved(CPPType *type) const;
  bool in_ignorefile(const string &name) const;
  bool in_ignoremember(const string &name) const;
  bool in_noinclude(const string &name) const;
  bool should_include(const string &filename) const;

  void remap_indices(vector<FunctionRemap *> &remaps);
  void scan_function(CPPFunctionGroup *fgroup);
  void scan_function(CPPInstance *function);
  void scan_struct_type(CPPStructType *type);
  void scan_enum_type(CPPEnumType *type);
  void scan_manifest(CPPManifest *manifest);
  ElementIndex scan_element(CPPInstance *element, CPPStructType *struct_type,
                            CPPScope *scope);

  FunctionIndex get_getter(CPPType *expr_type, string expression,
                           CPPStructType *struct_type, CPPScope *scope,
                           CPPInstance *element);
  FunctionIndex get_setter(CPPType *expr_type, string expression,
                           CPPStructType *struct_type, CPPScope *scope,
                           CPPInstance *element);
  FunctionIndex get_cast_function(CPPType *to_type, CPPType *from_type,
                                  const string &prefix);
  FunctionIndex
  get_function(CPPInstance *function, string description,
               CPPStructType *struct_type, CPPScope *scope,
               int flags, const string &expression = string());

  TypeIndex get_atomic_string_type();
  TypeIndex get_type(CPPType *type, bool global);

  void define_atomic_type(InterrogateType &itype, CPPSimpleType *cpptype);
  void define_wrapped_type(InterrogateType &itype, CPPPointerType *cpptype);
  void define_wrapped_type(InterrogateType &itype, CPPConstType *cpptype);
  void define_struct_type(InterrogateType &itype, CPPStructType *cpptype,
                          TypeIndex type_index, bool forced);
  void update_method_comment(CPPInstance *function, CPPStructType *struct_type,
                             CPPScope *scope);
  void define_method(CPPFunctionGroup *fgroup, InterrogateType &itype,
                     CPPStructType *struct_type, CPPScope *scope);
  void define_method(CPPInstance *function, InterrogateType &itype,
                     CPPStructType *struct_type, CPPScope *scope);
  void define_enum_type(InterrogateType &itype, CPPEnumType *cpptype);
  void define_extension_type(InterrogateType &itype,
                             CPPExtensionType *cpptype);

  static string trim_blanks(const string &str);

  typedef map<string, TypeIndex> TypesByName;
  typedef map<string, FunctionIndex> FunctionsByName;

  TypesByName _types_by_name;
  FunctionsByName _functions_by_name;

  typedef map<string, char> IncludeFiles;
  IncludeFiles _include_files;

  Commands _forcetype;
  CommandParams _renametype;
  Commands _ignoretype;
  Commands _ignoreinvolved;
  Commands _ignorefile;
  Commands _ignoremember;
  Commands _noinclude;

  string _library_hash_name;

  friend class FunctionRemap;
};

extern InterrogateBuilder builder;

#endif

---