ex_cmds_defs.h

Go to the documentation of this file.

#ifndef NVIM_EX_CMDS_DEFS_H
#define NVIM_EX_CMDS_DEFS_H

#include <stdbool.h>
#include <stdint.h>

#include "nvim/pos.h"      // for linenr_T
#include "nvim/normal.h"
#include "nvim/regexp_defs.h"

#ifdef INCLUDE_GENERATED_DECLARATIONS
# include "ex_cmds_enum.generated.h"
#endif

/*
 * When adding an Ex command:
 * 1. Add an entry to the table in src/nvim/ex_cmds.lua.  Keep it sorted on the 
 *    shortest version of the command name that works.  If it doesn't start with 
 *    a lower case letter, add it at the end.
 *
 *    Each table entry is a table with the following keys:
 *
 *      Key     | Description
 *      ------- | -------------------------------------------------------------
 *      command | Name of the command. Required.
 *      enum    | Name of the enum entry. If not set defaults to CMD_{command}.
 *      flags   | A set of the flags from below list joined by bitwise or.
 *      func    | Name of the function containing the implementation.
 *
 *    Referenced function should be either non-static one or defined in 
 *    ex_docmd.c and be coercible to ex_func_T type from below.
 *
 *    All keys not described in the above table are reserved for future use.
 *
 * 2. Add a "case: CMD_xxx" in the big switch in ex_docmd.c.
 * 3. Add an entry in the index for Ex commands at ":help ex-cmd-index".
 * 4. Add documentation in ../doc/xxx.txt.  Add a tag for both the short and
 *    long name of the command.
 */

#define RANGE           0x001   /* allow a linespecs */
#define BANG            0x002   /* allow a ! after the command name */
#define EXTRA           0x004   /* allow extra args after command name */
#define XFILE           0x008   /* expand wildcards in extra part */
#define NOSPC           0x010   /* no spaces allowed in the extra part */
#define DFLALL          0x020   /* default file range is 1,$ */
#define WHOLEFOLD       0x040   /* extend range to include whole fold also
                                   when less than two numbers given */
#define NEEDARG         0x080   /* argument required */
#define TRLBAR          0x100   /* check for trailing vertical bar */
#define REGSTR          0x200   /* allow "x for register designation */
#define COUNT           0x400   /* allow count in argument, after command */
#define NOTRLCOM        0x800   /* no trailing comment allowed */
#define ZEROR          0x1000   /* zero line number allowed */
#define USECTRLV       0x2000   /* do not remove CTRL-V from argument */
#define NOTADR         0x4000   /* number before command is not an address */
#define EDITCMD        0x8000   /* allow "+command" argument */
#define BUFNAME       0x10000   /* accepts buffer name */
#define BUFUNL        0x20000   /* accepts unlisted buffer too */
#define ARGOPT        0x40000   /* allow "++opt=val" argument */
#define SBOXOK        0x80000   /* allowed in the sandbox */
#define CMDWIN       0x100000   /* allowed in cmdline window; when missing
                                 * disallows editing another buffer when
                                 * curbuf_lock is set */
#define MODIFY       0x200000   /* forbidden in non-'modifiable' buffer */
#define EXFLAGS      0x400000   /* allow flags after count in argument */
#define FILES   (XFILE | EXTRA) /* multiple extra files allowed */
#define WORD1   (EXTRA | NOSPC) /* one extra word allowed */
#define FILE1   (FILES | NOSPC) /* 1 file allowed, defaults to current file */

// values for cmd_addr_type
#define ADDR_LINES              0
#define ADDR_WINDOWS            1
#define ADDR_ARGUMENTS          2
#define ADDR_LOADED_BUFFERS     3
#define ADDR_BUFFERS            4
#define ADDR_TABS               5
#define ADDR_TABS_RELATIVE      6   // Tab page that only relative
#define ADDR_QUICKFIX           7
#define ADDR_OTHER              99

typedef struct exarg exarg_T;

/* behavior for bad character, "++bad=" argument */
#define BAD_REPLACE     '?'     /* replace it with '?' (default) */
#define BAD_KEEP        -1      /* leave it */
#define BAD_DROP        -2      /* erase it */

typedef void (*ex_func_T)(exarg_T *eap);

typedef char_u *(*LineGetter)(int, void *, int, bool);

typedef struct cmdname {
  char_u *cmd_name;    
  ex_func_T cmd_func;  
  uint32_t cmd_argt;     
  int cmd_addr_type;     
} CommandDefinition;

struct exarg {
  char_u      *arg;             
  char_u      *nextcmd;         
  char_u      *cmd;             
  char_u      **cmdlinep;       
  cmdidx_T cmdidx;              
  uint32_t argt;                
  int skip;                     
  int forceit;                  
  int addr_count;               
  linenr_T line1;               
  linenr_T line2;               
  int addr_type;                
  int flags;                    
  char_u      *do_ecmd_cmd;     
  linenr_T do_ecmd_lnum;        
  int append;                   
  int usefilter;                
  int amount;                   
  int regname;                  
  int force_bin;                
  int read_edit;                
  int force_ff;                 
  int force_enc;                
  int bad_char;                 
  int useridx;                  
  char_u *errmsg;               
  LineGetter getline;           
  void   *cookie;               
  struct condstack *cstack;     
};

#define FORCE_BIN 1             // ":edit ++bin file"
#define FORCE_NOBIN 2           // ":edit ++nobin file"

// Values for "flags"
#define EXFLAG_LIST     0x01    // 'l': list
#define EXFLAG_NR       0x02    // '#': number
#define EXFLAG_PRINT    0x04    // 'p': print

// used for completion on the command line
struct expand {
  int xp_context;               // type of expansion
  char_u *xp_pattern;           // start of item to expand
  size_t xp_pattern_len;        // bytes in xp_pattern before cursor
  char_u *xp_arg;               // completion function
  sctx_T xp_script_ctx;         // SCTX for completion function
  int xp_backslash;             // one of the XP_BS_ values
#ifndef BACKSLASH_IN_FILENAME
  int xp_shell;                 // TRUE for a shell command, more
                                // characters need to be escaped
#endif
  int xp_numfiles;              // number of files found by file name completion
  char_u **xp_files;            // list of files
  char_u *xp_line;              // text being completed
  int xp_col;                   // cursor position in line
};

// values for xp_backslash
#define XP_BS_NONE      0       // nothing special for backslashes
#define XP_BS_ONE       1       // uses one backslash before a space
#define XP_BS_THREE     2       // uses three backslashes before a space

typedef struct {
  int split;                   
  int tab;                     
  bool browse;                 
  bool confirm;                
  bool hide;                   
  bool keepalt;                
  bool keepjumps;              
  bool keepmarks;              
  bool keeppatterns;           
  bool lockmarks;              
  bool noswapfile;             
  char_u *save_ei;             
  regmatch_T filter_regmatch;  
  bool filter_force;           
} cmdmod_T;

#endif  // NVIM_EX_CMDS_DEFS_H