eval.h

Go to the documentation of this file.

#ifndef NVIM_EVAL_H
#define NVIM_EVAL_H
 
#include "nvim/buffer_defs.h"
#include "nvim/channel.h"
#include "nvim/eval/funcs.h"  // For FunPtr
#include "nvim/event/time.h"  // For TimeWatcher
#include "nvim/ex_cmds_defs.h"  // For exarg_T
#include "nvim/os/fileio.h"  // For FileDescriptor
#include "nvim/os/stdpaths_defs.h"  // For XDGVarType
 
#define COPYID_INC 2
#define COPYID_MASK (~0x1)
 
// All user-defined functions are found in this hashtable.
extern hashtab_T func_hashtab;
 
// From user function to hashitem and back.
EXTERN ufunc_T dumuf;
#define UF2HIKEY(fp) ((fp)->uf_name)
#define HIKEY2UF(p)  ((ufunc_T *)(p - offsetof(ufunc_T, uf_name)))
#define HI2UF(hi)    HIKEY2UF((hi)->hi_key)
 
/*
 * Structure returned by get_lval() and used by set_var_lval().
 * For a plain name:
 *      "name"      points to the variable name.
 *      "exp_name"  is NULL.
 *      "tv"        is NULL
 * For a magic braces name:
 *      "name"      points to the expanded variable name.
 *      "exp_name"  is non-NULL, to be freed later.
 *      "tv"        is NULL
 * For an index in a list:
 *      "name"      points to the (expanded) variable name.
 *      "exp_name"  NULL or non-NULL, to be freed later.
 *      "tv"        points to the (first) list item value
 *      "li"        points to the (first) list item
 *      "range", "n1", "n2" and "empty2" indicate what items are used.
 * For an existing Dict item:
 *      "name"      points to the (expanded) variable name.
 *      "exp_name"  NULL or non-NULL, to be freed later.
 *      "tv"        points to the dict item value
 *      "newkey"    is NULL
 * For a non-existing Dict item:
 *      "name"      points to the (expanded) variable name.
 *      "exp_name"  NULL or non-NULL, to be freed later.
 *      "tv"        points to the Dictionary typval_T
 *      "newkey"    is the key for the new item.
 */
typedef struct lval_S {
  const char *ll_name;  
  size_t ll_name_len;   
  char *ll_exp_name;    
  typval_T *ll_tv;      
  listitem_T *ll_li;  
  list_T *ll_list;    
  bool ll_range;      
  bool ll_empty2;     
  long ll_n1;         
  long ll_n2;         
  dict_T *ll_dict;    
  dictitem_T *ll_di;  
  char *ll_newkey;  
  blob_T *ll_blob;    
} lval_T;
 
typedef enum {
  VAR_FLAVOUR_DEFAULT = 1,   // doesn't start with uppercase
  VAR_FLAVOUR_SESSION = 2,   // starts with uppercase, some lower
  VAR_FLAVOUR_SHADA   = 4,  // all uppercase
} var_flavour_T;
 
