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.
11 * Code to handle tags and the tag stack
14 #if defined(MSDOS) || defined(WIN16) || defined(WIN32) || defined(_WIN64)
15 # include "vimio.h" /* for lseek(), must be before vim.h */
21 * Structure to hold pointers to various items in a tag line.
23 typedef struct tag_pointers
25 /* filled in by parse_tag_line(): */
26 char_u
*tagname
; /* start of tag name (skip "file:") */
27 char_u
*tagname_end
; /* char after tag name */
28 char_u
*fname
; /* first char of file name */
29 char_u
*fname_end
; /* char after file name */
30 char_u
*command
; /* first char of command */
31 /* filled in by parse_match(): */
32 char_u
*command_end
; /* first char after command */
33 char_u
*tag_fname
; /* file name of the tags file. This is used
34 * when 'tr' is set. */
35 #ifdef FEAT_EMACS_TAGS
36 int is_etag
; /* TRUE for emacs tag */
38 char_u
*tagkind
; /* "kind:" value */
39 char_u
*tagkind_end
; /* end of tagkind */
43 * The matching tags are first stored in ga_match[]. In which one depends on
44 * the priority of the match.
45 * At the end, the matches from ga_match[] are concatenated, to make a list
48 #define MT_ST_CUR 0 /* static match in current file */
49 #define MT_GL_CUR 1 /* global match in current file */
50 #define MT_GL_OTH 2 /* global match in other file */
51 #define MT_ST_OTH 3 /* static match in other file */
52 #define MT_IC_ST_CUR 4 /* icase static match in current file */
53 #define MT_IC_GL_CUR 5 /* icase global match in current file */
54 #define MT_IC_GL_OTH 6 /* icase global match in other file */
55 #define MT_IC_ST_OTH 7 /* icase static match in other file */
56 #define MT_IC_OFF 4 /* add for icase match */
57 #define MT_RE_OFF 8 /* add for regexp match */
58 #define MT_MASK 7 /* mask for printing priority */
61 static char *mt_names
[MT_COUNT
/2] =
62 {"FSC", "F C", "F ", "FS ", " SC", " C", " ", " S "};
64 #define NOTAGFILE 99 /* return value for jumpto_tag */
65 static char_u
*nofile_fname
= NULL
; /* fname for NOTAGFILE error */
67 static void taglen_advance
__ARGS((int l
));
69 static int jumpto_tag
__ARGS((char_u
*lbuf
, int forceit
, int keep_help
));
70 #ifdef FEAT_EMACS_TAGS
71 static int parse_tag_line
__ARGS((char_u
*lbuf
, int is_etag
, tagptrs_T
*tagp
));
73 static int parse_tag_line
__ARGS((char_u
*lbuf
, tagptrs_T
*tagp
));
75 static int test_for_static
__ARGS((tagptrs_T
*));
76 static int parse_match
__ARGS((char_u
*lbuf
, tagptrs_T
*tagp
));
77 static char_u
*tag_full_fname
__ARGS((tagptrs_T
*tagp
));
78 static char_u
*expand_tag_fname
__ARGS((char_u
*fname
, char_u
*tag_fname
, int expand
));
79 #ifdef FEAT_EMACS_TAGS
80 static int test_for_current
__ARGS((int, char_u
*, char_u
*, char_u
*, char_u
*));
82 static int test_for_current
__ARGS((char_u
*, char_u
*, char_u
*, char_u
*));
84 static int find_extra
__ARGS((char_u
**pp
));
86 static char_u
*bottommsg
= (char_u
*)N_("E555: at bottom of tag stack");
87 static char_u
*topmsg
= (char_u
*)N_("E556: at top of tag stack");
89 static char_u
*tagmatchname
= NULL
; /* name of last used tag */
92 * We use ftello() here, if available. It returns off_t instead of long,
93 * which helps if long is 32 bit and off_t is 64 bit.
94 * We assume that when fseeko() is available then ftello() is too.
100 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
102 * Tag for preview window is remembered separately, to avoid messing up the
105 static taggy_T ptag_entry
= {NULL
, {INIT_POS_T(0, 0, 0), 0}, 0, 0};
109 * Jump to tag; handling of tag commands and tag stack
111 * *tag != NUL: ":tag {tag}", jump to new tag, add to tag stack
113 * type == DT_TAG: ":tag [tag]", jump to newer position or same tag again
114 * type == DT_HELP: like DT_TAG, but don't use regexp.
115 * type == DT_POP: ":pop" or CTRL-T, jump to old position
116 * type == DT_NEXT: jump to next match of same tag
117 * type == DT_PREV: jump to previous match of same tag
118 * type == DT_FIRST: jump to first match of same tag
119 * type == DT_LAST: jump to last match of same tag
120 * type == DT_SELECT: ":tselect [tag]", select tag from a list of all matches
121 * type == DT_JUMP: ":tjump [tag]", jump to tag or select tag from a list
122 * type == DT_CSCOPE: use cscope to find the tag
123 * type == DT_LTAG: use location list for displaying tag matches
124 * type == DT_FREE: free cached matches
126 * for cscope, returns TRUE if we jumped to tag or aborted, FALSE otherwise
129 do_tag(tag
, type
, count
, forceit
, verbose
)
130 char_u
*tag
; /* tag (pattern) to jump to */
133 int forceit
; /* :ta with ! */
134 int verbose
; /* print "tag not found" message */
136 taggy_T
*tagstack
= curwin
->w_tagstack
;
137 int tagstackidx
= curwin
->w_tagstackidx
;
138 int tagstacklen
= curwin
->w_tagstacklen
;
140 int cur_fnum
= curbuf
->b_fnum
;
141 int oldtagstackidx
= tagstackidx
;
142 int prevtagstackidx
= tagstackidx
;
143 int prev_num_matches
;
151 int no_regexp
= FALSE
;
152 int error_cur_match
= 0;
154 int save_pos
= FALSE
;
158 int jumped_to_tag
= FALSE
;
160 tagptrs_T tagp
, tagp2
;
162 char_u
**new_matches
;
165 int skip_msg
= FALSE
;
166 char_u
*buf_ffname
= curbuf
->b_ffname
; /* name to use for
167 priority computation */
170 /* remember the matches for the last used tag */
171 static int num_matches
= 0;
172 static int max_num_matches
= 0; /* limit used for match search */
173 static char_u
**matches
= NULL
;
179 /* remove the list of matches */
180 FreeWild(num_matches
, matches
);
196 prev_num_matches
= num_matches
;
197 free_string_option(nofile_fname
);
200 clearpos(&saved_fmark
.mark
); /* shutup gcc 4.0 */
201 saved_fmark
.fnum
= 0;
204 * Don't add a tag to the tagstack if 'tagstack' has been reset.
206 if ((!p_tgst
&& *tag
!= NUL
))
208 use_tagstack
= FALSE
;
213 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
215 use_tagstack
= FALSE
;
220 /* new pattern, add to the tag stack */
222 && (type
== DT_TAG
|| type
== DT_SELECT
|| type
== DT_JUMP
231 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
234 if (ptag_entry
.tagname
!= NULL
235 && STRCMP(ptag_entry
.tagname
, tag
) == 0)
237 /* Jumping to same tag: keep the current match, so that
238 * the CursorHold autocommand example works. */
239 cur_match
= ptag_entry
.cur_match
;
240 cur_fnum
= ptag_entry
.cur_fnum
;
244 vim_free(ptag_entry
.tagname
);
245 if ((ptag_entry
.tagname
= vim_strsave(tag
)) == NULL
)
253 * If the last used entry is not at the top, delete all tag
254 * stack entries above it.
256 while (tagstackidx
< tagstacklen
)
257 vim_free(tagstack
[--tagstacklen
].tagname
);
259 /* if the tagstack is full: remove oldest entry */
260 if (++tagstacklen
> TAGSTACKSIZE
)
262 tagstacklen
= TAGSTACKSIZE
;
263 vim_free(tagstack
[0].tagname
);
264 for (i
= 1; i
< tagstacklen
; ++i
)
265 tagstack
[i
- 1] = tagstack
[i
];
270 * put the tag name in the tag stack
272 if ((tagstack
[tagstackidx
].tagname
= vim_strsave(tag
)) == NULL
)
274 curwin
->w_tagstacklen
= tagstacklen
- 1;
277 curwin
->w_tagstacklen
= tagstacklen
;
279 save_pos
= TRUE
; /* save the cursor position below */
287 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
288 g_do_tagpreview
? ptag_entry
.tagname
== NULL
:
297 if (type
== DT_POP
) /* go to older position */
300 int old_KeyTyped
= KeyTyped
;
302 if ((tagstackidx
-= count
) < 0)
305 if (tagstackidx
+ count
== 0)
307 /* We did [num]^T from the bottom of the stack */
311 /* We weren't at the bottom of the stack, so jump all the
312 * way to the bottom now.
316 else if (tagstackidx
>= tagstacklen
) /* count == 0? */
322 /* Make a copy of the fmark, autocommands may invalidate the
323 * tagstack before it's used. */
324 saved_fmark
= tagstack
[tagstackidx
].fmark
;
325 if (saved_fmark
.fnum
!= curbuf
->b_fnum
)
328 * Jump to other file. If this fails (e.g. because the
329 * file was changed) keep original position in tag stack.
331 if (buflist_getfile(saved_fmark
.fnum
, saved_fmark
.mark
.lnum
,
332 GETF_SETMARK
, forceit
) == FAIL
)
334 tagstackidx
= oldtagstackidx
; /* back to old posn */
337 /* An BufReadPost autocommand may jump to the '" mark, but
338 * we don't what that here. */
339 curwin
->w_cursor
.lnum
= saved_fmark
.mark
.lnum
;
344 curwin
->w_cursor
.lnum
= saved_fmark
.mark
.lnum
;
346 curwin
->w_cursor
.col
= saved_fmark
.mark
.col
;
347 curwin
->w_set_curswant
= TRUE
;
350 if ((fdo_flags
& FDO_TAG
) && old_KeyTyped
)
354 /* remove the old list of matches */
355 FreeWild(num_matches
, matches
);
365 #if defined(FEAT_QUICKFIX)
370 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
373 cur_match
= ptag_entry
.cur_match
;
374 cur_fnum
= ptag_entry
.cur_fnum
;
379 /* ":tag" (no argument): go to newer pattern */
380 save_pos
= TRUE
; /* save the cursor position below */
381 if ((tagstackidx
+= count
- 1) >= tagstacklen
)
384 * Beyond the last one, just give an error message and
385 * go to the last one. Don't store the cursor
388 tagstackidx
= tagstacklen
- 1;
392 else if (tagstackidx
< 0) /* must have been count == 0 */
398 cur_match
= tagstack
[tagstackidx
].cur_match
;
399 cur_fnum
= tagstack
[tagstackidx
].cur_fnum
;
403 else /* go to other matching tag */
405 /* Save index for when selection is cancelled. */
406 prevtagstackidx
= tagstackidx
;
408 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
411 cur_match
= ptag_entry
.cur_match
;
412 cur_fnum
= ptag_entry
.cur_fnum
;
417 if (--tagstackidx
< 0)
419 cur_match
= tagstack
[tagstackidx
].cur_match
;
420 cur_fnum
= tagstack
[tagstackidx
].cur_fnum
;
424 case DT_FIRST
: cur_match
= count
- 1; break;
430 case DT_LAST
: cur_match
= MAXCOL
- 1; break;
431 case DT_NEXT
: cur_match
+= count
; break;
432 case DT_PREV
: cur_match
-= count
; break;
434 if (cur_match
>= MAXCOL
)
435 cur_match
= MAXCOL
- 1;
436 else if (cur_match
< 0)
438 EMSG(_("E425: Cannot go before first matching tag"));
441 cur_fnum
= curbuf
->b_fnum
;
446 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
449 if (type
!= DT_SELECT
&& type
!= DT_JUMP
)
451 ptag_entry
.cur_match
= cur_match
;
452 ptag_entry
.cur_fnum
= cur_fnum
;
459 * For ":tag [arg]" or ":tselect" remember position before the jump.
461 saved_fmark
= tagstack
[tagstackidx
].fmark
;
464 tagstack
[tagstackidx
].fmark
.mark
= curwin
->w_cursor
;
465 tagstack
[tagstackidx
].fmark
.fnum
= curbuf
->b_fnum
;
468 /* Curwin will change in the call to jumpto_tag() if ":stag" was
469 * used or an autocommand jumps to another window; store value of
470 * tagstackidx now. */
471 curwin
->w_tagstackidx
= tagstackidx
;
472 if (type
!= DT_SELECT
&& type
!= DT_JUMP
)
474 curwin
->w_tagstack
[tagstackidx
].cur_match
= cur_match
;
475 curwin
->w_tagstack
[tagstackidx
].cur_fnum
= cur_fnum
;
480 /* When not using the current buffer get the name of buffer "cur_fnum".
481 * Makes sure that the tag order doesn't change when using a remembered
482 * position for "cur_match". */
483 if (cur_fnum
!= curbuf
->b_fnum
)
485 buf_T
*buf
= buflist_findnr(cur_fnum
);
488 buf_ffname
= buf
->b_ffname
;
492 * Repeat searching for tags, when a file has not been found.
497 * When desired match not found yet, try to find it (and others).
500 name
= tagstack
[tagstackidx
].tagname
;
501 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
502 else if (g_do_tagpreview
)
503 name
= ptag_entry
.tagname
;
507 other_name
= (tagmatchname
== NULL
|| STRCMP(tagmatchname
, name
) != 0);
509 || (cur_match
>= num_matches
&& max_num_matches
!= MAXCOL
)
514 vim_free(tagmatchname
);
515 tagmatchname
= vim_strsave(name
);
519 * If a count is supplied to the ":tag <name>" command, then
520 * jump to count'th matching tag.
522 if (type
== DT_TAG
&& *tag
!= NUL
&& count
> 0)
523 cur_match
= count
- 1;
525 if (type
== DT_SELECT
|| type
== DT_JUMP
526 #if defined(FEAT_QUICKFIX)
530 cur_match
= MAXCOL
- 1;
531 max_num_matches
= cur_match
+ 1;
533 /* when the argument starts with '/', use it as a regexp */
534 if (!no_regexp
&& *name
== '/')
543 if (type
== DT_CSCOPE
)
547 flags
|= TAG_VERBOSE
;
548 if (type
== DT_TAG
&& use_tfu
)
549 flags
|= TAG_USE_TFU
;
551 if (find_tags(name
, &new_num_matches
, &new_matches
, flags
,
552 max_num_matches
, buf_ffname
) == OK
553 && new_num_matches
< max_num_matches
)
554 max_num_matches
= MAXCOL
; /* If less than max_num_matches
555 found: all matches found. */
557 /* If there already were some matches for the same name, move them
558 * to the start. Avoids that the order changes when using
559 * ":tnext" and jumping to another file. */
560 if (!new_tag
&& !other_name
)
562 /* Find the position of each old match in the new list. Need
563 * to use parse_match() to find the tag line. */
565 for (j
= 0; j
< num_matches
; ++j
)
567 parse_match(matches
[j
], &tagp
);
568 for (i
= idx
; i
< new_num_matches
; ++i
)
570 parse_match(new_matches
[i
], &tagp2
);
571 if (STRCMP(tagp
.tagname
, tagp2
.tagname
) == 0)
574 for (k
= i
; k
> idx
; --k
)
575 new_matches
[k
] = new_matches
[k
- 1];
576 new_matches
[idx
++] = p
;
582 FreeWild(num_matches
, matches
);
583 num_matches
= new_num_matches
;
584 matches
= new_matches
;
587 if (num_matches
<= 0)
590 EMSG2(_("E426: tag not found: %s"), name
);
591 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
597 int ask_for_selection
= FALSE
;
600 if (type
== DT_CSCOPE
&& num_matches
> 1)
603 ask_for_selection
= TRUE
;
607 if (type
== DT_SELECT
|| (type
== DT_JUMP
&& num_matches
> 1))
610 * List all the matching tags.
611 * Assume that the first match indicates how long the tags can
612 * be, and align the file names to that.
614 parse_match(matches
[0], &tagp
);
615 taglen
= (int)(tagp
.tagname_end
- tagp
.tagname
+ 2);
618 if (taglen
> Columns
- 25)
621 msg_didout
= FALSE
; /* overwrite previous message */
623 MSG_PUTS_ATTR(_(" # pri kind tag"), hl_attr(HLF_T
));
625 taglen_advance(taglen
);
626 MSG_PUTS_ATTR(_("file\n"), hl_attr(HLF_T
));
628 for (i
= 0; i
< num_matches
&& !got_int
; ++i
)
630 parse_match(matches
[i
], &tagp
);
632 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
634 && i
== ptag_entry
.cur_match
) ||
637 && i
== tagstack
[tagstackidx
].cur_match
)))
641 vim_snprintf((char *)IObuff
+ 1, IOSIZE
- 1,
643 mt_names
[matches
[i
][0] & MT_MASK
]);
645 if (tagp
.tagkind
!= NULL
)
646 msg_outtrans_len(tagp
.tagkind
,
647 (int)(tagp
.tagkind_end
- tagp
.tagkind
));
649 msg_outtrans_len_attr(tagp
.tagname
,
650 (int)(tagp
.tagname_end
- tagp
.tagname
),
653 taglen_advance(taglen
);
655 /* Find out the actual file name. If it is long, truncate
656 * it and put "..." in the middle */
657 p
= tag_full_fname(&tagp
);
660 msg_puts_long_attr(p
, hl_attr(HLF_D
));
669 /* print any extra fields */
670 command_end
= tagp
.command_end
;
671 if (command_end
!= NULL
)
674 while (*p
&& *p
!= '\r' && *p
!= '\n')
679 /* skip "file:" without a value (static tag) */
680 if (STRNCMP(p
, "file:", 5) == 0
681 && vim_isspace(p
[5]))
686 /* skip "kind:<kind>" and "<kind>" */
687 if (p
== tagp
.tagkind
688 || (p
+ 5 == tagp
.tagkind
689 && STRNCMP(p
, "kind:", 5) == 0))
691 p
= tagp
.tagkind_end
;
694 /* print all other extra fields */
695 attr
= hl_attr(HLF_CM
);
696 while (*p
&& *p
!= '\r' && *p
!= '\n')
698 if (msg_col
+ ptr2cells(p
) >= Columns
)
705 p
= msg_outtrans_one(p
, attr
);
708 msg_puts_attr((char_u
*)" ", attr
);
725 for (p
= tagp
.command
;
726 *p
&& *p
!= '\r' && *p
!= '\n'; ++p
)
732 * Put the info (in several lines) at column 15.
733 * Don't display "/^" and "?^".
736 if (*p
== '/' || *p
== '?')
742 /* Remove leading whitespace from pattern */
743 while (p
!= command_end
&& vim_isspace(*p
))
746 while (p
!= command_end
)
748 if (msg_col
+ (*p
== TAB
? 1 : ptr2cells(p
)) > Columns
)
754 /* skip backslash used for escaping command char */
755 if (*p
== '\\' && *(p
+ 1) == *tagp
.command
)
764 p
= msg_outtrans_one(p
, 0);
766 /* don't display the "$/;\"" and "$?;\"" */
767 if (p
== command_end
- 2 && *p
== '$'
768 && *(p
+ 1) == *tagp
.command
)
770 /* don't display matching '/' or '?' */
771 if (p
== command_end
- 1 && *p
== *tagp
.command
772 && (*p
== '/' || *p
== '?'))
780 got_int
= FALSE
; /* only stop the listing */
781 ask_for_selection
= TRUE
;
783 #if defined(FEAT_QUICKFIX) && defined(FEAT_EVAL)
784 else if (type
== DT_LTAG
)
787 char_u tag_name
[128 + 1];
788 char_u fname
[MAXPATHL
+ 1];
789 char_u cmd
[CMDBUFFSIZE
+ 1];
792 * Add the matching tags to the location list for the current
800 for (i
= 0; i
< num_matches
; ++i
)
806 parse_match(matches
[i
], &tagp
);
808 /* Save the tag name */
809 len
= (int)(tagp
.tagname_end
- tagp
.tagname
);
812 vim_strncpy(tag_name
, tagp
.tagname
, len
);
815 /* Save the tag file name */
816 p
= tag_full_fname(&tagp
);
823 * Get the line number or the search pattern used to locate
827 if (isdigit(*tagp
.command
))
828 /* Line number is used to locate the tag */
829 lnum
= atol((char *)tagp
.command
);
832 char_u
*cmd_start
, *cmd_end
;
834 /* Search pattern is used to locate the tag */
836 /* Locate the end of the command */
837 cmd_start
= tagp
.command
;
838 cmd_end
= tagp
.command_end
;
841 for (p
= tagp
.command
;
842 *p
&& *p
!= '\r' && *p
!= '\n'; ++p
)
848 * Now, cmd_end points to the character after the
849 * command. Adjust it to point to the last
850 * character of the command.
855 * Skip the '/' and '?' characters at the
856 * beginning and end of the search pattern.
858 if (*cmd_start
== '/' || *cmd_start
== '?')
861 if (*cmd_end
== '/' || *cmd_end
== '?')
868 * If "^" is present in the tag search pattern, then
871 if (*cmd_start
== '^')
879 * Precede the tag pattern with \V to make it very
885 cmd_len
= (int)(cmd_end
- cmd_start
+ 1);
886 if (cmd_len
> (CMDBUFFSIZE
- 5))
887 cmd_len
= CMDBUFFSIZE
- 5;
888 STRNCAT(cmd
, cmd_start
, cmd_len
);
891 if (cmd
[len
- 1] == '$')
894 * Replace '$' at the end of the search pattern
905 if ((dict
= dict_alloc()) == NULL
)
907 if (list_append_dict(list
, dict
) == FAIL
)
913 dict_add_nr_str(dict
, "text", 0L, tag_name
);
914 dict_add_nr_str(dict
, "filename", 0L, fname
);
915 dict_add_nr_str(dict
, "lnum", lnum
, NULL
);
917 dict_add_nr_str(dict
, "pattern", 0L, cmd
);
920 set_errorlist(curwin
, list
, ' ');
922 list_free(list
, TRUE
);
924 cur_match
= 0; /* Jump to the first tag */
928 if (ask_for_selection
== TRUE
)
931 * Ask to select a tag from the list.
933 i
= prompt_for_number(NULL
);
934 if (i
<= 0 || i
> num_matches
|| got_int
)
936 /* no valid choice: don't change anything */
939 tagstack
[tagstackidx
].fmark
= saved_fmark
;
940 tagstackidx
= prevtagstackidx
;
944 jumped_to_tag
= TRUE
;
951 if (cur_match
>= num_matches
)
953 /* Avoid giving this error when a file wasn't found and we're
954 * looking for a match in another file, which wasn't found.
955 * There will be an EMSG("file doesn't exist") below then. */
956 if ((type
== DT_NEXT
|| type
== DT_FIRST
)
957 && nofile_fname
== NULL
)
959 if (num_matches
== 1)
960 EMSG(_("E427: There is only one matching tag"));
962 EMSG(_("E428: Cannot go beyond last matching tag"));
965 cur_match
= num_matches
- 1;
969 tagstack
[tagstackidx
].cur_match
= cur_match
;
970 tagstack
[tagstackidx
].cur_fnum
= cur_fnum
;
973 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
974 else if (g_do_tagpreview
)
976 ptag_entry
.cur_match
= cur_match
;
977 ptag_entry
.cur_fnum
= cur_fnum
;
982 * Only when going to try the next match, report that the previous
983 * file didn't exist. Otherwise an EMSG() is given below.
985 if (nofile_fname
!= NULL
&& error_cur_match
!= cur_match
)
986 smsg((char_u
*)_("File \"%s\" does not exist"), nofile_fname
);
989 ic
= (matches
[cur_match
][0] & MT_IC_OFF
);
990 if (type
!= DT_SELECT
&& type
!= DT_JUMP
994 && (num_matches
> 1 || ic
)
997 /* Give an indication of the number of matching tags */
998 sprintf((char *)IObuff
, _("tag %d of %d%s"),
1001 max_num_matches
!= MAXCOL
? _(" or more") : "");
1003 STRCAT(IObuff
, _(" Using tag with different case!"));
1004 if ((num_matches
> prev_num_matches
|| new_tag
)
1008 msg_attr(IObuff
, hl_attr(HLF_W
));
1011 msg_scroll
= TRUE
; /* don't overwrite this message */
1014 give_warning(IObuff
, ic
);
1015 if (ic
&& !msg_scrolled
&& msg_silent
== 0)
1018 ui_delay(1000L, TRUE
);
1023 /* Let the SwapExists event know what tag we are jumping to. */
1024 vim_snprintf((char *)IObuff
, IOSIZE
, ":ta %s\r", name
);
1025 set_vim_var_string(VV_SWAPCOMMAND
, IObuff
, -1);
1029 * Jump to the desired match.
1031 i
= jumpto_tag(matches
[cur_match
], forceit
, type
!= DT_CSCOPE
);
1034 set_vim_var_string(VV_SWAPCOMMAND
, NULL
, -1);
1039 /* File not found: try again with another matching tag */
1040 if ((type
== DT_PREV
&& cur_match
> 0)
1041 || ((type
== DT_TAG
|| type
== DT_NEXT
1042 || type
== DT_FIRST
)
1043 && (max_num_matches
!= MAXCOL
1044 || cur_match
< num_matches
- 1)))
1046 error_cur_match
= cur_match
;
1049 if (type
== DT_PREV
)
1058 EMSG2(_("E429: File \"%s\" does not exist"), nofile_fname
);
1062 /* We may have jumped to another window, check that
1063 * tagstackidx is still valid. */
1064 if (use_tagstack
&& tagstackidx
> curwin
->w_tagstacklen
)
1065 tagstackidx
= curwin
->w_tagstackidx
;
1067 jumped_to_tag
= TRUE
;
1075 /* Only store the new index when using the tagstack and it's valid. */
1076 if (use_tagstack
&& tagstackidx
<= curwin
->w_tagstacklen
)
1077 curwin
->w_tagstackidx
= tagstackidx
;
1079 postponed_split
= 0; /* don't split next time */
1083 return jumped_to_tag
;
1095 vim_free(tagmatchname
);
1096 tagmatchname
= NULL
;
1109 msg_advance(13 + l
);
1113 * Print the tag stack
1117 exarg_T
*eap UNUSED
;
1121 taggy_T
*tagstack
= curwin
->w_tagstack
;
1122 int tagstackidx
= curwin
->w_tagstackidx
;
1123 int tagstacklen
= curwin
->w_tagstacklen
;
1125 /* Highlight title */
1126 MSG_PUTS_TITLE(_("\n # TO tag FROM line in file/text"));
1127 for (i
= 0; i
< tagstacklen
; ++i
)
1129 if (tagstack
[i
].tagname
!= NULL
)
1131 name
= fm_getname(&(tagstack
[i
].fmark
), 30);
1132 if (name
== NULL
) /* file name not available */
1136 sprintf((char *)IObuff
, "%c%2d %2d %-15s %5ld ",
1137 i
== tagstackidx
? '>' : ' ',
1139 tagstack
[i
].cur_match
+ 1,
1140 tagstack
[i
].tagname
,
1141 tagstack
[i
].fmark
.mark
.lnum
);
1142 msg_outtrans(IObuff
);
1143 msg_outtrans_attr(name
, tagstack
[i
].fmark
.fnum
== curbuf
->b_fnum
1144 ? hl_attr(HLF_D
) : 0);
1147 out_flush(); /* show one line at a time */
1149 if (tagstackidx
== tagstacklen
) /* idx at top of stack */
1153 /* When not using a CR for line separator, use vim_fgets() to read tag lines.
1154 * For the Mac use tag_fgets(). It can handle any line separator, but is much
1155 * slower than vim_fgets().
1158 # define tag_fgets vim_fgets
1161 #ifdef FEAT_TAG_BINS
1162 static int tag_strnicmp
__ARGS((char_u
*s1
, char_u
*s2
, size_t len
));
1165 * Compare two strings, for length "len", ignoring case the ASCII way.
1166 * return 0 for match, < 0 for smaller, > 0 for bigger
1167 * Make sure case is folded to uppercase in comparison (like for 'sort -f')
1170 tag_strnicmp(s1
, s2
, len
)
1179 i
= (int)TOUPPER_ASC(*s1
) - (int)TOUPPER_ASC(*s2
);
1181 return i
; /* this character different */
1183 break; /* strings match until NUL */
1188 return 0; /* strings match */
1193 * Structure to hold info about the tag pattern being used.
1197 char_u
*pat
; /* the pattern */
1198 int len
; /* length of pat[] */
1199 char_u
*head
; /* start of pattern head */
1200 int headlen
; /* length of head[] */
1201 regmatch_T regmatch
; /* regexp program, may be NULL */
1204 static void prepare_pats
__ARGS((pat_T
*pats
, int has_re
));
1207 * Extract info from the tag search pattern "pats->pat".
1210 prepare_pats(pats
, has_re
)
1214 pats
->head
= pats
->pat
;
1215 pats
->headlen
= pats
->len
;
1218 /* When the pattern starts with '^' or "\\<", binary searching can be
1219 * used (much faster). */
1220 if (pats
->pat
[0] == '^')
1221 pats
->head
= pats
->pat
+ 1;
1222 else if (pats
->pat
[0] == '\\' && pats
->pat
[1] == '<')
1223 pats
->head
= pats
->pat
+ 2;
1224 if (pats
->head
== pats
->pat
)
1227 for (pats
->headlen
= 0; pats
->head
[pats
->headlen
] != NUL
;
1229 if (vim_strchr((char_u
*)(p_magic
? ".[~*\\$" : "\\$"),
1230 pats
->head
[pats
->headlen
]) != NULL
)
1232 if (p_tl
!= 0 && pats
->headlen
> p_tl
) /* adjust for 'taglength' */
1233 pats
->headlen
= p_tl
;
1237 pats
->regmatch
.regprog
= vim_regcomp(pats
->pat
, p_magic
? RE_MAGIC
: 0);
1239 pats
->regmatch
.regprog
= NULL
;
1244 int len
; /* nr of chars of match[] to be compared */
1245 char_u match
[1]; /* actually longer */
1249 find_tfu_tags(char_u
*pat
, garray_T
*ga
, int *match_count
)
1253 listitem_T
*item
, *item2
;
1255 const int nfieds_required
= 3;
1259 static int call_level
= 0;
1262 args
[1] = g_tag_at_cursor
? "c": "";
1264 /* Prevent endless loop: */
1269 if (*curbuf
->b_p_tfu
== NUL
)
1272 pos
= curwin
->w_cursor
;
1273 taglist
= call_func_retlist(curbuf
->b_p_tfu
, 2, args
, FALSE
);
1274 curwin
->w_cursor
= pos
; /* restore the cursor position */
1276 if (taglist
== NULL
)
1279 for (item
= taglist
->lv_first
; item
!= NULL
; item
= item
->li_next
)
1281 struct match_found
*mfp
;
1283 if (item
->li_tv
.v_type
!= VAR_LIST
)
1285 /* FIXME:2010-04-24:llorens: ... */
1288 if (item
->li_tv
.vval
.v_list
->lv_len
!= nfieds_required
)
1290 /* FIXME:2010-04-24:llorens: ... */
1293 #ifdef FEAT_EMACS_TAGS
1298 len
+= nfieds_required
;
1300 for (item2
= item
->li_tv
.vval
.v_list
->lv_first
;
1302 item2
= item2
->li_next
)
1304 if (item2
->li_tv
.v_type
!= VAR_STRING
)
1306 /* FIXME:2010-04-24:llorens: ... */
1309 len
+= STRLEN(item2
->li_tv
.vval
.v_string
);
1312 mfp
= (struct match_found
*)alloc(
1313 (int)sizeof(struct match_found
) + len
);
1320 p
[1] = NUL
; /* no tag file name */
1322 #ifdef FEAT_EMACS_TAGS
1326 for (item2
= item
->li_tv
.vval
.v_list
->lv_first
;
1328 item2
= item2
->li_next
)
1330 STRCPY(p
, item2
->li_tv
.vval
.v_string
);
1331 p
+= STRLEN(item2
->li_tv
.vval
.v_string
);
1332 if (item2
->li_next
!= NULL
)
1338 /* FIXME:2010-04-24:llorens: Don't add identical matches. */
1339 if (ga_grow(ga
, 1) == OK
)
1341 ((struct match_found
**)(ga
->ga_data
)) [ga
->ga_len
++] = mfp
;
1350 list_free(taglist
, TRUE
);
1353 *match_count
= ntags
;
1358 * find_tags() - search for tags in tags files
1360 * Return FAIL if search completely failed (*num_matches will be 0, *matchesp
1361 * will be NULL), OK otherwise.
1363 * There is a priority in which type of tag is recognized.
1365 * 6. A static or global tag with a full matching tag for the current file.
1366 * 5. A global tag with a full matching tag for another file.
1367 * 4. A static tag with a full matching tag for another file.
1368 * 3. A static or global tag with an ignore-case matching tag for the
1370 * 2. A global tag with an ignore-case matching tag for another file.
1371 * 1. A static tag with an ignore-case matching tag for another file.
1373 * Tags in an emacs-style tags file are always global.
1376 * TAG_HELP only search for help tags
1377 * TAG_NAMES only return name of tag
1378 * TAG_REGEXP use "pat" as a regexp
1379 * TAG_NOIC don't always ignore case
1380 * TAG_KEEP_LANG keep language
1383 find_tags(pat
, num_matches
, matchesp
, flags
, mincount
, buf_ffname
)
1384 char_u
*pat
; /* pattern to search for */
1385 int *num_matches
; /* return: number of matches found */
1386 char_u
***matchesp
; /* return: array of matches found */
1388 int mincount
; /* MAXCOL: find all matches
1389 other: minimal number of matches */
1390 char_u
*buf_ffname
; /* name of buffer for priority */
1393 char_u
*lbuf
; /* line buffer */
1394 char_u
*tag_fname
; /* name of tag file */
1395 tagname_T tn
; /* info for get_tagfname() */
1396 int first_file
; /* trying first tag file */
1398 int did_open
= FALSE
; /* did open a tag file */
1399 int stop_searching
= FALSE
; /* stop when match found or error */
1400 int retval
= FAIL
; /* return value */
1401 int is_static
; /* current tag line is static */
1402 int is_current
; /* file name matches */
1403 int eof
= FALSE
; /* found end-of-file */
1407 #ifdef FEAT_TAG_BINS
1408 struct tag_search_info
/* Binary search file offsets */
1410 off_t low_offset
; /* offset for first char of first line that
1412 off_t high_offset
; /* offset of char after last line that could
1414 off_t curr_offset
; /* Current file offset in search range */
1415 off_t curr_offset_used
; /* curr_offset used when skipping back */
1416 off_t match_offset
; /* Where the binary search found a tag */
1417 int low_char
; /* first char at low_offset */
1418 int high_char
; /* first char at high_offset */
1427 TS_START
, /* at start of file */
1428 TS_LINEAR
/* linear searching forward, till EOF */
1429 #ifdef FEAT_TAG_BINS
1430 , TS_BINARY
, /* binary searching */
1431 TS_SKIP_BACK
, /* skipping backwards */
1432 TS_STEP_FORWARD
/* stepping forwards */
1434 } state
; /* Current search state */
1437 int match
; /* matches */
1438 int match_no_ic
= 0;/* matches with rm_ic == FALSE */
1439 int match_re
; /* match with regexp */
1442 #ifdef FEAT_EMACS_TAGS
1444 * Stack for included emacs-tags file.
1445 * It has a fixed size, to truncate cyclic includes. jw
1447 # define INCSTACK_SIZE 42
1452 } incstack
[INCSTACK_SIZE
];
1454 int incstack_idx
= 0; /* index in incstack */
1455 char_u
*ebuf
; /* additional buffer for etag fname */
1456 int is_etag
; /* current file is emaces style */
1459 struct match_found
*mfp
, *mfp2
;
1460 garray_T ga_match
[MT_COUNT
];
1461 int match_count
= 0; /* number of matches found */
1466 #ifdef FEAT_MULTI_LANG
1468 char_u
*help_lang_find
= NULL
; /* lang to be found */
1469 char_u help_lang
[3]; /* lang of current tags file */
1470 char_u
*saved_pat
= NULL
; /* copy of pat[] */
1473 /* Use two sets of variables for the pattern: "orgpat" holds the values
1474 * for the original pattern and "convpat" converted from 'encoding' to
1475 * encoding of the tags file. "pats" point to either one of these. */
1477 pat_T orgpat
; /* holds unconverted pattern info */
1479 pat_T convpat
; /* holds converted pattern info */
1483 #ifdef FEAT_TAG_BINS
1484 int findall
= (mincount
== MAXCOL
|| mincount
== TAG_MANY
);
1485 /* find all matching tags */
1486 int sort_error
= FALSE
; /* tags file not sorted */
1487 int linear
; /* do a linear search */
1488 int sortic
= FALSE
; /* tag file sorted in nocase */
1490 int line_error
= FALSE
; /* syntax error */
1491 int has_re
= (flags
& TAG_REGEXP
); /* regexp used */
1492 int help_only
= (flags
& TAG_HELP
);
1493 int name_only
= (flags
& TAG_NAMES
);
1494 int noic
= (flags
& TAG_NOIC
);
1495 int get_it_again
= FALSE
;
1497 int use_cscope
= (flags
& TAG_CSCOPE
);
1499 int verbose
= (flags
& TAG_VERBOSE
);
1500 int use_tfu
= (flags
& TAG_USE_TFU
);
1502 help_save
= curbuf
->b_help
;
1506 vimconv
.vc_type
= CONV_NONE
;
1510 * Allocate memory for the buffers that are used
1512 lbuf
= alloc(LSIZE
);
1513 tag_fname
= alloc(MAXPATHL
+ 1);
1514 #ifdef FEAT_EMACS_TAGS
1515 ebuf
= alloc(LSIZE
);
1517 for (mtt
= 0; mtt
< MT_COUNT
; ++mtt
)
1518 ga_init2(&ga_match
[mtt
], (int)sizeof(struct match_found
*), 100);
1520 /* check for out of memory situation */
1521 if (lbuf
== NULL
|| tag_fname
== NULL
1522 #ifdef FEAT_EMACS_TAGS
1529 STRCPY(tag_fname
, "from cscope"); /* for error messages */
1533 * Initialize a few variables
1535 if (help_only
) /* want tags from help file */
1536 curbuf
->b_help
= TRUE
; /* will be restored later */
1538 pats
->len
= (int)STRLEN(pat
);
1539 #ifdef FEAT_MULTI_LANG
1542 /* When "@ab" is specified use only the "ab" language, otherwise
1543 * search all languages. */
1544 if (pats
->len
> 3 && pat
[pats
->len
- 3] == '@'
1545 && ASCII_ISALPHA(pat
[pats
->len
- 2])
1546 && ASCII_ISALPHA(pat
[pats
->len
- 1]))
1548 saved_pat
= vim_strnsave(pat
, pats
->len
- 3);
1549 if (saved_pat
!= NULL
)
1551 help_lang_find
= &pat
[pats
->len
- 2];
1552 pats
->pat
= saved_pat
;
1558 if (p_tl
!= 0 && pats
->len
> p_tl
) /* adjust for 'taglength' */
1561 prepare_pats(pats
, has_re
);
1563 #ifdef FEAT_TAG_BINS
1564 /* This is only to avoid a compiler warning for using search_info
1566 vim_memset(&search_info
, 0, (size_t)1);
1571 retval
= find_tfu_tags(pat
, &ga_match
[0], &match_count
);
1576 * When finding a specified number of matches, first try with matching
1577 * case, so binary search can be used, and try ignore-case matches in a
1579 * When finding all matches, 'tagbsearch' is off, or there is no fixed
1580 * string to look for, ignore case right away to avoid going though the
1582 * When the tag file is case-fold sorted, it is either one or the other.
1583 * Only ignore case when TAG_NOIC not used or 'ignorecase' set.
1585 #ifdef FEAT_TAG_BINS
1586 pats
->regmatch
.rm_ic
= ((p_ic
|| !noic
)
1587 && (findall
|| pats
->headlen
== 0 || !p_tbs
));
1588 for (round
= 1; round
<= 2; ++round
)
1590 linear
= (pats
->headlen
== 0 || !p_tbs
|| round
== 2);
1592 pats
->regmatch
.rm_ic
= (p_ic
|| !noic
);
1596 * Try tag file names from tags option one by one.
1598 for (first_file
= TRUE
;
1602 get_tagfname(&tn
, first_file
, tag_fname
) == OK
;
1606 * A file that doesn't exist is silently ignored. Only when not a
1607 * single file is found, an error message is given (further on).
1611 fp
= NULL
; /* avoid GCC warning */
1615 #ifdef FEAT_MULTI_LANG
1618 /* Prefer help tags according to 'helplang'. Put the
1619 * two-letter language name in help_lang[]. */
1620 i
= (int)STRLEN(tag_fname
);
1621 if (i
> 3 && tag_fname
[i
- 3] == '-')
1622 STRCPY(help_lang
, tag_fname
+ i
- 2);
1624 STRCPY(help_lang
, "en");
1626 /* When searching for a specific language skip tags files
1627 * for other languages. */
1628 if (help_lang_find
!= NULL
1629 && STRICMP(help_lang
, help_lang_find
) != 0)
1632 /* For CTRL-] in a help file prefer a match with the same
1634 if ((flags
& TAG_KEEP_LANG
)
1635 && help_lang_find
== NULL
1636 && curbuf
->b_fname
!= NULL
1637 && (i
= (int)STRLEN(curbuf
->b_fname
)) > 4
1638 && curbuf
->b_fname
[i
- 1] == 'x'
1639 && curbuf
->b_fname
[i
- 4] == '.'
1640 && STRNICMP(curbuf
->b_fname
+ i
- 3, help_lang
, 2) == 0)
1645 for (s
= p_hlg
; *s
!= NUL
; ++s
)
1647 if (STRNICMP(s
, help_lang
, 2) == 0)
1650 if ((s
= vim_strchr(s
, ',')) == NULL
)
1653 if (s
== NULL
|| *s
== NUL
)
1655 /* Language not in 'helplang': use last, prefer English,
1656 * unless found already. */
1658 if (STRICMP(help_lang
, "en") != 0)
1665 if ((fp
= mch_fopen((char *)tag_fname
, "r")) == NULL
)
1671 smsg((char_u
*)_("Searching tags file %s"), tag_fname
);
1675 did_open
= TRUE
; /* remember that we found at least one file */
1677 state
= TS_START
; /* we're at the start of the file */
1678 #ifdef FEAT_EMACS_TAGS
1679 is_etag
= 0; /* default is: not emacs style */
1683 * Read and parse the lines in the file one by one
1687 line_breakcheck(); /* check for CTRL-C typed */
1688 #ifdef FEAT_INS_EXPAND
1689 if ((flags
& TAG_INS_COMP
)) /* Double brackets for gcc */
1690 ins_compl_check_keys(30);
1691 if (got_int
|| compl_interrupted
)
1696 stop_searching
= TRUE
;
1699 /* When mincount is TAG_MANY, stop when enough matches have been
1700 * found (for completion). */
1701 if (mincount
== TAG_MANY
&& match_count
>= TAG_MANY
)
1703 stop_searching
= TRUE
;
1709 #ifdef FEAT_TAG_BINS
1711 * For binary search: compute the next offset to use.
1713 if (state
== TS_BINARY
)
1715 offset
= search_info
.low_offset
+ ((search_info
.high_offset
1716 - search_info
.low_offset
) / 2);
1717 if (offset
== search_info
.curr_offset
)
1718 break; /* End the binary search without a match. */
1720 search_info
.curr_offset
= offset
;
1724 * Skipping back (after a match during binary search).
1726 else if (state
== TS_SKIP_BACK
)
1728 search_info
.curr_offset
-= LSIZE
* 2;
1729 if (search_info
.curr_offset
< 0)
1731 search_info
.curr_offset
= 0;
1733 state
= TS_STEP_FORWARD
;
1738 * When jumping around in the file, first read a line to find the
1739 * start of the next line.
1741 if (state
== TS_BINARY
|| state
== TS_SKIP_BACK
)
1743 /* Adjust the search file offset to the correct position */
1744 search_info
.curr_offset_used
= search_info
.curr_offset
;
1746 fseeko(fp
, search_info
.curr_offset
, SEEK_SET
);
1748 fseek(fp
, (long)search_info
.curr_offset
, SEEK_SET
);
1750 eof
= tag_fgets(lbuf
, LSIZE
, fp
);
1751 if (!eof
&& search_info
.curr_offset
!= 0)
1753 /* The explicit cast is to work around a bug in gcc 3.4.2
1754 * (repeated below). */
1755 search_info
.curr_offset
= ftell(fp
);
1756 if (search_info
.curr_offset
== search_info
.high_offset
)
1758 /* oops, gone a bit too far; try from low offset */
1760 fseeko(fp
, search_info
.low_offset
, SEEK_SET
);
1762 fseek(fp
, (long)search_info
.low_offset
, SEEK_SET
);
1764 search_info
.curr_offset
= search_info
.low_offset
;
1766 eof
= tag_fgets(lbuf
, LSIZE
, fp
);
1768 /* skip empty and blank lines */
1769 while (!eof
&& vim_isblankline(lbuf
))
1771 search_info
.curr_offset
= ftell(fp
);
1772 eof
= tag_fgets(lbuf
, LSIZE
, fp
);
1776 /* Hit end of file. Skip backwards. */
1777 state
= TS_SKIP_BACK
;
1778 search_info
.match_offset
= ftell(fp
);
1779 search_info
.curr_offset
= search_info
.curr_offset_used
;
1785 * Not jumping around in the file: Read the next line.
1790 /* skip empty and blank lines */
1795 eof
= cs_fgets(lbuf
, LSIZE
);
1798 eof
= tag_fgets(lbuf
, LSIZE
, fp
);
1799 } while (!eof
&& vim_isblankline(lbuf
));
1803 #ifdef FEAT_EMACS_TAGS
1804 if (incstack_idx
) /* this was an included file */
1807 fclose(fp
); /* end of this file ... */
1808 fp
= incstack
[incstack_idx
].fp
;
1809 STRCPY(tag_fname
, incstack
[incstack_idx
].etag_fname
);
1810 vim_free(incstack
[incstack_idx
].etag_fname
);
1811 is_etag
= 1; /* (only etags can include) */
1812 continue; /* ... continue with parent file */
1816 break; /* end of file */
1821 #ifdef FEAT_EMACS_TAGS
1823 * Emacs tags line with CTRL-L: New file name on next line.
1824 * The file name is followed by a ','.
1826 if (*lbuf
== Ctrl_L
) /* remember etag file name in ebuf */
1828 is_etag
= 1; /* in case at the start */
1830 if (!tag_fgets(ebuf
, LSIZE
, fp
))
1832 for (p
= ebuf
; *p
&& *p
!= ','; p
++)
1837 * atoi(p+1) is the number of bytes before the next ^L
1838 * unless it is an include statement.
1840 if (STRNCMP(p
+ 1, "include", 7) == 0
1841 && incstack_idx
< INCSTACK_SIZE
)
1843 /* Save current "fp" and "tag_fname" in the stack. */
1844 if ((incstack
[incstack_idx
].etag_fname
=
1845 vim_strsave(tag_fname
)) != NULL
)
1847 char_u
*fullpath_ebuf
;
1849 incstack
[incstack_idx
].fp
= fp
;
1852 /* Figure out "tag_fname" and "fp" to use for
1854 fullpath_ebuf
= expand_tag_fname(ebuf
,
1856 if (fullpath_ebuf
!= NULL
)
1858 fp
= mch_fopen((char *)fullpath_ebuf
, "r");
1861 if (STRLEN(fullpath_ebuf
) > LSIZE
)
1862 EMSG2(_("E430: Tag file path truncated for %s\n"), ebuf
);
1863 vim_strncpy(tag_fname
, fullpath_ebuf
,
1866 is_etag
= 0; /* we can include anything */
1868 vim_free(fullpath_ebuf
);
1872 /* Can't open the included file, skip it and
1873 * restore old value of "fp". */
1874 fp
= incstack
[incstack_idx
].fp
;
1875 vim_free(incstack
[incstack_idx
].etag_fname
);
1885 * When still at the start of the file, check for Emacs tags file
1886 * format, and for "not sorted" flag.
1888 if (state
== TS_START
)
1890 #ifdef FEAT_TAG_BINS
1892 * When there is no tag head, or ignoring case, need to do a
1894 * When no "!_TAG_" is found, default to binary search. If
1895 * the tag file isn't sorted, the second loop will find it.
1896 * When "!_TAG_FILE_SORTED" found: start binary search if
1898 * For cscope, it's always linear.
1901 if (linear
|| use_cscope
)
1906 else if (STRNCMP(lbuf
, "!_TAG_", 6) > 0)
1908 else if (STRNCMP(lbuf
, "!_TAG_FILE_SORTED\t", 18) == 0)
1910 /* Check sorted flag */
1911 if (lbuf
[18] == '1')
1913 else if (lbuf
[18] == '2')
1917 pats
->regmatch
.rm_ic
= (p_ic
|| !noic
);
1923 if (state
== TS_BINARY
&& pats
->regmatch
.rm_ic
&& !sortic
)
1925 /* binary search won't work for ignoring case, use linear
1934 #ifdef FEAT_TAG_BINS
1936 * When starting a binary search, get the size of the file and
1937 * compute the first offset.
1939 if (state
== TS_BINARY
)
1941 /* Get the tag file size (don't use mch_fstat(), it's not
1943 if ((filesize
= lseek(fileno(fp
),
1944 (off_t
)0L, SEEK_END
)) <= 0)
1948 lseek(fileno(fp
), (off_t
)0L, SEEK_SET
);
1950 /* Calculate the first read offset in the file. Start
1951 * the search in the middle of the file. */
1952 search_info
.low_offset
= 0;
1953 search_info
.low_char
= 0;
1954 search_info
.high_offset
= filesize
;
1955 search_info
.curr_offset
= 0;
1956 search_info
.high_char
= 0xff;
1964 if (lbuf
[0] == '!' && pats
== &orgpat
1965 && STRNCMP(lbuf
, "!_TAG_FILE_ENCODING\t", 20) == 0)
1967 /* Convert the search pattern from 'encoding' to the
1968 * specified encoding. */
1969 for (p
= lbuf
+ 20; *p
> ' ' && *p
< 127; ++p
)
1972 convert_setup(&vimconv
, p_enc
, lbuf
+ 20);
1973 if (vimconv
.vc_type
!= CONV_NONE
)
1975 convpat
.pat
= string_convert(&vimconv
, pats
->pat
, NULL
);
1976 if (convpat
.pat
!= NULL
)
1979 pats
->len
= (int)STRLEN(pats
->pat
);
1980 prepare_pats(pats
, has_re
);
1981 pats
->regmatch
.rm_ic
= orgpat
.regmatch
.rm_ic
;
1985 /* Prepare for converting a match the other way around. */
1986 convert_setup(&vimconv
, lbuf
+ 20, p_enc
);
1992 * Figure out where the different strings are in this line.
1993 * For "normal" tags: Do a quick check if the tag matches.
1994 * This speeds up tag searching a lot!
1997 #ifdef FEAT_EMACS_TAGS
2002 tagp
.tagname
= lbuf
;
2003 #ifdef FEAT_TAG_ANYWHITE
2004 tagp
.tagname_end
= skiptowhite(lbuf
);
2005 if (*tagp
.tagname_end
== NUL
) /* corrupted tag line */
2007 tagp
.tagname_end
= vim_strchr(lbuf
, TAB
);
2008 if (tagp
.tagname_end
== NULL
) /* corrupted tag line */
2015 #ifdef FEAT_TAG_OLDSTATIC
2017 * Check for old style static tag: "file:tag file .."
2020 for (p
= lbuf
; p
< tagp
.tagname_end
; ++p
)
2024 if (tagp
.fname
== NULL
)
2025 #ifdef FEAT_TAG_ANYWHITE
2026 tagp
.fname
= skipwhite(tagp
.tagname_end
);
2028 tagp
.fname
= tagp
.tagname_end
+ 1;
2030 if ( fnamencmp(lbuf
, tagp
.fname
, p
- lbuf
) == 0
2031 #ifdef FEAT_TAG_ANYWHITE
2032 && vim_iswhite(tagp
.fname
[p
- lbuf
])
2034 && tagp
.fname
[p
- lbuf
] == TAB
2039 tagp
.tagname
= p
+ 1;
2047 * Skip this line if the length of the tag is different and
2048 * there is no regexp, or the tag is too short.
2050 cmplen
= (int)(tagp
.tagname_end
- tagp
.tagname
);
2051 if (p_tl
!= 0 && cmplen
> p_tl
) /* adjust for 'taglength' */
2053 if (has_re
&& pats
->headlen
< cmplen
)
2054 cmplen
= pats
->headlen
;
2055 else if (state
== TS_LINEAR
&& pats
->headlen
!= cmplen
)
2058 #ifdef FEAT_TAG_BINS
2059 if (state
== TS_BINARY
)
2062 * Simplistic check for unsorted tags file.
2064 i
= (int)tagp
.tagname
[0];
2066 i
= (int)TOUPPER_ASC(tagp
.tagname
[0]);
2067 if (i
< search_info
.low_char
|| i
> search_info
.high_char
)
2071 * Compare the current tag with the searched tag.
2074 tagcmp
= tag_strnicmp(tagp
.tagname
, pats
->head
,
2077 tagcmp
= STRNCMP(tagp
.tagname
, pats
->head
, cmplen
);
2080 * A match with a shorter tag means to search forward.
2081 * A match with a longer tag means to search backward.
2085 if (cmplen
< pats
->headlen
)
2087 else if (cmplen
> pats
->headlen
)
2093 /* We've located the tag, now skip back and search
2094 * forward until the first matching tag is found.
2096 state
= TS_SKIP_BACK
;
2097 search_info
.match_offset
= search_info
.curr_offset
;
2102 search_info
.curr_offset
= ftell(fp
);
2103 if (search_info
.curr_offset
< search_info
.high_offset
)
2105 search_info
.low_offset
= search_info
.curr_offset
;
2107 search_info
.low_char
=
2108 TOUPPER_ASC(tagp
.tagname
[0]);
2110 search_info
.low_char
= tagp
.tagname
[0];
2115 && search_info
.curr_offset
!= search_info
.high_offset
)
2117 search_info
.high_offset
= search_info
.curr_offset
;
2119 search_info
.high_char
=
2120 TOUPPER_ASC(tagp
.tagname
[0]);
2122 search_info
.high_char
= tagp
.tagname
[0];
2126 /* No match yet and are at the end of the binary search. */
2129 else if (state
== TS_SKIP_BACK
)
2131 if (MB_STRNICMP(tagp
.tagname
, pats
->head
, cmplen
) != 0)
2132 state
= TS_STEP_FORWARD
;
2134 /* Have to skip back more. Restore the curr_offset
2135 * used, otherwise we get stuck at a long line. */
2136 search_info
.curr_offset
= search_info
.curr_offset_used
;
2139 else if (state
== TS_STEP_FORWARD
)
2141 if (MB_STRNICMP(tagp
.tagname
, pats
->head
, cmplen
) != 0)
2143 if ((off_t
)ftell(fp
) > search_info
.match_offset
)
2144 break; /* past last match */
2146 continue; /* before first match */
2151 /* skip this match if it can't match */
2152 if (MB_STRNICMP(tagp
.tagname
, pats
->head
, cmplen
) != 0)
2156 * Can be a matching tag, isolate the file name and command.
2158 #ifdef FEAT_TAG_OLDSTATIC
2159 if (tagp
.fname
== NULL
)
2161 #ifdef FEAT_TAG_ANYWHITE
2162 tagp
.fname
= skipwhite(tagp
.tagname_end
);
2164 tagp
.fname
= tagp
.tagname_end
+ 1;
2166 #ifdef FEAT_TAG_ANYWHITE
2167 tagp
.fname_end
= skiptowhite(tagp
.fname
);
2168 tagp
.command
= skipwhite(tagp
.fname_end
);
2169 if (*tagp
.command
== NUL
)
2171 tagp
.fname_end
= vim_strchr(tagp
.fname
, TAB
);
2172 tagp
.command
= tagp
.fname_end
+ 1;
2173 if (tagp
.fname_end
== NULL
)
2180 i
= parse_tag_line(lbuf
,
2181 #ifdef FEAT_EMACS_TAGS
2191 #ifdef FEAT_EMACS_TAGS
2196 * First try matching with the pattern literally (also when it is
2199 cmplen
= (int)(tagp
.tagname_end
- tagp
.tagname
);
2200 if (p_tl
!= 0 && cmplen
> p_tl
) /* adjust for 'taglength' */
2202 /* if tag length does not match, don't try comparing */
2203 if (pats
->len
!= cmplen
)
2207 if (pats
->regmatch
.rm_ic
)
2209 match
= (MB_STRNICMP(tagp
.tagname
, pats
->pat
, cmplen
) == 0);
2211 match_no_ic
= (STRNCMP(tagp
.tagname
, pats
->pat
,
2215 match
= (STRNCMP(tagp
.tagname
, pats
->pat
, cmplen
) == 0);
2219 * Has a regexp: Also find tags matching regexp.
2222 if (!match
&& pats
->regmatch
.regprog
!= NULL
)
2226 cc
= *tagp
.tagname_end
;
2227 *tagp
.tagname_end
= NUL
;
2228 match
= vim_regexec(&pats
->regmatch
, tagp
.tagname
, (colnr_T
)0);
2231 matchoff
= (int)(pats
->regmatch
.startp
[0] - tagp
.tagname
);
2232 if (pats
->regmatch
.rm_ic
)
2234 pats
->regmatch
.rm_ic
= FALSE
;
2235 match_no_ic
= vim_regexec(&pats
->regmatch
, tagp
.tagname
,
2237 pats
->regmatch
.rm_ic
= TRUE
;
2240 *tagp
.tagname_end
= cc
;
2245 * If a match is found, add it to ga_match[].
2252 /* Don't change the ordering, always use the same table. */
2258 /* Decide in which array to store this match. */
2259 is_current
= test_for_current(
2260 #ifdef FEAT_EMACS_TAGS
2263 tagp
.fname
, tagp
.fname_end
, tag_fname
,
2265 #ifdef FEAT_EMACS_TAGS
2267 if (!is_etag
) /* emacs tags are never static */
2270 #ifdef FEAT_TAG_OLDSTATIC
2271 if (tagp
.tagname
!= lbuf
)
2272 is_static
= TRUE
; /* detected static tag before */
2275 is_static
= test_for_static(&tagp
);
2278 /* decide in which of the sixteen tables to store this
2294 if (pats
->regmatch
.rm_ic
&& !match_no_ic
)
2301 * Add the found match in ga_match[mtt], avoiding duplicates.
2302 * Store the info we need later, which depends on the kind of
2303 * tags we are dealing with.
2305 if (ga_grow(&ga_match
[mtt
], 1) == OK
)
2308 char_u
*conv_line
= NULL
;
2309 char_u
*lbuf_line
= lbuf
;
2311 if (vimconv
.vc_type
!= CONV_NONE
)
2313 /* Convert the tag line from the encoding of the tags
2314 * file to 'encoding'. Then parse the line again. */
2315 conv_line
= string_convert(&vimconv
, lbuf
, NULL
);
2316 if (conv_line
!= NULL
)
2318 if (parse_tag_line(conv_line
,
2319 #ifdef FEAT_EMACS_TAGS
2323 lbuf_line
= conv_line
;
2325 /* doesn't work, go back to unconverted line. */
2326 (void)parse_tag_line(lbuf
,
2327 #ifdef FEAT_EMACS_TAGS
2334 # define lbuf_line lbuf
2338 #ifdef FEAT_MULTI_LANG
2344 * Append the help-heuristic number after the
2345 * tagname, for sorting it later.
2347 *tagp
.tagname_end
= NUL
;
2348 len
= (int)(tagp
.tagname_end
- tagp
.tagname
);
2349 mfp
= (struct match_found
*)
2350 alloc((int)sizeof(struct match_found
) + len
2354 /* "len" includes the language and the NUL, but
2355 * not the priority. */
2356 mfp
->len
= len
+ ML_EXTRA
+ 1;
2357 #define ML_HELP_LEN 6
2359 STRCPY(p
, tagp
.tagname
);
2360 #ifdef FEAT_MULTI_LANG
2362 STRCPY(p
+ len
+ 1, help_lang
);
2364 sprintf((char *)p
+ len
+ 1 + ML_EXTRA
, "%06d",
2365 help_heuristic(tagp
.tagname
,
2366 match_re
? matchoff
: 0, !match_no_ic
)
2367 #ifdef FEAT_MULTI_LANG
2372 *tagp
.tagname_end
= TAB
;
2378 char_u
*temp_end
= tagp
.command
;
2380 if (*temp_end
== '/')
2381 while (*temp_end
&& *temp_end
!= '\r'
2382 && *temp_end
!= '\n'
2383 && *temp_end
!= '$')
2386 if (tagp
.command
+ 2 < temp_end
)
2388 len
= (int)(temp_end
- tagp
.command
- 2);
2389 mfp
= (struct match_found
*)alloc(
2390 (int)sizeof(struct match_found
) + len
);
2393 mfp
->len
= len
+ 1; /* include the NUL */
2395 vim_strncpy(p
, tagp
.command
+ 2, len
);
2400 get_it_again
= FALSE
;
2404 len
= (int)(tagp
.tagname_end
- tagp
.tagname
);
2405 mfp
= (struct match_found
*)alloc(
2406 (int)sizeof(struct match_found
) + len
);
2409 mfp
->len
= len
+ 1; /* include the NUL */
2411 vim_strncpy(p
, tagp
.tagname
, len
);
2414 /* if wanted, re-read line to get long form too */
2416 get_it_again
= p_sft
;
2421 /* Save the tag in a buffer.
2422 * Emacs tag: <mtt><tag_fname><NUL><ebuf><NUL><lbuf>
2423 * other tag: <mtt><tag_fname><NUL><NUL><lbuf>
2424 * without Emacs tags: <mtt><tag_fname><NUL><lbuf>
2426 len
= (int)STRLEN(tag_fname
)
2427 + (int)STRLEN(lbuf_line
) + 3;
2428 #ifdef FEAT_EMACS_TAGS
2430 len
+= (int)STRLEN(ebuf
) + 1;
2434 mfp
= (struct match_found
*)alloc(
2435 (int)sizeof(struct match_found
) + len
);
2441 STRCPY(p
+ 1, tag_fname
);
2442 #ifdef BACKSLASH_IN_FILENAME
2443 /* Ignore differences in slashes, avoid adding
2444 * both path/file and path\file. */
2445 slash_adjust(p
+ 1);
2447 s
= p
+ 1 + STRLEN(tag_fname
) + 1;
2448 #ifdef FEAT_EMACS_TAGS
2452 s
+= STRLEN(ebuf
) + 1;
2457 STRCPY(s
, lbuf_line
);
2464 * Don't add identical matches.
2465 * This can take a lot of time when finding many
2466 * matches, check for CTRL-C now and then.
2467 * Add all cscope tags, because they are all listed.
2474 for (i
= ga_match
[mtt
].ga_len
; --i
>= 0 && !got_int
; )
2476 mfp2
= ((struct match_found
**)
2477 (ga_match
[mtt
].ga_data
))[i
];
2478 if (mfp2
->len
== mfp
->len
2479 && vim_memcmp(mfp2
->match
, mfp
->match
,
2480 (size_t)mfp
->len
) == 0)
2486 ((struct match_found
**)(ga_match
[mtt
].ga_data
))
2487 [ga_match
[mtt
].ga_len
++] = mfp
;
2494 /* Note: this makes the values in "tagp" invalid! */
2495 vim_free(conv_line
);
2498 else /* Out of memory! Just forget about the rest. */
2501 stop_searching
= TRUE
;
2506 if (use_cscope
&& eof
)
2513 EMSG2(_("E431: Format error in tags file \"%s\""), tag_fname
);
2517 EMSGN(_("Before byte %ld"), (long)ftell(fp
));
2518 stop_searching
= TRUE
;
2526 #ifdef FEAT_EMACS_TAGS
2527 while (incstack_idx
)
2530 fclose(incstack
[incstack_idx
].fp
);
2531 vim_free(incstack
[incstack_idx
].etag_fname
);
2535 if (pats
== &convpat
)
2537 /* Go back from converted pattern to original pattern. */
2538 vim_free(pats
->pat
);
2539 vim_free(pats
->regmatch
.regprog
);
2540 orgpat
.regmatch
.rm_ic
= pats
->regmatch
.rm_ic
;
2543 if (vimconv
.vc_type
!= CONV_NONE
)
2544 convert_setup(&vimconv
, NULL
, NULL
);
2547 #ifdef FEAT_TAG_BINS
2550 EMSG2(_("E432: Tags file not sorted: %s"), tag_fname
);
2556 * Stop searching if sufficient tags have been found.
2558 if (match_count
>= mincount
)
2561 stop_searching
= TRUE
;
2565 if (stop_searching
|| use_cscope
)
2571 } /* end of for-each-file loop */
2578 #ifdef FEAT_TAG_BINS
2579 /* stop searching when already did a linear search, or when TAG_NOIC
2580 * used, and 'ignorecase' not set or already did case-ignore search */
2581 if (stop_searching
|| linear
|| (!p_ic
&& noic
) || pats
->regmatch
.rm_ic
)
2587 pats
->regmatch
.rm_ic
= TRUE
; /* try another time while ignoring case */
2591 if (!stop_searching
)
2593 if (!did_open
&& verbose
) /* never opened any tags file */
2594 EMSG(_("E433: No tags file"));
2595 retval
= OK
; /* It's OK even when no tag found */
2600 vim_free(pats
->regmatch
.regprog
);
2601 vim_free(tag_fname
);
2602 #ifdef FEAT_EMACS_TAGS
2607 * Move the matches from the ga_match[] arrays into one list of
2608 * matches. When retval == FAIL, free the matches.
2613 if (match_count
> 0)
2614 matches
= (char_u
**)lalloc((long_u
)(match_count
* sizeof(char_u
*)),
2619 for (mtt
= 0; mtt
< MT_COUNT
; ++mtt
)
2621 for (i
= 0; i
< ga_match
[mtt
].ga_len
; ++i
)
2623 mfp
= ((struct match_found
**)(ga_match
[mtt
].ga_data
))[i
];
2624 if (matches
== NULL
)
2628 /* To avoid allocating memory again we turn the struct
2629 * match_found into a string. For help the priority was not
2630 * included in the length. */
2631 mch_memmove(mfp
, mfp
->match
,
2632 (size_t)(mfp
->len
+ (help_only
? ML_HELP_LEN
: 0)));
2633 matches
[match_count
++] = (char_u
*)mfp
;
2636 ga_clear(&ga_match
[mtt
]);
2639 *matchesp
= matches
;
2640 *num_matches
= match_count
;
2642 curbuf
->b_help
= help_save
;
2643 #ifdef FEAT_MULTI_LANG
2644 vim_free(saved_pat
);
2650 static garray_T tag_fnames
= GA_EMPTY
;
2651 static void found_tagfile_cb
__ARGS((char_u
*fname
, void *cookie
));
2654 * Callback function for finding all "tags" and "tags-??" files in
2655 * 'runtimepath' doc directories.
2658 found_tagfile_cb(fname
, cookie
)
2660 void *cookie UNUSED
;
2662 if (ga_grow(&tag_fnames
, 1) == OK
)
2663 ((char_u
**)(tag_fnames
.ga_data
))[tag_fnames
.ga_len
++] =
2667 #if defined(EXITFREE) || defined(PROTO)
2671 ga_clear_strings(&tag_fnames
);
2672 do_tag(NULL
, DT_FREE
, 0, 0, 0);
2675 # if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
2676 if (ptag_entry
.tagname
)
2678 vim_free(ptag_entry
.tagname
);
2679 ptag_entry
.tagname
= NULL
;
2686 * Get the next name of a tag file from the tag file list.
2687 * For help files, use "tags" file only.
2689 * Return FAIL if no more tag file names, OK otherwise.
2692 get_tagfname(tnp
, first
, buf
)
2693 tagname_T
*tnp
; /* holds status info */
2694 int first
; /* TRUE when first file name is wanted */
2695 char_u
*buf
; /* pointer to buffer of MAXPATHL chars */
2697 char_u
*fname
= NULL
;
2701 vim_memset(tnp
, 0, sizeof(tagname_T
));
2706 * For help files it's done in a completely different way:
2707 * Find "doc/tags" and "doc/tags-??" in all directories in
2712 ga_clear_strings(&tag_fnames
);
2713 ga_init2(&tag_fnames
, (int)sizeof(char_u
*), 10);
2714 do_in_runtimepath((char_u
*)
2715 #ifdef FEAT_MULTI_LANG
2717 /* Functions decc$to_vms() and decc$translate_vms() crash
2718 * on some VMS systems with wildcards "??". Seems ECO
2719 * patches do fix the problem in C RTL, but we can't use
2720 * an #ifdef for that. */
2721 "doc/tags doc/tags-*"
2723 "doc/tags doc/tags-??"
2728 , TRUE
, found_tagfile_cb
, NULL
);
2731 if (tnp
->tn_hf_idx
>= tag_fnames
.ga_len
)
2733 /* Not found in 'runtimepath', use 'helpfile', if it exists and
2734 * wasn't used yet, replacing "help.txt" with "tags". */
2735 if (tnp
->tn_hf_idx
> tag_fnames
.ga_len
|| *p_hf
== NUL
)
2739 STRCPY(gettail(buf
), "tags");
2742 vim_strncpy(buf
, ((char_u
**)(tag_fnames
.ga_data
))[
2743 tnp
->tn_hf_idx
++], MAXPATHL
- 1);
2749 /* Init. We make a copy of 'tags', because autocommands may change
2750 * the value without notifying us. */
2751 tnp
->tn_tags
= vim_strsave((*curbuf
->b_p_tags
!= NUL
)
2752 ? curbuf
->b_p_tags
: p_tags
);
2753 if (tnp
->tn_tags
== NULL
)
2755 tnp
->tn_np
= tnp
->tn_tags
;
2759 * Loop until we have found a file name that can be used.
2760 * There are two states:
2761 * tnp->tn_did_filefind_init == FALSE: setup for next part in 'tags'.
2762 * tnp->tn_did_filefind_init == TRUE: find next file in this part.
2766 if (tnp
->tn_did_filefind_init
)
2768 fname
= vim_findfile(tnp
->tn_search_ctx
);
2772 tnp
->tn_did_filefind_init
= FALSE
;
2776 char_u
*filename
= NULL
;
2778 /* Stop when used all parts of 'tags'. */
2779 if (*tnp
->tn_np
== NUL
)
2781 vim_findfile_cleanup(tnp
->tn_search_ctx
);
2782 tnp
->tn_search_ctx
= NULL
;
2787 * Copy next file name into buf.
2790 (void)copy_option_part(&tnp
->tn_np
, buf
, MAXPATHL
- 1, " ,");
2792 #ifdef FEAT_PATH_EXTRA
2793 r_ptr
= vim_findfile_stopdir(buf
);
2797 /* move the filename one char forward and truncate the
2798 * filepath with a NUL */
2799 filename
= gettail(buf
);
2800 STRMOVE(filename
+ 1, filename
);
2803 tnp
->tn_search_ctx
= vim_findfile_init(buf
, filename
,
2805 FALSE
, /* don't free visited list */
2806 FINDFILE_FILE
, /* we search for a file */
2807 tnp
->tn_search_ctx
, TRUE
, curbuf
->b_ffname
);
2808 if (tnp
->tn_search_ctx
!= NULL
)
2809 tnp
->tn_did_filefind_init
= TRUE
;
2819 * Free the contents of a tagname_T that was filled by get_tagfname().
2825 vim_free(tnp
->tn_tags
);
2826 vim_findfile_cleanup(tnp
->tn_search_ctx
);
2827 tnp
->tn_search_ctx
= NULL
;
2828 ga_clear_strings(&tag_fnames
);
2832 * Parse one line from the tags file. Find start/end of tag name, start/end of
2833 * file name and start of search pattern.
2835 * If is_etag is TRUE, tagp->fname and tagp->fname_end are not set.
2837 * Return FAIL if there is a format error in this line, OK otherwise.
2840 parse_tag_line(lbuf
,
2841 #ifdef FEAT_EMACS_TAGS
2845 char_u
*lbuf
; /* line to be parsed */
2846 #ifdef FEAT_EMACS_TAGS
2853 #ifdef FEAT_EMACS_TAGS
2859 * There are two formats for an emacs tag line:
2860 * 1: struct EnvBase ^?EnvBase^A139,4627
2861 * 2: #define ARPB_WILD_WORLD ^?153,5194
2863 p_7f
= vim_strchr(lbuf
, 0x7f);
2867 if (vim_strchr(lbuf
, '\n') == NULL
)
2869 /* Truncated line. Ignore it. */
2873 MSG(_("Ignoring long line in tags file"));
2876 tagp
->command
= lbuf
;
2877 tagp
->tagname
= lbuf
;
2878 tagp
->tagname_end
= lbuf
;
2884 /* Find ^A. If not found the line number is after the 0x7f */
2885 p
= vim_strchr(p_7f
, Ctrl_A
);
2891 if (!VIM_ISDIGIT(*p
)) /* check for start of line number */
2896 if (p
[-1] == Ctrl_A
) /* first format: explicit tagname given */
2898 tagp
->tagname
= p_7f
+ 1;
2899 tagp
->tagname_end
= p
- 1;
2901 else /* second format: isolate tagname */
2903 /* find end of tagname */
2904 for (p
= p_7f
- 1; !vim_iswordc(*p
); --p
)
2907 tagp
->tagname_end
= p
+ 1;
2908 while (p
>= lbuf
&& vim_iswordc(*p
))
2910 tagp
->tagname
= p
+ 1;
2913 else /* not an Emacs tag */
2916 /* Isolate the tagname, from lbuf up to the first white */
2917 tagp
->tagname
= lbuf
;
2918 #ifdef FEAT_TAG_ANYWHITE
2919 p
= skiptowhite(lbuf
);
2921 p
= vim_strchr(lbuf
, TAB
);
2925 tagp
->tagname_end
= p
;
2927 /* Isolate file name, from first to second white space */
2928 #ifdef FEAT_TAG_ANYWHITE
2935 #ifdef FEAT_TAG_ANYWHITE
2938 p
= vim_strchr(p
, TAB
);
2942 tagp
->fname_end
= p
;
2944 /* find start of search command, after second white space */
2945 #ifdef FEAT_TAG_ANYWHITE
2954 #ifdef FEAT_EMACS_TAGS
2962 * Check if tagname is a static tag
2964 * Static tags produced by the older ctags program have the format:
2965 * 'file:tag file /pattern'.
2966 * This is only recognized when both occurrence of 'file' are the same, to
2967 * avoid recognizing "string::string" or ":exit".
2969 * Static tags produced by the new ctags program have the format:
2970 * 'tag file /pattern/;"<Tab>file:' "
2972 * Return TRUE if it is a static tag and adjust *tagname to the real tag.
2973 * Return FALSE if it is not a static tag.
2976 test_for_static(tagp
)
2981 #ifdef FEAT_TAG_OLDSTATIC
2985 * Check for old style static tag: "file:tag file .."
2987 len
= (int)(tagp
->fname_end
- tagp
->fname
);
2988 p
= tagp
->tagname
+ len
;
2989 if ( p
< tagp
->tagname_end
2991 && fnamencmp(tagp
->tagname
, tagp
->fname
, len
) == 0)
2993 tagp
->tagname
= p
+ 1;
2999 * Check for new style static tag ":...<Tab>file:[<Tab>...]"
3002 while ((p
= vim_strchr(p
, '\t')) != NULL
)
3005 if (STRNCMP(p
, "file:", 5) == 0)
3013 * Parse a line from a matching tag. Does not change the line itself.
3015 * The line that we get looks like this:
3016 * Emacs tag: <mtt><tag_fname><NUL><ebuf><NUL><lbuf>
3017 * other tag: <mtt><tag_fname><NUL><NUL><lbuf>
3018 * without Emacs tags: <mtt><tag_fname><NUL><lbuf>
3020 * Return OK or FAIL.
3023 parse_match(lbuf
, tagp
)
3024 char_u
*lbuf
; /* input: matching line */
3025 tagptrs_T
*tagp
; /* output: pointers into the line */
3031 tagp
->tag_fname
= lbuf
+ 1;
3032 lbuf
+= STRLEN(tagp
->tag_fname
) + 2;
3033 #ifdef FEAT_EMACS_TAGS
3036 tagp
->is_etag
= TRUE
;
3038 lbuf
+= STRLEN(lbuf
);
3039 tagp
->fname_end
= lbuf
++;
3043 tagp
->is_etag
= FALSE
;
3048 /* Find search pattern and the file name for non-etags. */
3049 retval
= parse_tag_line(lbuf
,
3050 #ifdef FEAT_EMACS_TAGS
3055 tagp
->tagkind
= NULL
;
3056 tagp
->command_end
= NULL
;
3060 /* Try to find a kind field: "kind:<kind>" or just "<kind>"*/
3062 if (find_extra(&p
) == OK
)
3064 tagp
->command_end
= p
;
3065 p
+= 2; /* skip ";\"" */
3067 while (ASCII_ISALPHA(*p
))
3069 if (STRNCMP(p
, "kind:", 5) == 0)
3071 tagp
->tagkind
= p
+ 5;
3074 pc
= vim_strchr(p
, ':');
3075 pt
= vim_strchr(p
, '\t');
3076 if (pc
== NULL
|| (pt
!= NULL
&& pc
> pt
))
3086 if (tagp
->tagkind
!= NULL
)
3088 for (p
= tagp
->tagkind
;
3089 *p
&& *p
!= '\t' && *p
!= '\r' && *p
!= '\n'; ++p
)
3091 tagp
->tagkind_end
= p
;
3098 * Find out the actual file name of a tag. Concatenate the tags file name
3099 * with the matching tag file name.
3100 * Returns an allocated string or NULL (out of memory).
3103 tag_full_fname(tagp
)
3109 #ifdef FEAT_EMACS_TAGS
3111 c
= 0; /* to shut up GCC */
3115 c
= *tagp
->fname_end
;
3116 *tagp
->fname_end
= NUL
;
3118 fullname
= expand_tag_fname(tagp
->fname
, tagp
->tag_fname
, FALSE
);
3120 #ifdef FEAT_EMACS_TAGS
3123 *tagp
->fname_end
= c
;
3129 * Jump to a tag that has been found in one of the tag files
3131 * returns OK for success, NOTAGFILE when file not found, FAIL otherwise.
3134 jumpto_tag(lbuf
, forceit
, keep_help
)
3135 char_u
*lbuf
; /* line from the tags file for this tag */
3136 int forceit
; /* :ta with ! */
3137 int keep_help
; /* keep help flag (FALSE for cscope) */
3141 int save_p_ws
, save_p_scs
, save_p_ic
;
3145 char_u
*pbuf
; /* search pattern buffer */
3147 char_u
*tofree_fname
= NULL
;
3153 #ifdef FEAT_SEARCH_EXTRA
3154 int save_no_hlsearch
;
3156 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
3157 win_T
*curwin_save
= NULL
;
3159 char_u
*full_fname
= NULL
;
3161 int old_KeyTyped
= KeyTyped
; /* getting the file may reset it */
3164 pbuf
= alloc(LSIZE
);
3166 /* parse the match line into the tagp structure */
3167 if (pbuf
== NULL
|| parse_match(lbuf
, &tagp
) == FAIL
)
3169 tagp
.fname_end
= NULL
;
3173 /* truncate the file name, so it can be used as a string */
3174 csave
= *tagp
.fname_end
;
3175 *tagp
.fname_end
= NUL
;
3178 /* copy the command to pbuf[], remove trailing CR/NL */
3180 for (pbuf_end
= pbuf
; *str
&& *str
!= '\n' && *str
!= '\r'; )
3182 #ifdef FEAT_EMACS_TAGS
3183 if (tagp
.is_etag
&& *str
== ',')/* stop at ',' after line number */
3186 *pbuf_end
++ = *str
++;
3190 #ifdef FEAT_EMACS_TAGS
3195 * Remove the "<Tab>fieldname:value" stuff; we don't need it here.
3198 if (find_extra(&str
) == OK
)
3206 * Expand file name, when needed (for environment variables).
3207 * If 'tagrelative' option set, may change file name.
3209 fname
= expand_tag_fname(fname
, tagp
.tag_fname
, TRUE
);
3212 tofree_fname
= fname
; /* free() it later */
3215 * Check if the file with the tag exists before abandoning the current
3216 * file. Also accept a file name for which there is a matching BufReadCmd
3217 * autocommand event (e.g., http://sys/file).
3219 if (mch_getperm(fname
) < 0
3221 && !has_autocmd(EVENT_BUFREADCMD
, fname
, NULL
)
3226 vim_free(nofile_fname
);
3227 nofile_fname
= vim_strsave(fname
);
3228 if (nofile_fname
== NULL
)
3229 nofile_fname
= empty_option
;
3233 ++RedrawingDisabled
;
3236 need_mouse_correct
= TRUE
;
3239 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
3240 if (g_do_tagpreview
)
3242 postponed_split
= 0; /* don't split again below */
3243 curwin_save
= curwin
; /* Save current window */
3246 * If we are reusing a window, we may change dir when
3247 * entering it (autocommands) so turn the tag filename
3250 if (!curwin
->w_p_pvw
)
3252 full_fname
= FullName_save(fname
, FALSE
);
3256 * Make the preview window the current window.
3257 * Open a preview window when needed.
3259 prepare_tagpreview(TRUE
);
3263 /* If it was a CTRL-W CTRL-] command split window now. For ":tab tag"
3264 * open a new tab page. */
3265 if (postponed_split
|| cmdmod
.tab
!= 0)
3267 win_split(postponed_split
> 0 ? postponed_split
: 0,
3268 postponed_split_flags
);
3269 # ifdef FEAT_SCROLLBIND
3270 curwin
->w_p_scb
= FALSE
;
3277 /* A :ta from a help file will keep the b_help flag set. For ":ptag"
3278 * we need to use the flag from the window where we came from. */
3279 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
3280 if (g_do_tagpreview
)
3281 keep_help_flag
= curwin_save
->w_buffer
->b_help
;
3284 keep_help_flag
= curbuf
->b_help
;
3286 getfile_result
= getfile(0, fname
, NULL
, TRUE
, (linenr_T
)0, forceit
);
3287 keep_help_flag
= FALSE
;
3289 if (getfile_result
<= 0) /* got to the right file */
3291 curwin
->w_set_curswant
= TRUE
;
3293 postponed_split
= 0;
3296 save_secure
= secure
;
3301 save_magic
= p_magic
;
3302 p_magic
= FALSE
; /* always execute with 'nomagic' */
3303 #ifdef FEAT_SEARCH_EXTRA
3304 /* Save value of no_hlsearch, jumping to a tag is not a real search */
3305 save_no_hlsearch
= no_hlsearch
;
3309 * If 'cpoptions' contains 't', store the search pattern for the "n"
3310 * command. If 'cpoptions' does not contain 't', the search pattern
3313 if (vim_strchr(p_cpo
, CPO_TAGPAT
) != NULL
)
3316 search_options
= SEARCH_KEEP
;
3319 * If the command is a search, try here.
3321 * Reset 'smartcase' for the search, since the search pattern was not
3322 * typed by the user.
3323 * Only use do_search() when there is a full search command, without
3324 * anything following.
3327 if (pbuf
[0] == '/' || pbuf
[0] == '?')
3328 str
= skip_regexp(pbuf
+ 1, pbuf
[0], FALSE
, NULL
) + 1;
3329 if (str
> pbuf_end
- 1) /* search command with nothing following */
3334 p_ws
= TRUE
; /* need 'wrapscan' for backward searches */
3335 p_ic
= FALSE
; /* don't ignore case now */
3337 #if 0 /* disabled for now */
3339 /* put pattern in search history */
3340 add_to_history(HIST_SEARCH
, pbuf
+ 1, TRUE
, pbuf
[0]);
3343 save_lnum
= curwin
->w_cursor
.lnum
;
3344 curwin
->w_cursor
.lnum
= 0; /* start search before first line */
3345 if (do_search(NULL
, pbuf
[0], pbuf
+ 1, (long)1,
3346 search_options
, NULL
))
3354 * try again, ignore case now
3357 if (!do_search(NULL
, pbuf
[0], pbuf
+ 1, (long)1,
3358 search_options
, NULL
))
3361 * Failed to find pattern, take a guess: "^func ("
3364 (void)test_for_static(&tagp
);
3365 cc
= *tagp
.tagname_end
;
3366 *tagp
.tagname_end
= NUL
;
3367 sprintf((char *)pbuf
, "^%s\\s\\*(", tagp
.tagname
);
3368 if (!do_search(NULL
, '/', pbuf
, (long)1,
3369 search_options
, NULL
))
3371 /* Guess again: "^char * \<func (" */
3372 sprintf((char *)pbuf
, "^\\[#a-zA-Z_]\\.\\*\\<%s\\s\\*(",
3374 if (!do_search(NULL
, '/', pbuf
, (long)1,
3375 search_options
, NULL
))
3378 *tagp
.tagname_end
= cc
;
3382 EMSG(_("E434: Can't find tag pattern"));
3383 curwin
->w_cursor
.lnum
= save_lnum
;
3388 * Only give a message when really guessed, not when 'ic'
3389 * is set and match found while ignoring case.
3391 if (found
== 2 || !save_p_ic
)
3393 MSG(_("E435: Couldn't find tag, just guessing!"));
3394 if (!msg_scrolled
&& msg_silent
== 0)
3397 ui_delay(1000L, TRUE
);
3407 /* A search command may have positioned the cursor beyond the end
3408 * of the line. May need to correct that here. */
3413 curwin
->w_cursor
.lnum
= 1; /* start command in line 1 */
3414 do_cmdline_cmd(pbuf
);
3419 * When the command has done something that is not allowed make sure
3420 * the error message can be seen.
3424 secure
= save_secure
;
3425 p_magic
= save_magic
;
3429 #ifdef FEAT_SEARCH_EXTRA
3430 /* restore no_hlsearch when keeping the old search pattern */
3432 no_hlsearch
= save_no_hlsearch
;
3435 /* Return OK if jumped to another file (at least we found the file!). */
3436 if (getfile_result
== -1)
3442 * For a help buffer: Put the cursor line at the top of the window,
3443 * the help subject will be below it.
3446 set_topline(curwin
, curwin
->w_cursor
.lnum
);
3448 if ((fdo_flags
& FDO_TAG
) && old_KeyTyped
)
3453 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
3454 if (g_do_tagpreview
&& curwin
!= curwin_save
&& win_valid(curwin_save
))
3456 /* Return cursor to where we were */
3458 redraw_later(VALID
);
3459 win_enter(curwin_save
, TRUE
);
3463 --RedrawingDisabled
;
3467 --RedrawingDisabled
;
3469 if (postponed_split
) /* close the window */
3471 win_close(curwin
, FALSE
);
3472 postponed_split
= 0;
3478 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
3479 g_do_tagpreview
= 0; /* For next time */
3481 if (tagp
.fname_end
!= NULL
)
3482 *tagp
.fname_end
= csave
;
3484 vim_free(tofree_fname
);
3485 vim_free(full_fname
);
3491 * If "expand" is TRUE, expand wildcards in fname.
3492 * If 'tagrelative' option set, change fname (name of file containing tag)
3493 * according to tag_fname (name of tag file containing fname).
3494 * Returns a pointer to allocated memory (or NULL when out of memory).
3497 expand_tag_fname(fname
, tag_fname
, expand
)
3504 char_u
*expanded_fname
= NULL
;
3508 * Expand file name (for environment variables) when needed.
3510 if (expand
&& mch_has_wildcard(fname
))
3513 xpc
.xp_context
= EXPAND_FILES
;
3514 expanded_fname
= ExpandOne(&xpc
, (char_u
*)fname
, NULL
,
3515 WILD_LIST_NOTFOUND
|WILD_SILENT
, WILD_EXPAND_FREE
);
3516 if (expanded_fname
!= NULL
)
3517 fname
= expanded_fname
;
3520 if ((p_tr
|| curbuf
->b_help
)
3521 && !vim_isAbsName(fname
)
3522 && (p
= gettail(tag_fname
)) != tag_fname
)
3524 retval
= alloc(MAXPATHL
);
3527 STRCPY(retval
, tag_fname
);
3528 vim_strncpy(retval
+ (p
- tag_fname
), fname
,
3529 MAXPATHL
- (p
- tag_fname
) - 1);
3531 * Translate names like "src/a/../b/file.c" into "src/b/file.c".
3533 simplify_filename(retval
);
3537 retval
= vim_strsave(fname
);
3539 vim_free(expanded_fname
);
3545 * Converts a file name into a canonical form. It simplifies a file name into
3546 * its simplest form by stripping out unneeded components, if any. The
3547 * resulting file name is simplified in place and will either be the same
3548 * length as that supplied, or shorter.
3551 simplify_filename(filename
)
3554 #ifndef AMIGA /* Amiga doesn't have "..", it uses "/" */
3556 char_u
*p
, *tail
, *start
;
3557 int stripping_disabled
= FALSE
;
3558 int relative
= TRUE
;
3561 #ifdef BACKSLASH_IN_FILENAME
3562 if (p
[1] == ':') /* skip "x:" */
3566 if (vim_ispathsep(*p
))
3571 while (vim_ispathsep(*p
));
3573 start
= p
; /* remember start after "c:/" or "/" or "///" */
3577 /* At this point "p" is pointing to the char following a single "/"
3578 * or "p" is at the "start" of the (absolute or relative) path name. */
3580 /* VMS allows device:[path] - don't strip the [ in directory */
3581 if ((*p
== '[' || *p
== '<') && p
> filename
&& p
[-1] == ':')
3583 /* :[ or :< composition: vms directory component */
3585 p
= getnextcomp(p
+ 1);
3587 /* allow remote calls as host"user passwd"::device:[path] */
3588 else if (p
[0] == ':' && p
[1] == ':' && p
> filename
&& p
[-1] == '"' )
3590 /* ":: composition: vms host/passwd component */
3592 p
= getnextcomp(p
+ 2);
3596 if (vim_ispathsep(*p
))
3597 STRMOVE(p
, p
+ 1); /* remove duplicate "/" */
3598 else if (p
[0] == '.' && (vim_ispathsep(p
[1]) || p
[1] == NUL
))
3600 if (p
== start
&& relative
)
3601 p
+= 1 + (p
[1] != NUL
); /* keep single "." or leading "./" */
3604 /* Strip "./" or ".///". If we are at the end of the file name
3605 * and there is no trailing path separator, either strip "/." if
3606 * we are after "start", or strip "." if we are at the beginning
3607 * of an absolute path name . */
3610 while (vim_ispathsep(*tail
))
3613 --p
; /* strip preceding path separator */
3617 else if (p
[0] == '.' && p
[1] == '.' &&
3618 (vim_ispathsep(p
[2]) || p
[2] == NUL
))
3620 /* Skip to after ".." or "../" or "..///". */
3622 while (vim_ispathsep(*tail
))
3625 if (components
> 0) /* strip one preceding component */
3627 int do_strip
= FALSE
;
3631 /* Don't strip for an erroneous file name. */
3632 if (!stripping_disabled
)
3634 /* If the preceding component does not exist in the file
3635 * system, we strip it. On Unix, we don't accept a symbolic
3636 * link that refers to a non-existent file. */
3640 if (mch_lstat((char *)filename
, &st
) < 0)
3642 if (mch_stat((char *)filename
, &st
) < 0)
3648 /* Skip back to after previous '/'. */
3649 while (p
> start
&& !after_pathsep(start
, p
))
3650 mb_ptr_back(start
, p
);
3654 /* If the component exists in the file system, check
3655 * that stripping it won't change the meaning of the
3656 * file name. First get information about the
3657 * unstripped file name. This may fail if the component
3658 * to strip is not a searchable directory (but a regular
3659 * file, for instance), since the trailing "/.." cannot
3660 * be applied then. We don't strip it then since we
3661 * don't want to replace an erroneous file name by
3662 * a valid one, and we disable stripping of later
3666 if (mch_stat((char *)filename
, &st
) >= 0)
3669 stripping_disabled
= TRUE
;
3676 /* On Unix, the check for the unstripped file name
3677 * above works also for a symbolic link pointing to
3678 * a searchable directory. But then the parent of
3679 * the directory pointed to by the link must be the
3680 * same as the stripped file name. (The latter
3681 * exists in the file system since it is the
3682 * component's parent directory.) */
3683 if (p
== start
&& relative
)
3684 (void)mch_stat(".", &new_st
);
3689 (void)mch_stat((char *)filename
, &new_st
);
3693 if (new_st
.st_ino
!= st
.st_ino
||
3694 new_st
.st_dev
!= st
.st_dev
)
3697 /* We don't disable stripping of later
3698 * components since the unstripped path name is
3708 /* Skip the ".." or "../" and reset the counter for the
3709 * components that might be stripped later on. */
3715 /* Strip previous component. If the result would get empty
3716 * and there is no trailing path separator, leave a single
3717 * "." instead. If we are at the end of the file name and
3718 * there is no trailing path separator and a preceding
3719 * component is left after stripping, strip its trailing
3720 * path separator as well. */
3721 if (p
== start
&& relative
&& tail
[-1] == '.')
3728 if (p
> start
&& tail
[-1] == '.')
3730 STRMOVE(p
, tail
); /* strip previous component */
3736 else if (p
== start
&& !relative
) /* leading "/.." or "/../" */
3737 STRMOVE(p
, tail
); /* strip ".." or "../" */
3740 if (p
== start
+ 2 && p
[-2] == '.') /* leading "./../" */
3742 STRMOVE(p
- 2, p
); /* strip leading "./" */
3745 p
= tail
; /* skip to char after ".." or "../" */
3750 ++components
; /* simple path component */
3753 } while (*p
!= NUL
);
3758 * Check if we have a tag for the buffer with name "buf_ffname".
3759 * This is a bit slow, because of the full path compare in fullpathcmp().
3760 * Return TRUE if tag for file "fname" if tag file "tag_fname" is for current
3764 #ifdef FEAT_EMACS_TAGS
3765 test_for_current(is_etag
, fname
, fname_end
, tag_fname
, buf_ffname
)
3768 test_for_current(fname
, fname_end
, tag_fname
, buf_ffname
)
3779 if (buf_ffname
!= NULL
) /* if the buffer has a name */
3781 #ifdef FEAT_EMACS_TAGS
3783 c
= 0; /* to shut up GCC */
3790 fullname
= expand_tag_fname(fname
, tag_fname
, TRUE
);
3791 if (fullname
!= NULL
)
3793 retval
= (fullpathcmp(fullname
, buf_ffname
, TRUE
) & FPC_SAME
);
3796 #ifdef FEAT_EMACS_TAGS
3806 * Find the end of the tagaddress.
3807 * Return OK if ";\"" is following, FAIL otherwise.
3815 /* Repeat for addresses separated with ';' */
3818 if (VIM_ISDIGIT(*str
))
3819 str
= skipdigits(str
);
3820 else if (*str
== '/' || *str
== '?')
3822 str
= skip_regexp(str
+ 1, *str
, FALSE
, NULL
);
3830 if (str
== NULL
|| *str
!= ';'
3831 || !(VIM_ISDIGIT(str
[1]) || str
[1] == '/' || str
[1] == '?'))
3833 ++str
; /* skip ';' */
3836 if (str
!= NULL
&& STRNCMP(str
, ";\"", 2) == 0)
3844 #if defined(FEAT_CMDL_COMPL) || defined(PROTO)
3846 expand_tags(tagnames
, pat
, num_file
, file
)
3847 int tagnames
; /* expand tag names */
3860 tagnmflag
= TAG_NAMES
;
3864 ret
= find_tags(pat
+ 1, num_file
, file
,
3865 TAG_REGEXP
| tagnmflag
| TAG_VERBOSE
,
3866 TAG_MANY
, curbuf
->b_ffname
);
3868 ret
= find_tags(pat
, num_file
, file
,
3869 TAG_REGEXP
| tagnmflag
| TAG_VERBOSE
| TAG_NOIC
,
3870 TAG_MANY
, curbuf
->b_ffname
);
3871 if (ret
== OK
&& !tagnames
)
3873 /* Reorganize the tags for display and matching as strings of:
3874 * "<tagname>\0<kind>\0<filename>\0"
3876 for (i
= 0; i
< *num_file
; i
++)
3878 parse_match((*file
)[i
], &t_p
);
3879 c
= (int)(t_p
.tagname_end
- t_p
.tagname
);
3880 mch_memmove(tagnm
, t_p
.tagname
, (size_t)c
);
3882 tagnm
[c
++] = (t_p
.tagkind
!= NULL
&& *t_p
.tagkind
)
3883 ? *t_p
.tagkind
: 'f';
3885 mch_memmove((*file
)[i
] + c
, t_p
.fname
, t_p
.fname_end
- t_p
.fname
);
3886 (*file
)[i
][c
+ (t_p
.fname_end
- t_p
.fname
)] = 0;
3887 mch_memmove((*file
)[i
], tagnm
, (size_t)c
);
3894 #if defined(FEAT_EVAL) || defined(PROTO)
3895 static int add_tag_field
__ARGS((dict_T
*dict
, char *field_name
, char_u
*start
, char_u
*end
));
3898 * Add a tag field to the dictionary "dict"
3901 add_tag_field(dict
, field_name
, start
, end
)
3904 char_u
*start
; /* start of the value */
3905 char_u
*end
; /* after the value; can be NULL */
3907 char_u buf
[MAXPATHL
];
3914 end
= start
+ STRLEN(start
);
3915 while (end
> start
&& (end
[-1] == '\r' || end
[-1] == '\n'))
3918 len
= (int)(end
- start
);
3919 if (len
> (int)sizeof(buf
) - 1)
3920 len
= sizeof(buf
) - 1;
3921 vim_strncpy(buf
, start
, len
);
3924 return dict_add_nr_str(dict
, field_name
, 0L, buf
);
3928 * Add the tags matching the specified pattern to the list "list"
3936 int num_matches
, i
, ret
;
3937 char_u
**matches
, *p
;
3943 ret
= find_tags(pat
, &num_matches
, &matches
,
3944 TAG_REGEXP
| TAG_NOIC
, (int)MAXCOL
, NULL
);
3945 if (ret
== OK
&& num_matches
> 0)
3947 for (i
= 0; i
< num_matches
; ++i
)
3949 parse_match(matches
[i
], &tp
);
3950 is_static
= test_for_static(&tp
);
3952 /* Skip pseudo-tag lines. */
3953 if (STRNCMP(tp
.tagname
, "!_TAG_", 6) == 0)
3956 if ((dict
= dict_alloc()) == NULL
)
3958 if (list_append_dict(list
, dict
) == FAIL
)
3961 full_fname
= tag_full_fname(&tp
);
3962 if (add_tag_field(dict
, "name", tp
.tagname
, tp
.tagname_end
) == FAIL
3963 || add_tag_field(dict
, "filename", full_fname
,
3965 || add_tag_field(dict
, "cmd", tp
.command
,
3966 tp
.command_end
) == FAIL
3967 || add_tag_field(dict
, "kind", tp
.tagkind
,
3968 tp
.tagkind_end
) == FAIL
3969 || dict_add_nr_str(dict
, "static", is_static
, NULL
) == FAIL
)
3972 vim_free(full_fname
);
3974 if (tp
.command_end
!= NULL
)
3976 for (p
= tp
.command_end
+ 3;
3977 *p
!= NUL
&& *p
!= '\n' && *p
!= '\r'; ++p
)
3979 if (p
== tp
.tagkind
|| (p
+ 5 == tp
.tagkind
3980 && STRNCMP(p
, "kind:", 5) == 0))
3981 /* skip "kind:<kind>" and "<kind>" */
3982 p
= tp
.tagkind_end
- 1;
3983 else if (STRNCMP(p
, "file:", 5) == 0)
3984 /* skip "file:" (static tag) */
3986 else if (!vim_iswhite(*p
))
3991 /* Add extra field as a dict entry. Fields are
3992 * separated by Tabs. */
3994 while (*p
!= NUL
&& *p
>= ' ' && *p
< 127 && *p
!= ':')
3997 if (*p
== ':' && len
> 0)
4000 while (*p
!= NUL
&& *p
>= ' ')
4003 if (add_tag_field(dict
, (char *)n
, s
, p
) == FAIL
)
4008 /* Skip field without colon. */
4009 while (*p
!= NUL
&& *p
>= ' ')
4017 vim_free(matches
[i
]);