Mercurial > hg > octave-nkf
view libinterp/parse-tree/pt-fcn-handle.h @ 18599:04b4fb217b1a stable
doc: Improve documentation strings in parse-tree directory.
* lex.ll (F__display_tokens__): Add seealso reference.
* lex.ll (F__token_count__): Add seealso reference.
* lex.ll (F__lexer_debug_flag__): Document function.
* oct-parse.in.yy (Fautoload): Add additional calling form. Rephrase
several sentences.
* oct-parse.in.yy (Fmfilename): Make single sentence description stand
apart from the rest of documentation.
* oct-parse.in.yy (Fsource): Make single sentence description stand
apart from the rest of documentation. Add seealso link to 'run'.
* oct-parse.in.yy (Fbuiltin): Change type to "Built-in Function" from
"Loadable Function".
* oct-parse.in.yy (Feval): Rephrase several sentences. Add programming
note suggesting the use of alternatives like try/catch or unwind_protect.
* oct-parse.in.yy (F__parser_debug_flag__): Document function.
* pt-mat.cc (Fstring_fill_char): Use semicolon in place of period for
stronger idea linkage.
author | Rik <rik@octave.org> |
---|---|
date | Fri, 28 Feb 2014 14:04:41 -0800 |
parents | ebb3ef964372 |
children | 4197fc428c7d |
line wrap: on
line source
/* Copyright (C) 2003-2013 John W. Eaton 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 <http://www.gnu.org/licenses/>. */ #if !defined (octave_pt_fcn_handle_h) #define octave_fcn_handle_h 1 #include <iosfwd> #include <string> #include "pt-bp.h" #include "pt-exp.h" #include "pt-misc.h" #include "pt-stmt.h" #include "symtab.h" class octave_value_list; class tree_walker; #include "ov.h" #include "ov-usr-fcn.h" #include "symtab.h" class tree_fcn_handle : public tree_expression { public: tree_fcn_handle (int l = -1, int c = -1) : tree_expression (l, c), nm () { } tree_fcn_handle (const std::string& n, int l = -1, int c = -1) : tree_expression (l, c), nm (n) { } ~tree_fcn_handle (void) { } bool has_magic_end (void) const { return false; } void print (std::ostream& os, bool pr_as_read_syntax = false, bool pr_orig_txt = true); void print_raw (std::ostream& os, bool pr_as_read_syntax = false, bool pr_orig_txt = true); std::string name (void) const { return nm; } bool rvalue_ok (void) const { return true; } octave_value rvalue1 (int nargout = 1); octave_value_list rvalue (int nargout); tree_expression *dup (symbol_table::scope_id scope, symbol_table::context_id context) const; void accept (tree_walker& tw); private: // The name of this function handle. std::string nm; // No copying! tree_fcn_handle (const tree_fcn_handle&); tree_fcn_handle& operator = (const tree_fcn_handle&); }; class tree_anon_fcn_handle : public tree_expression { public: tree_anon_fcn_handle (int l = -1, int c = -1) : tree_expression (l, c), fcn (0), file_name () { } tree_anon_fcn_handle (tree_parameter_list *pl, tree_parameter_list *rl, tree_statement_list *cl, symbol_table::scope_id sid, int l = -1, int c = -1) : tree_expression (l, c), fcn (new octave_user_function (sid, pl, rl, cl)), file_name () { } ~tree_anon_fcn_handle (void) { delete fcn; } bool has_magic_end (void) const { return false; } bool rvalue_ok (void) const { return true; } octave_value rvalue1 (int nargout = 1); octave_value_list rvalue (int nargout); tree_parameter_list *parameter_list (void) const { return fcn ? fcn->parameter_list () : 0; } tree_parameter_list *return_list (void) const { return fcn ? fcn->return_list () : 0; } tree_statement_list *body (void) const { return fcn ? fcn->body () : 0; } symbol_table::scope_id scope (void) const { return fcn ? fcn->scope () : -1; } tree_expression *dup (symbol_table::scope_id scope, symbol_table::context_id context) const; void accept (tree_walker& tw); void stash_file_name (const std::string& file) { file_name = file; } private: // The function. octave_user_function *fcn; // Filename where the handle was defined. std::string file_name; // No copying! tree_anon_fcn_handle (const tree_anon_fcn_handle&); tree_anon_fcn_handle& operator = (const tree_anon_fcn_handle&); }; #endif