fish-shell/function.h

178 lines
4.6 KiB
C
Raw Normal View History

/** \file function.h
Prototypes for functions for storing and retrieving function
information. These functions also take care of autoloading
functions in the $fish_function_path. Actual function evaluation
is taken care of by the parser and to some degree the builtin
handling library.
*/
#ifndef FISH_FUNCTION_H
#define FISH_FUNCTION_H
#include <wchar.h>
#include "util.h"
2012-01-14 07:44:18 +00:00
#include "common.h"
#include "event.h"
#include <tr1/memory>
using std::tr1::shared_ptr;
class parser_t;
class env_vars;
/**
Structure describing a function. This is used by the parser to
store data on a function while parsing it. It is not used
internally to store functions, the function_internal_data_t
structure is used for that purpose. Parhaps these two should be
merged.
*/
struct function_data_t
{
/**
Name of function
*/
2012-02-09 10:01:49 +00:00
wcstring name;
/**
Description of function
*/
2012-02-09 10:01:49 +00:00
wcstring description;
/**
Function definition
*/
wchar_t *definition;
/**
List of all event handlers for this function
*/
2012-02-09 03:02:25 +00:00
std::vector<event_t> events;
/**
List of all named arguments for this function
*/
wcstring_list_t named_arguments;
/**
Set to non-zero if invoking this function shadows the variables
of the underlying function.
*/
int shadows;
};
class function_info_t {
public:
/** Constructs relevant information from the function_data */
function_info_t(const function_data_t &data, const wchar_t *filename, int def_offset, bool autoload);
/** Used by function_copy */
function_info_t(const function_info_t &data, const wchar_t *filename, int def_offset, bool autoload);
/** Function definition */
const wcstring definition;
/** Function description. Only the description may be changed after the function is created. */
wcstring description;
/** File where this function was defined (intern'd string) */
const wchar_t * const definition_file;
/** Line where definition started */
const int definition_offset;
/** List of all named arguments for this function */
const wcstring_list_t named_arguments;
/** Flag for specifying that this function was automatically loaded */
const bool is_autoload;
/** Set to true if invoking this function shadows the variables of the underlying function. */
const bool shadows;
};
/**
Initialize function data
*/
void function_init();
/** Add a function. */
void function_add( const function_data_t &data, const parser_t &parser );
/**
Remove the function with the specified name.
*/
2012-01-26 02:40:08 +00:00
void function_remove( const wcstring &name );
/**
Gets a function by name.
*/
shared_ptr<function_info_t> function_get(const wcstring &name);
/**
Returns the definition of the function with the name \c name.
*/
const wchar_t *function_get_definition( const wcstring &name );
/**
Returns the description of the function with the name \c name.
*/
const wchar_t *function_get_desc( const wcstring &name );
/**
Sets the description of the function with the name \c name.
*/
void function_set_desc( const wcstring &name, const wcstring &desc );
/**
Returns true if the function with the name name exists.
*/
int function_exists( const wcstring &name );
/**
Returns true if the function with the name name exists, without triggering autoload.
*/
int function_exists_no_autoload( const wcstring &name, const env_vars &vars );
/**
2012-01-14 07:44:18 +00:00
Returns all function names.
\param get_hidden whether to include hidden functions, i.e. ones starting with an underscore
*/
2012-01-14 07:44:18 +00:00
wcstring_list_t function_get_names( int get_hidden );
/**
Returns tha absolute path of the file where the specified function
was defined. Returns 0 if the file was defined on the commandline.
This function does not autoload functions, it will only work on
functions that have already been defined.
*/
const wchar_t *function_get_definition_file( const wcstring &name );
/**
Returns the linenumber where the definition of the specified
function started.
This function does not autoload functions, it will only work on
functions that have already been defined.
*/
int function_get_definition_offset( const wcstring &name );
/**
Returns a list of all named arguments of the specified function.
*/
wcstring_list_t function_get_named_arguments( const wcstring &name );
/**
Creates a new function using the same definition as the specified function.
Returns true if copy is successful.
*/
bool function_copy( const wcstring &name, const wcstring &new_name );
/**
Returns whether this function shadows variables of the underlying function
*/
int function_get_shadows( const wcstring &name );
#endif