panda3d/dtool/src/cppparser/cppDeclaration.h

/**
 * PANDA 3D SOFTWARE
 * Copyright (c) Carnegie Mellon University.  All rights reserved.
 *
 * All use of this software is subject to the terms of the revised BSD
 * license.  You should have received a copy of this license along
 * with this source code in a file named "LICENSE."
 *
 * @file cppDeclaration.h
 * @author drose
 * @date 1999-10-19
 */

#ifndef CPPDECLARATION_H
#define CPPDECLARATION_H

#include "dtoolbase.h"

#include "cppVisibility.h"
#include "cppFile.h"
#include "cppCommentBlock.h"
#include "cppAttributeList.h"

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

class CPPInstance;
class CPPTemplateParameterList;
class CPPTypedefType;
class CPPTypeDeclaration;
class CPPExpression;
class CPPType;
class CPPNamespace;
class CPPUsing;
class CPPSimpleType;
class CPPPointerType;
class CPPReferenceType;
class CPPArrayType;
class CPPConstType;
class CPPFunctionType;
class CPPFunctionGroup;
class CPPExtensionType;
class CPPStructType;
class CPPEnumType;
class CPPTypeProxy;
class CPPMakeProperty;
class CPPMakeSeq;
class CPPClosureType;
class CPPClassTemplateParameter;
class CPPTBDType;
class CPPScope;
class CPPTemplateScope;
class CPPPreprocessor;

/**
 *
 */
class CPPDeclaration {
public:
  enum SubType {
    // Empty declaration
    ST_empty,

    // Subtypes of CPPDeclaration
    ST_instance,
    ST_type_declaration,
    ST_expression,
    ST_type,
    ST_namespace,
    ST_using,
    ST_make_property,
    ST_make_seq,

    // Subtypes of CPPType
    ST_simple,
    ST_pointer,
    ST_reference,
    ST_array,
    ST_const,
    ST_function,
    ST_function_group,
    ST_extension,
    ST_struct,
    ST_enum,
    ST_class_template_parameter,
    ST_tbd,
    ST_type_proxy,
    ST_typedef,
    ST_closure,
  };

  CPPDeclaration(const CPPFile &file, CPPAttributeList attr = CPPAttributeList());
  CPPDeclaration(const CPPDeclaration &copy);
  virtual ~CPPDeclaration() {};

  CPPDeclaration &operator = (const CPPDeclaration &copy);

  bool operator == (const CPPDeclaration &other) const;
  bool operator != (const CPPDeclaration &other) const;
  bool operator < (const CPPDeclaration &other) const;

  bool is_template() const;
  CPPTemplateScope *get_template_scope() const;
  virtual bool is_fully_specified() const;
  virtual CPPDeclaration *
  instantiate(const CPPTemplateParameterList *actual_params,
              CPPScope *current_scope, CPPScope *global_scope,
              CPPPreprocessor *error_sink = nullptr) const;

  typedef std::map<CPPDeclaration *, CPPDeclaration *> SubstDecl;
  virtual CPPDeclaration *substitute_decl(SubstDecl &subst,
                                          CPPScope *current_scope,
                                          CPPScope *global_scope);

  typedef std::set<CPPDeclaration *> Instantiations;
  Instantiations _instantiations;

  virtual void output(std::ostream &out, int indent_level, CPPScope *scope,
                      bool complete) const;

  virtual SubType get_subtype() const;

  virtual CPPInstance *as_instance();
  virtual CPPClassTemplateParameter *as_class_template_parameter();
  virtual CPPTypedefType *as_typedef_type();
  virtual CPPTypeDeclaration *as_type_declaration();
  virtual CPPExpression *as_expression();
  virtual CPPType *as_type();
  virtual CPPNamespace *as_namespace();
  virtual CPPUsing *as_using();
  virtual CPPSimpleType *as_simple_type();
  virtual CPPPointerType *as_pointer_type();
  virtual CPPReferenceType *as_reference_type();
  virtual CPPArrayType *as_array_type();
  virtual CPPConstType *as_const_type();
  virtual CPPFunctionType *as_function_type();
  virtual CPPFunctionGroup *as_function_group();
  virtual CPPExtensionType *as_extension_type();
  virtual CPPStructType *as_struct_type();
  virtual CPPEnumType *as_enum_type();
  virtual CPPTBDType *as_tbd_type();
  virtual CPPTypeProxy *as_type_proxy();
  virtual CPPMakeProperty *as_make_property();
  virtual CPPMakeSeq *as_make_seq();
  virtual CPPClosureType *as_closure_type();

