Mercurial > jwe > octave
view libinterp/octave-value/ov-classdef.cc @ 29963:32c3a5805893
move DEFUN and DEFMETHOD functions inside octave namespace
* mk-opts.pl: Surround emitted function definitions with
OCTAVE_NAMESPACE_BEGIN and OCTAVE_NAMESPACE_END tags.
* mk-builtins.pl: Surround emitted function declarations with
OCTAVE_NAMESPACE_BEGIN and OCTAVE_NAMESPACE_END tags. Emit deprecated
global inline functions.
* __betainc__.cc, __contourc__.cc, __dsearchn__.cc, __eigs__.cc,
__expint__.cc, __ftp__.cc, __gammainc__.cc, __ichol__.cc, __ilu__.cc,
__lin_interpn__.cc, __magick_read__.cc, __pchip_deriv__.cc, __qp__.cc,
amd.cc, balance.cc, besselj.cc, bitfcns.cc, bsxfun.cc, call-stack.cc,
ccolamd.cc, cellfun.cc, chol.cc, colamd.cc, colloc.cc, conv2.cc,
daspk.cc, dasrt.cc, dassl.cc, data.cc, debug.cc, defaults.cc,
defun.cc, det.cc, dirfns.cc, display.cc, dlmread.cc, dmperm.cc,
dot.cc, eig.cc, ellipj.cc, environment.cc, error.cc, event-manager.cc,
fcn-info.cc, fft.cc, fft2.cc, fftn.cc, file-io.cc, filter.cc, find.cc,
gcd.cc, getgrent.cc, getpwent.cc, getrusage.cc, givens.cc,
graphics.cc, gsvd.cc, hash.cc, help.cc, hess.cc, hex2num.cc, input.cc,
interpreter.cc, inv.cc, jsondecode.cc, jsonencode.cc, kron.cc,
load-path.cc, load-save.cc, lookup.cc, ls-oct-text.cc, lsode.cc,
lu.cc, mappers.cc, matrix_type.cc, max.cc, mgorth.cc, nproc.cc,
oct-hist.cc, ordqz.cc, ordschur.cc, pager.cc, pinv.cc, pr-flt-fmt.cc,
pr-output.cc, psi.cc, qr.cc, quad.cc, quadcc.cc, qz.cc, rand.cc,
rcond.cc, regexp.cc, schur.cc, settings.cc, sighandlers.cc, sparse.cc,
spparms.cc, sqrtm.cc, stream-euler.cc, strfind.cc, strfns.cc,
sub2ind.cc, svd.cc, sylvester.cc, symbfact.cc, symrcm.cc, symtab.cc,
syscalls.cc, sysdep.cc, time.cc, toplev.cc, tril.cc, tsearch.cc,
typecast.cc, urlwrite.cc, utils.cc, variables.cc, __delaunayn__.cc,
__fltk_uigetfile__.cc, __glpk__.cc, __init_gnuplot__.cc, __ode15__.cc,
__voronoi__.cc, audiodevinfo.cc, audioread.cc, convhulln.cc, fftw.cc,
gzip.cc, ov-base.cc, ov-bool-mat.cc, ov-cell.cc, ov-class.cc,
ov-classdef.cc, ov-fcn-handle.cc, ov-java.cc, ov-null-mat.cc,
ov-oncleanup.cc, ov-struct.cc, ov-typeinfo.cc, ov-usr-fcn.cc, ov.cc,
octave.cc, lex.ll, oct-parse.yy, profiler.cc, pt-eval.cc: Surround
DEFUN and DEFMETHOD function defnitions with OCTAVE_NAMESPACE_BEGIN
and OCTAVE_NAMESPACE_END tags.
author | John W. Eaton <jwe@octave.org> |
---|---|
date | Fri, 13 Aug 2021 21:53:51 -0400 |
parents | 421e4913d8a4 |
children | 7d6709900da7 |
line wrap: on
line source
//////////////////////////////////////////////////////////////////////// // // Copyright (C) 2012-2021 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 (HAVE_CONFIG_H) # include "config.h" #endif #include <algorithm> #include <iomanip> #include "cdef-class.h" #include "cdef-method.h" #include "cdef-package.h" #include "cdef-property.h" #include "cdef-utils.h" #include "defun.h" #include "errwarn.h" #include "interpreter-private.h" #include "load-path.h" #include "ov-classdef.h" #include "ov-fcn-handle.h" #include "ov-typeinfo.h" #include "ov-usr-fcn.h" #include "parse.h" #include "pr-output.h" #include "pt-eval.h" #include "pt-misc.h" #include "oct-lvalue.h" static bool in_class_method (const octave::cdef_class& cls) { octave::cdef_class ctx = octave::get_class_context (); return (ctx.ok () && octave::is_superclass (ctx, cls)); } int octave_classdef::t_id (-1); const std::string octave_classdef::t_name ("object"); void octave_classdef::register_type (octave::type_info& ti) { t_id = ti.register_type (octave_classdef::t_name, "<unknown>", octave_value (new octave_classdef ())); } octave_value_list octave_classdef::subsref (const std::string& type, const std::list<octave_value_list>& idx, int nargout) { std::size_t skip = 0; octave_value_list retval; octave::cdef_class cls = m_object.get_class (); if (! in_class_method (cls) && ! called_from_builtin ()) { octave::cdef_method meth = cls.find_method ("subsref"); if (meth.ok ()) { octave_value_list args; args(1) = make_idx_args (type, idx, "subsref"); count++; args(0) = octave_value (this); retval = meth.execute (args, nargout, true, "subsref"); return retval; } } // At this point, the default subsref mechanism must be used. retval = m_object.subsref (type, idx, nargout, skip, octave::cdef_class ()); if (type.length () > skip && idx.size () > skip) retval = retval(0).next_subsref (nargout, type, idx, skip); return retval; } octave_value octave_classdef::subsref (const std::string& type, const std::list<octave_value_list>& idx, bool auto_add) { std::size_t skip = 0; octave_value_list retval; // This variant of subsref is used to create temporary values when doing // assignment with multi-level indexing. AFAIK this is only used for internal // purpose (not sure we should even implement this). octave::cdef_class cls = m_object.get_class (); if (! in_class_method (cls)) { octave::cdef_method meth = cls.find_method ("subsref"); if (meth.ok ()) { octave_value_list args; args(1) = make_idx_args (type, idx, "subsref"); count++; args(0) = octave_value (this); retval = meth.execute (args, 1, true, "subsref"); return retval.length () > 0 ? retval(0) : octave_value (); } } retval = m_object.subsref (type, idx, 1, skip, octave::cdef_class (), auto_add); if (type.length () > skip && idx.size () > skip) retval = retval(0).next_subsref (1, type, idx, skip); return retval.length () > 0 ? retval(0) : octave_value (); } octave_value octave_classdef::subsasgn (const std::string& type, const std::list<octave_value_list>& idx, const octave_value& rhs) { octave_value retval; octave::cdef_class cls = m_object.get_class (); if (! in_class_method (cls) && ! called_from_builtin ()) { octave::cdef_method meth = cls.find_method ("subsasgn"); if (meth.ok ()) { octave_value_list args; args(1) = make_idx_args (type, idx, "subsasgn"); count++; args(0) = octave_value (this); args(2) = rhs; octave_value_list retlist; retlist = meth.execute (args, 1, true, "subsasgn"); if (retlist.empty ()) error ("overloaded method 'subsasgn' did not return any value"); retval = retlist(0); } } if (! retval.is_defined ()) retval = m_object.subsasgn (type, idx, rhs); return retval; } octave_value octave_classdef::undef_subsasgn (const std::string& type, const std::list<octave_value_list>& idx, const octave_value& rhs) { if (type.length () == 1 && type[0] == '(') { m_object = m_object.make_array (); return subsasgn (type, idx, rhs); } else return octave_base_value::undef_subsasgn (type, idx, rhs); return octave_value (); } Matrix octave_classdef::size (void) { octave::cdef_class cls = m_object.get_class (); if (! in_class_method (cls) && ! called_from_builtin ()) { octave::cdef_method meth = cls.find_method ("size"); if (meth.ok ()) { count++; octave_value_list args (1, octave_value (this)); octave_value_list lv = meth.execute (args, 1, true, "size"); if (lv.length () <= 0 || ! lv(0).is_matrix_type () || ! lv(0).dims ().isvector ()) error ("%s.size: invalid return value", class_name ().c_str ()); return lv(0).matrix_value (); } } return octave_base_value::size (); } octave_idx_type octave_classdef::xnumel (const octave_value_list& idx) { octave_idx_type retval = -1; octave::cdef_class cls = m_object.get_class (); if (! in_class_method (cls) && ! called_from_builtin ()) { octave::cdef_method meth = cls.find_method ("numel"); if (meth.ok ()) { octave_value_list args (idx.length () + 1, octave_value ()); count++; args(0) = octave_value (this); for (octave_idx_type i = 0; i < idx.length (); i++) args(i+1) = idx(i); // Temporarily set lvalue list of current statement to NULL, to avoid // using that list for the execution of the method "numel" octave::interpreter& interp = octave::__get_interpreter__ ("octave_classdef::xnumel"); octave::tree_evaluator& tw = interp.get_evaluator(); octave::unwind_action act ([&tw] (const std::list<octave::octave_lvalue> *lvl) { tw.set_lvalue_list (lvl); }, tw.lvalue_list ()); tw.set_lvalue_list (nullptr); octave_value_list lv = meth.execute (args, 1, true, "numel"); if (lv.length () != 1 || ! lv(0).is_scalar_type ()) error ("@%s/numel: invalid return value", cls.get_name ().c_str ()); retval = lv(0).idx_type_value (true); return retval; } } retval = octave_base_value::xnumel (idx); return retval; } void octave_classdef::print (std::ostream& os, bool) { print_raw (os); } void octave_classdef::print_raw (std::ostream& os, bool) const { octave::cdef_class cls = m_object.get_class (); if (cls.ok ()) { bool is_array = m_object.is_array (); increment_indent_level (); indent (os); os << class_name () << " object"; if (is_array) os << " array"; os << " with properties:"; newline (os); if (! Vcompact_format) newline (os); increment_indent_level (); std::map<std::string, octave::cdef_property> property_map = cls.get_property_map (); std::size_t max_len = 0; for (const auto& pname_prop : property_map) { // FIXME: this loop duplicates a significant portion of the // loop below and the loop in Fproperties. const octave::cdef_property& prop = pname_prop.second; const std::string nm = prop.get_name (); octave_value acc = prop.get ("GetAccess"); if (! acc.is_string () || acc.string_value () != "public") continue; octave_value hid = prop.get ("Hidden"); if (hid.bool_value ()) continue; std::size_t sz = nm.size (); if (sz > max_len) max_len = sz; } for (auto& pname_prop : property_map) { const octave::cdef_property& prop = pname_prop.second; const std::string nm = prop.get_name (); octave_value acc = prop.get ("GetAccess"); if (! acc.is_string () || acc.string_value () != "public") continue; octave_value hid = prop.get ("Hidden"); if (hid.bool_value ()) continue; indent (os); if (is_array) os << " " << nm; else { octave_value val = prop.get_value (m_object, false); dim_vector dims = val.dims (); os << std::setw (max_len+2) << nm << ": "; if (val.is_string ()) os << val.string_value (); else if (val.islogical ()) os << val.bool_value (); else os << "[" << dims.str () << " " << val.class_name () << "]"; } newline (os); } decrement_indent_level (); decrement_indent_level (); } } bool octave_classdef::is_instance_of (const std::string& cls_name) const { octave::cdef_class cls = octave::lookup_class (cls_name, false, false); if (cls.ok ()) return is_superclass (cls, m_object.get_class ()); return false; } octave_value octave_classdef::superclass_ref (const std::string& meth, const std::string& cls) { return octave_value (new octave_classdef_superclass_ref (meth, cls)); } octave_value octave_classdef::metaclass_query (const std::string& cls) { return octave::to_ov (octave::lookup_class (cls)); } bool octave_classdef_meta::is_classdef_method (const std::string& cname) const { bool retval = false; if (m_object.is_method ()) { if (cname.empty ()) retval = true; else { octave::cdef_method meth (m_object); return meth.is_defined_in_class (cname); } } return retval; } bool octave_classdef_meta::is_classdef_constructor (const std::string& cname) const { bool retval = false; if (m_object.is_class ()) { if (cname.empty ()) retval = true; else { octave::cdef_class cls (m_object); if (cls.get_name () == cname) retval = true; } } return retval; } std::string octave_classdef_meta::doc_string (const std::string& meth_name) const { if (m_object.is_class ()) { octave::cdef_class cls (m_object); if (meth_name.empty ()) return cls.doc_string (); octave::cdef_method cdef_meth = cls.find_method (meth_name); if (cdef_meth.ok ()) return cdef_meth.get_doc_string (); } return ""; } octave_value_list octave_classdef_superclass_ref::execute (octave::tree_evaluator& tw, int nargout, const octave_value_list& idx) { octave_value_list retval; std::string meth_name; bool in_constructor; octave::cdef_class ctx; ctx = octave::get_class_context (meth_name, in_constructor); if (! ctx.ok ()) error ("superclass calls can only occur in methods or constructors"); std::string mname = m_method_name; std::string cname = m_class_name; // CLS is the superclass. The lookup_class function handles // pkg.class names. octave::cdef_class cls = octave::lookup_class (cname); if (in_constructor) { if (! is_direct_superclass (cls, ctx)) error ("'%s' is not a direct superclass of '%s'", cname.c_str (), ctx.get_name ().c_str ()); if (! is_constructed_object (tw, mname)) error ("cannot call superclass constructor with variable '%s'", mname.c_str ()); octave_value sym = tw.varval (mname); cls.run_constructor (octave::to_cdef_ref (sym), idx); retval(0) = sym; } else { std::size_t pos = mname.find ('.'); octave::cdef_object obj; if (pos != std::string::npos) { // We are looking at obj.meth. std::string oname = m_method_name.substr (0, pos); mname = mname.substr (pos + 1); octave_value tval = tw.varval (oname); // FIXME: Can we only call superclass methods on the current // object? If so, and we are looking at something like // // function meth (obj, ...) // obj.meth@superclass (...) // // Do we need to verify that the object that was passed to // meth is the same as the object we find when looking up // obj in the expression obj.meth? If so, what is the right // way to perform that check? if (tval.is_classdef_object ()) { octave_classdef *cdobj = tval.classdef_object_value (); obj = cdobj->get_object (); } } if (mname != meth_name) error ("method name mismatch ('%s' != '%s')", mname.c_str (), meth_name.c_str ()); if (! is_strict_superclass (cls, ctx)) error ("'%s' is not a superclass of '%s'", cname.c_str (), ctx.get_name ().c_str ()); // I see 2 possible implementations here: // 1) use cdef_object::subsref with a different class // context; this avoids duplicating code, but // assumes the object is always the first argument // 2) lookup the method manually and call // cdef_method::execute; this duplicates part of // logic in cdef_object::subsref, but avoid the // assumption of 1) // Not being sure about the assumption of 1), I // go with option 2) for the time being. octave::cdef_method meth = cls.find_method (meth_name, false); if (! meth.ok ()) error ("no method '%s' found in superclass '%s'", meth_name.c_str (), cname.c_str ()); retval = (obj.ok () ? meth.execute (obj, idx, nargout, true, meth_name) : meth.execute (idx, nargout, true, meth_name)); } return retval; } bool octave_classdef_superclass_ref::is_constructed_object (octave::tree_evaluator& tw, const std::string& nm) { octave_function *of = tw.current_function (); if (of->is_classdef_constructor ()) { octave_user_function *uf = of->user_function_value (true); if (uf) { octave::tree_parameter_list *ret_list = uf->return_list (); if (ret_list && ret_list->length () == 1) return (ret_list->front ()->name () == nm); } } return false; } OCTAVE_NAMESPACE_BEGIN DEFUN (__meta_get_package__, args, , doc: /* -*- texinfo -*- @deftypefn {} {} __meta_get_package__ () Undocumented internal function. @end deftypefn */) { if (args.length () != 1) print_usage (); std::string cname = args(0).xstring_value ("PACKAGE_NAME must be a string"); return octave::to_ov (octave::lookup_package (cname)); } DEFUN (metaclass, args, , doc: /* -*- texinfo -*- @deftypefn {} {} metaclass (obj) Returns the meta.class object corresponding to the class of @var{obj}. @end deftypefn */) { if (args.length () != 1) print_usage (); octave::cdef_object obj = octave::to_cdef (args(0)); return octave::to_ov (obj.get_class ()); } // FIXME: What about dynamic properties if obj is a scalar, or the // properties of the class of obj if obj is an array? Probably there // should be a function to do this job so that the DEFUN is just a // simple wrapper. DEFUN (properties, args, nargout, doc: /* -*- texinfo -*- @deftypefn {} {} properties (@var{class_name}) @deftypefnx {} {} properties (@var{obj}) @deftypefnx {} {@var{plist} =} properties (@dots{}) Return or display the public properties for the named class @var{class_name} or classdef object @var{obj}. If an output value is requested, return the list of property names in a cell array. Programming Note: Property names are returned if the @code{GetAccess} attribute is public and if the @code{Hidden} attribute is false. @seealso{methods} @end deftypefn */) { if (args.length () != 1) print_usage (); octave_value arg = args(0); std::string class_name; if (arg.isobject ()) class_name = arg.class_name (); else if (arg.is_string ()) class_name = arg.string_value (); else err_wrong_type_arg ("properties", arg); octave::cdef_class cls; cls = octave::lookup_class (class_name, false, true); if (! cls.ok ()) error ("invalid class: %s", class_name.c_str ()); std::map<std::string, octave::cdef_property> property_map = cls.get_property_map (); std::list<std::string> property_names; for (const auto& pname_prop : property_map) { // FIXME: this loop duplicates a significant portion of the loops // in octave_classdef::print_raw. const octave::cdef_property& prop = pname_prop.second; std::string nm = prop.get_name (); octave_value acc = prop.get ("GetAccess"); if (! acc.is_string () || acc.string_value () != "public") continue; octave_value hid = prop.get ("Hidden"); if (hid.bool_value ()) continue; property_names.push_back (nm); } if (nargout > 0) return octave_value (Cell (string_vector (property_names))); octave_stdout << "properties for class " << class_name << ":\n\n"; for (const auto& nm : property_names) octave_stdout << " " << nm << "\n"; octave_stdout << std::endl; return octave_value (); } /* %!assert (properties ("inputParser"), %! {"CaseSensitive"; "FunctionName"; "KeepUnmatched"; %! "Parameters"; "PartialMatching"; "Results"; %! "StructExpand"; "Unmatched"; "UsingDefaults"}); */ // FIXME: Need to implement the -full option. DEFMETHOD (__methods__, interp, args, , doc: /* -*- texinfo -*- @deftypefn {} {} __methods__ (@var{x}) @deftypefnx {} {} __methods__ ("classname") Internal function. Implements @code{methods} for Octave class objects and classnames. @seealso{methods} @end deftypefn */) { // Input validation has already been done in methods.m. octave_value arg = args(0); std::string class_name; if (arg.isobject ()) class_name = arg.class_name (); else if (arg.is_string ()) class_name = arg.string_value (); else err_wrong_type_arg ("__methods__", arg); string_vector sv; octave::cdef_class cls = octave::lookup_class (class_name, false, true); if (cls.ok ()) { std::map<std::string, octave::cdef_method> method_map = cls.get_method_map (false, true); std::list<std::string> method_names; for (const auto& nm_mthd : method_map) { std::string nm = nm_mthd.first; method_names.push_back (nm); } sv = string_vector (method_names); } // The following will also find methods for legacy @CLASS objects. octave::load_path& lp = interp.get_load_path (); sv.append (lp.methods (class_name)); return ovl (Cell (sv)); } OCTAVE_NAMESPACE_END /* ;;; Local Variables: *** ;;; mode: C++ *** ;;; End: *** */