typedef enum {
  VV_COUNT,
  VV_COUNT1,
  VV_PREVCOUNT,
  VV_ERRMSG,
  VV_WARNINGMSG,
  VV_STATUSMSG,
  VV_SHELL_ERROR,
  VV_THIS_SESSION,
  VV_VERSION,
  VV_LNUM,
  VV_TERMRESPONSE,
  VV_FNAME,
  VV_LANG,
  VV_LC_TIME,
  VV_CTYPE,
  VV_CC_FROM,
  VV_CC_TO,
  VV_FNAME_IN,
  VV_FNAME_OUT,
  VV_FNAME_NEW,
  VV_FNAME_DIFF,
  VV_CMDARG,
  VV_FOLDSTART,
  VV_FOLDEND,
  VV_FOLDDASHES,
  VV_FOLDLEVEL,
  VV_PROGNAME,
  VV_SEND_SERVER,
  VV_DYING,
  VV_EXCEPTION,
  VV_THROWPOINT,
  VV_REG,
  VV_CMDBANG,
  VV_INSERTMODE,
  VV_VAL,
  VV_KEY,
  VV_PROFILING,
  VV_FCS_REASON,
  VV_FCS_CHOICE,
  VV_BEVAL_BUFNR,
  VV_BEVAL_WINNR,
  VV_BEVAL_WINID,
  VV_BEVAL_LNUM,
  VV_BEVAL_COL,
  VV_BEVAL_TEXT,
  VV_SCROLLSTART,
  VV_SWAPNAME,
  VV_SWAPCHOICE,
  VV_SWAPCOMMAND,
  VV_CHAR,
  VV_MOUSE_WIN,
  VV_MOUSE_WINID,
  VV_MOUSE_LNUM,
  VV_MOUSE_COL,
  VV_OP,
  VV_SEARCHFORWARD,
  VV_HLSEARCH,
  VV_OLDFILES,
  VV_WINDOWID,
  VV_PROGPATH,
  VV_COMPLETED_ITEM,
  VV_OPTION_NEW,
  VV_OPTION_OLD,
  VV_OPTION_OLDLOCAL,
  VV_OPTION_OLDGLOBAL,
  VV_OPTION_COMMAND,
  VV_OPTION_TYPE,
  VV_ERRORS,
  VV_FALSE,
  VV_TRUE,
  VV_NULL,
  VV_NUMBERMAX,
  VV_NUMBERMIN,
  VV_NUMBERSIZE,
  VV_VIM_DID_ENTER,
  VV_TESTING,
  VV_TYPE_NUMBER,
  VV_TYPE_STRING,
  VV_TYPE_FUNC,
  VV_TYPE_LIST,
  VV_TYPE_DICT,
  VV_TYPE_FLOAT,
  VV_TYPE_BOOL,
  VV_TYPE_BLOB,
  VV_EVENT,
  VV_ECHOSPACE,
  VV_ARGV,
  VV_COLLATE,
  VV_EXITING,
  // Nvim
  VV_STDERR,
  VV_MSGPACK_TYPES,
  VV__NULL_STRING,  // String with NULL value. For test purposes only.
  VV__NULL_LIST,  // List with NULL value. For test purposes only.
  VV__NULL_DICT,  // Dictionary with NULL value. For test purposes only.
  VV__NULL_BLOB,  // Blob with NULL value. For test purposes only.
  VV_LUA,
} VimVarIndex;
 
typedef enum {
  kMPNil,
  kMPBoolean,
  kMPInteger,
  kMPFloat,
  kMPString,
  kMPBinary,
  kMPArray,
  kMPMap,
  kMPExt,
} MessagePackType;
#define LAST_MSGPACK_TYPE kMPExt
 
extern const list_T *eval_msgpack_type_lists[LAST_MSGPACK_TYPE + 1];
 
#undef LAST_MSGPACK_TYPE
 
// Struct passed to get_v_event() and restore_v_event().
typedef struct {
  bool sve_did_save;
  hashtab_T sve_hashtab;
} save_v_event_T;
 
typedef enum {
  TFN_INT = 1,  
  TFN_QUIET = 2,  
  TFN_NO_AUTOLOAD = 4,  
  TFN_NO_DEREF = 8,  
  TFN_READ_ONLY = 16,  
} TransFunctionNameFlags;
 
typedef enum {
  GLV_QUIET = TFN_QUIET,  
  GLV_NO_AUTOLOAD = TFN_NO_AUTOLOAD,  
  GLV_READ_ONLY = TFN_READ_ONLY,  
} GetLvalFlags;
 
#define FNE_INCL_BR     1       // find_name_end(): include [] in name
#define FNE_CHECK_START 2       // find_name_end(): check name starts with
                                // valid character
 
typedef struct {
  TimeWatcher tw;
  int timer_id;
  int repeat_count;
  int refcount;
  int emsg_count;  
  long timeout;
  bool stopped;
  bool paused;
  Callback callback;
} timer_T;
 
typedef enum {
  ASSERT_EQUAL,
  ASSERT_NOTEQUAL,
  ASSERT_MATCH,
  ASSERT_NOTMATCH,
  ASSERT_INRANGE,
  ASSERT_OTHER,
} assert_type_T;
 
typedef enum {
  EXPR_UNKNOWN = 0,
  EXPR_EQUAL,         
  EXPR_NEQUAL,        
  EXPR_GREATER,       
  EXPR_GEQUAL,        
  EXPR_SMALLER,       
  EXPR_SEQUAL,        
  EXPR_MATCH,         
  EXPR_NOMATCH,       
  EXPR_IS,            
  EXPR_ISNOT,         
} exprtype_T;
 
typedef enum {
  kDictListKeys,  
  kDictListValues,  
  kDictListItems,  
} DictListType;
 
typedef int (*ex_unletlock_callback)(lval_T *, char *, exarg_T *, int);
 
// Used for checking if local variables or arguments used in a lambda.
extern bool *eval_lavars_used;
 
#ifdef INCLUDE_GENERATED_DECLARATIONS
# include "eval.h.generated.h"
#endif
#endif  // NVIM_EVAL_H