  inline const CPPInstance *as_instance() const {
    return ((CPPDeclaration *)this)->as_instance();
  }
  inline const CPPClassTemplateParameter *as_class_template_parameter() const {
    return ((CPPDeclaration *)this)->as_class_template_parameter();
  }
  inline const CPPTypedefType *as_typedef_type() const {
    return ((CPPDeclaration *)this)->as_typedef_type();
  }
  inline const CPPTypeDeclaration *as_type_declaration() const {
    return ((CPPDeclaration *)this)->as_type_declaration();
  }
  inline const CPPExpression *as_expression() const {
    return ((CPPDeclaration *)this)->as_expression();
  }
  inline const CPPType *as_type() const {
    return ((CPPDeclaration *)this)->as_type();
  }
  inline const CPPNamespace *as_namespace() const {
    return ((CPPDeclaration *)this)->as_namespace();
  }
  inline const CPPUsing *as_using() const {
    return ((CPPDeclaration *)this)->as_using();
  }
  inline const CPPSimpleType *as_simple_type() const {
    return ((CPPDeclaration *)this)->as_simple_type();
  }
  inline const CPPPointerType *as_pointer_type() const {
    return ((CPPDeclaration *)this)->as_pointer_type();
  }
  inline const CPPReferenceType *as_reference_type() const {
    return ((CPPDeclaration *)this)->as_reference_type();
  }
  inline const CPPArrayType *as_array_type() const {
    return ((CPPDeclaration *)this)->as_array_type();
  }
  inline const CPPConstType *as_const_type() const {
    return ((CPPDeclaration *)this)->as_const_type();
  }
  inline const CPPFunctionType *as_function_type() const {
    return ((CPPDeclaration *)this)->as_function_type();
  }
  inline const CPPFunctionGroup *as_function_group() const {
    return ((CPPDeclaration *)this)->as_function_group();
  }
  inline const CPPExtensionType *as_extension_type() const {
    return ((CPPDeclaration *)this)->as_extension_type();
  }
  inline const CPPStructType *as_struct_type() const {
    return ((CPPDeclaration *)this)->as_struct_type();
  }
  inline const CPPEnumType *as_enum_type() const {
    return ((CPPDeclaration *)this)->as_enum_type();
  }
  inline const CPPTBDType *as_tbd_type() const {
    return ((CPPDeclaration *)this)->as_tbd_type();
  }
  inline const CPPTypeProxy *as_type_proxy() const {
    return ((CPPDeclaration *)this)->as_type_proxy();
  }
  inline const CPPMakeProperty *as_make_property() const {
    return ((CPPDeclaration *)this)->as_make_property();
  }
  inline const CPPMakeSeq *as_make_seq() const {
    return ((CPPDeclaration *)this)->as_make_seq();
  }
  inline const CPPClosureType *as_closure_type() const {
    return ((CPPDeclaration *)this)->as_closure_type();
  }

  CPPVisibility _vis;
  CPPTemplateScope *_template_scope;
  CPPFile _file;
  CPPCommentBlock *_leading_comment;
  CPPAttributeList _attributes;

protected:
  virtual bool is_equal(const CPPDeclaration *other) const;
  virtual bool is_less(const CPPDeclaration *other) const;
};

inline std::ostream &
operator << (std::ostream &out, const CPPDeclaration &decl) {
  decl.output(out, 0, nullptr, false);
  return out;
}

std::ostream &
operator << (std::ostream &out, const CPPDeclaration::SubstDecl &decl);

#endif