Merged from the latest developing branch.
[MacVim.git] / src / getchar.c
blob0947f35feb68dc158ee3ea532f202df8c1975959
1 /* vi:set ts=8 sts=4 sw=4:
3 * VIM - Vi IMproved by Bram Moolenaar
5 * Do ":help uganda" in Vim to read copying and usage conditions.
6 * Do ":help credits" in Vim to see a list of people who contributed.
7 * See README.txt for an overview of the Vim source code.
8 */
11 * getchar.c
13 * functions related with getting a character from the user/mapping/redo/...
15 * manipulations with redo buffer and stuff buffer
16 * mappings and abbreviations
19 #include "vim.h"
22 * These buffers are used for storing:
23 * - stuffed characters: A command that is translated into another command.
24 * - redo characters: will redo the last change.
25 * - recorded chracters: for the "q" command.
27 * The bytes are stored like in the typeahead buffer:
28 * - K_SPECIAL introduces a special key (two more bytes follow). A literal
29 * K_SPECIAL is stored as K_SPECIAL KS_SPECIAL KE_FILLER.
30 * - CSI introduces a GUI termcap code (also when gui.in_use is FALSE,
31 * otherwise switching the GUI on would make mappings invalid).
32 * A literal CSI is stored as CSI KS_EXTRA KE_CSI.
33 * These translations are also done on multi-byte characters!
35 * Escaping CSI bytes is done by the system-specific input functions, called
36 * by ui_inchar().
37 * Escaping K_SPECIAL is done by inchar().
38 * Un-escaping is done by vgetc().
41 #define MINIMAL_SIZE 20 /* minimal size for b_str */
43 static struct buffheader redobuff = {{NULL, {NUL}}, NULL, 0, 0};
44 static struct buffheader old_redobuff = {{NULL, {NUL}}, NULL, 0, 0};
45 #if defined(FEAT_AUTOCMD) || defined(FEAT_EVAL) || defined(PROTO)
46 static struct buffheader save_redobuff = {{NULL, {NUL}}, NULL, 0, 0};
47 static struct buffheader save_old_redobuff = {{NULL, {NUL}}, NULL, 0, 0};
48 #endif
49 static struct buffheader recordbuff = {{NULL, {NUL}}, NULL, 0, 0};
51 static int typeahead_char = 0; /* typeahead char that's not flushed */
54 * when block_redo is TRUE redo buffer will not be changed
55 * used by edit() to repeat insertions and 'V' command for redoing
57 static int block_redo = FALSE;
60 * Make a hash value for a mapping.
61 * "mode" is the lower 4 bits of the State for the mapping.
62 * "c1" is the first character of the "lhs".
63 * Returns a value between 0 and 255, index in maphash.
64 * Put Normal/Visual mode mappings mostly separately from Insert/Cmdline mode.
66 #define MAP_HASH(mode, c1) (((mode) & (NORMAL + VISUAL + SELECTMODE + OP_PENDING)) ? (c1) : ((c1) ^ 0x80))
69 * Each mapping is put in one of the 256 hash lists, to speed up finding it.
71 static mapblock_T *(maphash[256]);
72 static int maphash_valid = FALSE;
75 * List used for abbreviations.
77 static mapblock_T *first_abbr = NULL; /* first entry in abbrlist */
79 static int KeyNoremap = 0; /* remapping flags */
82 * variables used by vgetorpeek() and flush_buffers()
84 * typebuf.tb_buf[] contains all characters that are not consumed yet.
85 * typebuf.tb_buf[typebuf.tb_off] is the first valid character.
86 * typebuf.tb_buf[typebuf.tb_off + typebuf.tb_len - 1] is the last valid char.
87 * typebuf.tb_buf[typebuf.tb_off + typebuf.tb_len] must be NUL.
88 * The head of the buffer may contain the result of mappings, abbreviations
89 * and @a commands. The length of this part is typebuf.tb_maplen.
90 * typebuf.tb_silent is the part where <silent> applies.
91 * After the head are characters that come from the terminal.
92 * typebuf.tb_no_abbr_cnt is the number of characters in typebuf.tb_buf that
93 * should not be considered for abbreviations.
94 * Some parts of typebuf.tb_buf may not be mapped. These parts are remembered
95 * in typebuf.tb_noremap[], which is the same length as typebuf.tb_buf and
96 * contains RM_NONE for the characters that are not to be remapped.
97 * typebuf.tb_noremap[typebuf.tb_off] is the first valid flag.
98 * (typebuf has been put in globals.h, because check_termcode() needs it).
100 #define RM_YES 0 /* tb_noremap: remap */
101 #define RM_NONE 1 /* tb_noremap: don't remap */
102 #define RM_SCRIPT 2 /* tb_noremap: remap local script mappings */
103 #define RM_ABBR 4 /* tb_noremap: don't remap, do abbrev. */
105 /* typebuf.tb_buf has three parts: room in front (for result of mappings), the
106 * middle for typeahead and room for new characters (which needs to be 3 *
107 * MAXMAPLEN) for the Amiga).
109 #define TYPELEN_INIT (5 * (MAXMAPLEN + 3))
110 static char_u typebuf_init[TYPELEN_INIT]; /* initial typebuf.tb_buf */
111 static char_u noremapbuf_init[TYPELEN_INIT]; /* initial typebuf.tb_noremap */
113 static int last_recorded_len = 0; /* number of last recorded chars */
115 static char_u *get_buffcont __ARGS((struct buffheader *, int));
116 static void add_buff __ARGS((struct buffheader *, char_u *, long n));
117 static void add_num_buff __ARGS((struct buffheader *, long));
118 static void add_char_buff __ARGS((struct buffheader *, int));
119 static int read_stuff __ARGS((int advance));
120 static void start_stuff __ARGS((void));
121 static int read_redo __ARGS((int, int));
122 static void copy_redo __ARGS((int));
123 static void init_typebuf __ARGS((void));
124 static void gotchars __ARGS((char_u *, int));
125 static void may_sync_undo __ARGS((void));
126 static void closescript __ARGS((void));
127 static int vgetorpeek __ARGS((int));
128 static void map_free __ARGS((mapblock_T **));
129 static void validate_maphash __ARGS((void));
130 static void showmap __ARGS((mapblock_T *mp, int local));
131 #ifdef FEAT_EVAL
132 static char_u *eval_map_expr __ARGS((char_u *str));
133 #endif
136 * Free and clear a buffer.
138 void
139 free_buff(buf)
140 struct buffheader *buf;
142 struct buffblock *p, *np;
144 for (p = buf->bh_first.b_next; p != NULL; p = np)
146 np = p->b_next;
147 vim_free(p);
149 buf->bh_first.b_next = NULL;
153 * Return the contents of a buffer as a single string.
154 * K_SPECIAL and CSI in the returned string are escaped.
156 static char_u *
157 get_buffcont(buffer, dozero)
158 struct buffheader *buffer;
159 int dozero; /* count == zero is not an error */
161 long_u count = 0;
162 char_u *p = NULL;
163 char_u *p2;
164 char_u *str;
165 struct buffblock *bp;
167 /* compute the total length of the string */
168 for (bp = buffer->bh_first.b_next; bp != NULL; bp = bp->b_next)
169 count += (long_u)STRLEN(bp->b_str);
171 if ((count || dozero) && (p = lalloc(count + 1, TRUE)) != NULL)
173 p2 = p;
174 for (bp = buffer->bh_first.b_next; bp != NULL; bp = bp->b_next)
175 for (str = bp->b_str; *str; )
176 *p2++ = *str++;
177 *p2 = NUL;
179 return (p);
183 * Return the contents of the record buffer as a single string
184 * and clear the record buffer.
185 * K_SPECIAL and CSI in the returned string are escaped.
187 char_u *
188 get_recorded()
190 char_u *p;
191 size_t len;
193 p = get_buffcont(&recordbuff, TRUE);
194 free_buff(&recordbuff);
197 * Remove the characters that were added the last time, these must be the
198 * (possibly mapped) characters that stopped the recording.
200 len = STRLEN(p);
201 if ((int)len >= last_recorded_len)
203 len -= last_recorded_len;
204 p[len] = NUL;
208 * When stopping recording from Insert mode with CTRL-O q, also remove the
209 * CTRL-O.
211 if (len > 0 && restart_edit != 0 && p[len - 1] == Ctrl_O)
212 p[len - 1] = NUL;
214 return (p);
218 * Return the contents of the redo buffer as a single string.
219 * K_SPECIAL and CSI in the returned string are escaped.
221 char_u *
222 get_inserted()
224 return get_buffcont(&redobuff, FALSE);
228 * Add string "s" after the current block of buffer "buf".
229 * K_SPECIAL and CSI should have been escaped already.
231 static void
232 add_buff(buf, s, slen)
233 struct buffheader *buf;
234 char_u *s;
235 long slen; /* length of "s" or -1 */
237 struct buffblock *p;
238 long_u len;
240 if (slen < 0)
241 slen = (long)STRLEN(s);
242 if (slen == 0) /* don't add empty strings */
243 return;
245 if (buf->bh_first.b_next == NULL) /* first add to list */
247 buf->bh_space = 0;
248 buf->bh_curr = &(buf->bh_first);
250 else if (buf->bh_curr == NULL) /* buffer has already been read */
252 EMSG(_("E222: Add to read buffer"));
253 return;
255 else if (buf->bh_index != 0)
256 mch_memmove(buf->bh_first.b_next->b_str,
257 buf->bh_first.b_next->b_str + buf->bh_index,
258 STRLEN(buf->bh_first.b_next->b_str + buf->bh_index) + 1);
259 buf->bh_index = 0;
261 if (buf->bh_space >= (int)slen)
263 len = (long_u)STRLEN(buf->bh_curr->b_str);
264 vim_strncpy(buf->bh_curr->b_str + len, s, (size_t)slen);
265 buf->bh_space -= slen;
267 else
269 if (slen < MINIMAL_SIZE)
270 len = MINIMAL_SIZE;
271 else
272 len = slen;
273 p = (struct buffblock *)lalloc((long_u)(sizeof(struct buffblock) + len),
274 TRUE);
275 if (p == NULL)
276 return; /* no space, just forget it */
277 buf->bh_space = (int)(len - slen);
278 vim_strncpy(p->b_str, s, (size_t)slen);
280 p->b_next = buf->bh_curr->b_next;
281 buf->bh_curr->b_next = p;
282 buf->bh_curr = p;
284 return;
288 * Add number "n" to buffer "buf".
290 static void
291 add_num_buff(buf, n)
292 struct buffheader *buf;
293 long n;
295 char_u number[32];
297 sprintf((char *)number, "%ld", n);
298 add_buff(buf, number, -1L);
302 * Add character 'c' to buffer "buf".
303 * Translates special keys, NUL, CSI, K_SPECIAL and multibyte characters.
305 static void
306 add_char_buff(buf, c)
307 struct buffheader *buf;
308 int c;
310 #ifdef FEAT_MBYTE
311 char_u bytes[MB_MAXBYTES + 1];
312 int len;
313 int i;
314 #endif
315 char_u temp[4];
317 #ifdef FEAT_MBYTE
318 if (IS_SPECIAL(c))
319 len = 1;
320 else
321 len = (*mb_char2bytes)(c, bytes);
322 for (i = 0; i < len; ++i)
324 if (!IS_SPECIAL(c))
325 c = bytes[i];
326 #endif
328 if (IS_SPECIAL(c) || c == K_SPECIAL || c == NUL)
330 /* translate special key code into three byte sequence */
331 temp[0] = K_SPECIAL;
332 temp[1] = K_SECOND(c);
333 temp[2] = K_THIRD(c);
334 temp[3] = NUL;
336 #ifdef FEAT_GUI
337 else if (c == CSI)
339 /* Translate a CSI to a CSI - KS_EXTRA - KE_CSI sequence */
340 temp[0] = CSI;
341 temp[1] = KS_EXTRA;
342 temp[2] = (int)KE_CSI;
343 temp[3] = NUL;
345 #endif
346 else
348 temp[0] = c;
349 temp[1] = NUL;
351 add_buff(buf, temp, -1L);
352 #ifdef FEAT_MBYTE
354 #endif
358 * Get one byte from the stuff buffer.
359 * If advance == TRUE go to the next char.
360 * No translation is done K_SPECIAL and CSI are escaped.
362 static int
363 read_stuff(advance)
364 int advance;
366 char_u c;
367 struct buffblock *curr;
369 if (stuffbuff.bh_first.b_next == NULL) /* buffer is empty */
370 return NUL;
372 curr = stuffbuff.bh_first.b_next;
373 c = curr->b_str[stuffbuff.bh_index];
375 if (advance)
377 if (curr->b_str[++stuffbuff.bh_index] == NUL)
379 stuffbuff.bh_first.b_next = curr->b_next;
380 vim_free(curr);
381 stuffbuff.bh_index = 0;
384 return c;
388 * Prepare the stuff buffer for reading (if it contains something).
390 static void
391 start_stuff()
393 if (stuffbuff.bh_first.b_next != NULL)
395 stuffbuff.bh_curr = &(stuffbuff.bh_first);
396 stuffbuff.bh_space = 0;
401 * Return TRUE if the stuff buffer is empty.
404 stuff_empty()
406 return (stuffbuff.bh_first.b_next == NULL);
410 * Set a typeahead character that won't be flushed.
412 void
413 typeahead_noflush(c)
414 int c;
416 typeahead_char = c;
420 * Remove the contents of the stuff buffer and the mapped characters in the
421 * typeahead buffer (used in case of an error). If 'typeahead' is true,
422 * flush all typeahead characters (used when interrupted by a CTRL-C).
424 void
425 flush_buffers(typeahead)
426 int typeahead;
428 init_typebuf();
430 start_stuff();
431 while (read_stuff(TRUE) != NUL)
434 if (typeahead) /* remove all typeahead */
437 * We have to get all characters, because we may delete the first part
438 * of an escape sequence.
439 * In an xterm we get one char at a time and we have to get them all.
441 while (inchar(typebuf.tb_buf, typebuf.tb_buflen - 1, 10L,
442 typebuf.tb_change_cnt) != 0)
444 typebuf.tb_off = MAXMAPLEN;
445 typebuf.tb_len = 0;
447 else /* remove mapped characters only */
449 typebuf.tb_off += typebuf.tb_maplen;
450 typebuf.tb_len -= typebuf.tb_maplen;
452 typebuf.tb_maplen = 0;
453 typebuf.tb_silent = 0;
454 cmd_silent = FALSE;
455 typebuf.tb_no_abbr_cnt = 0;
459 * The previous contents of the redo buffer is kept in old_redobuffer.
460 * This is used for the CTRL-O <.> command in insert mode.
462 void
463 ResetRedobuff()
465 if (!block_redo)
467 free_buff(&old_redobuff);
468 old_redobuff = redobuff;
469 redobuff.bh_first.b_next = NULL;
473 #if defined(FEAT_AUTOCMD) || defined(FEAT_EVAL) || defined(PROTO)
475 * Save redobuff and old_redobuff to save_redobuff and save_old_redobuff.
476 * Used before executing autocommands and user functions.
478 static int save_level = 0;
480 void
481 saveRedobuff()
483 char_u *s;
485 if (save_level++ == 0)
487 save_redobuff = redobuff;
488 redobuff.bh_first.b_next = NULL;
489 save_old_redobuff = old_redobuff;
490 old_redobuff.bh_first.b_next = NULL;
492 /* Make a copy, so that ":normal ." in a function works. */
493 s = get_buffcont(&save_redobuff, FALSE);
494 if (s != NULL)
496 add_buff(&redobuff, s, -1L);
497 vim_free(s);
503 * Restore redobuff and old_redobuff from save_redobuff and save_old_redobuff.
504 * Used after executing autocommands and user functions.
506 void
507 restoreRedobuff()
509 if (--save_level == 0)
511 free_buff(&redobuff);
512 redobuff = save_redobuff;
513 free_buff(&old_redobuff);
514 old_redobuff = save_old_redobuff;
517 #endif
520 * Append "s" to the redo buffer.
521 * K_SPECIAL and CSI should already have been escaped.
523 void
524 AppendToRedobuff(s)
525 char_u *s;
527 if (!block_redo)
528 add_buff(&redobuff, s, -1L);
532 * Append to Redo buffer literally, escaping special characters with CTRL-V.
533 * K_SPECIAL and CSI are escaped as well.
535 void
536 AppendToRedobuffLit(str, len)
537 char_u *str;
538 int len; /* length of "str" or -1 for up to the NUL */
540 char_u *s = str;
541 int c;
542 char_u *start;
544 if (block_redo)
545 return;
547 while (len < 0 ? *s != NUL : s - str < len)
549 /* Put a string of normal characters in the redo buffer (that's
550 * faster). */
551 start = s;
552 while (*s >= ' '
553 #ifndef EBCDIC
554 && *s < DEL /* EBCDIC: all chars above space are normal */
555 #endif
556 && (len < 0 || s - str < len))
557 ++s;
559 /* Don't put '0' or '^' as last character, just in case a CTRL-D is
560 * typed next. */
561 if (*s == NUL && (s[-1] == '0' || s[-1] == '^'))
562 --s;
563 if (s > start)
564 add_buff(&redobuff, start, (long)(s - start));
566 if (*s == NUL || (len >= 0 && s - str >= len))
567 break;
569 /* Handle a special or multibyte character. */
570 #ifdef FEAT_MBYTE
571 if (has_mbyte)
572 /* Handle composing chars separately. */
573 c = mb_cptr2char_adv(&s);
574 else
575 #endif
576 c = *s++;
577 if (c < ' ' || c == DEL || (*s == NUL && (c == '0' || c == '^')))
578 add_char_buff(&redobuff, Ctrl_V);
580 /* CTRL-V '0' must be inserted as CTRL-V 048 (EBCDIC: xf0) */
581 if (*s == NUL && c == '0')
582 #ifdef EBCDIC
583 add_buff(&redobuff, (char_u *)"xf0", 3L);
584 #else
585 add_buff(&redobuff, (char_u *)"048", 3L);
586 #endif
587 else
588 add_char_buff(&redobuff, c);
593 * Append a character to the redo buffer.
594 * Translates special keys, NUL, CSI, K_SPECIAL and multibyte characters.
596 void
597 AppendCharToRedobuff(c)
598 int c;
600 if (!block_redo)
601 add_char_buff(&redobuff, c);
605 * Append a number to the redo buffer.
607 void
608 AppendNumberToRedobuff(n)
609 long n;
611 if (!block_redo)
612 add_num_buff(&redobuff, n);
616 * Append string "s" to the stuff buffer.
617 * CSI and K_SPECIAL must already have been escaped.
619 void
620 stuffReadbuff(s)
621 char_u *s;
623 add_buff(&stuffbuff, s, -1L);
626 void
627 stuffReadbuffLen(s, len)
628 char_u *s;
629 long len;
631 add_buff(&stuffbuff, s, len);
634 #if defined(FEAT_EVAL) || defined(PROTO)
636 * Stuff "s" into the stuff buffer, leaving special key codes unmodified and
637 * escaping other K_SPECIAL and CSI bytes.
639 void
640 stuffReadbuffSpec(s)
641 char_u *s;
643 while (*s != NUL)
645 if (*s == K_SPECIAL && s[1] != NUL && s[2] != NUL)
647 /* Insert special key literally. */
648 stuffReadbuffLen(s, 3L);
649 s += 3;
651 else
652 #ifdef FEAT_MBYTE
653 stuffcharReadbuff(mb_ptr2char_adv(&s));
654 #else
655 stuffcharReadbuff(*s++);
656 #endif
659 #endif
662 * Append a character to the stuff buffer.
663 * Translates special keys, NUL, CSI, K_SPECIAL and multibyte characters.
665 void
666 stuffcharReadbuff(c)
667 int c;
669 add_char_buff(&stuffbuff, c);
673 * Append a number to the stuff buffer.
675 void
676 stuffnumReadbuff(n)
677 long n;
679 add_num_buff(&stuffbuff, n);
683 * Read a character from the redo buffer. Translates K_SPECIAL, CSI and
684 * multibyte characters.
685 * The redo buffer is left as it is.
686 * if init is TRUE, prepare for redo, return FAIL if nothing to redo, OK
687 * otherwise
688 * if old is TRUE, use old_redobuff instead of redobuff
690 static int
691 read_redo(init, old_redo)
692 int init;
693 int old_redo;
695 static struct buffblock *bp;
696 static char_u *p;
697 int c;
698 #ifdef FEAT_MBYTE
699 int n;
700 char_u buf[MB_MAXBYTES];
701 int i;
702 #endif
704 if (init)
706 if (old_redo)
707 bp = old_redobuff.bh_first.b_next;
708 else
709 bp = redobuff.bh_first.b_next;
710 if (bp == NULL)
711 return FAIL;
712 p = bp->b_str;
713 return OK;
715 if ((c = *p) != NUL)
717 /* Reverse the conversion done by add_char_buff() */
718 #ifdef FEAT_MBYTE
719 /* For a multi-byte character get all the bytes and return the
720 * converted character. */
721 if (has_mbyte && (c != K_SPECIAL || p[1] == KS_SPECIAL))
722 n = MB_BYTE2LEN_CHECK(c);
723 else
724 n = 1;
725 for (i = 0; ; ++i)
726 #endif
728 if (c == K_SPECIAL) /* special key or escaped K_SPECIAL */
730 c = TO_SPECIAL(p[1], p[2]);
731 p += 2;
733 #ifdef FEAT_GUI
734 if (c == CSI) /* escaped CSI */
735 p += 2;
736 #endif
737 if (*++p == NUL && bp->b_next != NULL)
739 bp = bp->b_next;
740 p = bp->b_str;
742 #ifdef FEAT_MBYTE
743 buf[i] = c;
744 if (i == n - 1) /* last byte of a character */
746 if (n != 1)
747 c = (*mb_ptr2char)(buf);
748 break;
750 c = *p;
751 if (c == NUL) /* cannot happen? */
752 break;
753 #endif
757 return c;
761 * Copy the rest of the redo buffer into the stuff buffer (in a slow way).
762 * If old_redo is TRUE, use old_redobuff instead of redobuff.
763 * The escaped K_SPECIAL and CSI are copied without translation.
765 static void
766 copy_redo(old_redo)
767 int old_redo;
769 int c;
771 while ((c = read_redo(FALSE, old_redo)) != NUL)
772 stuffcharReadbuff(c);
776 * Stuff the redo buffer into the stuffbuff.
777 * Insert the redo count into the command.
778 * If "old_redo" is TRUE, the last but one command is repeated
779 * instead of the last command (inserting text). This is used for
780 * CTRL-O <.> in insert mode
782 * return FAIL for failure, OK otherwise
785 start_redo(count, old_redo)
786 long count;
787 int old_redo;
789 int c;
791 /* init the pointers; return if nothing to redo */
792 if (read_redo(TRUE, old_redo) == FAIL)
793 return FAIL;
795 c = read_redo(FALSE, old_redo);
797 /* copy the buffer name, if present */
798 if (c == '"')
800 add_buff(&stuffbuff, (char_u *)"\"", 1L);
801 c = read_redo(FALSE, old_redo);
803 /* if a numbered buffer is used, increment the number */
804 if (c >= '1' && c < '9')
805 ++c;
806 add_char_buff(&stuffbuff, c);
807 c = read_redo(FALSE, old_redo);
810 #ifdef FEAT_VISUAL
811 if (c == 'v') /* redo Visual */
813 VIsual = curwin->w_cursor;
814 VIsual_active = TRUE;
815 VIsual_select = FALSE;
816 VIsual_reselect = TRUE;
817 redo_VIsual_busy = TRUE;
818 c = read_redo(FALSE, old_redo);
820 #endif
822 /* try to enter the count (in place of a previous count) */
823 if (count)
825 while (VIM_ISDIGIT(c)) /* skip "old" count */
826 c = read_redo(FALSE, old_redo);
827 add_num_buff(&stuffbuff, count);
830 /* copy from the redo buffer into the stuff buffer */
831 add_char_buff(&stuffbuff, c);
832 copy_redo(old_redo);
833 return OK;
837 * Repeat the last insert (R, o, O, a, A, i or I command) by stuffing
838 * the redo buffer into the stuffbuff.
839 * return FAIL for failure, OK otherwise
842 start_redo_ins()
844 int c;
846 if (read_redo(TRUE, FALSE) == FAIL)
847 return FAIL;
848 start_stuff();
850 /* skip the count and the command character */
851 while ((c = read_redo(FALSE, FALSE)) != NUL)
853 if (vim_strchr((char_u *)"AaIiRrOo", c) != NULL)
855 if (c == 'O' || c == 'o')
856 stuffReadbuff(NL_STR);
857 break;
861 /* copy the typed text from the redo buffer into the stuff buffer */
862 copy_redo(FALSE);
863 block_redo = TRUE;
864 return OK;
867 void
868 stop_redo_ins()
870 block_redo = FALSE;
874 * Initialize typebuf.tb_buf to point to typebuf_init.
875 * alloc() cannot be used here: In out-of-memory situations it would
876 * be impossible to type anything.
878 static void
879 init_typebuf()
881 if (typebuf.tb_buf == NULL)
883 typebuf.tb_buf = typebuf_init;
884 typebuf.tb_noremap = noremapbuf_init;
885 typebuf.tb_buflen = TYPELEN_INIT;
886 typebuf.tb_len = 0;
887 typebuf.tb_off = 0;
888 typebuf.tb_change_cnt = 1;
893 * insert a string in position 'offset' in the typeahead buffer (for "@r"
894 * and ":normal" command, vgetorpeek() and check_termcode())
896 * If noremap is REMAP_YES, new string can be mapped again.
897 * If noremap is REMAP_NONE, new string cannot be mapped again.
898 * If noremap is REMAP_SKIP, fist char of new string cannot be mapped again,
899 * but abbreviations are allowed.
900 * If noremap is REMAP_SCRIPT, new string cannot be mapped again, except for
901 * script-local mappings.
902 * If noremap is > 0, that many characters of the new string cannot be mapped.
904 * If nottyped is TRUE, the string does not return KeyTyped (don't use when
905 * offset is non-zero!).
907 * If silent is TRUE, cmd_silent is set when the characters are obtained.
909 * return FAIL for failure, OK otherwise
912 ins_typebuf(str, noremap, offset, nottyped, silent)
913 char_u *str;
914 int noremap;
915 int offset;
916 int nottyped;
917 int silent;
919 char_u *s1, *s2;
920 int newlen;
921 int addlen;
922 int i;
923 int newoff;
924 int val;
925 int nrm;
927 init_typebuf();
928 if (++typebuf.tb_change_cnt == 0)
929 typebuf.tb_change_cnt = 1;
931 addlen = (int)STRLEN(str);
934 * Easy case: there is room in front of typebuf.tb_buf[typebuf.tb_off]
936 if (offset == 0 && addlen <= typebuf.tb_off)
938 typebuf.tb_off -= addlen;
939 mch_memmove(typebuf.tb_buf + typebuf.tb_off, str, (size_t)addlen);
943 * Need to allocate a new buffer.
944 * In typebuf.tb_buf there must always be room for 3 * MAXMAPLEN + 4
945 * characters. We add some extra room to avoid having to allocate too
946 * often.
948 else
950 newoff = MAXMAPLEN + 4;
951 newlen = typebuf.tb_len + addlen + newoff + 4 * (MAXMAPLEN + 4);
952 if (newlen < 0) /* string is getting too long */
954 EMSG(_(e_toocompl)); /* also calls flush_buffers */
955 setcursor();
956 return FAIL;
958 s1 = alloc(newlen);
959 if (s1 == NULL) /* out of memory */
960 return FAIL;
961 s2 = alloc(newlen);
962 if (s2 == NULL) /* out of memory */
964 vim_free(s1);
965 return FAIL;
967 typebuf.tb_buflen = newlen;
969 /* copy the old chars, before the insertion point */
970 mch_memmove(s1 + newoff, typebuf.tb_buf + typebuf.tb_off,
971 (size_t)offset);
972 /* copy the new chars */
973 mch_memmove(s1 + newoff + offset, str, (size_t)addlen);
974 /* copy the old chars, after the insertion point, including the NUL at
975 * the end */
976 mch_memmove(s1 + newoff + offset + addlen,
977 typebuf.tb_buf + typebuf.tb_off + offset,
978 (size_t)(typebuf.tb_len - offset + 1));
979 if (typebuf.tb_buf != typebuf_init)
980 vim_free(typebuf.tb_buf);
981 typebuf.tb_buf = s1;
983 mch_memmove(s2 + newoff, typebuf.tb_noremap + typebuf.tb_off,
984 (size_t)offset);
985 mch_memmove(s2 + newoff + offset + addlen,
986 typebuf.tb_noremap + typebuf.tb_off + offset,
987 (size_t)(typebuf.tb_len - offset));
988 if (typebuf.tb_noremap != noremapbuf_init)
989 vim_free(typebuf.tb_noremap);
990 typebuf.tb_noremap = s2;
992 typebuf.tb_off = newoff;
994 typebuf.tb_len += addlen;
996 /* If noremap == REMAP_SCRIPT: do remap script-local mappings. */
997 if (noremap == REMAP_SCRIPT)
998 val = RM_SCRIPT;
999 else if (noremap == REMAP_SKIP)
1000 val = RM_ABBR;
1001 else
1002 val = RM_NONE;
1005 * Adjust typebuf.tb_noremap[] for the new characters:
1006 * If noremap == REMAP_NONE or REMAP_SCRIPT: new characters are
1007 * (sometimes) not remappable
1008 * If noremap == REMAP_YES: all the new characters are mappable
1009 * If noremap > 0: "noremap" characters are not remappable, the rest
1010 * mappable
1012 if (noremap == REMAP_SKIP)
1013 nrm = 1;
1014 else if (noremap < 0)
1015 nrm = addlen;
1016 else
1017 nrm = noremap;
1018 for (i = 0; i < addlen; ++i)
1019 typebuf.tb_noremap[typebuf.tb_off + i + offset] =
1020 (--nrm >= 0) ? val : RM_YES;
1022 /* tb_maplen and tb_silent only remember the length of mapped and/or
1023 * silent mappings at the start of the buffer, assuming that a mapped
1024 * sequence doesn't result in typed characters. */
1025 if (nottyped || typebuf.tb_maplen > offset)
1026 typebuf.tb_maplen += addlen;
1027 if (silent || typebuf.tb_silent > offset)
1029 typebuf.tb_silent += addlen;
1030 cmd_silent = TRUE;
1032 if (typebuf.tb_no_abbr_cnt && offset == 0) /* and not used for abbrev.s */
1033 typebuf.tb_no_abbr_cnt += addlen;
1035 return OK;
1039 * Put character "c" back into the typeahead buffer.
1040 * Can be used for a character obtained by vgetc() that needs to be put back.
1041 * Uses cmd_silent, KeyTyped and KeyNoremap to restore the flags belonging to
1042 * the char.
1044 void
1045 ins_char_typebuf(c)
1046 int c;
1048 #ifdef FEAT_MBYTE
1049 char_u buf[MB_MAXBYTES];
1050 #else
1051 char_u buf[4];
1052 #endif
1053 if (IS_SPECIAL(c))
1055 buf[0] = K_SPECIAL;
1056 buf[1] = K_SECOND(c);
1057 buf[2] = K_THIRD(c);
1058 buf[3] = NUL;
1060 else
1062 #ifdef FEAT_MBYTE
1063 buf[(*mb_char2bytes)(c, buf)] = NUL;
1064 #else
1065 buf[0] = c;
1066 buf[1] = NUL;
1067 #endif
1069 (void)ins_typebuf(buf, KeyNoremap, 0, !KeyTyped, cmd_silent);
1073 * Return TRUE if the typeahead buffer was changed (while waiting for a
1074 * character to arrive). Happens when a message was received from a client or
1075 * from feedkeys().
1076 * But check in a more generic way to avoid trouble: When "typebuf.tb_buf"
1077 * changed it was reallocated and the old pointer can no longer be used.
1078 * Or "typebuf.tb_off" may have been changed and we would overwrite characters
1079 * that was just added.
1082 typebuf_changed(tb_change_cnt)
1083 int tb_change_cnt; /* old value of typebuf.tb_change_cnt */
1085 return (tb_change_cnt != 0 && (typebuf.tb_change_cnt != tb_change_cnt
1086 #if defined(FEAT_CLIENTSERVER) || defined(FEAT_EVAL)
1087 || typebuf_was_filled
1088 #endif
1093 * Return TRUE if there are no characters in the typeahead buffer that have
1094 * not been typed (result from a mapping or come from ":normal").
1097 typebuf_typed()
1099 return typebuf.tb_maplen == 0;
1102 #if defined(FEAT_VISUAL) || defined(PROTO)
1104 * Return the number of characters that are mapped (or not typed).
1107 typebuf_maplen()
1109 return typebuf.tb_maplen;
1111 #endif
1114 * remove "len" characters from typebuf.tb_buf[typebuf.tb_off + offset]
1116 void
1117 del_typebuf(len, offset)
1118 int len;
1119 int offset;
1121 int i;
1123 if (len == 0)
1124 return; /* nothing to do */
1126 typebuf.tb_len -= len;
1129 * Easy case: Just increase typebuf.tb_off.
1131 if (offset == 0 && typebuf.tb_buflen - (typebuf.tb_off + len)
1132 >= 3 * MAXMAPLEN + 3)
1133 typebuf.tb_off += len;
1135 * Have to move the characters in typebuf.tb_buf[] and typebuf.tb_noremap[]
1137 else
1139 i = typebuf.tb_off + offset;
1141 * Leave some extra room at the end to avoid reallocation.
1143 if (typebuf.tb_off > MAXMAPLEN)
1145 mch_memmove(typebuf.tb_buf + MAXMAPLEN,
1146 typebuf.tb_buf + typebuf.tb_off, (size_t)offset);
1147 mch_memmove(typebuf.tb_noremap + MAXMAPLEN,
1148 typebuf.tb_noremap + typebuf.tb_off, (size_t)offset);
1149 typebuf.tb_off = MAXMAPLEN;
1151 /* adjust typebuf.tb_buf (include the NUL at the end) */
1152 mch_memmove(typebuf.tb_buf + typebuf.tb_off + offset,
1153 typebuf.tb_buf + i + len,
1154 (size_t)(typebuf.tb_len - offset + 1));
1155 /* adjust typebuf.tb_noremap[] */
1156 mch_memmove(typebuf.tb_noremap + typebuf.tb_off + offset,
1157 typebuf.tb_noremap + i + len,
1158 (size_t)(typebuf.tb_len - offset));
1161 if (typebuf.tb_maplen > offset) /* adjust tb_maplen */
1163 if (typebuf.tb_maplen < offset + len)
1164 typebuf.tb_maplen = offset;
1165 else
1166 typebuf.tb_maplen -= len;
1168 if (typebuf.tb_silent > offset) /* adjust tb_silent */
1170 if (typebuf.tb_silent < offset + len)
1171 typebuf.tb_silent = offset;
1172 else
1173 typebuf.tb_silent -= len;
1175 if (typebuf.tb_no_abbr_cnt > offset) /* adjust tb_no_abbr_cnt */
1177 if (typebuf.tb_no_abbr_cnt < offset + len)
1178 typebuf.tb_no_abbr_cnt = offset;
1179 else
1180 typebuf.tb_no_abbr_cnt -= len;
1183 #if defined(FEAT_CLIENTSERVER) || defined(FEAT_EVAL)
1184 /* Reset the flag that text received from a client or from feedkeys()
1185 * was inserted in the typeahead buffer. */
1186 typebuf_was_filled = FALSE;
1187 #endif
1188 if (++typebuf.tb_change_cnt == 0)
1189 typebuf.tb_change_cnt = 1;
1193 * Write typed characters to script file.
1194 * If recording is on put the character in the recordbuffer.
1196 static void
1197 gotchars(chars, len)
1198 char_u *chars;
1199 int len;
1201 char_u *s = chars;
1202 int c;
1203 char_u buf[2];
1204 int todo = len;
1206 /* remember how many chars were last recorded */
1207 if (Recording)
1208 last_recorded_len += len;
1210 buf[1] = NUL;
1211 while (todo--)
1213 /* Handle one byte at a time; no translation to be done. */
1214 c = *s++;
1215 updatescript(c);
1217 if (Recording)
1219 buf[0] = c;
1220 add_buff(&recordbuff, buf, 1L);
1223 may_sync_undo();
1225 #ifdef FEAT_EVAL
1226 /* output "debug mode" message next time in debug mode */
1227 debug_did_msg = FALSE;
1228 #endif
1230 /* Since characters have been typed, consider the following to be in
1231 * another mapping. Search string will be kept in history. */
1232 ++maptick;
1236 * Sync undo. Called when typed characters are obtained from the typeahead
1237 * buffer, or when a menu is used.
1238 * Do not sync:
1239 * - In Insert mode, unless cursor key has been used.
1240 * - While reading a script file.
1241 * - When no_u_sync is non-zero.
1243 static void
1244 may_sync_undo()
1246 if ((!(State & (INSERT + CMDLINE)) || arrow_used)
1247 && scriptin[curscript] == NULL)
1248 u_sync(FALSE);
1252 * Make "typebuf" empty and allocate new buffers.
1253 * Returns FAIL when out of memory.
1256 alloc_typebuf()
1258 typebuf.tb_buf = alloc(TYPELEN_INIT);
1259 typebuf.tb_noremap = alloc(TYPELEN_INIT);
1260 if (typebuf.tb_buf == NULL || typebuf.tb_noremap == NULL)
1262 free_typebuf();
1263 return FAIL;
1265 typebuf.tb_buflen = TYPELEN_INIT;
1266 typebuf.tb_off = 0;
1267 typebuf.tb_len = 0;
1268 typebuf.tb_maplen = 0;
1269 typebuf.tb_silent = 0;
1270 typebuf.tb_no_abbr_cnt = 0;
1271 if (++typebuf.tb_change_cnt == 0)
1272 typebuf.tb_change_cnt = 1;
1273 return OK;
1277 * Free the buffers of "typebuf".
1279 void
1280 free_typebuf()
1282 if (typebuf.tb_buf == typebuf_init)
1283 EMSG2(_(e_intern2), "Free typebuf 1");
1284 else
1285 vim_free(typebuf.tb_buf);
1286 if (typebuf.tb_buf == noremapbuf_init)
1287 EMSG2(_(e_intern2), "Free typebuf 2");
1288 else
1289 vim_free(typebuf.tb_noremap);
1293 * When doing ":so! file", the current typeahead needs to be saved, and
1294 * restored when "file" has been read completely.
1296 static typebuf_T saved_typebuf[NSCRIPT];
1299 save_typebuf()
1301 init_typebuf();
1302 saved_typebuf[curscript] = typebuf;
1303 /* If out of memory: restore typebuf and close file. */
1304 if (alloc_typebuf() == FAIL)
1306 closescript();
1307 return FAIL;
1309 return OK;
1312 #if defined(FEAT_EVAL) || defined(FEAT_EX_EXTRA) || defined(PROTO)
1315 * Save all three kinds of typeahead, so that the user must type at a prompt.
1317 void
1318 save_typeahead(tp)
1319 tasave_T *tp;
1321 tp->save_typebuf = typebuf;
1322 tp->typebuf_valid = (alloc_typebuf() == OK);
1323 if (!tp->typebuf_valid)
1324 typebuf = tp->save_typebuf;
1326 tp->save_stuffbuff = stuffbuff;
1327 stuffbuff.bh_first.b_next = NULL;
1328 # ifdef USE_INPUT_BUF
1329 tp->save_inputbuf = get_input_buf();
1330 # endif
1334 * Restore the typeahead to what it was before calling save_typeahead().
1335 * The allocated memory is freed, can only be called once!
1337 void
1338 restore_typeahead(tp)
1339 tasave_T *tp;
1341 if (tp->typebuf_valid)
1343 free_typebuf();
1344 typebuf = tp->save_typebuf;
1347 free_buff(&stuffbuff);
1348 stuffbuff = tp->save_stuffbuff;
1349 # ifdef USE_INPUT_BUF
1350 set_input_buf(tp->save_inputbuf);
1351 # endif
1353 #endif
1356 * Open a new script file for the ":source!" command.
1358 void
1359 openscript(name, directly)
1360 char_u *name;
1361 int directly; /* when TRUE execute directly */
1363 if (curscript + 1 == NSCRIPT)
1365 EMSG(_(e_nesting));
1366 return;
1368 #ifdef FEAT_EVAL
1369 if (ignore_script)
1370 /* Not reading from script, also don't open one. Warning message? */
1371 return;
1372 #endif
1374 if (scriptin[curscript] != NULL) /* already reading script */
1375 ++curscript;
1376 /* use NameBuff for expanded name */
1377 expand_env(name, NameBuff, MAXPATHL);
1378 if ((scriptin[curscript] = mch_fopen((char *)NameBuff, READBIN)) == NULL)
1380 EMSG2(_(e_notopen), name);
1381 if (curscript)
1382 --curscript;
1383 return;
1385 if (save_typebuf() == FAIL)
1386 return;
1389 * Execute the commands from the file right now when using ":source!"
1390 * after ":global" or ":argdo" or in a loop. Also when another command
1391 * follows. This means the display won't be updated. Don't do this
1392 * always, "make test" would fail.
1394 if (directly)
1396 oparg_T oa;
1397 int oldcurscript;
1398 int save_State = State;
1399 int save_restart_edit = restart_edit;
1400 int save_insertmode = p_im;
1401 int save_finish_op = finish_op;
1402 int save_msg_scroll = msg_scroll;
1404 State = NORMAL;
1405 msg_scroll = FALSE; /* no msg scrolling in Normal mode */
1406 restart_edit = 0; /* don't go to Insert mode */
1407 p_im = FALSE; /* don't use 'insertmode' */
1408 clear_oparg(&oa);
1409 finish_op = FALSE;
1411 oldcurscript = curscript;
1414 update_topline_cursor(); /* update cursor position and topline */
1415 normal_cmd(&oa, FALSE); /* execute one command */
1416 vpeekc(); /* check for end of file */
1418 while (scriptin[oldcurscript] != NULL);
1420 State = save_State;
1421 msg_scroll = save_msg_scroll;
1422 restart_edit = save_restart_edit;
1423 p_im = save_insertmode;
1424 finish_op = save_finish_op;
1429 * Close the currently active input script.
1431 static void
1432 closescript()
1434 free_typebuf();
1435 typebuf = saved_typebuf[curscript];
1437 fclose(scriptin[curscript]);
1438 scriptin[curscript] = NULL;
1439 if (curscript > 0)
1440 --curscript;
1443 #if defined(EXITFREE) || defined(PROTO)
1444 void
1445 close_all_scripts()
1447 while (scriptin[0] != NULL)
1448 closescript();
1450 #endif
1452 #if defined(FEAT_INS_EXPAND) || defined(PROTO)
1454 * Return TRUE when reading keys from a script file.
1457 using_script()
1459 return scriptin[curscript] != NULL;
1461 #endif
1464 * This function is called just before doing a blocking wait. Thus after
1465 * waiting 'updatetime' for a character to arrive.
1467 void
1468 before_blocking()
1470 updatescript(0);
1471 #ifdef FEAT_EVAL
1472 if (may_garbage_collect)
1473 garbage_collect();
1474 #endif
1478 * updatescipt() is called when a character can be written into the script file
1479 * or when we have waited some time for a character (c == 0)
1481 * All the changed memfiles are synced if c == 0 or when the number of typed
1482 * characters reaches 'updatecount' and 'updatecount' is non-zero.
1484 void
1485 updatescript(c)
1486 int c;
1488 static int count = 0;
1490 if (c && scriptout)
1491 putc(c, scriptout);
1492 if (c == 0 || (p_uc > 0 && ++count >= p_uc))
1494 ml_sync_all(c == 0, TRUE);
1495 count = 0;
1499 #define KL_PART_KEY -1 /* keylen value for incomplete key-code */
1500 #define KL_PART_MAP -2 /* keylen value for incomplete mapping */
1502 static int old_char = -1; /* character put back by vungetc() */
1503 static int old_mod_mask; /* mod_mask for ungotten character */
1506 * Get the next input character.
1507 * Can return a special key or a multi-byte character.
1508 * Can return NUL when called recursively, use safe_vgetc() if that's not
1509 * wanted.
1510 * This translates escaped K_SPECIAL and CSI bytes to a K_SPECIAL or CSI byte.
1511 * Collects the bytes of a multibyte character into the whole character.
1512 * Returns the modifers in the global "mod_mask".
1515 vgetc()
1517 int c, c2;
1518 #ifdef FEAT_MBYTE
1519 int n;
1520 char_u buf[MB_MAXBYTES];
1521 int i;
1522 #endif
1524 #ifdef FEAT_EVAL
1525 /* Do garbage collection when garbagecollect() was called previously and
1526 * we are now at the toplevel. */
1527 if (may_garbage_collect && want_garbage_collect)
1528 garbage_collect();
1529 #endif
1532 * If a character was put back with vungetc, it was already processed.
1533 * Return it directly.
1535 if (old_char != -1)
1537 c = old_char;
1538 old_char = -1;
1539 mod_mask = old_mod_mask;
1541 else
1543 mod_mask = 0x0;
1544 last_recorded_len = 0;
1545 for (;;) /* this is done twice if there are modifiers */
1547 if (mod_mask) /* no mapping after modifier has been read */
1549 ++no_mapping;
1550 ++allow_keys;
1552 c = vgetorpeek(TRUE);
1553 if (mod_mask)
1555 --no_mapping;
1556 --allow_keys;
1559 /* Get two extra bytes for special keys */
1560 if (c == K_SPECIAL
1561 #ifdef FEAT_GUI
1562 || c == CSI
1563 #endif
1566 int save_allow_keys = allow_keys;
1568 ++no_mapping;
1569 allow_keys = 0; /* make sure BS is not found */
1570 c2 = vgetorpeek(TRUE); /* no mapping for these chars */
1571 c = vgetorpeek(TRUE);
1572 --no_mapping;
1573 allow_keys = save_allow_keys;
1574 if (c2 == KS_MODIFIER)
1576 mod_mask = c;
1577 continue;
1579 c = TO_SPECIAL(c2, c);
1581 #if defined(FEAT_GUI_W32) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
1582 /* Handle K_TEAROFF here, the caller of vgetc() doesn't need to
1583 * know that a menu was torn off */
1584 if (c == K_TEAROFF)
1586 char_u name[200];
1587 int i;
1589 /* get menu path, it ends with a <CR> */
1590 for (i = 0; (c = vgetorpeek(TRUE)) != '\r'; )
1592 name[i] = c;
1593 if (i < 199)
1594 ++i;
1596 name[i] = NUL;
1597 gui_make_tearoff(name);
1598 continue;
1600 #endif
1601 #if defined(FEAT_GUI) && defined(HAVE_GTK2) && defined(FEAT_MENU)
1602 /* GTK: <F10> normally selects the menu, but it's passed until
1603 * here to allow mapping it. Intercept and invoke the GTK
1604 * behavior if it's not mapped. */
1605 if (c == K_F10 && gui.menubar != NULL)
1607 gtk_menu_shell_select_first(GTK_MENU_SHELL(gui.menubar), FALSE);
1608 continue;
1610 #endif
1611 #ifdef FEAT_GUI
1612 /* Handle focus event here, so that the caller doesn't need to
1613 * know about it. Return K_IGNORE so that we loop once (needed if
1614 * 'lazyredraw' is set). */
1615 if (c == K_FOCUSGAINED || c == K_FOCUSLOST)
1617 ui_focus_change(c == K_FOCUSGAINED);
1618 c = K_IGNORE;
1621 /* Translate K_CSI to CSI. The special key is only used to avoid
1622 * it being recognized as the start of a special key. */
1623 if (c == K_CSI)
1624 c = CSI;
1625 #endif
1627 #ifdef MSDOS
1629 * If K_NUL was typed, it is replaced by K_NUL, 3 in mch_inchar().
1630 * Delete the 3 here.
1632 else if (c == K_NUL && vpeekc() == 3)
1633 (void)vgetorpeek(TRUE);
1634 #endif
1636 /* a keypad or special function key was not mapped, use it like
1637 * its ASCII equivalent */
1638 switch (c)
1640 case K_KPLUS: c = '+'; break;
1641 case K_KMINUS: c = '-'; break;
1642 case K_KDIVIDE: c = '/'; break;
1643 case K_KMULTIPLY: c = '*'; break;
1644 case K_KENTER: c = CAR; break;
1645 case K_KPOINT:
1646 #ifdef WIN32
1647 /* Can be either '.' or a ',', *
1648 * depending on the type of keypad. */
1649 c = MapVirtualKey(VK_DECIMAL, 2); break;
1650 #else
1651 c = '.'; break;
1652 #endif
1653 case K_K0: c = '0'; break;
1654 case K_K1: c = '1'; break;
1655 case K_K2: c = '2'; break;
1656 case K_K3: c = '3'; break;
1657 case K_K4: c = '4'; break;
1658 case K_K5: c = '5'; break;
1659 case K_K6: c = '6'; break;
1660 case K_K7: c = '7'; break;
1661 case K_K8: c = '8'; break;
1662 case K_K9: c = '9'; break;
1664 case K_XHOME:
1665 case K_ZHOME: if (mod_mask == MOD_MASK_SHIFT)
1667 c = K_S_HOME;
1668 mod_mask = 0;
1670 else if (mod_mask == MOD_MASK_CTRL)
1672 c = K_C_HOME;
1673 mod_mask = 0;
1675 else
1676 c = K_HOME;
1677 break;
1678 case K_XEND:
1679 case K_ZEND: if (mod_mask == MOD_MASK_SHIFT)
1681 c = K_S_END;
1682 mod_mask = 0;
1684 else if (mod_mask == MOD_MASK_CTRL)
1686 c = K_C_END;
1687 mod_mask = 0;
1689 else
1690 c = K_END;
1691 break;
1693 case K_XUP: c = K_UP; break;
1694 case K_XDOWN: c = K_DOWN; break;
1695 case K_XLEFT: c = K_LEFT; break;
1696 case K_XRIGHT: c = K_RIGHT; break;
1699 #ifdef FEAT_MBYTE
1700 /* For a multi-byte character get all the bytes and return the
1701 * converted character.
1702 * Note: This will loop until enough bytes are received!
1704 if (has_mbyte && (n = MB_BYTE2LEN_CHECK(c)) > 1)
1706 ++no_mapping;
1707 buf[0] = c;
1708 for (i = 1; i < n; ++i)
1710 buf[i] = vgetorpeek(TRUE);
1711 if (buf[i] == K_SPECIAL
1712 #ifdef FEAT_GUI
1713 || buf[i] == CSI
1714 #endif
1717 /* Must be a K_SPECIAL - KS_SPECIAL - KE_FILLER sequence,
1718 * which represents a K_SPECIAL (0x80),
1719 * or a CSI - KS_EXTRA - KE_CSI sequence, which represents
1720 * a CSI (0x9B),
1721 * of a K_SPECIAL - KS_EXTRA - KE_CSI, which is CSI too. */
1722 c = vgetorpeek(TRUE);
1723 if (vgetorpeek(TRUE) == (int)KE_CSI && c == KS_EXTRA)
1724 buf[i] = CSI;
1727 --no_mapping;
1728 c = (*mb_ptr2char)(buf);
1730 #endif
1732 break;
1736 #ifdef FEAT_EVAL
1738 * In the main loop "may_garbage_collect" can be set to do garbage
1739 * collection in the first next vgetc(). It's disabled after that to
1740 * avoid internally used Lists and Dicts to be freed.
1742 may_garbage_collect = FALSE;
1743 #endif
1745 return c;
1749 * Like vgetc(), but never return a NUL when called recursively, get a key
1750 * directly from the user (ignoring typeahead).
1753 safe_vgetc()
1755 int c;
1757 c = vgetc();
1758 if (c == NUL)
1759 c = get_keystroke();
1760 return c;
1764 * Like safe_vgetc(), but loop to handle K_IGNORE.
1765 * Also ignore scrollbar events.
1768 plain_vgetc()
1770 int c;
1774 c = safe_vgetc();
1775 } while (c == K_IGNORE || c == K_VER_SCROLLBAR || c == K_HOR_SCROLLBAR);
1776 return c;
1780 * Check if a character is available, such that vgetc() will not block.
1781 * If the next character is a special character or multi-byte, the returned
1782 * character is not valid!.
1785 vpeekc()
1787 if (old_char != -1)
1788 return old_char;
1789 return vgetorpeek(FALSE);
1792 #if defined(FEAT_TERMRESPONSE) || defined(PROTO)
1794 * Like vpeekc(), but don't allow mapping. Do allow checking for terminal
1795 * codes.
1798 vpeekc_nomap()
1800 int c;
1802 ++no_mapping;
1803 ++allow_keys;
1804 c = vpeekc();
1805 --no_mapping;
1806 --allow_keys;
1807 return c;
1809 #endif
1811 #if defined(FEAT_INS_EXPAND) || defined(PROTO)
1813 * Check if any character is available, also half an escape sequence.
1814 * Trick: when no typeahead found, but there is something in the typeahead
1815 * buffer, it must be an ESC that is recognized as the start of a key code.
1818 vpeekc_any()
1820 int c;
1822 c = vpeekc();
1823 if (c == NUL && typebuf.tb_len > 0)
1824 c = ESC;
1825 return c;
1827 #endif
1830 * Call vpeekc() without causing anything to be mapped.
1831 * Return TRUE if a character is available, FALSE otherwise.
1834 char_avail()
1836 int retval;
1838 ++no_mapping;
1839 retval = vpeekc();
1840 --no_mapping;
1841 return (retval != NUL);
1844 void
1845 vungetc(c) /* unget one character (can only be done once!) */
1846 int c;
1848 old_char = c;
1849 old_mod_mask = mod_mask;
1853 * get a character:
1854 * 1. from the stuffbuffer
1855 * This is used for abbreviated commands like "D" -> "d$".
1856 * Also used to redo a command for ".".
1857 * 2. from the typeahead buffer
1858 * Stores text obtained previously but not used yet.
1859 * Also stores the result of mappings.
1860 * Also used for the ":normal" command.
1861 * 3. from the user
1862 * This may do a blocking wait if "advance" is TRUE.
1864 * if "advance" is TRUE (vgetc()):
1865 * really get the character.
1866 * KeyTyped is set to TRUE in the case the user typed the key.
1867 * KeyStuffed is TRUE if the character comes from the stuff buffer.
1868 * if "advance" is FALSE (vpeekc()):
1869 * just look whether there is a character available.
1871 * When "no_mapping" is zero, checks for mappings in the current mode.
1872 * Only returns one byte (of a multi-byte character).
1873 * K_SPECIAL and CSI may be escaped, need to get two more bytes then.
1875 static int
1876 vgetorpeek(advance)
1877 int advance;
1879 int c, c1;
1880 int keylen;
1881 char_u *s;
1882 mapblock_T *mp;
1883 #ifdef FEAT_LOCALMAP
1884 mapblock_T *mp2;
1885 #endif
1886 mapblock_T *mp_match;
1887 int mp_match_len = 0;
1888 int timedout = FALSE; /* waited for more than 1 second
1889 for mapping to complete */
1890 int mapdepth = 0; /* check for recursive mapping */
1891 int mode_deleted = FALSE; /* set when mode has been deleted */
1892 int local_State;
1893 int mlen;
1894 int max_mlen;
1895 int i;
1896 #ifdef FEAT_CMDL_INFO
1897 int new_wcol, new_wrow;
1898 #endif
1899 #ifdef FEAT_GUI
1900 # ifdef FEAT_MENU
1901 int idx;
1902 # endif
1903 int shape_changed = FALSE; /* adjusted cursor shape */
1904 #endif
1905 int n;
1906 #ifdef FEAT_LANGMAP
1907 int nolmaplen;
1908 #endif
1909 int old_wcol, old_wrow;
1910 int wait_tb_len;
1913 * This function doesn't work very well when called recursively. This may
1914 * happen though, because of:
1915 * 1. The call to add_to_showcmd(). char_avail() is then used to check if
1916 * there is a character available, which calls this function. In that
1917 * case we must return NUL, to indicate no character is available.
1918 * 2. A GUI callback function writes to the screen, causing a
1919 * wait_return().
1920 * Using ":normal" can also do this, but it saves the typeahead buffer,
1921 * thus it should be OK. But don't get a key from the user then.
1923 if (vgetc_busy > 0
1924 #ifdef FEAT_EX_EXTRA
1925 && ex_normal_busy == 0
1926 #endif
1928 return NUL;
1930 local_State = get_real_state();
1932 ++vgetc_busy;
1934 if (advance)
1935 KeyStuffed = FALSE;
1937 init_typebuf();
1938 start_stuff();
1939 if (advance && typebuf.tb_maplen == 0)
1940 Exec_reg = FALSE;
1944 * get a character: 1. from the stuffbuffer
1946 if (typeahead_char != 0)
1948 c = typeahead_char;
1949 if (advance)
1950 typeahead_char = 0;
1952 else
1953 c = read_stuff(advance);
1954 if (c != NUL && !got_int)
1956 if (advance)
1958 /* KeyTyped = FALSE; When the command that stuffed something
1959 * was typed, behave like the stuffed command was typed.
1960 * needed for CTRL-W CTRl-] to open a fold, for example. */
1961 KeyStuffed = TRUE;
1963 if (typebuf.tb_no_abbr_cnt == 0)
1964 typebuf.tb_no_abbr_cnt = 1; /* no abbreviations now */
1966 else
1969 * Loop until we either find a matching mapped key, or we
1970 * are sure that it is not a mapped key.
1971 * If a mapped key sequence is found we go back to the start to
1972 * try re-mapping.
1974 for (;;)
1977 * ui_breakcheck() is slow, don't use it too often when
1978 * inside a mapping. But call it each time for typed
1979 * characters.
1981 if (typebuf.tb_maplen)
1982 line_breakcheck();
1983 else
1984 ui_breakcheck(); /* check for CTRL-C */
1985 keylen = 0;
1986 if (got_int)
1988 /* flush all input */
1989 c = inchar(typebuf.tb_buf, typebuf.tb_buflen - 1, 0L,
1990 typebuf.tb_change_cnt);
1992 * If inchar() returns TRUE (script file was active) or we
1993 * are inside a mapping, get out of insert mode.
1994 * Otherwise we behave like having gotten a CTRL-C.
1995 * As a result typing CTRL-C in insert mode will
1996 * really insert a CTRL-C.
1998 if ((c || typebuf.tb_maplen)
1999 && (State & (INSERT + CMDLINE)))
2000 c = ESC;
2001 else
2002 c = Ctrl_C;
2003 flush_buffers(TRUE); /* flush all typeahead */
2005 if (advance)
2007 /* Also record this character, it might be needed to
2008 * get out of Insert mode. */
2009 *typebuf.tb_buf = c;
2010 gotchars(typebuf.tb_buf, 1);
2012 cmd_silent = FALSE;
2014 break;
2016 else if (typebuf.tb_len > 0)
2019 * Check for a mappable key sequence.
2020 * Walk through one maphash[] list until we find an
2021 * entry that matches.
2023 * Don't look for mappings if:
2024 * - no_mapping set: mapping disabled (e.g. for CTRL-V)
2025 * - maphash_valid not set: no mappings present.
2026 * - typebuf.tb_buf[typebuf.tb_off] should not be remapped
2027 * - in insert or cmdline mode and 'paste' option set
2028 * - waiting for "hit return to continue" and CR or SPACE
2029 * typed
2030 * - waiting for a char with --more--
2031 * - in Ctrl-X mode, and we get a valid char for that mode
2033 mp = NULL;
2034 max_mlen = 0;
2035 c1 = typebuf.tb_buf[typebuf.tb_off];
2036 if (no_mapping == 0 && maphash_valid
2037 && (no_zero_mapping == 0 || c1 != '0')
2038 && (typebuf.tb_maplen == 0
2039 || (p_remap
2040 && (typebuf.tb_noremap[typebuf.tb_off]
2041 & (RM_NONE|RM_ABBR)) == 0))
2042 && !(p_paste && (State & (INSERT + CMDLINE)))
2043 && !(State == HITRETURN && (c1 == CAR || c1 == ' '))
2044 && State != ASKMORE
2045 && State != CONFIRM
2046 #ifdef FEAT_INS_EXPAND
2047 && !((ctrl_x_mode != 0 && vim_is_ctrl_x_key(c1))
2048 || ((compl_cont_status & CONT_LOCAL)
2049 && (c1 == Ctrl_N || c1 == Ctrl_P)))
2050 #endif
2053 #ifdef FEAT_LANGMAP
2054 if (c1 == K_SPECIAL)
2055 nolmaplen = 2;
2056 else
2058 LANGMAP_ADJUST(c1, TRUE);
2059 nolmaplen = 0;
2061 #endif
2062 #ifdef FEAT_LOCALMAP
2063 /* First try buffer-local mappings. */
2064 mp = curbuf->b_maphash[MAP_HASH(local_State, c1)];
2065 mp2 = maphash[MAP_HASH(local_State, c1)];
2066 if (mp == NULL)
2068 mp = mp2;
2069 mp2 = NULL;
2071 #else
2072 mp = maphash[MAP_HASH(local_State, c1)];
2073 #endif
2075 * Loop until a partly matching mapping is found or
2076 * all (local) mappings have been checked.
2077 * The longest full match is remembered in "mp_match".
2078 * A full match is only accepted if there is no partly
2079 * match, so "aa" and "aaa" can both be mapped.
2081 mp_match = NULL;
2082 mp_match_len = 0;
2083 for ( ; mp != NULL;
2084 #ifdef FEAT_LOCALMAP
2085 mp->m_next == NULL ? (mp = mp2, mp2 = NULL) :
2086 #endif
2087 (mp = mp->m_next))
2090 * Only consider an entry if the first character
2091 * matches and it is for the current state.
2092 * Skip ":lmap" mappings if keys were mapped.
2094 if (mp->m_keys[0] == c1
2095 && (mp->m_mode & local_State)
2096 && ((mp->m_mode & LANGMAP) == 0
2097 || typebuf.tb_maplen == 0))
2099 #ifdef FEAT_LANGMAP
2100 int nomap = nolmaplen;
2101 int c2;
2102 #endif
2103 /* find the match length of this mapping */
2104 for (mlen = 1; mlen < typebuf.tb_len; ++mlen)
2106 #ifdef FEAT_LANGMAP
2107 c2 = typebuf.tb_buf[typebuf.tb_off + mlen];
2108 if (nomap > 0)
2109 --nomap;
2110 else if (c2 == K_SPECIAL)
2111 nomap = 2;
2112 else
2113 LANGMAP_ADJUST(c2, TRUE);
2114 if (mp->m_keys[mlen] != c2)
2115 #else
2116 if (mp->m_keys[mlen] !=
2117 typebuf.tb_buf[typebuf.tb_off + mlen])
2118 #endif
2119 break;
2122 #ifdef FEAT_MBYTE
2123 /* Don't allow mapping the first byte(s) of a
2124 * multi-byte char. Happens when mapping
2125 * <M-a> and then changing 'encoding'. */
2126 if (has_mbyte && MB_BYTE2LEN(c1)
2127 > (*mb_ptr2len)(mp->m_keys))
2128 mlen = 0;
2129 #endif
2131 * Check an entry whether it matches.
2132 * - Full match: mlen == keylen
2133 * - Partly match: mlen == typebuf.tb_len
2135 keylen = mp->m_keylen;
2136 if (mlen == keylen
2137 || (mlen == typebuf.tb_len
2138 && typebuf.tb_len < keylen))
2141 * If only script-local mappings are
2142 * allowed, check if the mapping starts
2143 * with K_SNR.
2145 s = typebuf.tb_noremap + typebuf.tb_off;
2146 if (*s == RM_SCRIPT
2147 && (mp->m_keys[0] != K_SPECIAL
2148 || mp->m_keys[1] != KS_EXTRA
2149 || mp->m_keys[2]
2150 != (int)KE_SNR))
2151 continue;
2153 * If one of the typed keys cannot be
2154 * remapped, skip the entry.
2156 for (n = mlen; --n >= 0; )
2157 if (*s++ & (RM_NONE|RM_ABBR))
2158 break;
2159 if (n >= 0)
2160 continue;
2162 if (keylen > typebuf.tb_len)
2164 if (!timedout)
2166 /* break at a partly match */
2167 keylen = KL_PART_MAP;
2168 break;
2171 else if (keylen > mp_match_len)
2173 /* found a longer match */
2174 mp_match = mp;
2175 mp_match_len = keylen;
2178 else
2179 /* No match; may have to check for
2180 * termcode at next character. */
2181 if (max_mlen < mlen)
2182 max_mlen = mlen;
2186 /* If no partly match found, use the longest full
2187 * match. */
2188 if (keylen != KL_PART_MAP)
2190 mp = mp_match;
2191 keylen = mp_match_len;
2195 /* Check for match with 'pastetoggle' */
2196 if (*p_pt != NUL && mp == NULL && (State & (INSERT|NORMAL)))
2198 for (mlen = 0; mlen < typebuf.tb_len && p_pt[mlen];
2199 ++mlen)
2200 if (p_pt[mlen] != typebuf.tb_buf[typebuf.tb_off
2201 + mlen])
2202 break;
2203 if (p_pt[mlen] == NUL) /* match */
2205 /* write chars to script file(s) */
2206 if (mlen > typebuf.tb_maplen)
2207 gotchars(typebuf.tb_buf + typebuf.tb_off
2208 + typebuf.tb_maplen,
2209 mlen - typebuf.tb_maplen);
2211 del_typebuf(mlen, 0); /* remove the chars */
2212 set_option_value((char_u *)"paste",
2213 (long)!p_paste, NULL, 0);
2214 if (!(State & INSERT))
2216 msg_col = 0;
2217 msg_row = Rows - 1;
2218 msg_clr_eos(); /* clear ruler */
2220 showmode();
2221 setcursor();
2222 continue;
2224 /* Need more chars for partly match. */
2225 if (mlen == typebuf.tb_len)
2226 keylen = KL_PART_KEY;
2227 else if (max_mlen < mlen)
2228 /* no match, may have to check for termcode at
2229 * next character */
2230 max_mlen = mlen + 1;
2233 if ((mp == NULL || max_mlen >= mp_match_len)
2234 && keylen != KL_PART_MAP)
2236 int save_keylen = keylen;
2239 * When no matching mapping found or found a
2240 * non-matching mapping that matches at least what the
2241 * matching mapping matched:
2242 * Check if we have a terminal code, when:
2243 * mapping is allowed,
2244 * keys have not been mapped,
2245 * and not an ESC sequence, not in insert mode or
2246 * p_ek is on,
2247 * and when not timed out,
2249 if ((no_mapping == 0 || allow_keys != 0)
2250 && (typebuf.tb_maplen == 0
2251 || (p_remap && typebuf.tb_noremap[
2252 typebuf.tb_off] == RM_YES))
2253 && !timedout)
2255 keylen = check_termcode(max_mlen + 1, NULL, 0);
2257 /* If no termcode matched but 'pastetoggle'
2258 * matched partially it's like an incomplete key
2259 * sequence. */
2260 if (keylen == 0 && save_keylen == KL_PART_KEY)
2261 keylen = KL_PART_KEY;
2264 * When getting a partial match, but the last
2265 * characters were not typed, don't wait for a
2266 * typed character to complete the termcode.
2267 * This helps a lot when a ":normal" command ends
2268 * in an ESC.
2270 if (keylen < 0
2271 && typebuf.tb_len == typebuf.tb_maplen)
2272 keylen = 0;
2274 else
2275 keylen = 0;
2276 if (keylen == 0) /* no matching terminal code */
2278 #ifdef AMIGA /* check for window bounds report */
2279 if (typebuf.tb_maplen == 0 && (typebuf.tb_buf[
2280 typebuf.tb_off] & 0xff) == CSI)
2282 for (s = typebuf.tb_buf + typebuf.tb_off + 1;
2283 s < typebuf.tb_buf + typebuf.tb_off
2284 + typebuf.tb_len
2285 && (VIM_ISDIGIT(*s) || *s == ';'
2286 || *s == ' ');
2287 ++s)
2289 if (*s == 'r' || *s == '|') /* found one */
2291 del_typebuf((int)(s + 1 -
2292 (typebuf.tb_buf + typebuf.tb_off)), 0);
2293 /* get size and redraw screen */
2294 shell_resized();
2295 continue;
2297 if (*s == NUL) /* need more characters */
2298 keylen = KL_PART_KEY;
2300 if (keylen >= 0)
2301 #endif
2302 /* When there was a matching mapping and no
2303 * termcode could be replaced after another one,
2304 * use that mapping (loop around). If there was
2305 * no mapping use the character from the
2306 * typeahead buffer right here. */
2307 if (mp == NULL)
2310 * get a character: 2. from the typeahead buffer
2312 c = typebuf.tb_buf[typebuf.tb_off] & 255;
2313 if (advance) /* remove chars from tb_buf */
2315 cmd_silent = (typebuf.tb_silent > 0);
2316 if (typebuf.tb_maplen > 0)
2317 KeyTyped = FALSE;
2318 else
2320 KeyTyped = TRUE;
2321 /* write char to script file(s) */
2322 gotchars(typebuf.tb_buf
2323 + typebuf.tb_off, 1);
2325 KeyNoremap = typebuf.tb_noremap[
2326 typebuf.tb_off];
2327 del_typebuf(1, 0);
2329 break; /* got character, break for loop */
2332 if (keylen > 0) /* full matching terminal code */
2334 #if defined(FEAT_GUI) && defined(FEAT_MENU)
2335 if (typebuf.tb_buf[typebuf.tb_off] == K_SPECIAL
2336 && typebuf.tb_buf[typebuf.tb_off + 1]
2337 == KS_MENU)
2340 * Using a menu may cause a break in undo!
2341 * It's like using gotchars(), but without
2342 * recording or writing to a script file.
2344 may_sync_undo();
2345 del_typebuf(3, 0);
2346 idx = get_menu_index(current_menu, local_State);
2347 if (idx != MENU_INDEX_INVALID)
2349 # ifdef FEAT_VISUAL
2351 * In Select mode and a Visual mode menu
2352 * is used: Switch to Visual mode
2353 * temporarily. Append K_SELECT to switch
2354 * back to Select mode.
2356 if (VIsual_active && VIsual_select
2357 && (current_menu->modes & VISUAL))
2359 VIsual_select = FALSE;
2360 (void)ins_typebuf(K_SELECT_STRING,
2361 REMAP_NONE, 0, TRUE, FALSE);
2363 # endif
2364 ins_typebuf(current_menu->strings[idx],
2365 current_menu->noremap[idx],
2366 0, TRUE,
2367 current_menu->silent[idx]);
2370 #endif /* FEAT_GUI && FEAT_MENU */
2371 continue; /* try mapping again */
2374 /* Partial match: get some more characters. When a
2375 * matching mapping was found use that one. */
2376 if (mp == NULL || keylen < 0)
2377 keylen = KL_PART_KEY;
2378 else
2379 keylen = mp_match_len;
2382 /* complete match */
2383 if (keylen >= 0 && keylen <= typebuf.tb_len)
2385 /* write chars to script file(s) */
2386 if (keylen > typebuf.tb_maplen)
2387 gotchars(typebuf.tb_buf + typebuf.tb_off
2388 + typebuf.tb_maplen,
2389 keylen - typebuf.tb_maplen);
2391 cmd_silent = (typebuf.tb_silent > 0);
2392 del_typebuf(keylen, 0); /* remove the mapped keys */
2395 * Put the replacement string in front of mapstr.
2396 * The depth check catches ":map x y" and ":map y x".
2398 if (++mapdepth >= p_mmd)
2400 EMSG(_("E223: recursive mapping"));
2401 if (State & CMDLINE)
2402 redrawcmdline();
2403 else
2404 setcursor();
2405 flush_buffers(FALSE);
2406 mapdepth = 0; /* for next one */
2407 c = -1;
2408 break;
2411 #ifdef FEAT_VISUAL
2413 * In Select mode and a Visual mode mapping is used:
2414 * Switch to Visual mode temporarily. Append K_SELECT
2415 * to switch back to Select mode.
2417 if (VIsual_active && VIsual_select
2418 && (mp->m_mode & VISUAL))
2420 VIsual_select = FALSE;
2421 (void)ins_typebuf(K_SELECT_STRING, REMAP_NONE,
2422 0, TRUE, FALSE);
2424 #endif
2426 #ifdef FEAT_EVAL
2428 * Handle ":map <expr>": evaluate the {rhs} as an
2429 * expression. Save and restore the typeahead so that
2430 * getchar() can be used. Also save and restore the
2431 * command line for "normal :".
2433 if (mp->m_expr)
2435 tasave_T tabuf;
2436 int save_vgetc_busy = vgetc_busy;
2438 save_typeahead(&tabuf);
2439 if (tabuf.typebuf_valid)
2441 vgetc_busy = 0;
2442 s = eval_map_expr(mp->m_str);
2443 vgetc_busy = save_vgetc_busy;
2445 else
2446 s = NULL;
2447 restore_typeahead(&tabuf);
2449 else
2450 #endif
2451 s = mp->m_str;
2454 * Insert the 'to' part in the typebuf.tb_buf.
2455 * If 'from' field is the same as the start of the
2456 * 'to' field, don't remap the first character (but do
2457 * allow abbreviations).
2458 * If m_noremap is set, don't remap the whole 'to'
2459 * part.
2461 if (s == NULL)
2462 i = FAIL;
2463 else
2465 i = ins_typebuf(s,
2466 mp->m_noremap != REMAP_YES
2467 ? mp->m_noremap
2468 : STRNCMP(s, mp->m_keys,
2469 (size_t)keylen) != 0
2470 ? REMAP_YES : REMAP_SKIP,
2471 0, TRUE, cmd_silent || mp->m_silent);
2472 #ifdef FEAT_EVAL
2473 if (mp->m_expr)
2474 vim_free(s);
2475 #endif
2477 if (i == FAIL)
2479 c = -1;
2480 break;
2482 continue;
2487 * get a character: 3. from the user - handle <Esc> in Insert mode
2490 * special case: if we get an <ESC> in insert mode and there
2491 * are no more characters at once, we pretend to go out of
2492 * insert mode. This prevents the one second delay after
2493 * typing an <ESC>. If we get something after all, we may
2494 * have to redisplay the mode. That the cursor is in the wrong
2495 * place does not matter.
2497 c = 0;
2498 #ifdef FEAT_CMDL_INFO
2499 new_wcol = curwin->w_wcol;
2500 new_wrow = curwin->w_wrow;
2501 #endif
2502 if ( advance
2503 && typebuf.tb_len == 1
2504 && typebuf.tb_buf[typebuf.tb_off] == ESC
2505 && !no_mapping
2506 #ifdef FEAT_EX_EXTRA
2507 && ex_normal_busy == 0
2508 #endif
2509 && typebuf.tb_maplen == 0
2510 && (State & INSERT)
2511 && (p_timeout || (keylen == KL_PART_KEY && p_ttimeout))
2512 && (c = inchar(typebuf.tb_buf + typebuf.tb_off
2513 + typebuf.tb_len, 3, 25L,
2514 typebuf.tb_change_cnt)) == 0)
2516 colnr_T col = 0, vcol;
2517 char_u *ptr;
2519 if (mode_displayed)
2521 unshowmode(TRUE);
2522 mode_deleted = TRUE;
2524 #ifdef FEAT_GUI
2525 /* may show different cursor shape */
2526 if (gui.in_use)
2528 int save_State;
2530 save_State = State;
2531 State = NORMAL;
2532 gui_update_cursor(TRUE, FALSE);
2533 State = save_State;
2534 shape_changed = TRUE;
2536 #endif
2537 validate_cursor();
2538 old_wcol = curwin->w_wcol;
2539 old_wrow = curwin->w_wrow;
2541 /* move cursor left, if possible */
2542 if (curwin->w_cursor.col != 0)
2544 if (curwin->w_wcol > 0)
2546 if (did_ai)
2549 * We are expecting to truncate the trailing
2550 * white-space, so find the last non-white
2551 * character -- webb
2553 col = vcol = curwin->w_wcol = 0;
2554 ptr = ml_get_curline();
2555 while (col < curwin->w_cursor.col)
2557 if (!vim_iswhite(ptr[col]))
2558 curwin->w_wcol = vcol;
2559 vcol += lbr_chartabsize(ptr + col,
2560 (colnr_T)vcol);
2561 #ifdef FEAT_MBYTE
2562 if (has_mbyte)
2563 col += (*mb_ptr2len)(ptr + col);
2564 else
2565 #endif
2566 ++col;
2568 curwin->w_wrow = curwin->w_cline_row
2569 + curwin->w_wcol / W_WIDTH(curwin);
2570 curwin->w_wcol %= W_WIDTH(curwin);
2571 curwin->w_wcol += curwin_col_off();
2572 #ifdef FEAT_MBYTE
2573 col = 0; /* no correction needed */
2574 #endif
2576 else
2578 --curwin->w_wcol;
2579 #ifdef FEAT_MBYTE
2580 col = curwin->w_cursor.col - 1;
2581 #endif
2584 else if (curwin->w_p_wrap && curwin->w_wrow)
2586 --curwin->w_wrow;
2587 curwin->w_wcol = W_WIDTH(curwin) - 1;
2588 #ifdef FEAT_MBYTE
2589 col = curwin->w_cursor.col - 1;
2590 #endif
2592 #ifdef FEAT_MBYTE
2593 if (has_mbyte && col > 0 && curwin->w_wcol > 0)
2595 /* Correct when the cursor is on the right halve
2596 * of a double-wide character. */
2597 ptr = ml_get_curline();
2598 col -= (*mb_head_off)(ptr, ptr + col);
2599 if ((*mb_ptr2cells)(ptr + col) > 1)
2600 --curwin->w_wcol;
2602 #endif
2604 setcursor();
2605 out_flush();
2606 #ifdef FEAT_CMDL_INFO
2607 new_wcol = curwin->w_wcol;
2608 new_wrow = curwin->w_wrow;
2609 #endif
2610 curwin->w_wcol = old_wcol;
2611 curwin->w_wrow = old_wrow;
2613 if (c < 0)
2614 continue; /* end of input script reached */
2615 typebuf.tb_len += c;
2617 /* buffer full, don't map */
2618 if (typebuf.tb_len >= typebuf.tb_maplen + MAXMAPLEN)
2620 timedout = TRUE;
2621 continue;
2624 #ifdef FEAT_EX_EXTRA
2625 if (ex_normal_busy > 0)
2627 # ifdef FEAT_CMDWIN
2628 static int tc = 0;
2629 # endif
2631 /* No typeahead left and inside ":normal". Must return
2632 * something to avoid getting stuck. When an incomplete
2633 * mapping is present, behave like it timed out. */
2634 if (typebuf.tb_len > 0)
2636 timedout = TRUE;
2637 continue;
2639 /* When 'insertmode' is set, ESC just beeps in Insert
2640 * mode. Use CTRL-L to make edit() return.
2641 * For the command line only CTRL-C always breaks it.
2642 * For the cmdline window: Alternate between ESC and
2643 * CTRL-C: ESC for most situations and CTRL-C to close the
2644 * cmdline window. */
2645 if (p_im && (State & INSERT))
2646 c = Ctrl_L;
2647 else if ((State & CMDLINE)
2648 # ifdef FEAT_CMDWIN
2649 || (cmdwin_type > 0 && tc == ESC)
2650 # endif
2652 c = Ctrl_C;
2653 else
2654 c = ESC;
2655 # ifdef FEAT_CMDWIN
2656 tc = c;
2657 # endif
2658 break;
2660 #endif
2663 * get a character: 3. from the user - update display
2665 /* In insert mode a screen update is skipped when characters
2666 * are still available. But when those available characters
2667 * are part of a mapping, and we are going to do a blocking
2668 * wait here. Need to update the screen to display the
2669 * changed text so far. */
2670 if ((State & INSERT) && advance && must_redraw != 0)
2672 update_screen(0);
2673 setcursor(); /* put cursor back where it belongs */
2677 * If we have a partial match (and are going to wait for more
2678 * input from the user), show the partially matched characters
2679 * to the user with showcmd.
2681 #ifdef FEAT_CMDL_INFO
2682 i = 0;
2683 #endif
2684 c1 = 0;
2685 if (typebuf.tb_len > 0 && advance && !exmode_active)
2687 if (((State & (NORMAL | INSERT)) || State == LANGMAP)
2688 && State != HITRETURN)
2690 /* this looks nice when typing a dead character map */
2691 if (State & INSERT
2692 && ptr2cells(typebuf.tb_buf + typebuf.tb_off
2693 + typebuf.tb_len - 1) == 1)
2695 edit_putchar(typebuf.tb_buf[typebuf.tb_off
2696 + typebuf.tb_len - 1], FALSE);
2697 setcursor(); /* put cursor back where it belongs */
2698 c1 = 1;
2700 #ifdef FEAT_CMDL_INFO
2701 /* need to use the col and row from above here */
2702 old_wcol = curwin->w_wcol;
2703 old_wrow = curwin->w_wrow;
2704 curwin->w_wcol = new_wcol;
2705 curwin->w_wrow = new_wrow;
2706 push_showcmd();
2707 if (typebuf.tb_len > SHOWCMD_COLS)
2708 i = typebuf.tb_len - SHOWCMD_COLS;
2709 while (i < typebuf.tb_len)
2710 (void)add_to_showcmd(typebuf.tb_buf[typebuf.tb_off
2711 + i++]);
2712 curwin->w_wcol = old_wcol;
2713 curwin->w_wrow = old_wrow;
2714 #endif
2717 /* this looks nice when typing a dead character map */
2718 if ((State & CMDLINE)
2719 #if defined(FEAT_CRYPT) || defined(FEAT_EVAL)
2720 && cmdline_star == 0
2721 #endif
2722 && ptr2cells(typebuf.tb_buf + typebuf.tb_off
2723 + typebuf.tb_len - 1) == 1)
2725 putcmdline(typebuf.tb_buf[typebuf.tb_off
2726 + typebuf.tb_len - 1], FALSE);
2727 c1 = 1;
2732 * get a character: 3. from the user - get it
2734 wait_tb_len = typebuf.tb_len;
2735 c = inchar(typebuf.tb_buf + typebuf.tb_off + typebuf.tb_len,
2736 typebuf.tb_buflen - typebuf.tb_off - typebuf.tb_len - 1,
2737 !advance
2739 : ((typebuf.tb_len == 0
2740 || !(p_timeout || (p_ttimeout
2741 && keylen == KL_PART_KEY)))
2742 ? -1L
2743 : ((keylen == KL_PART_KEY && p_ttm >= 0)
2744 ? p_ttm
2745 : p_tm)), typebuf.tb_change_cnt);
2747 #ifdef FEAT_CMDL_INFO
2748 if (i != 0)
2749 pop_showcmd();
2750 #endif
2751 if (c1 == 1)
2753 if (State & INSERT)
2754 edit_unputchar();
2755 if (State & CMDLINE)
2756 unputcmdline();
2757 setcursor(); /* put cursor back where it belongs */
2760 if (c < 0)
2761 continue; /* end of input script reached */
2762 if (c == NUL) /* no character available */
2764 if (!advance)
2765 break;
2766 if (wait_tb_len > 0) /* timed out */
2768 timedout = TRUE;
2769 continue;
2772 else
2773 { /* allow mapping for just typed characters */
2774 while (typebuf.tb_buf[typebuf.tb_off
2775 + typebuf.tb_len] != NUL)
2776 typebuf.tb_noremap[typebuf.tb_off
2777 + typebuf.tb_len++] = RM_YES;
2778 #ifdef USE_IM_CONTROL
2779 /* Get IM status right after getting keys, not after the
2780 * timeout for a mapping (focus may be lost by then). */
2781 vgetc_im_active = im_get_status();
2782 #endif
2784 } /* for (;;) */
2785 } /* if (!character from stuffbuf) */
2787 /* if advance is FALSE don't loop on NULs */
2788 } while (c < 0 || (advance && c == NUL));
2791 * The "INSERT" message is taken care of here:
2792 * if we return an ESC to exit insert mode, the message is deleted
2793 * if we don't return an ESC but deleted the message before, redisplay it
2795 if (advance && p_smd && msg_silent == 0 && (State & INSERT))
2797 if (c == ESC && !mode_deleted && !no_mapping && mode_displayed)
2799 if (typebuf.tb_len && !KeyTyped)
2800 redraw_cmdline = TRUE; /* delete mode later */
2801 else
2802 unshowmode(FALSE);
2804 else if (c != ESC && mode_deleted)
2806 if (typebuf.tb_len && !KeyTyped)
2807 redraw_cmdline = TRUE; /* show mode later */
2808 else
2809 showmode();
2812 #ifdef FEAT_GUI
2813 /* may unshow different cursor shape */
2814 if (gui.in_use && shape_changed)
2815 gui_update_cursor(TRUE, FALSE);
2816 #endif
2818 --vgetc_busy;
2820 return c;
2824 * inchar() - get one character from
2825 * 1. a scriptfile
2826 * 2. the keyboard
2828 * As much characters as we can get (upto 'maxlen') are put in "buf" and
2829 * NUL terminated (buffer length must be 'maxlen' + 1).
2830 * Minimum for "maxlen" is 3!!!!
2832 * "tb_change_cnt" is the value of typebuf.tb_change_cnt if "buf" points into
2833 * it. When typebuf.tb_change_cnt changes (e.g., when a message is received
2834 * from a remote client) "buf" can no longer be used. "tb_change_cnt" is 0
2835 * otherwise.
2837 * If we got an interrupt all input is read until none is available.
2839 * If wait_time == 0 there is no waiting for the char.
2840 * If wait_time == n we wait for n msec for a character to arrive.
2841 * If wait_time == -1 we wait forever for a character to arrive.
2843 * Return the number of obtained characters.
2844 * Return -1 when end of input script reached.
2847 inchar(buf, maxlen, wait_time, tb_change_cnt)
2848 char_u *buf;
2849 int maxlen;
2850 long wait_time; /* milli seconds */
2851 int tb_change_cnt;
2853 int len = 0; /* init for GCC */
2854 int retesc = FALSE; /* return ESC with gotint */
2855 int script_char;
2857 if (wait_time == -1L || wait_time > 100L) /* flush output before waiting */
2859 cursor_on();
2860 out_flush();
2861 #ifdef FEAT_GUI
2862 if (gui.in_use)
2864 gui_update_cursor(FALSE, FALSE);
2865 # ifdef FEAT_MOUSESHAPE
2866 if (postponed_mouseshape)
2867 update_mouseshape(-1);
2868 # endif
2870 #endif
2874 * Don't reset these when at the hit-return prompt, otherwise a endless
2875 * recursive loop may result (write error in swapfile, hit-return, timeout
2876 * on char wait, flush swapfile, write error....).
2878 if (State != HITRETURN)
2880 did_outofmem_msg = FALSE; /* display out of memory message (again) */
2881 did_swapwrite_msg = FALSE; /* display swap file write error again */
2883 undo_off = FALSE; /* restart undo now */
2886 * Get a character from a script file if there is one.
2887 * If interrupted: Stop reading script files, close them all.
2889 script_char = -1;
2890 while (scriptin[curscript] != NULL && script_char < 0
2891 #ifdef FEAT_EVAL
2892 && !ignore_script
2893 #endif
2897 #if defined(FEAT_NETBEANS_INTG)
2898 /* Process the queued netbeans messages. */
2899 netbeans_parse_messages();
2900 #endif
2902 if (got_int || (script_char = getc(scriptin[curscript])) < 0)
2904 /* Reached EOF.
2905 * Careful: closescript() frees typebuf.tb_buf[] and buf[] may
2906 * point inside typebuf.tb_buf[]. Don't use buf[] after this! */
2907 closescript();
2909 * When reading script file is interrupted, return an ESC to get
2910 * back to normal mode.
2911 * Otherwise return -1, because typebuf.tb_buf[] has changed.
2913 if (got_int)
2914 retesc = TRUE;
2915 else
2916 return -1;
2918 else
2920 buf[0] = script_char;
2921 len = 1;
2925 if (script_char < 0) /* did not get a character from script */
2928 * If we got an interrupt, skip all previously typed characters and
2929 * return TRUE if quit reading script file.
2930 * Stop reading typeahead when a single CTRL-C was read,
2931 * fill_input_buf() returns this when not able to read from stdin.
2932 * Don't use buf[] here, closescript() may have freed typebuf.tb_buf[]
2933 * and buf may be pointing inside typebuf.tb_buf[].
2935 if (got_int)
2937 #define DUM_LEN MAXMAPLEN * 3 + 3
2938 char_u dum[DUM_LEN + 1];
2940 for (;;)
2942 len = ui_inchar(dum, DUM_LEN, 0L, 0);
2943 if (len == 0 || (len == 1 && dum[0] == 3))
2944 break;
2946 return retesc;
2950 * Always flush the output characters when getting input characters
2951 * from the user.
2953 out_flush();
2956 * Fill up to a third of the buffer, because each character may be
2957 * tripled below.
2959 len = ui_inchar(buf, maxlen / 3, wait_time, tb_change_cnt);
2962 if (typebuf_changed(tb_change_cnt))
2963 return 0;
2965 return fix_input_buffer(buf, len, script_char >= 0);
2969 * Fix typed characters for use by vgetc() and check_termcode().
2970 * buf[] must have room to triple the number of bytes!
2971 * Returns the new length.
2974 fix_input_buffer(buf, len, script)
2975 char_u *buf;
2976 int len;
2977 int script; /* TRUE when reading from a script */
2979 int i;
2980 char_u *p = buf;
2983 * Two characters are special: NUL and K_SPECIAL.
2984 * When compiled With the GUI CSI is also special.
2985 * Replace NUL by K_SPECIAL KS_ZERO KE_FILLER
2986 * Replace K_SPECIAL by K_SPECIAL KS_SPECIAL KE_FILLER
2987 * Replace CSI by K_SPECIAL KS_EXTRA KE_CSI
2988 * Don't replace K_SPECIAL when reading a script file.
2990 for (i = len; --i >= 0; ++p)
2992 #ifdef FEAT_GUI
2993 /* When the GUI is used any character can come after a CSI, don't
2994 * escape it. */
2995 if (gui.in_use && p[0] == CSI && i >= 2)
2997 p += 2;
2998 i -= 2;
3000 /* When the GUI is not used CSI needs to be escaped. */
3001 else if (!gui.in_use && p[0] == CSI)
3003 mch_memmove(p + 3, p + 1, (size_t)i);
3004 *p++ = K_SPECIAL;
3005 *p++ = KS_EXTRA;
3006 *p = (int)KE_CSI;
3007 len += 2;
3009 else
3010 #endif
3011 if (p[0] == NUL || (p[0] == K_SPECIAL && !script
3012 #ifdef FEAT_AUTOCMD
3013 /* timeout may generate K_CURSORHOLD */
3014 && (i < 2 || p[1] != KS_EXTRA || p[2] != (int)KE_CURSORHOLD)
3015 #endif
3016 #if defined(WIN3264) && !defined(FEAT_GUI)
3017 /* Win32 console passes modifiers */
3018 && (i < 2 || p[1] != KS_MODIFIER)
3019 #endif
3022 mch_memmove(p + 3, p + 1, (size_t)i);
3023 p[2] = K_THIRD(p[0]);
3024 p[1] = K_SECOND(p[0]);
3025 p[0] = K_SPECIAL;
3026 p += 2;
3027 len += 2;
3030 *p = NUL; /* add trailing NUL */
3031 return len;
3034 #if defined(USE_INPUT_BUF) || defined(PROTO)
3036 * Return TRUE when bytes are in the input buffer or in the typeahead buffer.
3037 * Normally the input buffer would be sufficient, but the server_to_input_buf()
3038 * or feedkeys() may insert characters in the typeahead buffer while we are
3039 * waiting for input to arrive.
3042 input_available()
3044 return (!vim_is_input_buf_empty()
3045 # if defined(FEAT_CLIENTSERVER) || defined(FEAT_EVAL)
3046 || typebuf_was_filled
3047 # endif
3050 #endif
3053 * map[!] : show all key mappings
3054 * map[!] {lhs} : show key mapping for {lhs}
3055 * map[!] {lhs} {rhs} : set key mapping for {lhs} to {rhs}
3056 * noremap[!] {lhs} {rhs} : same, but no remapping for {rhs}
3057 * unmap[!] {lhs} : remove key mapping for {lhs}
3058 * abbr : show all abbreviations
3059 * abbr {lhs} : show abbreviations for {lhs}
3060 * abbr {lhs} {rhs} : set abbreviation for {lhs} to {rhs}
3061 * noreabbr {lhs} {rhs} : same, but no remapping for {rhs}
3062 * unabbr {lhs} : remove abbreviation for {lhs}
3064 * maptype: 0 for :map, 1 for :unmap, 2 for noremap.
3066 * arg is pointer to any arguments. Note: arg cannot be a read-only string,
3067 * it will be modified.
3069 * for :map mode is NORMAL + VISUAL + SELECTMODE + OP_PENDING
3070 * for :map! mode is INSERT + CMDLINE
3071 * for :cmap mode is CMDLINE
3072 * for :imap mode is INSERT
3073 * for :lmap mode is LANGMAP
3074 * for :nmap mode is NORMAL
3075 * for :vmap mode is VISUAL + SELECTMODE
3076 * for :xmap mode is VISUAL
3077 * for :smap mode is SELECTMODE
3078 * for :omap mode is OP_PENDING
3080 * for :abbr mode is INSERT + CMDLINE
3081 * for :iabbr mode is INSERT
3082 * for :cabbr mode is CMDLINE
3084 * Return 0 for success
3085 * 1 for invalid arguments
3086 * 2 for no match
3087 * 4 for out of mem
3088 * 5 for entry not unique
3091 do_map(maptype, arg, mode, abbrev)
3092 int maptype;
3093 char_u *arg;
3094 int mode;
3095 int abbrev; /* not a mapping but an abbreviation */
3097 char_u *keys;
3098 mapblock_T *mp, **mpp;
3099 char_u *rhs;
3100 char_u *p;
3101 int n;
3102 int len = 0; /* init for GCC */
3103 char_u *newstr;
3104 int hasarg;
3105 int haskey;
3106 int did_it = FALSE;
3107 #ifdef FEAT_LOCALMAP
3108 int did_local = FALSE;
3109 #endif
3110 int round;
3111 char_u *keys_buf = NULL;
3112 char_u *arg_buf = NULL;
3113 int retval = 0;
3114 int do_backslash;
3115 int hash;
3116 int new_hash;
3117 mapblock_T **abbr_table;
3118 mapblock_T **map_table;
3119 int unique = FALSE;
3120 int silent = FALSE;
3121 int special = FALSE;
3122 #ifdef FEAT_EVAL
3123 int expr = FALSE;
3124 #endif
3125 int noremap;
3127 keys = arg;
3128 map_table = maphash;
3129 abbr_table = &first_abbr;
3131 /* For ":noremap" don't remap, otherwise do remap. */
3132 if (maptype == 2)
3133 noremap = REMAP_NONE;
3134 else
3135 noremap = REMAP_YES;
3137 /* Accept <buffer>, <silent>, <expr> <script> and <unique> in any order. */
3138 for (;;)
3140 #ifdef FEAT_LOCALMAP
3142 * Check for "<buffer>": mapping local to buffer.
3144 if (STRNCMP(keys, "<buffer>", 8) == 0)
3146 keys = skipwhite(keys + 8);
3147 map_table = curbuf->b_maphash;
3148 abbr_table = &curbuf->b_first_abbr;
3149 continue;
3151 #endif
3154 * Check for "<silent>": don't echo commands.
3156 if (STRNCMP(keys, "<silent>", 8) == 0)
3158 keys = skipwhite(keys + 8);
3159 silent = TRUE;
3160 continue;
3164 * Check for "<special>": accept special keys in <>
3166 if (STRNCMP(keys, "<special>", 9) == 0)
3168 keys = skipwhite(keys + 9);
3169 special = TRUE;
3170 continue;
3173 #ifdef FEAT_EVAL
3175 * Check for "<script>": remap script-local mappings only
3177 if (STRNCMP(keys, "<script>", 8) == 0)
3179 keys = skipwhite(keys + 8);
3180 noremap = REMAP_SCRIPT;
3181 continue;
3185 * Check for "<expr>": {rhs} is an expression.
3187 if (STRNCMP(keys, "<expr>", 6) == 0)
3189 keys = skipwhite(keys + 6);
3190 expr = TRUE;
3191 continue;
3193 #endif
3195 * Check for "<unique>": don't overwrite an existing mapping.
3197 if (STRNCMP(keys, "<unique>", 8) == 0)
3199 keys = skipwhite(keys + 8);
3200 unique = TRUE;
3201 continue;
3203 break;
3206 validate_maphash();
3209 * find end of keys and skip CTRL-Vs (and backslashes) in it
3210 * Accept backslash like CTRL-V when 'cpoptions' does not contain 'B'.
3211 * with :unmap white space is included in the keys, no argument possible
3213 p = keys;
3214 do_backslash = (vim_strchr(p_cpo, CPO_BSLASH) == NULL);
3215 while (*p && (maptype == 1 || !vim_iswhite(*p)))
3217 if ((p[0] == Ctrl_V || (do_backslash && p[0] == '\\')) &&
3218 p[1] != NUL)
3219 ++p; /* skip CTRL-V or backslash */
3220 ++p;
3222 if (*p != NUL)
3223 *p++ = NUL;
3224 p = skipwhite(p);
3225 rhs = p;
3226 hasarg = (*rhs != NUL);
3227 haskey = (*keys != NUL);
3229 /* check for :unmap without argument */
3230 if (maptype == 1 && !haskey)
3232 retval = 1;
3233 goto theend;
3237 * If mapping has been given as ^V<C_UP> say, then replace the term codes
3238 * with the appropriate two bytes. If it is a shifted special key, unshift
3239 * it too, giving another two bytes.
3240 * replace_termcodes() may move the result to allocated memory, which
3241 * needs to be freed later (*keys_buf and *arg_buf).
3242 * replace_termcodes() also removes CTRL-Vs and sometimes backslashes.
3244 if (haskey)
3245 keys = replace_termcodes(keys, &keys_buf, TRUE, TRUE, special);
3246 if (hasarg)
3248 if (STRICMP(rhs, "<nop>") == 0) /* "<Nop>" means nothing */
3249 rhs = (char_u *)"";
3250 else
3251 rhs = replace_termcodes(rhs, &arg_buf, FALSE, TRUE, special);
3254 #ifdef FEAT_FKMAP
3256 * when in right-to-left mode and alternate keymap option set,
3257 * reverse the character flow in the rhs in Farsi.
3259 if (p_altkeymap && curwin->w_p_rl)
3260 lrswap(rhs);
3261 #endif
3264 * check arguments and translate function keys
3266 if (haskey)
3268 len = (int)STRLEN(keys);
3269 if (len > MAXMAPLEN) /* maximum length of MAXMAPLEN chars */
3271 retval = 1;
3272 goto theend;
3275 if (abbrev && maptype != 1)
3278 * If an abbreviation ends in a keyword character, the
3279 * rest must be all keyword-char or all non-keyword-char.
3280 * Otherwise we won't be able to find the start of it in a
3281 * vi-compatible way.
3283 #ifdef FEAT_MBYTE
3284 if (has_mbyte)
3286 int first, last;
3287 int same = -1;
3289 first = vim_iswordp(keys);
3290 last = first;
3291 p = keys + (*mb_ptr2len)(keys);
3292 n = 1;
3293 while (p < keys + len)
3295 ++n; /* nr of (multi-byte) chars */
3296 last = vim_iswordp(p); /* type of last char */
3297 if (same == -1 && last != first)
3298 same = n - 1; /* count of same char type */
3299 p += (*mb_ptr2len)(p);
3301 if (last && n > 2 && same >= 0 && same < n - 1)
3303 retval = 1;
3304 goto theend;
3307 else
3308 #endif
3309 if (vim_iswordc(keys[len - 1])) /* ends in keyword char */
3310 for (n = 0; n < len - 2; ++n)
3311 if (vim_iswordc(keys[n]) != vim_iswordc(keys[len - 2]))
3313 retval = 1;
3314 goto theend;
3316 /* An abbrevation cannot contain white space. */
3317 for (n = 0; n < len; ++n)
3318 if (vim_iswhite(keys[n]))
3320 retval = 1;
3321 goto theend;
3326 if (haskey && hasarg && abbrev) /* if we will add an abbreviation */
3327 no_abbr = FALSE; /* reset flag that indicates there are
3328 no abbreviations */
3330 if (!haskey || (maptype != 1 && !hasarg))
3331 msg_start();
3333 #ifdef FEAT_LOCALMAP
3335 * Check if a new local mapping wasn't already defined globally.
3337 if (map_table == curbuf->b_maphash && haskey && hasarg && maptype != 1)
3339 /* need to loop over all global hash lists */
3340 for (hash = 0; hash < 256 && !got_int; ++hash)
3342 if (abbrev)
3344 if (hash != 0) /* there is only one abbreviation list */
3345 break;
3346 mp = first_abbr;
3348 else
3349 mp = maphash[hash];
3350 for ( ; mp != NULL && !got_int; mp = mp->m_next)
3352 /* check entries with the same mode */
3353 if ((mp->m_mode & mode) != 0
3354 && mp->m_keylen == len
3355 && unique
3356 && STRNCMP(mp->m_keys, keys, (size_t)len) == 0)
3358 if (abbrev)
3359 EMSG2(_("E224: global abbreviation already exists for %s"),
3360 mp->m_keys);
3361 else
3362 EMSG2(_("E225: global mapping already exists for %s"),
3363 mp->m_keys);
3364 retval = 5;
3365 goto theend;
3372 * When listing global mappings, also list buffer-local ones here.
3374 if (map_table != curbuf->b_maphash && !hasarg && maptype != 1)
3376 /* need to loop over all global hash lists */
3377 for (hash = 0; hash < 256 && !got_int; ++hash)
3379 if (abbrev)
3381 if (hash != 0) /* there is only one abbreviation list */
3382 break;
3383 mp = curbuf->b_first_abbr;
3385 else
3386 mp = curbuf->b_maphash[hash];
3387 for ( ; mp != NULL && !got_int; mp = mp->m_next)
3389 /* check entries with the same mode */
3390 if ((mp->m_mode & mode) != 0)
3392 if (!haskey) /* show all entries */
3394 showmap(mp, TRUE);
3395 did_local = TRUE;
3397 else
3399 n = mp->m_keylen;
3400 if (STRNCMP(mp->m_keys, keys,
3401 (size_t)(n < len ? n : len)) == 0)
3403 showmap(mp, TRUE);
3404 did_local = TRUE;
3411 #endif
3414 * Find an entry in the maphash[] list that matches.
3415 * For :unmap we may loop two times: once to try to unmap an entry with a
3416 * matching 'from' part, a second time, if the first fails, to unmap an
3417 * entry with a matching 'to' part. This was done to allow ":ab foo bar"
3418 * to be unmapped by typing ":unab foo", where "foo" will be replaced by
3419 * "bar" because of the abbreviation.
3421 for (round = 0; (round == 0 || maptype == 1) && round <= 1
3422 && !did_it && !got_int; ++round)
3424 /* need to loop over all hash lists */
3425 for (hash = 0; hash < 256 && !got_int; ++hash)
3427 if (abbrev)
3429 if (hash > 0) /* there is only one abbreviation list */
3430 break;
3431 mpp = abbr_table;
3433 else
3434 mpp = &(map_table[hash]);
3435 for (mp = *mpp; mp != NULL && !got_int; mp = *mpp)
3438 if (!(mp->m_mode & mode)) /* skip entries with wrong mode */
3440 mpp = &(mp->m_next);
3441 continue;
3443 if (!haskey) /* show all entries */
3445 showmap(mp, map_table != maphash);
3446 did_it = TRUE;
3448 else /* do we have a match? */
3450 if (round) /* second round: Try unmap "rhs" string */
3452 n = (int)STRLEN(mp->m_str);
3453 p = mp->m_str;
3455 else
3457 n = mp->m_keylen;
3458 p = mp->m_keys;
3460 if (STRNCMP(p, keys, (size_t)(n < len ? n : len)) == 0)
3462 if (maptype == 1) /* delete entry */
3464 /* Only accept a full match. For abbreviations we
3465 * ignore trailing space when matching with the
3466 * "lhs", since an abbreviation can't have
3467 * trailing space. */
3468 if (n != len && (!abbrev || round || n > len
3469 || *skipwhite(keys + n) != NUL))
3471 mpp = &(mp->m_next);
3472 continue;
3475 * We reset the indicated mode bits. If nothing is
3476 * left the entry is deleted below.
3478 mp->m_mode &= ~mode;
3479 did_it = TRUE; /* remember we did something */
3481 else if (!hasarg) /* show matching entry */
3483 showmap(mp, map_table != maphash);
3484 did_it = TRUE;
3486 else if (n != len) /* new entry is ambiguous */
3488 mpp = &(mp->m_next);
3489 continue;
3491 else if (unique)
3493 if (abbrev)
3494 EMSG2(_("E226: abbreviation already exists for %s"),
3496 else
3497 EMSG2(_("E227: mapping already exists for %s"), p);
3498 retval = 5;
3499 goto theend;
3501 else /* new rhs for existing entry */
3503 mp->m_mode &= ~mode; /* remove mode bits */
3504 if (mp->m_mode == 0 && !did_it) /* reuse entry */
3506 newstr = vim_strsave(rhs);
3507 if (newstr == NULL)
3509 retval = 4; /* no mem */
3510 goto theend;
3512 vim_free(mp->m_str);
3513 mp->m_str = newstr;
3514 mp->m_noremap = noremap;
3515 mp->m_silent = silent;
3516 mp->m_mode = mode;
3517 #ifdef FEAT_EVAL
3518 mp->m_expr = expr;
3519 mp->m_script_ID = current_SID;
3520 #endif
3521 did_it = TRUE;
3524 if (mp->m_mode == 0) /* entry can be deleted */
3526 map_free(mpp);
3527 continue; /* continue with *mpp */
3531 * May need to put this entry into another hash list.
3533 new_hash = MAP_HASH(mp->m_mode, mp->m_keys[0]);
3534 if (!abbrev && new_hash != hash)
3536 *mpp = mp->m_next;
3537 mp->m_next = map_table[new_hash];
3538 map_table[new_hash] = mp;
3540 continue; /* continue with *mpp */
3544 mpp = &(mp->m_next);
3549 if (maptype == 1) /* delete entry */
3551 if (!did_it)
3552 retval = 2; /* no match */
3553 goto theend;
3556 if (!haskey || !hasarg) /* print entries */
3558 if (!did_it
3559 #ifdef FEAT_LOCALMAP
3560 && !did_local
3561 #endif
3564 if (abbrev)
3565 MSG(_("No abbreviation found"));
3566 else
3567 MSG(_("No mapping found"));
3569 goto theend; /* listing finished */
3572 if (did_it) /* have added the new entry already */
3573 goto theend;
3576 * Get here when adding a new entry to the maphash[] list or abbrlist.
3578 mp = (mapblock_T *)alloc((unsigned)sizeof(mapblock_T));
3579 if (mp == NULL)
3581 retval = 4; /* no mem */
3582 goto theend;
3585 /* If CTRL-C has been mapped, don't always use it for Interrupting */
3586 if (*keys == Ctrl_C)
3587 mapped_ctrl_c = TRUE;
3589 mp->m_keys = vim_strsave(keys);
3590 mp->m_str = vim_strsave(rhs);
3591 if (mp->m_keys == NULL || mp->m_str == NULL)
3593 vim_free(mp->m_keys);
3594 vim_free(mp->m_str);
3595 vim_free(mp);
3596 retval = 4; /* no mem */
3597 goto theend;
3599 mp->m_keylen = (int)STRLEN(mp->m_keys);
3600 mp->m_noremap = noremap;
3601 mp->m_silent = silent;
3602 mp->m_mode = mode;
3603 #ifdef FEAT_EVAL
3604 mp->m_expr = expr;
3605 mp->m_script_ID = current_SID;
3606 #endif
3608 /* add the new entry in front of the abbrlist or maphash[] list */
3609 if (abbrev)
3611 mp->m_next = *abbr_table;
3612 *abbr_table = mp;
3614 else
3616 n = MAP_HASH(mp->m_mode, mp->m_keys[0]);
3617 mp->m_next = map_table[n];
3618 map_table[n] = mp;
3621 theend:
3622 vim_free(keys_buf);
3623 vim_free(arg_buf);
3624 return retval;
3628 * Delete one entry from the abbrlist or maphash[].
3629 * "mpp" is a pointer to the m_next field of the PREVIOUS entry!
3631 static void
3632 map_free(mpp)
3633 mapblock_T **mpp;
3635 mapblock_T *mp;
3637 mp = *mpp;
3638 vim_free(mp->m_keys);
3639 vim_free(mp->m_str);
3640 *mpp = mp->m_next;
3641 vim_free(mp);
3645 * Initialize maphash[] for first use.
3647 static void
3648 validate_maphash()
3650 if (!maphash_valid)
3652 vim_memset(maphash, 0, sizeof(maphash));
3653 maphash_valid = TRUE;
3658 * Get the mapping mode from the command name.
3661 get_map_mode(cmdp, forceit)
3662 char_u **cmdp;
3663 int forceit;
3665 char_u *p;
3666 int modec;
3667 int mode;
3669 p = *cmdp;
3670 modec = *p++;
3671 if (modec == 'i')
3672 mode = INSERT; /* :imap */
3673 else if (modec == 'l')
3674 mode = LANGMAP; /* :lmap */
3675 else if (modec == 'c')
3676 mode = CMDLINE; /* :cmap */
3677 else if (modec == 'n' && *p != 'o') /* avoid :noremap */
3678 mode = NORMAL; /* :nmap */
3679 else if (modec == 'v')
3680 mode = VISUAL + SELECTMODE; /* :vmap */
3681 else if (modec == 'x')
3682 mode = VISUAL; /* :xmap */
3683 else if (modec == 's')
3684 mode = SELECTMODE; /* :smap */
3685 else if (modec == 'o')
3686 mode = OP_PENDING; /* :omap */
3687 else
3689 --p;
3690 if (forceit)
3691 mode = INSERT + CMDLINE; /* :map ! */
3692 else
3693 mode = VISUAL + SELECTMODE + NORMAL + OP_PENDING;/* :map */
3696 *cmdp = p;
3697 return mode;
3701 * Clear all mappings or abbreviations.
3702 * 'abbr' should be FALSE for mappings, TRUE for abbreviations.
3704 /*ARGSUSED*/
3705 void
3706 map_clear(cmdp, arg, forceit, abbr)
3707 char_u *cmdp;
3708 char_u *arg;
3709 int forceit;
3710 int abbr;
3712 int mode;
3713 #ifdef FEAT_LOCALMAP
3714 int local;
3716 local = (STRCMP(arg, "<buffer>") == 0);
3717 if (!local && *arg != NUL)
3719 EMSG(_(e_invarg));
3720 return;
3722 #endif
3724 mode = get_map_mode(&cmdp, forceit);
3725 map_clear_int(curbuf, mode,
3726 #ifdef FEAT_LOCALMAP
3727 local,
3728 #else
3729 FALSE,
3730 #endif
3731 abbr);
3735 * Clear all mappings in "mode".
3737 /*ARGSUSED*/
3738 void
3739 map_clear_int(buf, mode, local, abbr)
3740 buf_T *buf; /* buffer for local mappings */
3741 int mode; /* mode in which to delete */
3742 int local; /* TRUE for buffer-local mappings */
3743 int abbr; /* TRUE for abbreviations */
3745 mapblock_T *mp, **mpp;
3746 int hash;
3747 int new_hash;
3749 validate_maphash();
3751 for (hash = 0; hash < 256; ++hash)
3753 if (abbr)
3755 if (hash > 0) /* there is only one abbrlist */
3756 break;
3757 #ifdef FEAT_LOCALMAP
3758 if (local)
3759 mpp = &buf->b_first_abbr;
3760 else
3761 #endif
3762 mpp = &first_abbr;
3764 else
3766 #ifdef FEAT_LOCALMAP
3767 if (local)
3768 mpp = &buf->b_maphash[hash];
3769 else
3770 #endif
3771 mpp = &maphash[hash];
3773 while (*mpp != NULL)
3775 mp = *mpp;
3776 if (mp->m_mode & mode)
3778 mp->m_mode &= ~mode;
3779 if (mp->m_mode == 0) /* entry can be deleted */
3781 map_free(mpp);
3782 continue;
3785 * May need to put this entry into another hash list.
3787 new_hash = MAP_HASH(mp->m_mode, mp->m_keys[0]);
3788 if (!abbr && new_hash != hash)
3790 *mpp = mp->m_next;
3791 #ifdef FEAT_LOCALMAP
3792 if (local)
3794 mp->m_next = buf->b_maphash[new_hash];
3795 buf->b_maphash[new_hash] = mp;
3797 else
3798 #endif
3800 mp->m_next = maphash[new_hash];
3801 maphash[new_hash] = mp;
3803 continue; /* continue with *mpp */
3806 mpp = &(mp->m_next);
3811 static void
3812 showmap(mp, local)
3813 mapblock_T *mp;
3814 int local; /* TRUE for buffer-local map */
3816 int len = 1;
3818 if (msg_didout || msg_silent != 0)
3820 msg_putchar('\n');
3821 if (got_int) /* 'q' typed at MORE prompt */
3822 return;
3824 if ((mp->m_mode & (INSERT + CMDLINE)) == INSERT + CMDLINE)
3825 msg_putchar('!'); /* :map! */
3826 else if (mp->m_mode & INSERT)
3827 msg_putchar('i'); /* :imap */
3828 else if (mp->m_mode & LANGMAP)
3829 msg_putchar('l'); /* :lmap */
3830 else if (mp->m_mode & CMDLINE)
3831 msg_putchar('c'); /* :cmap */
3832 else if ((mp->m_mode & (NORMAL + VISUAL + SELECTMODE + OP_PENDING))
3833 == NORMAL + VISUAL + SELECTMODE + OP_PENDING)
3834 msg_putchar(' '); /* :map */
3835 else
3837 len = 0;
3838 if (mp->m_mode & NORMAL)
3840 msg_putchar('n'); /* :nmap */
3841 ++len;
3843 if (mp->m_mode & OP_PENDING)
3845 msg_putchar('o'); /* :omap */
3846 ++len;
3848 if ((mp->m_mode & (VISUAL + SELECTMODE)) == VISUAL + SELECTMODE)
3850 msg_putchar('v'); /* :vmap */
3851 ++len;
3853 else
3855 if (mp->m_mode & VISUAL)
3857 msg_putchar('x'); /* :xmap */
3858 ++len;
3860 if (mp->m_mode & SELECTMODE)
3862 msg_putchar('s'); /* :smap */
3863 ++len;
3867 while (++len <= 3)
3868 msg_putchar(' ');
3870 /* Display the LHS. Get length of what we write. */
3871 len = msg_outtrans_special(mp->m_keys, TRUE);
3874 msg_putchar(' '); /* padd with blanks */
3875 ++len;
3876 } while (len < 12);
3878 if (mp->m_noremap == REMAP_NONE)
3879 msg_puts_attr((char_u *)"*", hl_attr(HLF_8));
3880 else if (mp->m_noremap == REMAP_SCRIPT)
3881 msg_puts_attr((char_u *)"&", hl_attr(HLF_8));
3882 else
3883 msg_putchar(' ');
3885 if (local)
3886 msg_putchar('@');
3887 else
3888 msg_putchar(' ');
3890 /* Use FALSE below if we only want things like <Up> to show up as such on
3891 * the rhs, and not M-x etc, TRUE gets both -- webb
3893 if (*mp->m_str == NUL)
3894 msg_puts_attr((char_u *)"<Nop>", hl_attr(HLF_8));
3895 else
3896 msg_outtrans_special(mp->m_str, FALSE);
3897 #ifdef FEAT_EVAL
3898 if (p_verbose > 0)
3899 last_set_msg(mp->m_script_ID);
3900 #endif
3901 out_flush(); /* show one line at a time */
3904 #if defined(FEAT_EVAL) || defined(PROTO)
3906 * Return TRUE if a map exists that has "str" in the rhs for mode "modechars".
3907 * Recognize termcap codes in "str".
3908 * Also checks mappings local to the current buffer.
3911 map_to_exists(str, modechars, abbr)
3912 char_u *str;
3913 char_u *modechars;
3914 int abbr;
3916 int mode = 0;
3917 char_u *rhs;
3918 char_u *buf;
3919 int retval;
3921 rhs = replace_termcodes(str, &buf, FALSE, TRUE, FALSE);
3923 if (vim_strchr(modechars, 'n') != NULL)
3924 mode |= NORMAL;
3925 if (vim_strchr(modechars, 'v') != NULL)
3926 mode |= VISUAL + SELECTMODE;
3927 if (vim_strchr(modechars, 'x') != NULL)
3928 mode |= VISUAL;
3929 if (vim_strchr(modechars, 's') != NULL)
3930 mode |= SELECTMODE;
3931 if (vim_strchr(modechars, 'o') != NULL)
3932 mode |= OP_PENDING;
3933 if (vim_strchr(modechars, 'i') != NULL)
3934 mode |= INSERT;
3935 if (vim_strchr(modechars, 'l') != NULL)
3936 mode |= LANGMAP;
3937 if (vim_strchr(modechars, 'c') != NULL)
3938 mode |= CMDLINE;
3940 retval = map_to_exists_mode(rhs, mode, abbr);
3941 vim_free(buf);
3943 return retval;
3945 #endif
3948 * Return TRUE if a map exists that has "str" in the rhs for mode "mode".
3949 * Also checks mappings local to the current buffer.
3952 map_to_exists_mode(rhs, mode, abbr)
3953 char_u *rhs;
3954 int mode;
3955 int abbr;
3957 mapblock_T *mp;
3958 int hash;
3959 # ifdef FEAT_LOCALMAP
3960 int expand_buffer = FALSE;
3962 validate_maphash();
3964 /* Do it twice: once for global maps and once for local maps. */
3965 for (;;)
3967 # endif
3968 for (hash = 0; hash < 256; ++hash)
3970 if (abbr)
3972 if (hash > 0) /* there is only one abbr list */
3973 break;
3974 #ifdef FEAT_LOCALMAP
3975 if (expand_buffer)
3976 mp = curbuf->b_first_abbr;
3977 else
3978 #endif
3979 mp = first_abbr;
3981 # ifdef FEAT_LOCALMAP
3982 else if (expand_buffer)
3983 mp = curbuf->b_maphash[hash];
3984 # endif
3985 else
3986 mp = maphash[hash];
3987 for (; mp; mp = mp->m_next)
3989 if ((mp->m_mode & mode)
3990 && strstr((char *)mp->m_str, (char *)rhs) != NULL)
3991 return TRUE;
3994 # ifdef FEAT_LOCALMAP
3995 if (expand_buffer)
3996 break;
3997 expand_buffer = TRUE;
3999 # endif
4001 return FALSE;
4004 #if defined(FEAT_CMDL_COMPL) || defined(PROTO)
4006 * Used below when expanding mapping/abbreviation names.
4008 static int expand_mapmodes = 0;
4009 static int expand_isabbrev = 0;
4010 #ifdef FEAT_LOCALMAP
4011 static int expand_buffer = FALSE;
4012 #endif
4015 * Work out what to complete when doing command line completion of mapping
4016 * or abbreviation names.
4018 char_u *
4019 set_context_in_map_cmd(xp, cmd, arg, forceit, isabbrev, isunmap, cmdidx)
4020 expand_T *xp;
4021 char_u *cmd;
4022 char_u *arg;
4023 int forceit; /* TRUE if '!' given */
4024 int isabbrev; /* TRUE if abbreviation */
4025 int isunmap; /* TRUE if unmap/unabbrev command */
4026 cmdidx_T cmdidx;
4028 if (forceit && cmdidx != CMD_map && cmdidx != CMD_unmap)
4029 xp->xp_context = EXPAND_NOTHING;
4030 else
4032 if (isunmap)
4033 expand_mapmodes = get_map_mode(&cmd, forceit || isabbrev);
4034 else
4036 expand_mapmodes = INSERT + CMDLINE;
4037 if (!isabbrev)
4038 expand_mapmodes += VISUAL + SELECTMODE + NORMAL + OP_PENDING;
4040 expand_isabbrev = isabbrev;
4041 xp->xp_context = EXPAND_MAPPINGS;
4042 #ifdef FEAT_LOCALMAP
4043 expand_buffer = FALSE;
4044 #endif
4045 for (;;)
4047 #ifdef FEAT_LOCALMAP
4048 if (STRNCMP(arg, "<buffer>", 8) == 0)
4050 expand_buffer = TRUE;
4051 arg = skipwhite(arg + 8);
4052 continue;
4054 #endif
4055 if (STRNCMP(arg, "<unique>", 8) == 0)
4057 arg = skipwhite(arg + 8);
4058 continue;
4060 if (STRNCMP(arg, "<silent>", 8) == 0)
4062 arg = skipwhite(arg + 8);
4063 continue;
4065 #ifdef FEAT_EVAL
4066 if (STRNCMP(arg, "<script>", 8) == 0)
4068 arg = skipwhite(arg + 8);
4069 continue;
4071 if (STRNCMP(arg, "<expr>", 6) == 0)
4073 arg = skipwhite(arg + 6);
4074 continue;
4076 #endif
4077 break;
4079 xp->xp_pattern = arg;
4082 return NULL;
4086 * Find all mapping/abbreviation names that match regexp 'prog'.
4087 * For command line expansion of ":[un]map" and ":[un]abbrev" in all modes.
4088 * Return OK if matches found, FAIL otherwise.
4091 ExpandMappings(regmatch, num_file, file)
4092 regmatch_T *regmatch;
4093 int *num_file;
4094 char_u ***file;
4096 mapblock_T *mp;
4097 int hash;
4098 int count;
4099 int round;
4100 char_u *p;
4101 int i;
4103 validate_maphash();
4105 *num_file = 0; /* return values in case of FAIL */
4106 *file = NULL;
4109 * round == 1: Count the matches.
4110 * round == 2: Build the array to keep the matches.
4112 for (round = 1; round <= 2; ++round)
4114 count = 0;
4116 for (i = 0; i < 5; ++i)
4118 if (i == 0)
4119 p = (char_u *)"<silent>";
4120 else if (i == 1)
4121 p = (char_u *)"<unique>";
4122 #ifdef FEAT_EVAL
4123 else if (i == 2)
4124 p = (char_u *)"<script>";
4125 else if (i == 3)
4126 p = (char_u *)"<expr>";
4127 #endif
4128 #ifdef FEAT_LOCALMAP
4129 else if (i == 4 && !expand_buffer)
4130 p = (char_u *)"<buffer>";
4131 #endif
4132 else
4133 continue;
4135 if (vim_regexec(regmatch, p, (colnr_T)0))
4137 if (round == 1)
4138 ++count;
4139 else
4140 (*file)[count++] = vim_strsave(p);
4144 for (hash = 0; hash < 256; ++hash)
4146 if (expand_isabbrev)
4148 if (hash > 0) /* only one abbrev list */
4149 break; /* for (hash) */
4150 mp = first_abbr;
4152 #ifdef FEAT_LOCALMAP
4153 else if (expand_buffer)
4154 mp = curbuf->b_maphash[hash];
4155 #endif
4156 else
4157 mp = maphash[hash];
4158 for (; mp; mp = mp->m_next)
4160 if (mp->m_mode & expand_mapmodes)
4162 p = translate_mapping(mp->m_keys, TRUE);
4163 if (p != NULL && vim_regexec(regmatch, p, (colnr_T)0))
4165 if (round == 1)
4166 ++count;
4167 else
4169 (*file)[count++] = p;
4170 p = NULL;
4173 vim_free(p);
4175 } /* for (mp) */
4176 } /* for (hash) */
4178 if (count == 0) /* no match found */
4179 break; /* for (round) */
4181 if (round == 1)
4183 *file = (char_u **)alloc((unsigned)(count * sizeof(char_u *)));
4184 if (*file == NULL)
4185 return FAIL;
4187 } /* for (round) */
4189 if (count > 1)
4191 char_u **ptr1;
4192 char_u **ptr2;
4193 char_u **ptr3;
4195 /* Sort the matches */
4196 sort_strings(*file, count);
4198 /* Remove multiple entries */
4199 ptr1 = *file;
4200 ptr2 = ptr1 + 1;
4201 ptr3 = ptr1 + count;
4203 while (ptr2 < ptr3)
4205 if (STRCMP(*ptr1, *ptr2))
4206 *++ptr1 = *ptr2++;
4207 else
4209 vim_free(*ptr2++);
4210 count--;
4215 *num_file = count;
4216 return (count == 0 ? FAIL : OK);
4218 #endif /* FEAT_CMDL_COMPL */
4221 * Check for an abbreviation.
4222 * Cursor is at ptr[col]. When inserting, mincol is where insert started.
4223 * "c" is the character typed before check_abbr was called. It may have
4224 * ABBR_OFF added to avoid prepending a CTRL-V to it.
4226 * Historic vi practice: The last character of an abbreviation must be an id
4227 * character ([a-zA-Z0-9_]). The characters in front of it must be all id
4228 * characters or all non-id characters. This allows for abbr. "#i" to
4229 * "#include".
4231 * Vim addition: Allow for abbreviations that end in a non-keyword character.
4232 * Then there must be white space before the abbr.
4234 * return TRUE if there is an abbreviation, FALSE if not
4237 check_abbr(c, ptr, col, mincol)
4238 int c;
4239 char_u *ptr;
4240 int col;
4241 int mincol;
4243 int len;
4244 int scol; /* starting column of the abbr. */
4245 int j;
4246 char_u *s;
4247 #ifdef FEAT_MBYTE
4248 char_u tb[MB_MAXBYTES + 4];
4249 #else
4250 char_u tb[4];
4251 #endif
4252 mapblock_T *mp;
4253 #ifdef FEAT_LOCALMAP
4254 mapblock_T *mp2;
4255 #endif
4256 #ifdef FEAT_MBYTE
4257 int clen = 0; /* length in characters */
4258 #endif
4259 int is_id = TRUE;
4260 int vim_abbr;
4262 if (typebuf.tb_no_abbr_cnt) /* abbrev. are not recursive */
4263 return FALSE;
4264 if ((KeyNoremap & (RM_NONE|RM_SCRIPT)) != 0)
4265 /* no remapping implies no abbreviation */
4266 return FALSE;
4269 * Check for word before the cursor: If it ends in a keyword char all
4270 * chars before it must be al keyword chars or non-keyword chars, but not
4271 * white space. If it ends in a non-keyword char we accept any characters
4272 * before it except white space.
4274 if (col == 0) /* cannot be an abbr. */
4275 return FALSE;
4277 #ifdef FEAT_MBYTE
4278 if (has_mbyte)
4280 char_u *p;
4282 p = mb_prevptr(ptr, ptr + col);
4283 if (!vim_iswordp(p))
4284 vim_abbr = TRUE; /* Vim added abbr. */
4285 else
4287 vim_abbr = FALSE; /* vi compatible abbr. */
4288 if (p > ptr)
4289 is_id = vim_iswordp(mb_prevptr(ptr, p));
4291 clen = 1;
4292 while (p > ptr + mincol)
4294 p = mb_prevptr(ptr, p);
4295 if (vim_isspace(*p) || (!vim_abbr && is_id != vim_iswordp(p)))
4297 p += (*mb_ptr2len)(p);
4298 break;
4300 ++clen;
4302 scol = (int)(p - ptr);
4304 else
4305 #endif
4307 if (!vim_iswordc(ptr[col - 1]))
4308 vim_abbr = TRUE; /* Vim added abbr. */
4309 else
4311 vim_abbr = FALSE; /* vi compatible abbr. */
4312 if (col > 1)
4313 is_id = vim_iswordc(ptr[col - 2]);
4315 for (scol = col - 1; scol > 0 && !vim_isspace(ptr[scol - 1])
4316 && (vim_abbr || is_id == vim_iswordc(ptr[scol - 1])); --scol)
4320 if (scol < mincol)
4321 scol = mincol;
4322 if (scol < col) /* there is a word in front of the cursor */
4324 ptr += scol;
4325 len = col - scol;
4326 #ifdef FEAT_LOCALMAP
4327 mp = curbuf->b_first_abbr;
4328 mp2 = first_abbr;
4329 if (mp == NULL)
4331 mp = mp2;
4332 mp2 = NULL;
4334 #else
4335 mp = first_abbr;
4336 #endif
4337 for ( ; mp;
4338 #ifdef FEAT_LOCALMAP
4339 mp->m_next == NULL ? (mp = mp2, mp2 = NULL) :
4340 #endif
4341 (mp = mp->m_next))
4343 /* find entries with right mode and keys */
4344 if ( (mp->m_mode & State)
4345 && mp->m_keylen == len
4346 && !STRNCMP(mp->m_keys, ptr, (size_t)len))
4347 break;
4349 if (mp != NULL)
4352 * Found a match:
4353 * Insert the rest of the abbreviation in typebuf.tb_buf[].
4354 * This goes from end to start.
4356 * Characters 0x000 - 0x100: normal chars, may need CTRL-V,
4357 * except K_SPECIAL: Becomes K_SPECIAL KS_SPECIAL KE_FILLER
4358 * Characters where IS_SPECIAL() == TRUE: key codes, need
4359 * K_SPECIAL. Other characters (with ABBR_OFF): don't use CTRL-V.
4361 * Character CTRL-] is treated specially - it completes the
4362 * abbreviation, but is not inserted into the input stream.
4364 j = 0;
4365 /* special key code, split up */
4366 if (c != Ctrl_RSB)
4368 if (IS_SPECIAL(c) || c == K_SPECIAL)
4370 tb[j++] = K_SPECIAL;
4371 tb[j++] = K_SECOND(c);
4372 tb[j++] = K_THIRD(c);
4374 else
4376 if (c < ABBR_OFF && (c < ' ' || c > '~'))
4377 tb[j++] = Ctrl_V; /* special char needs CTRL-V */
4378 #ifdef FEAT_MBYTE
4379 if (has_mbyte)
4381 /* if ABBR_OFF has been added, remove it here */
4382 if (c >= ABBR_OFF)
4383 c -= ABBR_OFF;
4384 j += (*mb_char2bytes)(c, tb + j);
4386 else
4387 #endif
4388 tb[j++] = c;
4390 tb[j] = NUL;
4391 /* insert the last typed char */
4392 (void)ins_typebuf(tb, 1, 0, TRUE, mp->m_silent);
4394 #ifdef FEAT_EVAL
4395 if (mp->m_expr)
4396 s = eval_map_expr(mp->m_str);
4397 else
4398 #endif
4399 s = mp->m_str;
4400 if (s != NULL)
4402 /* insert the to string */
4403 (void)ins_typebuf(s, mp->m_noremap, 0, TRUE, mp->m_silent);
4404 /* no abbrev. for these chars */
4405 typebuf.tb_no_abbr_cnt += (int)STRLEN(s) + j + 1;
4406 #ifdef FEAT_EVAL
4407 if (mp->m_expr)
4408 vim_free(s);
4409 #endif
4412 tb[0] = Ctrl_H;
4413 tb[1] = NUL;
4414 #ifdef FEAT_MBYTE
4415 if (has_mbyte)
4416 len = clen; /* Delete characters instead of bytes */
4417 #endif
4418 while (len-- > 0) /* delete the from string */
4419 (void)ins_typebuf(tb, 1, 0, TRUE, mp->m_silent);
4420 return TRUE;
4423 return FALSE;
4426 #ifdef FEAT_EVAL
4428 * Evaluate the RHS of a mapping or abbreviations and take care of escaping
4429 * special characters.
4431 static char_u *
4432 eval_map_expr(str)
4433 char_u *str;
4435 char_u *res;
4436 char_u *p;
4437 char_u *save_cmd;
4438 pos_T save_cursor;
4440 save_cmd = save_cmdline_alloc();
4441 if (save_cmd == NULL)
4442 return NULL;
4444 /* Forbid changing text or using ":normal" to avoid most of the bad side
4445 * effects. Also restore the cursor position. */
4446 ++textlock;
4447 #ifdef FEAT_EX_EXTRA
4448 ++ex_normal_lock;
4449 #endif
4450 save_cursor = curwin->w_cursor;
4451 p = eval_to_string(str, NULL, FALSE);
4452 --textlock;
4453 #ifdef FEAT_EX_EXTRA
4454 --ex_normal_lock;
4455 #endif
4456 curwin->w_cursor = save_cursor;
4458 restore_cmdline_alloc(save_cmd);
4459 if (p == NULL)
4460 return NULL;
4461 res = vim_strsave_escape_csi(p);
4462 vim_free(p);
4464 return res;
4466 #endif
4469 * Copy "p" to allocated memory, escaping K_SPECIAL and CSI so that the result
4470 * can be put in the typeahead buffer.
4471 * Returns NULL when out of memory.
4473 char_u *
4474 vim_strsave_escape_csi(p)
4475 char_u *p;
4477 char_u *res;
4478 char_u *s, *d;
4480 /* Need a buffer to hold up to three times as much. */
4481 res = alloc((unsigned)(STRLEN(p) * 3) + 1);
4482 if (res != NULL)
4484 d = res;
4485 for (s = p; *s != NUL; )
4487 if (s[0] == K_SPECIAL && s[1] != NUL && s[2] != NUL)
4489 /* Copy special key unmodified. */
4490 *d++ = *s++;
4491 *d++ = *s++;
4492 *d++ = *s++;
4494 else
4496 /* Add character, possibly multi-byte to destination, escaping
4497 * CSI and K_SPECIAL. */
4498 d = add_char2buf(PTR2CHAR(s), d);
4499 mb_ptr_adv(s);
4502 *d = NUL;
4504 return res;
4508 * Remove escaping from CSI and K_SPECIAL characters. Reverse of
4509 * vim_strsave_escape_csi(). Works in-place.
4511 void
4512 vim_unescape_csi(p)
4513 char_u *p;
4515 char_u *s = p, *d = p;
4517 while (*s != NUL)
4519 if (s[0] == K_SPECIAL && s[1] == KS_SPECIAL && s[2] == KE_FILLER)
4521 *d++ = K_SPECIAL;
4522 s += 3;
4524 else if ((s[0] == K_SPECIAL || s[0] == CSI)
4525 && s[1] == KS_EXTRA && s[2] == (int)KE_CSI)
4527 *d++ = CSI;
4528 s += 3;
4530 else
4531 *d++ = *s++;
4533 *d = NUL;
4537 * Write map commands for the current mappings to an .exrc file.
4538 * Return FAIL on error, OK otherwise.
4541 makemap(fd, buf)
4542 FILE *fd;
4543 buf_T *buf; /* buffer for local mappings or NULL */
4545 mapblock_T *mp;
4546 char_u c1, c2, c3;
4547 char_u *p;
4548 char *cmd;
4549 int abbr;
4550 int hash;
4551 int did_cpo = FALSE;
4552 int i;
4554 validate_maphash();
4557 * Do the loop twice: Once for mappings, once for abbreviations.
4558 * Then loop over all map hash lists.
4560 for (abbr = 0; abbr < 2; ++abbr)
4561 for (hash = 0; hash < 256; ++hash)
4563 if (abbr)
4565 if (hash > 0) /* there is only one abbr list */
4566 break;
4567 #ifdef FEAT_LOCALMAP
4568 if (buf != NULL)
4569 mp = buf->b_first_abbr;
4570 else
4571 #endif
4572 mp = first_abbr;
4574 else
4576 #ifdef FEAT_LOCALMAP
4577 if (buf != NULL)
4578 mp = buf->b_maphash[hash];
4579 else
4580 #endif
4581 mp = maphash[hash];
4584 for ( ; mp; mp = mp->m_next)
4586 /* skip script-local mappings */
4587 if (mp->m_noremap == REMAP_SCRIPT)
4588 continue;
4590 /* skip mappings that contain a <SNR> (script-local thing),
4591 * they probably don't work when loaded again */
4592 for (p = mp->m_str; *p != NUL; ++p)
4593 if (p[0] == K_SPECIAL && p[1] == KS_EXTRA
4594 && p[2] == (int)KE_SNR)
4595 break;
4596 if (*p != NUL)
4597 continue;
4599 /* It's possible to create a mapping and then ":unmap" certain
4600 * modes. We recreate this here by mapping the individual
4601 * modes, which requires up to three of them. */
4602 c1 = NUL;
4603 c2 = NUL;
4604 c3 = NUL;
4605 if (abbr)
4606 cmd = "abbr";
4607 else
4608 cmd = "map";
4609 switch (mp->m_mode)
4611 case NORMAL + VISUAL + SELECTMODE + OP_PENDING:
4612 break;
4613 case NORMAL:
4614 c1 = 'n';
4615 break;
4616 case VISUAL:
4617 c1 = 'x';
4618 break;
4619 case SELECTMODE:
4620 c1 = 's';
4621 break;
4622 case OP_PENDING:
4623 c1 = 'o';
4624 break;
4625 case NORMAL + VISUAL:
4626 c1 = 'n';
4627 c2 = 'x';
4628 break;
4629 case NORMAL + SELECTMODE:
4630 c1 = 'n';
4631 c2 = 's';
4632 break;
4633 case NORMAL + OP_PENDING:
4634 c1 = 'n';
4635 c2 = 'o';
4636 break;
4637 case VISUAL + SELECTMODE:
4638 c1 = 'v';
4639 break;
4640 case VISUAL + OP_PENDING:
4641 c1 = 'x';
4642 c2 = 'o';
4643 break;
4644 case SELECTMODE + OP_PENDING:
4645 c1 = 's';
4646 c2 = 'o';
4647 break;
4648 case NORMAL + VISUAL + SELECTMODE:
4649 c1 = 'n';
4650 c2 = 'v';
4651 break;
4652 case NORMAL + VISUAL + OP_PENDING:
4653 c1 = 'n';
4654 c2 = 'x';
4655 c3 = 'o';
4656 break;
4657 case NORMAL + SELECTMODE + OP_PENDING:
4658 c1 = 'n';
4659 c2 = 's';
4660 c3 = 'o';
4661 break;
4662 case VISUAL + SELECTMODE + OP_PENDING:
4663 c1 = 'v';
4664 c2 = 'o';
4665 break;
4666 case CMDLINE + INSERT:
4667 if (!abbr)
4668 cmd = "map!";
4669 break;
4670 case CMDLINE:
4671 c1 = 'c';
4672 break;
4673 case INSERT:
4674 c1 = 'i';
4675 break;
4676 case LANGMAP:
4677 c1 = 'l';
4678 break;
4679 default:
4680 EMSG(_("E228: makemap: Illegal mode"));
4681 return FAIL;
4683 do /* do this twice if c2 is set, 3 times with c3 */
4685 /* When outputting <> form, need to make sure that 'cpo'
4686 * is set to the Vim default. */
4687 if (!did_cpo)
4689 if (*mp->m_str == NUL) /* will use <Nop> */
4690 did_cpo = TRUE;
4691 else
4692 for (i = 0; i < 2; ++i)
4693 for (p = (i ? mp->m_str : mp->m_keys); *p; ++p)
4694 if (*p == K_SPECIAL || *p == NL)
4695 did_cpo = TRUE;
4696 if (did_cpo)
4698 if (fprintf(fd, "let s:cpo_save=&cpo") < 0
4699 || put_eol(fd) < 0
4700 || fprintf(fd, "set cpo&vim") < 0
4701 || put_eol(fd) < 0)
4702 return FAIL;
4705 if (c1 && putc(c1, fd) < 0)
4706 return FAIL;
4707 if (mp->m_noremap != REMAP_YES && fprintf(fd, "nore") < 0)
4708 return FAIL;
4709 if (fputs(cmd, fd) < 0)
4710 return FAIL;
4711 if (buf != NULL && fputs(" <buffer>", fd) < 0)
4712 return FAIL;
4713 if (mp->m_silent && fputs(" <silent>", fd) < 0)
4714 return FAIL;
4715 #ifdef FEAT_EVAL
4716 if (mp->m_noremap == REMAP_SCRIPT
4717 && fputs("<script>", fd) < 0)
4718 return FAIL;
4719 if (mp->m_expr && fputs(" <expr>", fd) < 0)
4720 return FAIL;
4721 #endif
4723 if ( putc(' ', fd) < 0
4724 || put_escstr(fd, mp->m_keys, 0) == FAIL
4725 || putc(' ', fd) < 0
4726 || put_escstr(fd, mp->m_str, 1) == FAIL
4727 || put_eol(fd) < 0)
4728 return FAIL;
4729 c1 = c2;
4730 c2 = c3;
4731 c3 = NUL;
4732 } while (c1 != NUL);
4736 if (did_cpo)
4737 if (fprintf(fd, "let &cpo=s:cpo_save") < 0
4738 || put_eol(fd) < 0
4739 || fprintf(fd, "unlet s:cpo_save") < 0
4740 || put_eol(fd) < 0)
4741 return FAIL;
4742 return OK;
4746 * write escape string to file
4747 * "what": 0 for :map lhs, 1 for :map rhs, 2 for :set
4749 * return FAIL for failure, OK otherwise
4752 put_escstr(fd, strstart, what)
4753 FILE *fd;
4754 char_u *strstart;
4755 int what;
4757 char_u *str = strstart;
4758 int c;
4759 int modifiers;
4761 /* :map xx <Nop> */
4762 if (*str == NUL && what == 1)
4764 if (fprintf(fd, "<Nop>") < 0)
4765 return FAIL;
4766 return OK;
4769 for ( ; *str != NUL; ++str)
4771 #ifdef FEAT_MBYTE
4772 char_u *p;
4774 /* Check for a multi-byte character, which may contain escaped
4775 * K_SPECIAL and CSI bytes */
4776 p = mb_unescape(&str);
4777 if (p != NULL)
4779 while (*p != NUL)
4780 if (fputc(*p++, fd) < 0)
4781 return FAIL;
4782 --str;
4783 continue;
4785 #endif
4787 c = *str;
4789 * Special key codes have to be translated to be able to make sense
4790 * when they are read back.
4792 if (c == K_SPECIAL && what != 2)
4794 modifiers = 0x0;
4795 if (str[1] == KS_MODIFIER)
4797 modifiers = str[2];
4798 str += 3;
4799 c = *str;
4801 if (c == K_SPECIAL)
4803 c = TO_SPECIAL(str[1], str[2]);
4804 str += 2;
4806 if (IS_SPECIAL(c) || modifiers) /* special key */
4808 if (fputs((char *)get_special_key_name(c, modifiers), fd) < 0)
4809 return FAIL;
4810 continue;
4815 * A '\n' in a map command should be written as <NL>.
4816 * A '\n' in a set command should be written as \^V^J.
4818 if (c == NL)
4820 if (what == 2)
4822 if (fprintf(fd, IF_EB("\\\026\n", "\\" CTRL_V_STR "\n")) < 0)
4823 return FAIL;
4825 else
4827 if (fprintf(fd, "<NL>") < 0)
4828 return FAIL;
4830 continue;
4834 * Some characters have to be escaped with CTRL-V to
4835 * prevent them from misinterpreted in DoOneCmd().
4836 * A space, Tab and '"' has to be escaped with a backslash to
4837 * prevent it to be misinterpreted in do_set().
4838 * A space has to be escaped with a CTRL-V when it's at the start of a
4839 * ":map" rhs.
4840 * A '<' has to be escaped with a CTRL-V to prevent it being
4841 * interpreted as the start of a special key name.
4842 * A space in the lhs of a :map needs a CTRL-V.
4844 if (what == 2 && (vim_iswhite(c) || c == '"' || c == '\\'))
4846 if (putc('\\', fd) < 0)
4847 return FAIL;
4849 else if (c < ' ' || c > '~' || c == '|'
4850 || (what == 0 && c == ' ')
4851 || (what == 1 && str == strstart && c == ' ')
4852 || (what != 2 && c == '<'))
4854 if (putc(Ctrl_V, fd) < 0)
4855 return FAIL;
4857 if (putc(c, fd) < 0)
4858 return FAIL;
4860 return OK;
4864 * Check all mappings for the presence of special key codes.
4865 * Used after ":set term=xxx".
4867 void
4868 check_map_keycodes()
4870 mapblock_T *mp;
4871 char_u *p;
4872 int i;
4873 char_u buf[3];
4874 char_u *save_name;
4875 int abbr;
4876 int hash;
4877 #ifdef FEAT_LOCALMAP
4878 buf_T *bp;
4879 #endif
4881 validate_maphash();
4882 save_name = sourcing_name;
4883 sourcing_name = (char_u *)"mappings"; /* avoids giving error messages */
4885 #ifdef FEAT_LOCALMAP
4886 /* This this once for each buffer, and then once for global
4887 * mappings/abbreviations with bp == NULL */
4888 for (bp = firstbuf; ; bp = bp->b_next)
4890 #endif
4892 * Do the loop twice: Once for mappings, once for abbreviations.
4893 * Then loop over all map hash lists.
4895 for (abbr = 0; abbr <= 1; ++abbr)
4896 for (hash = 0; hash < 256; ++hash)
4898 if (abbr)
4900 if (hash) /* there is only one abbr list */
4901 break;
4902 #ifdef FEAT_LOCALMAP
4903 if (bp != NULL)
4904 mp = bp->b_first_abbr;
4905 else
4906 #endif
4907 mp = first_abbr;
4909 else
4911 #ifdef FEAT_LOCALMAP
4912 if (bp != NULL)
4913 mp = bp->b_maphash[hash];
4914 else
4915 #endif
4916 mp = maphash[hash];
4918 for ( ; mp != NULL; mp = mp->m_next)
4920 for (i = 0; i <= 1; ++i) /* do this twice */
4922 if (i == 0)
4923 p = mp->m_keys; /* once for the "from" part */
4924 else
4925 p = mp->m_str; /* and once for the "to" part */
4926 while (*p)
4928 if (*p == K_SPECIAL)
4930 ++p;
4931 if (*p < 128) /* for "normal" tcap entries */
4933 buf[0] = p[0];
4934 buf[1] = p[1];
4935 buf[2] = NUL;
4936 (void)add_termcap_entry(buf, FALSE);
4938 ++p;
4940 ++p;
4945 #ifdef FEAT_LOCALMAP
4946 if (bp == NULL)
4947 break;
4949 #endif
4950 sourcing_name = save_name;
4953 #ifdef FEAT_EVAL
4955 * Check the string "keys" against the lhs of all mappings
4956 * Return pointer to rhs of mapping (mapblock->m_str)
4957 * NULL otherwise
4959 char_u *
4960 check_map(keys, mode, exact, ign_mod, abbr)
4961 char_u *keys;
4962 int mode;
4963 int exact; /* require exact match */
4964 int ign_mod; /* ignore preceding modifier */
4965 int abbr; /* do abbreviations */
4967 int hash;
4968 int len, minlen;
4969 mapblock_T *mp;
4970 char_u *s;
4971 #ifdef FEAT_LOCALMAP
4972 int local;
4973 #endif
4975 validate_maphash();
4977 len = (int)STRLEN(keys);
4978 #ifdef FEAT_LOCALMAP
4979 for (local = 1; local >= 0; --local)
4980 #endif
4981 /* loop over all hash lists */
4982 for (hash = 0; hash < 256; ++hash)
4984 if (abbr)
4986 if (hash > 0) /* there is only one list. */
4987 break;
4988 #ifdef FEAT_LOCALMAP
4989 if (local)
4990 mp = curbuf->b_first_abbr;
4991 else
4992 #endif
4993 mp = first_abbr;
4995 #ifdef FEAT_LOCALMAP
4996 else if (local)
4997 mp = curbuf->b_maphash[hash];
4998 #endif
4999 else
5000 mp = maphash[hash];
5001 for ( ; mp != NULL; mp = mp->m_next)
5003 /* skip entries with wrong mode, wrong length and not matching
5004 * ones */
5005 if ((mp->m_mode & mode) && (!exact || mp->m_keylen == len))
5007 if (len > mp->m_keylen)
5008 minlen = mp->m_keylen;
5009 else
5010 minlen = len;
5011 s = mp->m_keys;
5012 if (ign_mod && s[0] == K_SPECIAL && s[1] == KS_MODIFIER
5013 && s[2] != NUL)
5015 s += 3;
5016 if (len > mp->m_keylen - 3)
5017 minlen = mp->m_keylen - 3;
5019 if (STRNCMP(s, keys, minlen) == 0)
5020 return mp->m_str;
5025 return NULL;
5027 #endif
5029 #if defined(MSDOS) || defined(MSWIN) || defined(OS2) || defined(MACOS)
5031 #define VIS_SEL (VISUAL+SELECTMODE) /* abbreviation */
5034 * Default mappings for some often used keys.
5036 static struct initmap
5038 char_u *arg;
5039 int mode;
5040 } initmappings[] =
5042 #if defined(MSDOS) || defined(MSWIN) || defined(OS2)
5043 /* Use the Windows (CUA) keybindings. */
5044 # ifdef FEAT_GUI
5045 # if 0 /* These are now used to move tab pages */
5046 {(char_u *)"<C-PageUp> H", NORMAL+VIS_SEL},
5047 {(char_u *)"<C-PageUp> <C-O>H",INSERT},
5048 {(char_u *)"<C-PageDown> L$", NORMAL+VIS_SEL},
5049 {(char_u *)"<C-PageDown> <C-O>L<C-O>$", INSERT},
5050 # endif
5052 /* paste, copy and cut */
5053 {(char_u *)"<S-Insert> \"*P", NORMAL},
5054 {(char_u *)"<S-Insert> \"-d\"*P", VIS_SEL},
5055 {(char_u *)"<S-Insert> <C-R><C-O>*", INSERT+CMDLINE},
5056 {(char_u *)"<C-Insert> \"*y", VIS_SEL},
5057 {(char_u *)"<S-Del> \"*d", VIS_SEL},
5058 {(char_u *)"<C-Del> \"*d", VIS_SEL},
5059 {(char_u *)"<C-X> \"*d", VIS_SEL},
5060 /* Missing: CTRL-C (cancel) and CTRL-V (block selection) */
5061 # else
5062 # if 0 /* These are now used to move tab pages */
5063 {(char_u *)"\316\204 H", NORMAL+VIS_SEL}, /* CTRL-PageUp is "H" */
5064 {(char_u *)"\316\204 \017H",INSERT}, /* CTRL-PageUp is "^OH"*/
5065 {(char_u *)"\316v L$", NORMAL+VIS_SEL}, /* CTRL-PageDown is "L$" */
5066 {(char_u *)"\316v \017L\017$", INSERT}, /* CTRL-PageDown ="^OL^O$"*/
5067 # endif
5068 {(char_u *)"\316w <C-Home>", NORMAL+VIS_SEL},
5069 {(char_u *)"\316w <C-Home>", INSERT+CMDLINE},
5070 {(char_u *)"\316u <C-End>", NORMAL+VIS_SEL},
5071 {(char_u *)"\316u <C-End>", INSERT+CMDLINE},
5073 /* paste, copy and cut */
5074 # ifdef FEAT_CLIPBOARD
5075 # ifdef DJGPP
5076 {(char_u *)"\316\122 \"*P", NORMAL}, /* SHIFT-Insert is "*P */
5077 {(char_u *)"\316\122 \"-d\"*P", VIS_SEL}, /* SHIFT-Insert is "-d"*P */
5078 {(char_u *)"\316\122 \022\017*", INSERT}, /* SHIFT-Insert is ^R^O* */
5079 {(char_u *)"\316\222 \"*y", VIS_SEL}, /* CTRL-Insert is "*y */
5080 # if 0 /* Shift-Del produces the same code as Del */
5081 {(char_u *)"\316\123 \"*d", VIS_SEL}, /* SHIFT-Del is "*d */
5082 # endif
5083 {(char_u *)"\316\223 \"*d", VIS_SEL}, /* CTRL-Del is "*d */
5084 {(char_u *)"\030 \"-d", VIS_SEL}, /* CTRL-X is "-d */
5085 # else
5086 {(char_u *)"\316\324 \"*P", NORMAL}, /* SHIFT-Insert is "*P */
5087 {(char_u *)"\316\324 \"-d\"*P", VIS_SEL}, /* SHIFT-Insert is "-d"*P */
5088 {(char_u *)"\316\324 \022\017*", INSERT}, /* SHIFT-Insert is ^R^O* */
5089 {(char_u *)"\316\325 \"*y", VIS_SEL}, /* CTRL-Insert is "*y */
5090 {(char_u *)"\316\327 \"*d", VIS_SEL}, /* SHIFT-Del is "*d */
5091 {(char_u *)"\316\330 \"*d", VIS_SEL}, /* CTRL-Del is "*d */
5092 {(char_u *)"\030 \"-d", VIS_SEL}, /* CTRL-X is "-d */
5093 # endif
5094 # else
5095 {(char_u *)"\316\324 P", NORMAL}, /* SHIFT-Insert is P */
5096 {(char_u *)"\316\324 \"-dP", VIS_SEL}, /* SHIFT-Insert is "-dP */
5097 {(char_u *)"\316\324 \022\017\"", INSERT}, /* SHIFT-Insert is ^R^O" */
5098 {(char_u *)"\316\325 y", VIS_SEL}, /* CTRL-Insert is y */
5099 {(char_u *)"\316\327 d", VIS_SEL}, /* SHIFT-Del is d */
5100 {(char_u *)"\316\330 d", VIS_SEL}, /* CTRL-Del is d */
5101 # endif
5102 # endif
5103 #endif
5105 #if defined(MACOS)
5106 /* Use the Standard MacOS binding. */
5107 /* paste, copy and cut */
5108 {(char_u *)"<D-v> \"*P", NORMAL},
5109 {(char_u *)"<D-v> \"-d\"*P", VIS_SEL},
5110 {(char_u *)"<D-v> <C-R>*", INSERT+CMDLINE},
5111 {(char_u *)"<D-c> \"*y", VIS_SEL},
5112 {(char_u *)"<D-x> \"*d", VIS_SEL},
5113 {(char_u *)"<Backspace> \"-d", VIS_SEL},
5114 #endif
5117 # undef VIS_SEL
5118 #endif
5121 * Set up default mappings.
5123 void
5124 init_mappings()
5126 #if defined(MSDOS) || defined(MSWIN) || defined(OS2) || defined(MACOS)
5127 int i;
5129 for (i = 0; i < sizeof(initmappings) / sizeof(struct initmap); ++i)
5130 add_map(initmappings[i].arg, initmappings[i].mode);
5131 #endif
5134 #if defined(MSDOS) || defined(MSWIN) || defined(OS2) \
5135 || defined(FEAT_CMDWIN) || defined(MACOS) || defined(PROTO)
5137 * Add a mapping "map" for mode "mode".
5138 * Need to put string in allocated memory, because do_map() will modify it.
5140 void
5141 add_map(map, mode)
5142 char_u *map;
5143 int mode;
5145 char_u *s;
5146 char_u *cpo_save = p_cpo;
5148 p_cpo = (char_u *)""; /* Allow <> notation */
5149 s = vim_strsave(map);
5150 if (s != NULL)
5152 (void)do_map(0, s, mode, FALSE);
5153 vim_free(s);
5155 p_cpo = cpo_save;
5157 #endif