NetBSD/usr.bin/vi/term.h

202 lines
7.7 KiB
C

/*-
* Copyright (c) 1991, 1993, 1994
* The Regents of the University of California. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* 3. All advertising materials mentioning features or use of this software
* must display the following acknowledgement:
* This product includes software developed by the University of
* California, Berkeley and its contributors.
* 4. Neither the name of the University nor the names of its contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*
* @(#)term.h 8.37 (Berkeley) 3/22/94
*/
/*
* Fundamental character types.
*
* CHAR_T An integral type that can hold any character.
* ARG_CHAR_T The type of a CHAR_T when passed as an argument using
* traditional promotion rules. It should also be able
* to be compared against any CHAR_T for equality without
* problems.
* MAX_CHAR_T The maximum value of any character.
*
* If no integral type can hold a character, don't even try the port.
*/
typedef u_char CHAR_T;
typedef u_int ARG_CHAR_T;
#define MAX_CHAR_T 0xff
/* The maximum number of columns any character can take up on a screen. */
#define MAX_CHARACTER_COLUMNS 4
/* Structure to return a character and associated information. */
struct _ch {
CHAR_T ch; /* Character. */
#define K_NOTUSED 0
#define K_CARAT 1
#define K_CNTRLD 2
#define K_CNTRLR 3
#define K_CNTRLT 4
#define K_CNTRLZ 5
#define K_COLON 6
#define K_CR 7
#define K_ESCAPE 8
#define K_FORMFEED 9
#define K_NL 10
#define K_RIGHTBRACE 11
#define K_RIGHTPAREN 12
#define K_TAB 13
#define K_VERASE 14
#define K_VINTR 15
#define K_VKILL 16
#define K_VLNEXT 17
#define K_VWERASE 18
#define K_ZERO 19
u_int8_t value; /* Special character flag values. */
#define CH_ABBREVIATED 0x01 /* Character from an abbreviation. */
#define CH_NOMAP 0x02 /* Do not attempt to map the character. */
#define CH_QUOTED 0x04 /* Character is already quoted. */
u_int8_t flags;
};
/* Structure for the key input buffer. */
struct _ibuf {
CHAR_T *ch; /* Array of characters. */
u_int8_t *chf; /* Array of character flags (CH_*). */
#define MAX_MAP_COUNT 50 /* Infinite loop check. */
u_int8_t *cmap; /* Number of times character has been mapped. */
size_t cnt; /* Count of remaining characters. */
size_t nelem; /* Numer of array elements. */
size_t next; /* Offset of next array entry. */
};
/* Return if more keys in queue. */
#define KEYS_WAITING(sp) ((sp)->gp->tty->cnt)
#define MAPPED_KEYS_WAITING(sp) \
(KEYS_WAITING(sp) && sp->gp->tty->cmap[sp->gp->tty->next])
/*
* Structure to name a character. Used both as an interface to the
* screen and to name objects named by characters in error messages.
*/
struct _chname {
char *name; /* Character name. */
u_int8_t len; /* Length of the character name. */
};
/*
* Routines that return a key as a side-effect return:
*
* INP_OK Returning a character; must be 0.
* INP_EOF EOF.
* INP_ERR Error.
*
* The vi structure depends on the key routines being able to return INP_EOF
* multiple times without failing -- eventually enough things will end due to
* INP_EOF that vi will reach the command level for the screen, at which point
* the exit flags will be set and vi will exit.
*/
enum input { INP_OK=0, INP_EOF, INP_ERR };
/*
* Routines that return a confirmation return:
*
* CONF_NO User answered no.
* CONF_QUIT User answered quit, eof or an error.
* CONF_YES User answered yes.
*/
enum confirm { CONF_NO, CONF_QUIT, CONF_YES };
/*
* Ex/vi commands are generally separated by whitespace characters. We
* can't use the standard isspace(3) macro because it returns true for
* characters like ^K in the ASCII character set. The 4.4BSD isblank(3)
* macro does exactly what we want, but it's not portable yet.
*
* XXX
* Note side effect, ch is evaluated multiple times.
*/
#ifndef isblank
#define isblank(ch) ((ch) == ' ' || (ch) == '\t')
#endif
/* The "standard" tab width, for displaying things to users. */
#define STANDARD_TAB 6
/* Various special characters, messages. */
#define CURSOR_CH ' ' /* Cursor character. */
#define END_CH '$' /* End of a range. */
#define HEX_CH 'x' /* Leading hex number. */
#define LITERAL_CH '\026' /* Standard literal ^V. */
#define NOT_DIGIT_CH 'a' /* A non-isdigit() character. */
#define NO_CH 'n' /* No. */
#define QUIT_CH 'q' /* Quit. */
#define YES_CH 'y' /* Yes. */
#define CONFSTRING "confirm? [ynq]"
#define CONTMSG "Enter return to continue: "
#define CONTMSG_I "Enter return to continue [q to quit]: "
/* Flags describing how input is handled. */
#define TXT_AICHARS 0x0000001 /* Leading autoindent chars. */
#define TXT_ALTWERASE 0x0000002 /* Option: altwerase. */
#define TXT_APPENDEOL 0x0000004 /* Appending after EOL. */
#define TXT_AUTOINDENT 0x0000008 /* Autoindent set this line. */
#define TXT_BEAUTIFY 0x0000010 /* Only printable characters. */
#define TXT_BS 0x0000020 /* Backspace returns the buffer. */
#define TXT_CNTRLD 0x0000040 /* Control-D is a special command. */
#define TXT_CNTRLT 0x0000080 /* Control-T is an indent special. */
#define TXT_CR 0x0000100 /* CR returns the buffer. */
#define TXT_EMARK 0x0000200 /* End of replacement mark. */
#define TXT_ESCAPE 0x0000400 /* Escape returns the buffer. */
#define TXT_INFOLINE 0x0000800 /* Editing the info line. */
#define TXT_MAPCOMMAND 0x0001000 /* Apply the command map. */
#define TXT_MAPINPUT 0x0002000 /* Apply the input map. */
#define TXT_MAPNODIGIT 0x0004000 /* Return to a digit. */
#define TXT_NLECHO 0x0008000 /* Echo the newline. */
#define TXT_OVERWRITE 0x0010000 /* Overwrite characters. */
#define TXT_PROMPT 0x0020000 /* Display a prompt. */
#define TXT_RECORD 0x0040000 /* Record for replay. */
#define TXT_REPLACE 0x0080000 /* Replace; don't delete overwrite. */
#define TXT_REPLAY 0x0100000 /* Replay the last input. */
#define TXT_RESOLVE 0x0200000 /* Resolve the text into the file. */
#define TXT_SHOWMATCH 0x0400000 /* Option: showmatch. */
#define TXT_TTYWERASE 0x0800000 /* Option: ttywerase. */
#define TXT_WRAPMARGIN 0x1000000 /* Option: wrapmargin. */
/* Support keyboard routines. */
int __term_key_val __P((SCR *, ARG_CHAR_T));
void term_ab_flush __P((SCR *, char *));
int term_init __P((SCR *));
enum input term_key __P((SCR *, CH *, u_int));
int term_key_queue __P((SCR *));
void term_map_flush __P((SCR *, char *));
int term_push __P((SCR *, CHAR_T *, size_t, u_int, u_int));
enum input term_user_key __P((SCR *, CH *));
int term_waiting __P((SCR *));