Mercurial > octave
view libinterp/octave-value/cdef-class.h @ 31246:43a6be589387
doc: New documentation for memoization techniques (bug #60860)
vectorize.texi: New section on memoization
octave.texi: List new section
author | Arun Giridhar <arungiridhar@gmail.com> |
---|---|
date | Thu, 29 Sep 2022 20:31:52 -0400 |
parents | 6cac9f1e54b5 |
children | e88a07dec498 |
line wrap: on
line source
//////////////////////////////////////////////////////////////////////// // // Copyright (C) 2012-2022 The Octave Project Developers // // See the file COPYRIGHT.md in the top-level directory of this // distribution or <https://octave.org/copyright/>. // // This file is part of Octave. // // Octave is free software: you can redistribute it and/or modify it // under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Octave is distributed in the hope that it will be useful, but // WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Octave; see the file COPYING. If not, see // <https://www.gnu.org/licenses/>. // //////////////////////////////////////////////////////////////////////// #if ! defined (octave_cdef_class_h) #define octave_cdef_class_h 1 #include "octave-config.h" #include <map> #include <set> #include <string> #include "oct-refcount.h" #include "cdef-fwd.h" #include "cdef-method.h" #include "cdef-object.h" #include "cdef-package.h" #include "cdef-property.h" #include "error.h" #include "ov.h" #include "ovl.h" namespace octave { class interpreter; class tree_classdef; class OCTINTERP_API cdef_class : public cdef_meta_object { private: class cdef_class_rep : public cdef_meta_object_rep { public: cdef_class_rep (void) : cdef_meta_object_rep (), m_member_count (0), m_handle_class (false), m_meta (false) { } OCTINTERP_API cdef_class_rep (const std::list<cdef_class>& superclasses); cdef_class_rep& operator = (const cdef_class_rep&) = delete; ~cdef_class_rep (void) = default; cdef_object_rep * copy (void) const { return new cdef_class_rep (*this); } bool is_class (void) const { return true; } std::string get_name (void) const { return get ("Name").string_value (); } void set_name (const std::string& nm) { put ("Name", nm); } bool is_abstract (void) const { return get ("Abstract").bool_value (); } bool is_sealed (void) const { return get ("Sealed").bool_value (); } OCTINTERP_API cdef_method find_method (const std::string& nm, bool local = false); OCTINTERP_API void install_method (const cdef_method& meth); OCTINTERP_API Cell get_methods (bool include_ctor); OCTINTERP_API std::map<std::string, cdef_method> get_method_map (bool only_inherited, bool include_ctor); OCTINTERP_API cdef_property find_property (const std::string& nm); OCTINTERP_API void install_property (const cdef_property& prop); OCTINTERP_API Cell get_properties (int mode); OCTINTERP_API std::map<std::string, cdef_property> get_property_map (int mode); OCTINTERP_API string_vector get_names (void); void set_directory (const std::string& dir) { m_directory = dir; } std::string get_directory (void) const { return m_directory; } OCTINTERP_API void delete_object (const cdef_object& obj); OCTINTERP_API octave_value_list meta_subsref (const std::string& type, const std::list<octave_value_list>& idx, int nargout); OCTINTERP_API void meta_release (void); bool meta_accepts_postfix_index (char type) const { return (type == '(' || type == '.'); } OCTINTERP_API octave_value get_method (const std::string& name) const; OCTINTERP_API octave_value construct (const octave_value_list& args); OCTINTERP_API cdef_object construct_object (const octave_value_list& args); OCTINTERP_API void initialize_object (cdef_object& obj); OCTINTERP_API void run_constructor (cdef_object& obj, const octave_value_list& args); void mark_as_handle_class (void) { m_handle_class = true; } bool is_handle_class (void) const { return m_handle_class; } octave_idx_type static_count (void) const { return m_member_count; } void destroy (void) { if (m_member_count) { m_count++; cdef_class lock (this); m_member_count = 0; m_method_map.clear (); m_property_map.clear (); } else delete this; } void mark_as_meta_class (void) { m_meta = true; } bool is_meta_class (void) const { return m_meta; } void doc_string (const std::string& txt) { m_doc_string = txt; } std::string doc_string (void) const { return m_doc_string; } void file_name (const std::string& nm) { m_file_name = nm; } std::string file_name (void) const { return m_file_name; } private: OCTINTERP_API void load_all_methods (void); OCTINTERP_API void find_names (std::set<std::string>& names, bool all); OCTINTERP_API void find_properties (std::map<std::string, cdef_property>& props, int mode = 0); OCTINTERP_API void find_methods (std::map<std::string, cdef_method>& meths, bool only_inherited, bool include_ctor = false); cdef_class wrap (void) { m_count++; return cdef_class (this); } // The @-directory were this class is loaded from. // (not used yet) std::string m_directory; std::string m_doc_string; std::string m_file_name; // The methods defined by this class. std::map<std::string, cdef_method> m_method_map; // The properties defined by this class. std::map<std::string, cdef_property> m_property_map; // The number of members in this class (methods, properties...) octave_idx_type m_member_count; // TRUE if this class is a handle class. A class is a handle // class when the abstract "handle" class is one of its superclasses. bool m_handle_class; // The list of super-class constructors that are called implicitly by the // classdef engine when creating an object. These constructors are not // called explicitly by the class constructor. std::list<cdef_class> m_implicit_ctor_list; // TRUE if this class is a built-in meta class. bool m_meta; // Utility iterator typedefs. typedef std::map<std::string, cdef_method>::iterator method_iterator; typedef std::map<std::string, cdef_method>::const_iterator method_const_iterator; typedef std::map<std::string, cdef_property>::iterator property_iterator; typedef std::map<std::string, cdef_property>::const_iterator property_const_iterator; cdef_class_rep (const cdef_class_rep& c) = default; }; public: // Create an invalid class object. cdef_class (void) : cdef_meta_object () { } cdef_class (const std::string& nm, const std::list<cdef_class>& superclasses) : cdef_meta_object (new cdef_class_rep (superclasses)) { get_rep ()->set_name (nm); } cdef_class (const cdef_class& cls) : cdef_meta_object (cls) { } cdef_class (const cdef_object& obj) : cdef_meta_object (obj) { // This should never happen... if (! is_class ()) error ("internal error: invalid assignment from %s to meta.class object", class_name ().c_str ()); } cdef_class& operator = (const cdef_class& cls) { cdef_object::operator = (cls); return *this; } ~cdef_class (void) = default; OCTINTERP_API cdef_method find_method (const std::string& nm, bool local = false); void install_method (const cdef_method& meth) { get_rep ()->install_method (meth); } Cell get_methods (bool include_ctor = false) { return get_rep ()->get_methods (include_ctor); } std::map<std::string, cdef_method> get_method_map (bool only_inherited = false, bool include_ctor = false) { return get_rep ()->get_method_map (only_inherited, include_ctor); } OCTINTERP_API cdef_property find_property (const std::string& nm); void install_property (const cdef_property& prop) { get_rep ()->install_property (prop); } Cell get_properties (int mode = property_normal) { return get_rep ()->get_properties (mode); } std::map<std::string, cdef_property> get_property_map (int mode = property_normal) { return get_rep ()->get_property_map (mode); } string_vector get_names (void) { return get_rep ()->get_names (); } bool is_abstract (void) const { return get_rep ()->is_abstract (); } bool is_sealed (void) const { return get_rep ()->is_sealed (); } void set_directory (const std::string& dir) { get_rep ()->set_directory (dir); } std::string get_directory (void) const { return get_rep ()->get_directory (); } std::string get_name (void) const { return get_rep ()->get_name (); } bool is_builtin (void) const { return get_directory ().empty (); } void delete_object (const cdef_object& obj) { get_rep ()->delete_object (obj); } //! Analyze the tree_classdef tree and transform it to a cdef_class //! //! <b>All attribute validation should occur here.</b> //! //! Classdef attribute values can be given in the form of //! expressions. These expressions must be evaluated before //! assigning them as attribute values. Evaluating them as they are //! parsed causes trouble with possible recursion in the parser so we //! do it here. For example //! //! @code //! classdef recursion_class //! methods (Access = ?recursion_class) //! endmethods //! endclassdef //! @endcode //! //! will fail because each attempt to compute the metaclass of //! recursion_class will cause recursion_class to be parsed again. static OCTINTERP_API cdef_class make_meta_class (interpreter& interp, tree_classdef *t, bool is_at_folder = false); octave_value get_method (const std::string& nm) const { return get_rep ()->get_method (nm); } OCTINTERP_API octave_value get_method_function (const std::string& nm); octave_value get_constructor_function (void) { return get_method_function (get_name ()); } octave_value construct (const octave_value_list& args) { return get_rep ()->construct (args); } cdef_object construct_object (const octave_value_list& args) { return get_rep ()->construct_object (args); } void initialize_object (cdef_object& obj) { get_rep ()->initialize_object (obj); } void run_constructor (cdef_object& obj, const octave_value_list& args) { get_rep ()->run_constructor (obj, args); } void mark_as_handle_class (void) { get_rep ()->mark_as_handle_class (); } bool is_handle_class (void) const { return get_rep ()->is_handle_class (); } void mark_as_meta_class (void) { get_rep ()->mark_as_meta_class (); } bool is_meta_class (void) const { return get_rep ()->is_meta_class (); } void doc_string (const std::string& txt) { get_rep ()->doc_string (txt); } std::string doc_string (void) const { return get_rep ()->doc_string (); } void file_name (const std::string& nm) { get_rep ()->file_name (nm); } std::string file_name (void) const { return get_rep ()->file_name (); } public: enum { property_normal, property_inherited, property_all }; private: cdef_class_rep * get_rep (void) { return dynamic_cast<cdef_class_rep *> (cdef_object::get_rep ()); } const cdef_class_rep * get_rep (void) const { return dynamic_cast<const cdef_class_rep *> (cdef_object::get_rep ()); } friend OCTINTERP_API bool operator == (const cdef_class&, const cdef_class&); friend OCTINTERP_API bool operator != (const cdef_class&, const cdef_class&); friend OCTINTERP_API bool operator < (const cdef_class&, const cdef_class&); friend void install_classdef (octave::interpreter& interp); }; inline bool operator == (const cdef_class& clsa, const cdef_class& clsb) { // FIXME: is this really the right way to check class equality? return (clsa.get_rep () == clsb.get_rep ()); } inline bool operator != (const cdef_class& clsa, const cdef_class& clsb) { return ! (clsa == clsb); } // This is only to be able to use cdef_class as map keys. inline bool operator < (const cdef_class& clsa, const cdef_class& clsb) { return clsa.get_rep () < clsb.get_rep (); } inline cdef_method cdef_class::find_method (const std::string& nm, bool local) { return get_rep ()->find_method (nm, local); } inline cdef_property cdef_class::find_property (const std::string& nm) { return get_rep ()->find_property (nm); } } #endif