]> code.delx.au - gnu-emacs/blob - src/syntax.c
(skip_syntaxes): Fix previous change.
[gnu-emacs] / src / syntax.c
1 /* GNU Emacs routines to deal with syntax tables; also word and list parsing.
2 Copyright (C) 1985, 87, 93, 94, 95, 97, 1998, 1999 Free Software Foundation, Inc.
3
4 This file is part of GNU Emacs.
5
6 GNU Emacs is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
9 any later version.
10
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 Boston, MA 02111-1307, USA. */
20
21
22 #include <config.h>
23 #include <ctype.h>
24 #include "lisp.h"
25 #include "commands.h"
26 #include "buffer.h"
27 #include "character.h"
28 #include "keymap.h"
29
30 /* Make syntax table lookup grant data in gl_state. */
31 #define SYNTAX_ENTRY_VIA_PROPERTY
32
33 #include "syntax.h"
34 #include "intervals.h"
35
36 /* We use these constants in place for comment-style and
37 string-ender-char to distinguish comments/strings started by
38 comment_fence and string_fence codes. */
39
40 #define ST_COMMENT_STYLE (256 + 1)
41 #define ST_STRING_STYLE (256 + 2)
42 #include "category.h"
43
44 Lisp_Object Qsyntax_table_p, Qsyntax_table, Qscan_error;
45
46 int words_include_escapes;
47 int parse_sexp_lookup_properties;
48
49 /* Nonzero means `scan-sexps' treat all multibyte characters as symbol. */
50 int multibyte_syntax_as_symbol;
51
52 /* Used as a temporary in SYNTAX_ENTRY and other macros in syntax.h,
53 if not compiled with GCC. No need to mark it, since it is used
54 only very temporarily. */
55 Lisp_Object syntax_temp;
56
57 /* Non-zero means an open parenthesis in column 0 is always considered
58 to be the start of a defun. Zero means an open parenthesis in
59 column 0 has no special meaning. */
60
61 int open_paren_in_column_0_is_defun_start;
62
63 /* This is the internal form of the parse state used in parse-partial-sexp. */
64
65 struct lisp_parse_state
66 {
67 int depth; /* Depth at end of parsing. */
68 int instring; /* -1 if not within string, else desired terminator. */
69 int incomment; /* -1 if in unnestable comment else comment nesting */
70 int comstyle; /* comment style a=0, or b=1, or ST_COMMENT_STYLE. */
71 int quoted; /* Nonzero if just after an escape char at end of parsing */
72 int thislevelstart; /* Char number of most recent start-of-expression at current level */
73 int prevlevelstart; /* Char number of start of containing expression */
74 int location; /* Char number at which parsing stopped. */
75 int mindepth; /* Minimum depth seen while scanning. */
76 int comstr_start; /* Position just after last comment/string starter. */
77 Lisp_Object levelstarts; /* Char numbers of starts-of-expression
78 of levels (starting from outermost). */
79 };
80 \f
81 /* These variables are a cache for finding the start of a defun.
82 find_start_pos is the place for which the defun start was found.
83 find_start_value is the defun start position found for it.
84 find_start_value_byte is the corresponding byte position.
85 find_start_buffer is the buffer it was found in.
86 find_start_begv is the BEGV value when it was found.
87 find_start_modiff is the value of MODIFF when it was found. */
88
89 static int find_start_pos;
90 static int find_start_value;
91 static int find_start_value_byte;
92 static struct buffer *find_start_buffer;
93 static int find_start_begv;
94 static int find_start_modiff;
95
96
97 static int find_defun_start P_ ((int, int));
98 static int back_comment P_ ((int, int, int, int, int, int *, int *));
99 static int char_quoted P_ ((int, int));
100 static Lisp_Object skip_chars P_ ((int, Lisp_Object, Lisp_Object));
101 static Lisp_Object skip_syntaxes P_ ((int, Lisp_Object, Lisp_Object));
102 static Lisp_Object scan_lists P_ ((int, int, int, int));
103 static void scan_sexps_forward P_ ((struct lisp_parse_state *,
104 int, int, int, int,
105 int, Lisp_Object, int));
106 \f
107
108 struct gl_state_s gl_state; /* Global state of syntax parser. */
109
110 INTERVAL interval_of ();
111 #define INTERVALS_AT_ONCE 10 /* 1 + max-number of intervals
112 to scan to property-change. */
113
114 /* Update gl_state to an appropriate interval which contains CHARPOS. The
115 sign of COUNT give the relative position of CHARPOS wrt the previously
116 valid interval. If INIT, only [be]_property fields of gl_state are
117 valid at start, the rest is filled basing on OBJECT.
118
119 `gl_state.*_i' are the intervals, and CHARPOS is further in the search
120 direction than the intervals - or in an interval. We update the
121 current syntax-table basing on the property of this interval, and
122 update the interval to start further than CHARPOS - or be
123 NULL_INTERVAL. We also update lim_property to be the next value of
124 charpos to call this subroutine again - or be before/after the
125 start/end of OBJECT. */
126
127 void
128 update_syntax_table (charpos, count, init, object)
129 int charpos, count, init;
130 Lisp_Object object;
131 {
132 Lisp_Object tmp_table;
133 int cnt = 0, invalidate = 1;
134 INTERVAL i, oldi;
135
136 if (init)
137 {
138 gl_state.old_prop = Qnil;
139 gl_state.start = gl_state.b_property;
140 gl_state.stop = gl_state.e_property;
141 i = interval_of (charpos, object);
142 gl_state.backward_i = gl_state.forward_i = i;
143 invalidate = 0;
144 if (NULL_INTERVAL_P (i))
145 return;
146 /* interval_of updates only ->position of the return value, so
147 update the parents manually to speed up update_interval. */
148 while (!NULL_PARENT (i))
149 {
150 if (AM_RIGHT_CHILD (i))
151 INTERVAL_PARENT (i)->position = i->position
152 - LEFT_TOTAL_LENGTH (i) + TOTAL_LENGTH (i) /* right end */
153 - TOTAL_LENGTH (INTERVAL_PARENT (i))
154 + LEFT_TOTAL_LENGTH (INTERVAL_PARENT (i));
155 else
156 INTERVAL_PARENT (i)->position = i->position - LEFT_TOTAL_LENGTH (i)
157 + TOTAL_LENGTH (i);
158 i = INTERVAL_PARENT (i);
159 }
160 i = gl_state.forward_i;
161 gl_state.b_property = i->position - gl_state.offset;
162 gl_state.e_property = INTERVAL_LAST_POS (i) - gl_state.offset;
163 goto update;
164 }
165 oldi = i = count > 0 ? gl_state.forward_i : gl_state.backward_i;
166
167 /* We are guaranteed to be called with CHARPOS either in i,
168 or further off. */
169 if (NULL_INTERVAL_P (i))
170 error ("Error in syntax_table logic for to-the-end intervals");
171 else if (charpos < i->position) /* Move left. */
172 {
173 if (count > 0)
174 error ("Error in syntax_table logic for intervals <-");
175 /* Update the interval. */
176 i = update_interval (i, charpos);
177 if (INTERVAL_LAST_POS (i) != gl_state.b_property)
178 {
179 invalidate = 0;
180 gl_state.forward_i = i;
181 gl_state.e_property = INTERVAL_LAST_POS (i) - gl_state.offset;
182 }
183 }
184 else if (charpos >= INTERVAL_LAST_POS (i)) /* Move right. */
185 {
186 if (count < 0)
187 error ("Error in syntax_table logic for intervals ->");
188 /* Update the interval. */
189 i = update_interval (i, charpos);
190 if (i->position != gl_state.e_property)
191 {
192 invalidate = 0;
193 gl_state.backward_i = i;
194 gl_state.b_property = i->position - gl_state.offset;
195 }
196 }
197
198 update:
199 tmp_table = textget (i->plist, Qsyntax_table);
200
201 if (invalidate)
202 invalidate = !EQ (tmp_table, gl_state.old_prop); /* Need to invalidate? */
203
204 if (invalidate) /* Did not get to adjacent interval. */
205 { /* with the same table => */
206 /* invalidate the old range. */
207 if (count > 0)
208 {
209 gl_state.backward_i = i;
210 gl_state.b_property = i->position - gl_state.offset;
211 }
212 else
213 {
214 gl_state.forward_i = i;
215 gl_state.e_property = INTERVAL_LAST_POS (i) - gl_state.offset;
216 }
217 }
218
219 if (!EQ (tmp_table, gl_state.old_prop))
220 {
221 gl_state.current_syntax_table = tmp_table;
222 gl_state.old_prop = tmp_table;
223 if (EQ (Fsyntax_table_p (tmp_table), Qt))
224 {
225 gl_state.use_global = 0;
226 }
227 else if (CONSP (tmp_table))
228 {
229 gl_state.use_global = 1;
230 gl_state.global_code = tmp_table;
231 }
232 else
233 {
234 gl_state.use_global = 0;
235 gl_state.current_syntax_table = current_buffer->syntax_table;
236 }
237 }
238
239 while (!NULL_INTERVAL_P (i))
240 {
241 if (cnt && !EQ (tmp_table, textget (i->plist, Qsyntax_table)))
242 {
243 if (count > 0)
244 {
245 gl_state.e_property = i->position - gl_state.offset;
246 gl_state.forward_i = i;
247 }
248 else
249 {
250 gl_state.b_property = i->position + LENGTH (i) - gl_state.offset;
251 gl_state.backward_i = i;
252 }
253 return;
254 }
255 else if (cnt == INTERVALS_AT_ONCE)
256 {
257 if (count > 0)
258 {
259 gl_state.e_property = i->position + LENGTH (i) - gl_state.offset;
260 gl_state.forward_i = i;
261 }
262 else
263 {
264 gl_state.b_property = i->position - gl_state.offset;
265 gl_state.backward_i = i;
266 }
267 return;
268 }
269 cnt++;
270 i = count > 0 ? next_interval (i) : previous_interval (i);
271 }
272 eassert (NULL_INTERVAL_P (i)); /* This property goes to the end. */
273 if (count > 0)
274 gl_state.e_property = gl_state.stop;
275 else
276 gl_state.b_property = gl_state.start;
277 }
278 \f
279 /* Returns TRUE if char at CHARPOS is quoted.
280 Global syntax-table data should be set up already to be good at CHARPOS
281 or after. On return global syntax data is good for lookup at CHARPOS. */
282
283 static int
284 char_quoted (charpos, bytepos)
285 register int charpos, bytepos;
286 {
287 register enum syntaxcode code;
288 register int beg = BEGV;
289 register int quoted = 0;
290 int orig = charpos;
291
292 DEC_BOTH (charpos, bytepos);
293
294 while (bytepos >= beg)
295 {
296 UPDATE_SYNTAX_TABLE_BACKWARD (charpos);
297 code = SYNTAX (FETCH_CHAR_AS_MULTIBYTE (bytepos));
298 if (! (code == Scharquote || code == Sescape))
299 break;
300
301 DEC_BOTH (charpos, bytepos);
302 quoted = !quoted;
303 }
304
305 UPDATE_SYNTAX_TABLE (orig);
306 return quoted;
307 }
308
309 /* Return the bytepos one character after BYTEPOS.
310 We assume that BYTEPOS is not at the end of the buffer. */
311
312 INLINE int
313 inc_bytepos (bytepos)
314 int bytepos;
315 {
316 if (NILP (current_buffer->enable_multibyte_characters))
317 return bytepos + 1;
318
319 INC_POS (bytepos);
320 return bytepos;
321 }
322
323 /* Return the bytepos one character before BYTEPOS.
324 We assume that BYTEPOS is not at the start of the buffer. */
325
326 INLINE int
327 dec_bytepos (bytepos)
328 int bytepos;
329 {
330 if (NILP (current_buffer->enable_multibyte_characters))
331 return bytepos - 1;
332
333 DEC_POS (bytepos);
334 return bytepos;
335 }
336 \f
337 /* Return a defun-start position before before POS and not too far before.
338 It should be the last one before POS, or nearly the last.
339
340 When open_paren_in_column_0_is_defun_start is nonzero,
341 the beginning of every line is treated as a defun-start.
342
343 We record the information about where the scan started
344 and what its result was, so that another call in the same area
345 can return the same value very quickly.
346
347 There is no promise at which position the global syntax data is
348 valid on return from the subroutine, so the caller should explicitly
349 update the global data. */
350
351 static int
352 find_defun_start (pos, pos_byte)
353 int pos, pos_byte;
354 {
355 int opoint = PT, opoint_byte = PT_BYTE;
356
357 /* Use previous finding, if it's valid and applies to this inquiry. */
358 if (current_buffer == find_start_buffer
359 /* Reuse the defun-start even if POS is a little farther on.
360 POS might be in the next defun, but that's ok.
361 Our value may not be the best possible, but will still be usable. */
362 && pos <= find_start_pos + 1000
363 && pos >= find_start_value
364 && BEGV == find_start_begv
365 && MODIFF == find_start_modiff)
366 return find_start_value;
367
368 /* Back up to start of line. */
369 scan_newline (pos, pos_byte, BEGV, BEGV_BYTE, -1, 1);
370
371 /* We optimize syntax-table lookup for rare updates. Thus we accept
372 only those `^\s(' which are good in global _and_ text-property
373 syntax-tables. */
374 gl_state.current_syntax_table = current_buffer->syntax_table;
375 gl_state.use_global = 0;
376 if (open_paren_in_column_0_is_defun_start)
377 {
378 while (PT > BEGV)
379 {
380 /* Open-paren at start of line means we may have found our
381 defun-start. */
382 if (SYNTAX (FETCH_CHAR_AS_MULTIBYTE (PT_BYTE)) == Sopen)
383 {
384 SETUP_SYNTAX_TABLE (PT + 1, -1); /* Try again... */
385 if (SYNTAX (FETCH_CHAR_AS_MULTIBYTE (PT_BYTE)) == Sopen)
386 break;
387 /* Now fallback to the default value. */
388 gl_state.current_syntax_table = current_buffer->syntax_table;
389 gl_state.use_global = 0;
390 }
391 /* Move to beg of previous line. */
392 scan_newline (PT, PT_BYTE, BEGV, BEGV_BYTE, -2, 1);
393 }
394 }
395
396 /* Record what we found, for the next try. */
397 find_start_value = PT;
398 find_start_value_byte = PT_BYTE;
399 find_start_buffer = current_buffer;
400 find_start_modiff = MODIFF;
401 find_start_begv = BEGV;
402 find_start_pos = pos;
403
404 TEMP_SET_PT_BOTH (opoint, opoint_byte);
405
406 return find_start_value;
407 }
408 \f
409 /* Return the SYNTAX_COMEND_FIRST of the character before POS, POS_BYTE. */
410
411 static int
412 prev_char_comend_first (pos, pos_byte)
413 int pos, pos_byte;
414 {
415 int c, val;
416
417 DEC_BOTH (pos, pos_byte);
418 UPDATE_SYNTAX_TABLE_BACKWARD (pos);
419 c = FETCH_CHAR (pos_byte);
420 val = SYNTAX_COMEND_FIRST (c);
421 UPDATE_SYNTAX_TABLE_FORWARD (pos + 1);
422 return val;
423 }
424
425 /* Return the SYNTAX_COMSTART_FIRST of the character before POS, POS_BYTE. */
426
427 /* static int
428 * prev_char_comstart_first (pos, pos_byte)
429 * int pos, pos_byte;
430 * {
431 * int c, val;
432 *
433 * DEC_BOTH (pos, pos_byte);
434 * UPDATE_SYNTAX_TABLE_BACKWARD (pos);
435 * c = FETCH_CHAR (pos_byte);
436 * val = SYNTAX_COMSTART_FIRST (c);
437 * UPDATE_SYNTAX_TABLE_FORWARD (pos + 1);
438 * return val;
439 * } */
440
441 /* Checks whether charpos FROM is at the end of a comment.
442 FROM_BYTE is the bytepos corresponding to FROM.
443 Do not move back before STOP.
444
445 Return a positive value if we find a comment ending at FROM/FROM_BYTE;
446 return -1 otherwise.
447
448 If successful, store the charpos of the comment's beginning
449 into *CHARPOS_PTR, and the bytepos into *BYTEPOS_PTR.
450
451 Global syntax data remains valid for backward search starting at
452 the returned value (or at FROM, if the search was not successful). */
453
454 static int
455 back_comment (from, from_byte, stop, comnested, comstyle, charpos_ptr, bytepos_ptr)
456 int from, from_byte, stop;
457 int comnested, comstyle;
458 int *charpos_ptr, *bytepos_ptr;
459 {
460 /* Look back, counting the parity of string-quotes,
461 and recording the comment-starters seen.
462 When we reach a safe place, assume that's not in a string;
463 then step the main scan to the earliest comment-starter seen
464 an even number of string quotes away from the safe place.
465
466 OFROM[I] is position of the earliest comment-starter seen
467 which is I+2X quotes from the comment-end.
468 PARITY is current parity of quotes from the comment end. */
469 int string_style = -1; /* Presumed outside of any string. */
470 int string_lossage = 0;
471 /* Not a real lossage: indicates that we have passed a matching comment
472 starter plus an non-matching comment-ender, meaning that any matching
473 comment-starter we might see later could be a false positive (hidden
474 inside another comment).
475 Test case: { a (* b } c (* d *) */
476 int comment_lossage = 0;
477 int comment_end = from;
478 int comment_end_byte = from_byte;
479 int comstart_pos = 0;
480 int comstart_byte;
481 /* Place where the containing defun starts,
482 or 0 if we didn't come across it yet. */
483 int defun_start = 0;
484 int defun_start_byte = 0;
485 register enum syntaxcode code;
486 int nesting = 1; /* current comment nesting */
487 int c;
488 int syntax = 0;
489
490 /* FIXME: A }} comment-ender style leads to incorrect behavior
491 in the case of {{ c }}} because we ignore the last two chars which are
492 assumed to be comment-enders although they aren't. */
493
494 /* At beginning of range to scan, we're outside of strings;
495 that determines quote parity to the comment-end. */
496 while (from != stop)
497 {
498 int temp_byte, prev_syntax;
499 int com2start, com2end;
500
501 /* Move back and examine a character. */
502 DEC_BOTH (from, from_byte);
503 UPDATE_SYNTAX_TABLE_BACKWARD (from);
504
505 prev_syntax = syntax;
506 c = FETCH_CHAR_AS_MULTIBYTE (from_byte);
507 syntax = SYNTAX_WITH_FLAGS (c);
508 code = SYNTAX (c);
509
510 /* Check for 2-char comment markers. */
511 com2start = (SYNTAX_FLAGS_COMSTART_FIRST (syntax)
512 && SYNTAX_FLAGS_COMSTART_SECOND (prev_syntax)
513 && comstyle == SYNTAX_FLAGS_COMMENT_STYLE (prev_syntax)
514 && (SYNTAX_FLAGS_COMMENT_NESTED (prev_syntax)
515 || SYNTAX_FLAGS_COMMENT_NESTED (syntax)) == comnested);
516 com2end = (SYNTAX_FLAGS_COMEND_FIRST (syntax)
517 && SYNTAX_FLAGS_COMEND_SECOND (prev_syntax));
518
519 /* Nasty cases with overlapping 2-char comment markers:
520 - snmp-mode: -- c -- foo -- c --
521 --- c --
522 ------ c --
523 - c-mode: *||*
524 |* *|* *|
525 |*| |* |*|
526 /// */
527
528 /* If a 2-char comment sequence partly overlaps with another,
529 we don't try to be clever. */
530 if (from > stop && (com2end || com2start))
531 {
532 int next = from, next_byte = from_byte, next_c, next_syntax;
533 DEC_BOTH (next, next_byte);
534 UPDATE_SYNTAX_TABLE_BACKWARD (next);
535 next_c = FETCH_CHAR_AS_MULTIBYTE (next_byte);
536 next_syntax = SYNTAX_WITH_FLAGS (next_c);
537 if (((com2start || comnested)
538 && SYNTAX_FLAGS_COMEND_SECOND (syntax)
539 && SYNTAX_FLAGS_COMEND_FIRST (next_syntax))
540 || ((com2end || comnested)
541 && SYNTAX_FLAGS_COMSTART_SECOND (syntax)
542 && comstyle == SYNTAX_FLAGS_COMMENT_STYLE (syntax)
543 && SYNTAX_FLAGS_COMSTART_FIRST (next_syntax)))
544 goto lossage;
545 /* UPDATE_SYNTAX_TABLE_FORWARD (next + 1); */
546 }
547
548 if (com2start && comstart_pos == 0)
549 /* We're looking at a comment starter. But it might be a comment
550 ender as well (see snmp-mode). The first time we see one, we
551 need to consider it as a comment starter,
552 and the subsequent times as a comment ender. */
553 com2end = 0;
554
555 /* Turn a 2-char comment sequences into the appropriate syntax. */
556 if (com2end)
557 code = Sendcomment;
558 else if (com2start)
559 code = Scomment;
560 /* Ignore comment starters of a different style. */
561 else if (code == Scomment
562 && (comstyle != SYNTAX_FLAGS_COMMENT_STYLE (syntax)
563 || SYNTAX_FLAGS_COMMENT_NESTED (syntax) != comnested))
564 continue;
565
566 /* Ignore escaped characters, except comment-enders. */
567 if (code != Sendcomment && char_quoted (from, from_byte))
568 continue;
569
570 switch (code)
571 {
572 case Sstring_fence:
573 case Scomment_fence:
574 c = (code == Sstring_fence ? ST_STRING_STYLE : ST_COMMENT_STYLE);
575 case Sstring:
576 /* Track parity of quotes. */
577 if (string_style == -1)
578 /* Entering a string. */
579 string_style = c;
580 else if (string_style == c)
581 /* Leaving the string. */
582 string_style = -1;
583 else
584 /* If we have two kinds of string delimiters.
585 There's no way to grok this scanning backwards. */
586 string_lossage = 1;
587 break;
588
589 case Scomment:
590 /* We've already checked that it is the relevant comstyle. */
591 if (string_style != -1 || comment_lossage || string_lossage)
592 /* There are odd string quotes involved, so let's be careful.
593 Test case in Pascal: " { " a { " } */
594 goto lossage;
595
596 if (!comnested)
597 {
598 /* Record best comment-starter so far. */
599 comstart_pos = from;
600 comstart_byte = from_byte;
601 }
602 else if (--nesting <= 0)
603 /* nested comments have to be balanced, so we don't need to
604 keep looking for earlier ones. We use here the same (slightly
605 incorrect) reasoning as below: since it is followed by uniform
606 paired string quotes, this comment-start has to be outside of
607 strings, else the comment-end itself would be inside a string. */
608 goto done;
609 break;
610
611 case Sendcomment:
612 if (SYNTAX_FLAGS_COMMENT_STYLE (syntax) == comstyle
613 && (SYNTAX_FLAGS_COMMENT_NESTED (prev_syntax)
614 || SYNTAX_FLAGS_COMMENT_NESTED (syntax)) == comnested)
615 /* This is the same style of comment ender as ours. */
616 {
617 if (comnested)
618 nesting++;
619 else
620 /* Anything before that can't count because it would match
621 this comment-ender rather than ours. */
622 from = stop; /* Break out of the loop. */
623 }
624 else if (comstart_pos != 0 || c != '\n')
625 /* We're mixing comment styles here, so we'd better be careful.
626 The (comstart_pos != 0 || c != '\n') check is not quite correct
627 (we should just always set comment_lossage), but removing it
628 would imply that any multiline comment in C would go through
629 lossage, which seems overkill.
630 The failure should only happen in the rare cases such as
631 { (* } *) */
632 comment_lossage = 1;
633 break;
634
635 case Sopen:
636 /* Assume a defun-start point is outside of strings. */
637 if (open_paren_in_column_0_is_defun_start
638 && (from == stop
639 || (temp_byte = dec_bytepos (from_byte),
640 FETCH_CHAR (temp_byte) == '\n')))
641 {
642 defun_start = from;
643 defun_start_byte = from_byte;
644 from = stop; /* Break out of the loop. */
645 }
646 break;
647
648 default:
649 break;
650 }
651 }
652
653 if (comstart_pos == 0)
654 {
655 from = comment_end;
656 from_byte = comment_end_byte;
657 UPDATE_SYNTAX_TABLE_FORWARD (comment_end - 1);
658 }
659 /* If comstart_pos is set and we get here (ie. didn't jump to `lossage'
660 or `done'), then we've found the beginning of the non-nested comment. */
661 else if (1) /* !comnested */
662 {
663 from = comstart_pos;
664 from_byte = comstart_byte;
665 /* Globals are correct now. */
666 }
667 else
668 {
669 struct lisp_parse_state state;
670 lossage:
671 /* We had two kinds of string delimiters mixed up
672 together. Decode this going forwards.
673 Scan fwd from a known safe place (beginning-of-defun)
674 to the one in question; this records where we
675 last passed a comment starter. */
676 /* If we did not already find the defun start, find it now. */
677 if (defun_start == 0)
678 {
679 defun_start = find_defun_start (comment_end, comment_end_byte);
680 defun_start_byte = find_start_value_byte;
681 }
682 do
683 {
684 scan_sexps_forward (&state,
685 defun_start, defun_start_byte,
686 comment_end, -10000, 0, Qnil, 0);
687 defun_start = comment_end;
688 if (state.incomment == (comnested ? 1 : -1)
689 && state.comstyle == comstyle)
690 from = state.comstr_start;
691 else
692 {
693 from = comment_end;
694 if (state.incomment)
695 /* If comment_end is inside some other comment, maybe ours
696 is nested, so we need to try again from within the
697 surrounding comment. Example: { a (* " *) */
698 {
699 /* FIXME: We should advance by one or two chars. */
700 defun_start = state.comstr_start + 2;
701 defun_start_byte = CHAR_TO_BYTE (defun_start);
702 }
703 }
704 } while (defun_start < comment_end);
705
706 from_byte = CHAR_TO_BYTE (from);
707 UPDATE_SYNTAX_TABLE_FORWARD (from - 1);
708 }
709
710 done:
711 *charpos_ptr = from;
712 *bytepos_ptr = from_byte;
713
714 return (from == comment_end) ? -1 : from;
715 }
716 \f
717 DEFUN ("syntax-table-p", Fsyntax_table_p, Ssyntax_table_p, 1, 1, 0,
718 doc: /* Return t if OBJECT is a syntax table.
719 Currently, any char-table counts as a syntax table. */)
720 (object)
721 Lisp_Object object;
722 {
723 if (CHAR_TABLE_P (object)
724 && EQ (XCHAR_TABLE (object)->purpose, Qsyntax_table))
725 return Qt;
726 return Qnil;
727 }
728
729 static void
730 check_syntax_table (obj)
731 Lisp_Object obj;
732 {
733 if (!(CHAR_TABLE_P (obj)
734 && EQ (XCHAR_TABLE (obj)->purpose, Qsyntax_table)))
735 wrong_type_argument (Qsyntax_table_p, obj);
736 }
737
738 DEFUN ("syntax-table", Fsyntax_table, Ssyntax_table, 0, 0, 0,
739 doc: /* Return the current syntax table.
740 This is the one specified by the current buffer. */)
741 ()
742 {
743 return current_buffer->syntax_table;
744 }
745
746 DEFUN ("standard-syntax-table", Fstandard_syntax_table,
747 Sstandard_syntax_table, 0, 0, 0,
748 doc: /* Return the standard syntax table.
749 This is the one used for new buffers. */)
750 ()
751 {
752 return Vstandard_syntax_table;
753 }
754
755 DEFUN ("copy-syntax-table", Fcopy_syntax_table, Scopy_syntax_table, 0, 1, 0,
756 doc: /* Construct a new syntax table and return it.
757 It is a copy of the TABLE, which defaults to the standard syntax table. */)
758 (table)
759 Lisp_Object table;
760 {
761 Lisp_Object copy;
762
763 if (!NILP (table))
764 check_syntax_table (table);
765 else
766 table = Vstandard_syntax_table;
767
768 copy = Fcopy_sequence (table);
769
770 /* Only the standard syntax table should have a default element.
771 Other syntax tables should inherit from parents instead. */
772 XCHAR_TABLE (copy)->defalt = Qnil;
773
774 /* Copied syntax tables should all have parents.
775 If we copied one with no parent, such as the standard syntax table,
776 use the standard syntax table as the copy's parent. */
777 if (NILP (XCHAR_TABLE (copy)->parent))
778 Fset_char_table_parent (copy, Vstandard_syntax_table);
779 return copy;
780 }
781
782 DEFUN ("set-syntax-table", Fset_syntax_table, Sset_syntax_table, 1, 1, 0,
783 doc: /* Select a new syntax table for the current buffer.
784 One argument, a syntax table. */)
785 (table)
786 Lisp_Object table;
787 {
788 int idx;
789 check_syntax_table (table);
790 current_buffer->syntax_table = table;
791 /* Indicate that this buffer now has a specified syntax table. */
792 idx = PER_BUFFER_VAR_IDX (syntax_table);
793 SET_PER_BUFFER_VALUE_P (current_buffer, idx, 1);
794 return table;
795 }
796 \f
797 /* Convert a letter which signifies a syntax code
798 into the code it signifies.
799 This is used by modify-syntax-entry, and other things. */
800
801 unsigned char syntax_spec_code[0400] =
802 { 0377, 0377, 0377, 0377, 0377, 0377, 0377, 0377,
803 0377, 0377, 0377, 0377, 0377, 0377, 0377, 0377,
804 0377, 0377, 0377, 0377, 0377, 0377, 0377, 0377,
805 0377, 0377, 0377, 0377, 0377, 0377, 0377, 0377,
806 (char) Swhitespace, (char) Scomment_fence, (char) Sstring, 0377,
807 (char) Smath, 0377, 0377, (char) Squote,
808 (char) Sopen, (char) Sclose, 0377, 0377,
809 0377, (char) Swhitespace, (char) Spunct, (char) Scharquote,
810 0377, 0377, 0377, 0377, 0377, 0377, 0377, 0377,
811 0377, 0377, 0377, 0377,
812 (char) Scomment, 0377, (char) Sendcomment, 0377,
813 (char) Sinherit, 0377, 0377, 0377, 0377, 0377, 0377, 0377, /* @, A ... */
814 0377, 0377, 0377, 0377, 0377, 0377, 0377, 0377,
815 0377, 0377, 0377, 0377, 0377, 0377, 0377, (char) Sword,
816 0377, 0377, 0377, 0377, (char) Sescape, 0377, 0377, (char) Ssymbol,
817 0377, 0377, 0377, 0377, 0377, 0377, 0377, 0377, /* `, a, ... */
818 0377, 0377, 0377, 0377, 0377, 0377, 0377, 0377,
819 0377, 0377, 0377, 0377, 0377, 0377, 0377, (char) Sword,
820 0377, 0377, 0377, 0377, (char) Sstring_fence, 0377, 0377, 0377
821 };
822
823 /* Indexed by syntax code, give the letter that describes it. */
824
825 char syntax_code_spec[16] =
826 {
827 ' ', '.', 'w', '_', '(', ')', '\'', '\"', '$', '\\', '/', '<', '>', '@',
828 '!', '|'
829 };
830
831 /* Indexed by syntax code, give the object (cons of syntax code and
832 nil) to be stored in syntax table. Since these objects can be
833 shared among syntax tables, we generate them in advance. By
834 sharing objects, the function `describe-syntax' can give a more
835 compact listing. */
836 static Lisp_Object Vsyntax_code_object;
837
838 \f
839 DEFUN ("char-syntax", Fchar_syntax, Schar_syntax, 1, 1, 0,
840 doc: /* Return the syntax code of CHARACTER, described by a character.
841 For example, if CHARACTER is a word constituent,
842 the character `w' is returned.
843 The characters that correspond to various syntax codes
844 are listed in the documentation of `modify-syntax-entry'. */)
845 (character)
846 Lisp_Object character;
847 {
848 int char_int;
849 gl_state.current_syntax_table = current_buffer->syntax_table;
850
851 gl_state.use_global = 0;
852 CHECK_NUMBER (character);
853 char_int = XINT (character);
854 return make_number (syntax_code_spec[(int) SYNTAX (char_int)]);
855 }
856
857 DEFUN ("matching-paren", Fmatching_paren, Smatching_paren, 1, 1, 0,
858 doc: /* Return the matching parenthesis of CHARACTER, or nil if none. */)
859 (character)
860 Lisp_Object character;
861 {
862 int char_int, code;
863 gl_state.current_syntax_table = current_buffer->syntax_table;
864 gl_state.use_global = 0;
865 CHECK_NUMBER (character);
866 char_int = XINT (character);
867 code = SYNTAX (char_int);
868 if (code == Sopen || code == Sclose)
869 return SYNTAX_MATCH (char_int);
870 return Qnil;
871 }
872
873 DEFUN ("string-to-syntax", Fstring_to_syntax, Sstring_to_syntax, 1, 1, 0,
874 doc: /* Convert a syntax specification STRING into syntax cell form.
875 STRING should be a string as it is allowed as argument of
876 `modify-syntax-entry'. Value is the equivalent cons cell
877 (CODE . MATCHING-CHAR) that can be used as value of a `syntax-table'
878 text property. */)
879 (string)
880 Lisp_Object string;
881 {
882 register unsigned char *p;
883 register enum syntaxcode code;
884 int val;
885 Lisp_Object match;
886
887 CHECK_STRING (string);
888
889 p = XSTRING (string)->data;
890 code = (enum syntaxcode) syntax_spec_code[*p++];
891 if (((int) code & 0377) == 0377)
892 error ("invalid syntax description letter: %c", p[-1]);
893
894 if (code == Sinherit)
895 return Qnil;
896
897 if (*p)
898 {
899 int len;
900 int character = (STRING_CHAR_AND_LENGTH
901 (p, STRING_BYTES (XSTRING (string)) - 1, len));
902 XSETINT (match, character);
903 if (XFASTINT (match) == ' ')
904 match = Qnil;
905 p += len;
906 }
907 else
908 match = Qnil;
909
910 val = (int) code;
911 while (*p)
912 switch (*p++)
913 {
914 case '1':
915 val |= 1 << 16;
916 break;
917
918 case '2':
919 val |= 1 << 17;
920 break;
921
922 case '3':
923 val |= 1 << 18;
924 break;
925
926 case '4':
927 val |= 1 << 19;
928 break;
929
930 case 'p':
931 val |= 1 << 20;
932 break;
933
934 case 'b':
935 val |= 1 << 21;
936 break;
937
938 case 'n':
939 val |= 1 << 22;
940 break;
941 }
942
943 if (val < XVECTOR (Vsyntax_code_object)->size && NILP (match))
944 return XVECTOR (Vsyntax_code_object)->contents[val];
945 else
946 /* Since we can't use a shared object, let's make a new one. */
947 return Fcons (make_number (val), match);
948 }
949
950 /* I really don't know why this is interactive
951 help-form should at least be made useful whilst reading the second arg. */
952 DEFUN ("modify-syntax-entry", Fmodify_syntax_entry, Smodify_syntax_entry, 2, 3,
953 "cSet syntax for character: \nsSet syntax for %s to: ",
954 doc: /* Set syntax for character CHAR according to string NEWENTRY.
955 The syntax is changed only for table SYNTAX_TABLE, which defaults to
956 the current buffer's syntax table.
957 CHAR may be a cons (MIN . MAX), in which case, syntaxes of all characters
958 in the range MIN and MAX are changed.
959 The first character of NEWENTRY should be one of the following:
960 Space or - whitespace syntax. w word constituent.
961 _ symbol constituent. . punctuation.
962 ( open-parenthesis. ) close-parenthesis.
963 " string quote. \\ escape.
964 $ paired delimiter. ' expression quote or prefix operator.
965 < comment starter. > comment ender.
966 / character-quote. @ inherit from `standard-syntax-table'.
967 | generic string fence. ! generic comment fence.
968
969 Only single-character comment start and end sequences are represented thus.
970 Two-character sequences are represented as described below.
971 The second character of NEWENTRY is the matching parenthesis,
972 used only if the first character is `(' or `)'.
973 Any additional characters are flags.
974 Defined flags are the characters 1, 2, 3, 4, b, p, and n.
975 1 means CHAR is the start of a two-char comment start sequence.
976 2 means CHAR is the second character of such a sequence.
977 3 means CHAR is the start of a two-char comment end sequence.
978 4 means CHAR is the second character of such a sequence.
979
980 There can be up to two orthogonal comment sequences. This is to support
981 language modes such as C++. By default, all comment sequences are of style
982 a, but you can set the comment sequence style to b (on the second character
983 of a comment-start, or the first character of a comment-end sequence) using
984 this flag:
985 b means CHAR is part of comment sequence b.
986 n means CHAR is part of a nestable comment sequence.
987
988 p means CHAR is a prefix character for `backward-prefix-chars';
989 such characters are treated as whitespace when they occur
990 between expressions.
991 usage: (modify-syntax-entry CHAR NEWENTRY &optional SYNTAX-TABLE) */)
992 (c, newentry, syntax_table)
993 Lisp_Object c, newentry, syntax_table;
994 {
995 if (CONSP (c))
996 {
997 CHECK_CHARACTER (XCAR (c));
998 CHECK_CHARACTER (XCDR (c));
999 }
1000 else
1001 CHECK_CHARACTER (c);
1002
1003 if (NILP (syntax_table))
1004 syntax_table = current_buffer->syntax_table;
1005 else
1006 check_syntax_table (syntax_table);
1007
1008 newentry = Fstring_to_syntax (newentry);
1009 if (CONSP (c))
1010 SET_RAW_SYNTAX_ENTRY_RANGE (syntax_table, c, newentry);
1011 else
1012 SET_RAW_SYNTAX_ENTRY (syntax_table, XINT (c), newentry);
1013 return Qnil;
1014 }
1015 \f
1016 /* Dump syntax table to buffer in human-readable format */
1017
1018 DEFUN ("internal-describe-syntax-value", Finternal_describe_syntax_value,
1019 Sinternal_describe_syntax_value, 1, 1, 0,
1020 doc: /* Insert a description of the internal syntax description SYNTAX at point. */)
1021 (syntax)
1022 Lisp_Object syntax;
1023 {
1024 register enum syntaxcode code;
1025 char desc, start1, start2, end1, end2, prefix, comstyle, comnested;
1026 char str[2];
1027 Lisp_Object first, match_lisp, value = syntax;
1028
1029 if (NILP (value))
1030 {
1031 insert_string ("default");
1032 return syntax;
1033 }
1034
1035 if (CHAR_TABLE_P (value))
1036 {
1037 insert_string ("deeper char-table ...");
1038 return syntax;
1039 }
1040
1041 if (!CONSP (value))
1042 {
1043 insert_string ("invalid");
1044 return syntax;
1045 }
1046
1047 first = XCAR (value);
1048 match_lisp = XCDR (value);
1049
1050 if (!INTEGERP (first) || !(NILP (match_lisp) || INTEGERP (match_lisp)))
1051 {
1052 insert_string ("invalid");
1053 return syntax;
1054 }
1055
1056 code = (enum syntaxcode) (XINT (first) & 0377);
1057 start1 = (XINT (first) >> 16) & 1;
1058 start2 = (XINT (first) >> 17) & 1;
1059 end1 = (XINT (first) >> 18) & 1;
1060 end2 = (XINT (first) >> 19) & 1;
1061 prefix = (XINT (first) >> 20) & 1;
1062 comstyle = (XINT (first) >> 21) & 1;
1063 comnested = (XINT (first) >> 22) & 1;
1064
1065 if ((int) code < 0 || (int) code >= (int) Smax)
1066 {
1067 insert_string ("invalid");
1068 return syntax;
1069 }
1070 desc = syntax_code_spec[(int) code];
1071
1072 str[0] = desc, str[1] = 0;
1073 insert (str, 1);
1074
1075 if (NILP (match_lisp))
1076 insert (" ", 1);
1077 else
1078 insert_char (XINT (match_lisp));
1079
1080 if (start1)
1081 insert ("1", 1);
1082 if (start2)
1083 insert ("2", 1);
1084
1085 if (end1)
1086 insert ("3", 1);
1087 if (end2)
1088 insert ("4", 1);
1089
1090 if (prefix)
1091 insert ("p", 1);
1092 if (comstyle)
1093 insert ("b", 1);
1094 if (comnested)
1095 insert ("n", 1);
1096
1097 insert_string ("\twhich means: ");
1098
1099 switch (SWITCH_ENUM_CAST (code))
1100 {
1101 case Swhitespace:
1102 insert_string ("whitespace"); break;
1103 case Spunct:
1104 insert_string ("punctuation"); break;
1105 case Sword:
1106 insert_string ("word"); break;
1107 case Ssymbol:
1108 insert_string ("symbol"); break;
1109 case Sopen:
1110 insert_string ("open"); break;
1111 case Sclose:
1112 insert_string ("close"); break;
1113 case Squote:
1114 insert_string ("prefix"); break;
1115 case Sstring:
1116 insert_string ("string"); break;
1117 case Smath:
1118 insert_string ("math"); break;
1119 case Sescape:
1120 insert_string ("escape"); break;
1121 case Scharquote:
1122 insert_string ("charquote"); break;
1123 case Scomment:
1124 insert_string ("comment"); break;
1125 case Sendcomment:
1126 insert_string ("endcomment"); break;
1127 case Sinherit:
1128 insert_string ("inherit"); break;
1129 case Scomment_fence:
1130 insert_string ("comment fence"); break;
1131 case Sstring_fence:
1132 insert_string ("string fence"); break;
1133 default:
1134 insert_string ("invalid");
1135 return syntax;
1136 }
1137
1138 if (!NILP (match_lisp))
1139 {
1140 insert_string (", matches ");
1141 insert_char (XINT (match_lisp));
1142 }
1143
1144 if (start1)
1145 insert_string (",\n\t is the first character of a comment-start sequence");
1146 if (start2)
1147 insert_string (",\n\t is the second character of a comment-start sequence");
1148
1149 if (end1)
1150 insert_string (",\n\t is the first character of a comment-end sequence");
1151 if (end2)
1152 insert_string (",\n\t is the second character of a comment-end sequence");
1153 if (comstyle)
1154 insert_string (" (comment style b)");
1155 if (comnested)
1156 insert_string (" (nestable)");
1157
1158 if (prefix)
1159 insert_string (",\n\t is a prefix character for `backward-prefix-chars'");
1160
1161 return syntax;
1162 }
1163 \f
1164 int parse_sexp_ignore_comments;
1165
1166 Lisp_Object Vnext_word_boundary_function_table;
1167
1168 /* Return the position across COUNT words from FROM.
1169 If that many words cannot be found before the end of the buffer, return 0.
1170 COUNT negative means scan backward and stop at word beginning. */
1171
1172 int
1173 scan_words (from, count)
1174 register int from, count;
1175 {
1176 register int beg = BEGV;
1177 register int end = ZV;
1178 register int from_byte = CHAR_TO_BYTE (from);
1179 register enum syntaxcode code;
1180 int ch0, ch1;
1181
1182 immediate_quit = 1;
1183 QUIT;
1184
1185 SETUP_SYNTAX_TABLE (from, count);
1186
1187 while (count > 0)
1188 {
1189 Lisp_Object func;
1190
1191 while (1)
1192 {
1193 if (from == end)
1194 {
1195 immediate_quit = 0;
1196 return 0;
1197 }
1198 UPDATE_SYNTAX_TABLE_FORWARD (from);
1199 ch0 = FETCH_CHAR_AS_MULTIBYTE (from_byte);
1200 code = SYNTAX (ch0);
1201 INC_BOTH (from, from_byte);
1202 if (words_include_escapes
1203 && (code == Sescape || code == Scharquote))
1204 break;
1205 if (code == Sword)
1206 break;
1207 }
1208 /* Now CH0 is a character which begins a word and FROM is the
1209 position of the next character. */
1210 func = CHAR_TABLE_REF (Vnext_word_boundary_function_table, ch0);
1211 if (! NILP (Ffboundp (func)))
1212 {
1213 Lisp_Object pos;
1214
1215 pos = call2 (func, make_number (from - 1), make_number (end));
1216 from = XINT (pos);
1217 from_byte = CHAR_TO_BYTE (from);
1218 }
1219 else
1220 {
1221 Lisp_Object script;
1222
1223 script = CHAR_TABLE_REF (Vchar_script_table, ch0);
1224 while (1)
1225 {
1226 if (from == end) break;
1227 UPDATE_SYNTAX_TABLE_FORWARD (from);
1228 ch1 = FETCH_CHAR_AS_MULTIBYTE (from_byte);
1229 code = SYNTAX (ch1);
1230 if ((code != Sword
1231 && (! words_include_escapes
1232 || (code != Sescape && code != Scharquote)))
1233 || ! EQ (CHAR_TABLE_REF (Vchar_script_table, ch1), script))
1234 break;
1235 INC_BOTH (from, from_byte);
1236 ch0 = ch1;
1237 }
1238 }
1239
1240 count--;
1241 }
1242 while (count < 0)
1243 {
1244 Lisp_Object func;
1245
1246 while (1)
1247 {
1248 if (from == beg)
1249 {
1250 immediate_quit = 0;
1251 return 0;
1252 }
1253 DEC_BOTH (from, from_byte);
1254 UPDATE_SYNTAX_TABLE_BACKWARD (from);
1255 ch1 = FETCH_CHAR_AS_MULTIBYTE (from_byte);
1256 code = SYNTAX (ch1);
1257 if (words_include_escapes
1258 && (code == Sescape || code == Scharquote))
1259 break;
1260 if (code == Sword)
1261 break;
1262 }
1263 /* Now CH1 is a character which ends a word and FROM is the
1264 position of it. */
1265 func = CHAR_TABLE_REF (Vnext_word_boundary_function_table, ch1);
1266 if (! NILP (Ffboundp (func)))
1267 {
1268 Lisp_Object pos;
1269
1270 pos = call2 (func, make_number (from), make_number (beg));
1271 from = XINT (pos);
1272 from_byte = CHAR_TO_BYTE (from);
1273 }
1274 else
1275 {
1276 Lisp_Object script;
1277
1278 script = CHAR_TABLE_REF (Vchar_script_table, ch1);
1279 while (1)
1280 {
1281 int temp_byte;
1282
1283 if (from == beg)
1284 break;
1285 temp_byte = dec_bytepos (from_byte);
1286 UPDATE_SYNTAX_TABLE_BACKWARD (from);
1287 ch0 = FETCH_CHAR_AS_MULTIBYTE (temp_byte);
1288 code = SYNTAX (ch0);
1289 if ((code != Sword
1290 && (! words_include_escapes
1291 || (code != Sescape && code != Scharquote)))
1292 || ! EQ (CHAR_TABLE_REF (Vchar_script_table, ch0), script))
1293 break;
1294 DEC_BOTH (from, from_byte);
1295 ch1 = ch0;
1296 }
1297 }
1298 count++;
1299 }
1300
1301 immediate_quit = 0;
1302
1303 return from;
1304 }
1305
1306 DEFUN ("forward-word", Fforward_word, Sforward_word, 1, 1, "p",
1307 doc: /* Move point forward ARG words (backward if ARG is negative).
1308 Normally returns t.
1309 If an edge of the buffer or a field boundary is reached, point is left there
1310 and the function returns nil. Field boundaries are not noticed if
1311 `inhibit-field-text-motion' is non-nil. */)
1312 (count)
1313 Lisp_Object count;
1314 {
1315 int orig_val, val;
1316 CHECK_NUMBER (count);
1317
1318 val = orig_val = scan_words (PT, XINT (count));
1319 if (! orig_val)
1320 val = XINT (count) > 0 ? ZV : BEGV;
1321
1322 /* Avoid jumping out of an input field. */
1323 val = XFASTINT (Fconstrain_to_field (make_number (val), make_number (PT),
1324 Qt, Qnil, Qnil));
1325
1326 SET_PT (val);
1327 return val == orig_val ? Qt : Qnil;
1328 }
1329 \f
1330 Lisp_Object skip_chars ();
1331
1332 DEFUN ("skip-chars-forward", Fskip_chars_forward, Sskip_chars_forward, 1, 2, 0,
1333 doc: /* Move point forward, stopping before a char not in STRING, or at pos LIM.
1334 STRING is like the inside of a `[...]' in a regular expression
1335 except that `]' is never special and `\\' quotes `^', `-' or `\\'
1336 (but not as the end of a range; quoting is never needed there).
1337 Thus, with arg "a-zA-Z", this skips letters stopping before first nonletter.
1338 With arg "^a-zA-Z", skips nonletters stopping before first letter.
1339 Returns the distance traveled, either zero or positive. */)
1340 (string, lim)
1341 Lisp_Object string, lim;
1342 {
1343 return skip_chars (1, string, lim);
1344 }
1345
1346 DEFUN ("skip-chars-backward", Fskip_chars_backward, Sskip_chars_backward, 1, 2, 0,
1347 doc: /* Move point backward, stopping after a char not in STRING, or at pos LIM.
1348 See `skip-chars-forward' for details.
1349 Returns the distance traveled, either zero or negative. */)
1350 (string, lim)
1351 Lisp_Object string, lim;
1352 {
1353 return skip_chars (0, string, lim);
1354 }
1355
1356 DEFUN ("skip-syntax-forward", Fskip_syntax_forward, Sskip_syntax_forward, 1, 2, 0,
1357 doc: /* Move point forward across chars in specified syntax classes.
1358 SYNTAX is a string of syntax code characters.
1359 Stop before a char whose syntax is not in SYNTAX, or at position LIM.
1360 If SYNTAX starts with ^, skip characters whose syntax is NOT in SYNTAX.
1361 This function returns the distance traveled, either zero or positive. */)
1362 (syntax, lim)
1363 Lisp_Object syntax, lim;
1364 {
1365 return skip_syntaxes (1, syntax, lim);
1366 }
1367
1368 DEFUN ("skip-syntax-backward", Fskip_syntax_backward, Sskip_syntax_backward, 1, 2, 0,
1369 doc: /* Move point backward across chars in specified syntax classes.
1370 SYNTAX is a string of syntax code characters.
1371 Stop on reaching a char whose syntax is not in SYNTAX, or at position LIM.
1372 If SYNTAX starts with ^, skip characters whose syntax is NOT in SYNTAX.
1373 This function returns the distance traveled, either zero or negative. */)
1374 (syntax, lim)
1375 Lisp_Object syntax, lim;
1376 {
1377 return skip_syntaxes (0, syntax, lim);
1378 }
1379
1380 static Lisp_Object
1381 skip_chars (forwardp, string, lim)
1382 int forwardp;
1383 Lisp_Object string, lim;
1384 {
1385 register unsigned int c;
1386 unsigned char fastmap[0400];
1387 /* Store the ranges of non-ASCII characters. */
1388 int *char_ranges;
1389 int n_char_ranges = 0;
1390 int negate = 0;
1391 register int i, i_byte;
1392 /* Set to 1 if the current buffer is multibyte and the region
1393 contains non-ASCII chars. */
1394 int multibyte;
1395 /* Set to 1 if STRING is multibyte and it contains non-ASCII
1396 chars. */
1397 int string_multibyte;
1398 int size_byte;
1399 unsigned char *str;
1400 int len;
1401
1402 CHECK_STRING (string);
1403
1404 if (NILP (lim))
1405 XSETINT (lim, forwardp ? ZV : BEGV);
1406 else
1407 CHECK_NUMBER_COERCE_MARKER (lim);
1408
1409 /* In any case, don't allow scan outside bounds of buffer. */
1410 if (XINT (lim) > ZV)
1411 XSETFASTINT (lim, ZV);
1412 if (XINT (lim) < BEGV)
1413 XSETFASTINT (lim, BEGV);
1414
1415 multibyte = (!NILP (current_buffer->enable_multibyte_characters)
1416 && (lim - PT != CHAR_TO_BYTE (lim) - PT_BYTE));
1417 string_multibyte = STRING_BYTES (XSTRING (string)) > XSTRING (string)->size;
1418
1419 bzero (fastmap, sizeof fastmap);
1420 if (multibyte)
1421 char_ranges = (int *) alloca (XSTRING (string)->size * (sizeof (int)) * 2);
1422
1423 str = XSTRING (string)->data;
1424 size_byte = STRING_BYTES (XSTRING (string));
1425
1426 i_byte = 0;
1427 if (i_byte < size_byte
1428 && XSTRING (string)->data[0] == '^')
1429 {
1430 negate = 1; i_byte++;
1431 }
1432
1433 /* Find the characters specified and set their elements of fastmap.
1434 Handle backslashes and ranges specially.
1435
1436 If STRING contains non-ASCII characters, setup char_ranges for
1437 them and use fastmap only for their leading codes. */
1438
1439 if (! string_multibyte)
1440 {
1441 int string_has_eight_bit = 0;
1442
1443 /* At first setup fastmap. */
1444 while (i_byte < size_byte)
1445 {
1446 c = str[i_byte++];
1447
1448 if (c == '\\')
1449 {
1450 if (i_byte == size_byte)
1451 break;
1452
1453 c = str[i_byte++];
1454 }
1455 if (i_byte < size_byte
1456 && str[i_byte] == '-')
1457 {
1458 unsigned int c2;
1459
1460 /* Skip over the dash. */
1461 i_byte++;
1462
1463 if (i_byte == size_byte)
1464 break;
1465
1466 /* Get the end of the range. */
1467 c2 = str[i_byte++];
1468 if (c2 == '\\'
1469 && i_byte < size_byte)
1470 c2 = str[i_byte++];
1471
1472 while (c <= c2)
1473 fastmap[c++] = 1;
1474 if (! ASCII_CHAR_P (c2))
1475 string_has_eight_bit = 1;
1476 }
1477 else
1478 {
1479 fastmap[c] = 1;
1480 if (! ASCII_CHAR_P (c))
1481 string_has_eight_bit = 1;
1482 }
1483 }
1484
1485 /* If the current range is multibyte and STRING contains
1486 eight-bit chars, arrange fastmap and setup char_ranges for
1487 the corresponding multibyte chars. */
1488 if (multibyte && string_has_eight_bit)
1489 {
1490 unsigned char fastmap2[0400];
1491 int range_start_byte, range_start_char;
1492
1493 bcopy (fastmap2 + 0200, fastmap + 0200, 0200);
1494 bzero (fastmap + 0200, 0200);
1495 /* We are sure that this loop stops. */
1496 for (i = 0200; ! fastmap2[i]; i++);
1497 c = unibyte_char_to_multibyte (i);
1498 fastmap[CHAR_LEADING_CODE (c)] = 1;
1499 range_start_byte = i;
1500 range_start_char = c;
1501 for (i = 129; i < 0400; i++)
1502 {
1503 c = unibyte_char_to_multibyte (i);
1504 fastmap[CHAR_LEADING_CODE (c)] = 1;
1505 if (i - range_start_byte != c - range_start_char)
1506 {
1507 char_ranges[n_char_ranges++] = range_start_char;
1508 char_ranges[n_char_ranges++] = ((i - 1 - range_start_byte)
1509 + range_start_char);
1510 range_start_byte = i;
1511 range_start_char = c;
1512 }
1513 }
1514 char_ranges[n_char_ranges++] = range_start_char;
1515 char_ranges[n_char_ranges++] = ((i - 1 - range_start_byte)
1516 + range_start_char);
1517 }
1518 }
1519 else
1520 {
1521 while (i_byte < size_byte)
1522 {
1523 unsigned char leading_code;
1524
1525 leading_code = str[i_byte];
1526 c = STRING_CHAR_AND_LENGTH (str + i_byte, size_byte-i_byte, len);
1527 i_byte += len;
1528
1529 if (c == '\\')
1530 {
1531 if (i_byte == size_byte)
1532 break;
1533
1534 leading_code = str[i_byte];
1535 c = STRING_CHAR_AND_LENGTH (str+i_byte, size_byte-i_byte, len);
1536 i_byte += len;
1537 }
1538 if (i_byte < size_byte
1539 && str[i_byte] == '-')
1540 {
1541 unsigned int c2;
1542 unsigned char leading_code2;
1543
1544 /* Skip over the dash. */
1545 i_byte++;
1546
1547 if (i_byte == size_byte)
1548 break;
1549
1550 /* Get the end of the range. */
1551 leading_code2 = str[i_byte];
1552 c2 =STRING_CHAR_AND_LENGTH (str + i_byte, size_byte-i_byte, len);
1553 i_byte += len;
1554
1555 if (c2 == '\\'
1556 && i_byte < size_byte)
1557 {
1558 leading_code2 = str[i_byte];
1559 c2 =STRING_CHAR_AND_LENGTH (str + i_byte, size_byte-i_byte, len);
1560 i_byte += len;
1561 }
1562
1563 if (ASCII_CHAR_P (c))
1564 {
1565 while (c <= c2 && c < 0x80)
1566 fastmap[c++] = 1;
1567 leading_code = CHAR_LEADING_CODE (c);
1568 }
1569 if (! ASCII_CHAR_P (c))
1570 {
1571 while (leading_code <= leading_code2)
1572 fastmap[leading_code++] = 1;
1573 if (c <= c2)
1574 {
1575 char_ranges[n_char_ranges++] = c;
1576 char_ranges[n_char_ranges++] = c2;
1577 }
1578 }
1579 }
1580 else
1581 {
1582 if (ASCII_CHAR_P (c))
1583 fastmap[c] = 1;
1584 else
1585 {
1586 fastmap[leading_code] = 1;
1587 char_ranges[n_char_ranges++] = c;
1588 char_ranges[n_char_ranges++] = c;
1589 }
1590 }
1591 }
1592
1593 /* If the current range is unibyte and STRING contains non-ASCII
1594 chars, arrange fastmap for the corresponding unibyte
1595 chars. */
1596
1597 if (! multibyte && n_char_ranges > 0)
1598 {
1599 bzero (fastmap + 0200, 0200);
1600 for (i = 0; i < n_char_ranges; i += 2)
1601 {
1602 int c1 = char_ranges[i];
1603 int c2 = char_ranges[i + 1];
1604
1605 for (; c1 <= c2; c1++)
1606 fastmap[CHAR_TO_BYTE8 (c1)] = 1;
1607 }
1608 }
1609 }
1610
1611 /* If ^ was the first character, complement the fastmap. */
1612 if (negate)
1613 {
1614 if (! multibyte)
1615 for (i = 0; i < sizeof fastmap; i++)
1616 fastmap[i] ^= 1;
1617 else
1618 {
1619 for (i = 0; i < 0200; i++)
1620 fastmap[i] ^= 1;
1621 /* All non-ASCII chars possibly match. */
1622 for (; i < sizeof fastmap; i++)
1623 fastmap[i] = 1;
1624 }
1625 }
1626
1627 {
1628 int start_point = PT;
1629 int pos = PT;
1630 int pos_byte = PT_BYTE;
1631
1632 immediate_quit = 1;
1633 if (forwardp)
1634 {
1635 if (multibyte)
1636 while (pos < XINT (lim))
1637 {
1638 c = FETCH_BYTE (pos_byte);
1639 if (! fastmap[c])
1640 break;
1641 if (! ASCII_CHAR_P (c))
1642 {
1643 c = FETCH_MULTIBYTE_CHAR (pos_byte);
1644 /* As we are looking at a multibyte character, we
1645 must look up the character in the table
1646 CHAR_RANGES. If there's no data in the table,
1647 that character is not what we want to skip. */
1648
1649 /* The following code do the right thing even if
1650 n_char_ranges is zero (i.e. no data in
1651 CHAR_RANGES). */
1652 for (i = 0; i < n_char_ranges; i += 2)
1653 if (c >= char_ranges[i] && c <= char_ranges[i + 1])
1654 break;
1655 if (!(negate ^ (i < n_char_ranges)))
1656 break;
1657 }
1658 /* Since we already checked for multibyteness, avoid
1659 using INC_BOTH which checks again. */
1660 INC_POS (pos_byte);
1661 pos++;
1662 }
1663 else
1664 {
1665 while (pos < XINT (lim) && fastmap[FETCH_BYTE (pos_byte)])
1666 pos++, pos_byte++;
1667 }
1668 }
1669 else
1670 {
1671 if (multibyte)
1672 while (pos > XINT (lim))
1673 {
1674 int prev_pos_byte = pos_byte;
1675
1676 DEC_POS (prev_pos_byte);
1677 c = FETCH_BYTE (prev_pos_byte);
1678 if (! fastmap[c])
1679 break;
1680 if (! ASCII_CHAR_P (c))
1681 {
1682 c = FETCH_MULTIBYTE_CHAR (prev_pos_byte);
1683 /* See the comment in the previous similar code. */
1684 for (i = 0; i < n_char_ranges; i += 2)
1685 if (c >= char_ranges[i] && c <= char_ranges[i + 1])
1686 break;
1687 if (!(negate ^ (i < n_char_ranges)))
1688 break;
1689 }
1690 pos--;
1691 pos_byte = prev_pos_byte;
1692 }
1693 else
1694 {
1695 while (pos > XINT (lim) && fastmap[FETCH_BYTE (pos_byte - 1)])
1696 pos--, pos_byte--;
1697 }
1698 }
1699
1700 SET_PT_BOTH (pos, pos_byte);
1701 immediate_quit = 0;
1702
1703 return make_number (PT - start_point);
1704 }
1705 }
1706
1707
1708 static Lisp_Object
1709 skip_syntaxes (forwardp, string, lim)
1710 int forwardp;
1711 Lisp_Object string, lim;
1712 {
1713 register unsigned int c;
1714 unsigned char fastmap[0400];
1715 int negate = 0;
1716 register int i, i_byte;
1717 int multibyte;
1718 int size_byte;
1719 unsigned char *str;
1720
1721 CHECK_STRING (string);
1722
1723 if (NILP (lim))
1724 XSETINT (lim, forwardp ? ZV : BEGV);
1725 else
1726 CHECK_NUMBER_COERCE_MARKER (lim);
1727
1728 /* In any case, don't allow scan outside bounds of buffer. */
1729 if (XINT (lim) > ZV)
1730 XSETFASTINT (lim, ZV);
1731 if (XINT (lim) < BEGV)
1732 XSETFASTINT (lim, BEGV);
1733
1734 multibyte = (!NILP (current_buffer->enable_multibyte_characters)
1735 && (lim - PT != CHAR_TO_BYTE (lim) - PT_BYTE));
1736
1737 bzero (fastmap, sizeof fastmap);
1738
1739 if (STRING_BYTES (XSTRING (string)) > XSTRING (string)->size)
1740 /* As this is very rare case, don't consider efficiency. */
1741 string = string_make_unibyte (string);
1742
1743 str = XSTRING (string)->data;
1744 size_byte = STRING_BYTES (XSTRING (string));
1745
1746 i_byte = 0;
1747 if (i_byte < size_byte
1748 && XSTRING (string)->data[0] == '^')
1749 {
1750 negate = 1; i_byte++;
1751 }
1752
1753 /* Find the syntaxes specified and set their elements of fastmap. */
1754
1755 while (i_byte < size_byte)
1756 {
1757 c = str[i_byte++];
1758 fastmap[syntax_spec_code[c]] = 1;
1759 }
1760
1761 /* If ^ was the first character, complement the fastmap. */
1762 if (negate)
1763 for (i = 0; i < sizeof fastmap; i++)
1764 fastmap[i] ^= 1;
1765
1766 {
1767 int start_point = PT;
1768 int pos = PT;
1769 int pos_byte = PT_BYTE;
1770
1771 immediate_quit = 1;
1772 SETUP_SYNTAX_TABLE (pos, forwardp ? 1 : -1);
1773 if (forwardp)
1774 {
1775 if (multibyte)
1776 {
1777 if (pos < XINT (lim))
1778 while (fastmap[(int) SYNTAX (FETCH_CHAR (pos_byte))])
1779 {
1780 /* Since we already checked for multibyteness,
1781 avoid using INC_BOTH which checks again. */
1782 INC_POS (pos_byte);
1783 pos++;
1784 if (pos >= XINT (lim))
1785 break;
1786 UPDATE_SYNTAX_TABLE_FORWARD (pos);
1787 }
1788 }
1789 else
1790 {
1791 while (pos < XINT (lim))
1792 {
1793 c = FETCH_BYTE (pos_byte);
1794 MAKE_CHAR_MULTIBYTE (c);
1795 if (! fastmap[(int) SYNTAX (c)])
1796 break;
1797 pos++, pos_byte++;
1798 UPDATE_SYNTAX_TABLE_FORWARD (pos);
1799 }
1800 }
1801 }
1802 else
1803 {
1804 if (multibyte)
1805 {
1806 while (pos > XINT (lim))
1807 {
1808 int savepos = pos_byte;
1809 /* Since we already checked for multibyteness,
1810 avoid using DEC_BOTH which checks again. */
1811 pos--;
1812 DEC_POS (pos_byte);
1813 UPDATE_SYNTAX_TABLE_BACKWARD (pos);
1814 if (!fastmap[(int) SYNTAX (FETCH_CHAR (pos_byte))])
1815 {
1816 pos++;
1817 pos_byte = savepos;
1818 break;
1819 }
1820 }
1821 }
1822 else
1823 {
1824 if (pos > XINT (lim))
1825 while (1)
1826 {
1827 c = FETCH_BYTE (pos_byte - 1);
1828 MAKE_CHAR_MULTIBYTE (c);
1829 if (! fastmap[(int) SYNTAX (c)])
1830 break;
1831 pos--, pos_byte--;
1832 if (pos <= XINT (lim))
1833 break;
1834 UPDATE_SYNTAX_TABLE_BACKWARD (pos - 1);
1835 }
1836 }
1837 }
1838
1839 SET_PT_BOTH (pos, pos_byte);
1840 immediate_quit = 0;
1841
1842 return make_number (PT - start_point);
1843 }
1844 }
1845 \f
1846 /* Jump over a comment, assuming we are at the beginning of one.
1847 FROM is the current position.
1848 FROM_BYTE is the bytepos corresponding to FROM.
1849 Do not move past STOP (a charpos).
1850 The comment over which we have to jump is of style STYLE
1851 (either SYNTAX_COMMENT_STYLE(foo) or ST_COMMENT_STYLE).
1852 NESTING should be positive to indicate the nesting at the beginning
1853 for nested comments and should be zero or negative else.
1854 ST_COMMENT_STYLE cannot be nested.
1855 PREV_SYNTAX is the SYNTAX_WITH_FLAGS of the previous character
1856 (or 0 If the search cannot start in the middle of a two-character).
1857
1858 If successful, return 1 and store the charpos of the comment's end
1859 into *CHARPOS_PTR and the corresponding bytepos into *BYTEPOS_PTR.
1860 Else, return 0 and store the charpos STOP into *CHARPOS_PTR, the
1861 corresponding bytepos into *BYTEPOS_PTR and the current nesting
1862 (as defined for state.incomment) in *INCOMMENT_PTR.
1863
1864 The comment end is the last character of the comment rather than the
1865 character just after the comment.
1866
1867 Global syntax data is assumed to initially be valid for FROM and
1868 remains valid for forward search starting at the returned position. */
1869
1870 static int
1871 forw_comment (from, from_byte, stop, nesting, style, prev_syntax,
1872 charpos_ptr, bytepos_ptr, incomment_ptr)
1873 int from, from_byte, stop;
1874 int nesting, style, prev_syntax;
1875 int *charpos_ptr, *bytepos_ptr, *incomment_ptr;
1876 {
1877 register int c, c1;
1878 register enum syntaxcode code;
1879 register int syntax;
1880
1881 if (nesting <= 0) nesting = -1;
1882
1883 /* Enter the loop in the middle so that we find
1884 a 2-char comment ender if we start in the middle of it. */
1885 syntax = prev_syntax;
1886 if (syntax != 0) goto forw_incomment;
1887
1888 while (1)
1889 {
1890 if (from == stop)
1891 {
1892 *incomment_ptr = nesting;
1893 *charpos_ptr = from;
1894 *bytepos_ptr = from_byte;
1895 return 0;
1896 }
1897 c = FETCH_CHAR (from_byte);
1898 syntax = SYNTAX_WITH_FLAGS (c);
1899 code = syntax & 0xff;
1900 if (code == Sendcomment
1901 && SYNTAX_FLAGS_COMMENT_STYLE (syntax) == style
1902 && (SYNTAX_FLAGS_COMMENT_NESTED (syntax) ?
1903 (nesting > 0 && --nesting == 0) : nesting < 0))
1904 /* we have encountered a comment end of the same style
1905 as the comment sequence which began this comment
1906 section */
1907 break;
1908 if (code == Scomment_fence
1909 && style == ST_COMMENT_STYLE)
1910 /* we have encountered a comment end of the same style
1911 as the comment sequence which began this comment
1912 section. */
1913 break;
1914 if (nesting > 0
1915 && code == Scomment
1916 && SYNTAX_FLAGS_COMMENT_NESTED (syntax)
1917 && SYNTAX_FLAGS_COMMENT_STYLE (syntax) == style)
1918 /* we have encountered a nested comment of the same style
1919 as the comment sequence which began this comment section */
1920 nesting++;
1921 INC_BOTH (from, from_byte);
1922 UPDATE_SYNTAX_TABLE_FORWARD (from);
1923
1924 forw_incomment:
1925 if (from < stop && SYNTAX_FLAGS_COMEND_FIRST (syntax)
1926 && SYNTAX_FLAGS_COMMENT_STYLE (syntax) == style
1927 && (c1 = FETCH_CHAR (from_byte),
1928 SYNTAX_COMEND_SECOND (c1))
1929 && ((SYNTAX_FLAGS_COMMENT_NESTED (syntax) ||
1930 SYNTAX_COMMENT_NESTED (c1)) ? nesting > 0 : nesting < 0))
1931 {
1932 if (--nesting <= 0)
1933 /* we have encountered a comment end of the same style
1934 as the comment sequence which began this comment
1935 section */
1936 break;
1937 else
1938 {
1939 INC_BOTH (from, from_byte);
1940 UPDATE_SYNTAX_TABLE_FORWARD (from);
1941 }
1942 }
1943 if (nesting > 0
1944 && from < stop
1945 && SYNTAX_FLAGS_COMSTART_FIRST (syntax)
1946 && (c1 = FETCH_CHAR (from_byte),
1947 SYNTAX_COMMENT_STYLE (c1) == style
1948 && SYNTAX_COMSTART_SECOND (c1))
1949 && (SYNTAX_FLAGS_COMMENT_NESTED (syntax) ||
1950 SYNTAX_COMMENT_NESTED (c1)))
1951 /* we have encountered a nested comment of the same style
1952 as the comment sequence which began this comment
1953 section */
1954 {
1955 INC_BOTH (from, from_byte);
1956 UPDATE_SYNTAX_TABLE_FORWARD (from);
1957 nesting++;
1958 }
1959 }
1960 *charpos_ptr = from;
1961 *bytepos_ptr = from_byte;
1962 return 1;
1963 }
1964
1965 DEFUN ("forward-comment", Fforward_comment, Sforward_comment, 1, 1, 0,
1966 doc: /* Move forward across up to N comments. If N is negative, move backward.
1967 Stop scanning if we find something other than a comment or whitespace.
1968 Set point to where scanning stops.
1969 If N comments are found as expected, with nothing except whitespace
1970 between them, return t; otherwise return nil. */)
1971 (count)
1972 Lisp_Object count;
1973 {
1974 register int from;
1975 int from_byte;
1976 register int stop;
1977 register int c, c1;
1978 register enum syntaxcode code;
1979 int comstyle = 0; /* style of comment encountered */
1980 int comnested = 0; /* whether the comment is nestable or not */
1981 int found;
1982 int count1;
1983 int out_charpos, out_bytepos;
1984 int dummy;
1985
1986 CHECK_NUMBER (count);
1987 count1 = XINT (count);
1988 stop = count1 > 0 ? ZV : BEGV;
1989
1990 immediate_quit = 1;
1991 QUIT;
1992
1993 from = PT;
1994 from_byte = PT_BYTE;
1995
1996 SETUP_SYNTAX_TABLE (from, count1);
1997 while (count1 > 0)
1998 {
1999 do
2000 {
2001 int comstart_first;
2002
2003 if (from == stop)
2004 {
2005 SET_PT_BOTH (from, from_byte);
2006 immediate_quit = 0;
2007 return Qnil;
2008 }
2009 c = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2010 code = SYNTAX (c);
2011 comstart_first = SYNTAX_COMSTART_FIRST (c);
2012 comnested = SYNTAX_COMMENT_NESTED (c);
2013 comstyle = SYNTAX_COMMENT_STYLE (c);
2014 INC_BOTH (from, from_byte);
2015 UPDATE_SYNTAX_TABLE_FORWARD (from);
2016 if (from < stop && comstart_first
2017 && (c1 = FETCH_CHAR_AS_MULTIBYTE (from_byte),
2018 SYNTAX_COMSTART_SECOND (c1)))
2019 {
2020 /* We have encountered a comment start sequence and we
2021 are ignoring all text inside comments. We must record
2022 the comment style this sequence begins so that later,
2023 only a comment end of the same style actually ends
2024 the comment section. */
2025 code = Scomment;
2026 comstyle = SYNTAX_COMMENT_STYLE (c1);
2027 comnested = comnested || SYNTAX_COMMENT_NESTED (c1);
2028 INC_BOTH (from, from_byte);
2029 UPDATE_SYNTAX_TABLE_FORWARD (from);
2030 }
2031 }
2032 while (code == Swhitespace || (code == Sendcomment && c == '\n'));
2033
2034 if (code == Scomment_fence)
2035 comstyle = ST_COMMENT_STYLE;
2036 else if (code != Scomment)
2037 {
2038 immediate_quit = 0;
2039 DEC_BOTH (from, from_byte);
2040 SET_PT_BOTH (from, from_byte);
2041 return Qnil;
2042 }
2043 /* We're at the start of a comment. */
2044 found = forw_comment (from, from_byte, stop, comnested, comstyle, 0,
2045 &out_charpos, &out_bytepos, &dummy);
2046 from = out_charpos; from_byte = out_bytepos;
2047 if (!found)
2048 {
2049 immediate_quit = 0;
2050 SET_PT_BOTH (from, from_byte);
2051 return Qnil;
2052 }
2053 INC_BOTH (from, from_byte);
2054 UPDATE_SYNTAX_TABLE_FORWARD (from);
2055 /* We have skipped one comment. */
2056 count1--;
2057 }
2058
2059 while (count1 < 0)
2060 {
2061 while (1)
2062 {
2063 int quoted;
2064
2065 if (from <= stop)
2066 {
2067 SET_PT_BOTH (BEGV, BEGV_BYTE);
2068 immediate_quit = 0;
2069 return Qnil;
2070 }
2071
2072 DEC_BOTH (from, from_byte);
2073 /* char_quoted does UPDATE_SYNTAX_TABLE_BACKWARD (from). */
2074 quoted = char_quoted (from, from_byte);
2075 c = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2076 code = SYNTAX (c);
2077 comstyle = 0;
2078 comnested = SYNTAX_COMMENT_NESTED (c);
2079 if (code == Sendcomment)
2080 comstyle = SYNTAX_COMMENT_STYLE (c);
2081 if (from > stop && SYNTAX_COMEND_SECOND (c)
2082 && prev_char_comend_first (from, from_byte)
2083 && !char_quoted (from - 1, dec_bytepos (from_byte)))
2084 {
2085 /* We must record the comment style encountered so that
2086 later, we can match only the proper comment begin
2087 sequence of the same style. */
2088 DEC_BOTH (from, from_byte);
2089 code = Sendcomment;
2090 /* Calling char_quoted, above, set up global syntax position
2091 at the new value of FROM. */
2092 c1 = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2093 comstyle = SYNTAX_COMMENT_STYLE (c1);
2094 comnested = comnested || SYNTAX_COMMENT_NESTED (c1);
2095 }
2096
2097 if (code == Scomment_fence)
2098 {
2099 /* Skip until first preceding unquoted comment_fence. */
2100 int found = 0, ini = from, ini_byte = from_byte;
2101
2102 while (1)
2103 {
2104 DEC_BOTH (from, from_byte);
2105 if (from == stop)
2106 break;
2107 UPDATE_SYNTAX_TABLE_BACKWARD (from);
2108 c = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2109 if (SYNTAX (c) == Scomment_fence
2110 && !char_quoted (from, from_byte))
2111 {
2112 found = 1;
2113 break;
2114 }
2115 }
2116 if (found == 0)
2117 {
2118 from = ini; /* Set point to ini + 1. */
2119 from_byte = ini_byte;
2120 goto leave;
2121 }
2122 }
2123 else if (code == Sendcomment)
2124 {
2125 found = back_comment (from, from_byte, stop, comnested, comstyle,
2126 &out_charpos, &out_bytepos);
2127 if (found == -1)
2128 {
2129 if (c == '\n')
2130 /* This end-of-line is not an end-of-comment.
2131 Treat it like a whitespace.
2132 CC-mode (and maybe others) relies on this behavior. */
2133 ;
2134 else
2135 {
2136 /* Failure: we should go back to the end of this
2137 not-quite-endcomment. */
2138 if (SYNTAX(c) != code)
2139 /* It was a two-char Sendcomment. */
2140 INC_BOTH (from, from_byte);
2141 goto leave;
2142 }
2143 }
2144 else
2145 {
2146 /* We have skipped one comment. */
2147 from = out_charpos, from_byte = out_bytepos;
2148 break;
2149 }
2150 }
2151 else if (code != Swhitespace || quoted)
2152 {
2153 leave:
2154 immediate_quit = 0;
2155 INC_BOTH (from, from_byte);
2156 SET_PT_BOTH (from, from_byte);
2157 return Qnil;
2158 }
2159 }
2160
2161 count1++;
2162 }
2163
2164 SET_PT_BOTH (from, from_byte);
2165 immediate_quit = 0;
2166 return Qt;
2167 }
2168 \f
2169 /* Return syntax code of character C if C is an ASCII character
2170 or `multibyte_symbol_p' is zero. Otherwise, return Ssymbol. */
2171
2172 #define SYNTAX_WITH_MULTIBYTE_CHECK(c) \
2173 ((ASCII_CHAR_P (c) || !multibyte_symbol_p) \
2174 ? SYNTAX (c) : Ssymbol)
2175
2176 static Lisp_Object
2177 scan_lists (from, count, depth, sexpflag)
2178 register int from;
2179 int count, depth, sexpflag;
2180 {
2181 Lisp_Object val;
2182 register int stop = count > 0 ? ZV : BEGV;
2183 register int c, c1;
2184 int stringterm;
2185 int quoted;
2186 int mathexit = 0;
2187 register enum syntaxcode code, temp_code;
2188 int min_depth = depth; /* Err out if depth gets less than this. */
2189 int comstyle = 0; /* style of comment encountered */
2190 int comnested = 0; /* whether the comment is nestable or not */
2191 int temp_pos;
2192 int last_good = from;
2193 int found;
2194 int from_byte;
2195 int out_bytepos, out_charpos;
2196 int temp, dummy;
2197 int multibyte_symbol_p = sexpflag && multibyte_syntax_as_symbol;
2198
2199 if (depth > 0) min_depth = 0;
2200
2201 if (from > ZV) from = ZV;
2202 if (from < BEGV) from = BEGV;
2203
2204 from_byte = CHAR_TO_BYTE (from);
2205
2206 immediate_quit = 1;
2207 QUIT;
2208
2209 SETUP_SYNTAX_TABLE (from, count);
2210 while (count > 0)
2211 {
2212 while (from < stop)
2213 {
2214 int comstart_first, prefix;
2215 UPDATE_SYNTAX_TABLE_FORWARD (from);
2216 c = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2217 code = SYNTAX_WITH_MULTIBYTE_CHECK (c);
2218 comstart_first = SYNTAX_COMSTART_FIRST (c);
2219 comnested = SYNTAX_COMMENT_NESTED (c);
2220 comstyle = SYNTAX_COMMENT_STYLE (c);
2221 prefix = SYNTAX_PREFIX (c);
2222 if (depth == min_depth)
2223 last_good = from;
2224 INC_BOTH (from, from_byte);
2225 UPDATE_SYNTAX_TABLE_FORWARD (from);
2226 if (from < stop && comstart_first
2227 && SYNTAX_COMSTART_SECOND (FETCH_CHAR_AS_MULTIBYTE (from_byte))
2228 && parse_sexp_ignore_comments)
2229 {
2230 /* we have encountered a comment start sequence and we
2231 are ignoring all text inside comments. We must record
2232 the comment style this sequence begins so that later,
2233 only a comment end of the same style actually ends
2234 the comment section */
2235 code = Scomment;
2236 c1 = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2237 comstyle = SYNTAX_COMMENT_STYLE (c1);
2238 comnested = comnested || SYNTAX_COMMENT_NESTED (c1);
2239 INC_BOTH (from, from_byte);
2240 UPDATE_SYNTAX_TABLE_FORWARD (from);
2241 }
2242
2243 if (prefix)
2244 continue;
2245
2246 switch (SWITCH_ENUM_CAST (code))
2247 {
2248 case Sescape:
2249 case Scharquote:
2250 if (from == stop) goto lose;
2251 INC_BOTH (from, from_byte);
2252 /* treat following character as a word constituent */
2253 case Sword:
2254 case Ssymbol:
2255 if (depth || !sexpflag) break;
2256 /* This word counts as a sexp; return at end of it. */
2257 while (from < stop)
2258 {
2259 UPDATE_SYNTAX_TABLE_FORWARD (from);
2260
2261 /* Some compilers can't handle this inside the switch. */
2262 c = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2263 temp = SYNTAX_WITH_MULTIBYTE_CHECK (c);
2264 switch (temp)
2265 {
2266 case Scharquote:
2267 case Sescape:
2268 INC_BOTH (from, from_byte);
2269 if (from == stop) goto lose;
2270 break;
2271 case Sword:
2272 case Ssymbol:
2273 case Squote:
2274 break;
2275 default:
2276 goto done;
2277 }
2278 INC_BOTH (from, from_byte);
2279 }
2280 goto done;
2281
2282 case Scomment_fence:
2283 comstyle = ST_COMMENT_STYLE;
2284 /* FALLTHROUGH */
2285 case Scomment:
2286 if (!parse_sexp_ignore_comments) break;
2287 UPDATE_SYNTAX_TABLE_FORWARD (from);
2288 found = forw_comment (from, from_byte, stop,
2289 comnested, comstyle, 0,
2290 &out_charpos, &out_bytepos, &dummy);
2291 from = out_charpos, from_byte = out_bytepos;
2292 if (!found)
2293 {
2294 if (depth == 0)
2295 goto done;
2296 goto lose;
2297 }
2298 INC_BOTH (from, from_byte);
2299 UPDATE_SYNTAX_TABLE_FORWARD (from);
2300 break;
2301
2302 case Smath:
2303 if (!sexpflag)
2304 break;
2305 if (from != stop && c == FETCH_CHAR_AS_MULTIBYTE (from_byte))
2306 {
2307 INC_BOTH (from, from_byte);
2308 }
2309 if (mathexit)
2310 {
2311 mathexit = 0;
2312 goto close1;
2313 }
2314 mathexit = 1;
2315
2316 case Sopen:
2317 if (!++depth) goto done;
2318 break;
2319
2320 case Sclose:
2321 close1:
2322 if (!--depth) goto done;
2323 if (depth < min_depth)
2324 Fsignal (Qscan_error,
2325 Fcons (build_string ("Containing expression ends prematurely"),
2326 Fcons (make_number (last_good),
2327 Fcons (make_number (from), Qnil))));
2328 break;
2329
2330 case Sstring:
2331 case Sstring_fence:
2332 temp_pos = dec_bytepos (from_byte);
2333 stringterm = FETCH_CHAR_AS_MULTIBYTE (temp_pos);
2334 while (1)
2335 {
2336 if (from >= stop) goto lose;
2337 UPDATE_SYNTAX_TABLE_FORWARD (from);
2338 c = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2339 if (code == Sstring
2340 ? (c == stringterm
2341 && SYNTAX_WITH_MULTIBYTE_CHECK (c) == Sstring)
2342 : SYNTAX_WITH_MULTIBYTE_CHECK (c) == Sstring_fence)
2343 break;
2344
2345 /* Some compilers can't handle this inside the switch. */
2346 temp = SYNTAX_WITH_MULTIBYTE_CHECK (c);
2347 switch (temp)
2348 {
2349 case Scharquote:
2350 case Sescape:
2351 INC_BOTH (from, from_byte);
2352 }
2353 INC_BOTH (from, from_byte);
2354 }
2355 INC_BOTH (from, from_byte);
2356 if (!depth && sexpflag) goto done;
2357 break;
2358 }
2359 }
2360
2361 /* Reached end of buffer. Error if within object, return nil if between */
2362 if (depth) goto lose;
2363
2364 immediate_quit = 0;
2365 return Qnil;
2366
2367 /* End of object reached */
2368 done:
2369 count--;
2370 }
2371
2372 while (count < 0)
2373 {
2374 while (from > stop)
2375 {
2376 DEC_BOTH (from, from_byte);
2377 UPDATE_SYNTAX_TABLE_BACKWARD (from);
2378 c = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2379 code = SYNTAX_WITH_MULTIBYTE_CHECK (c);
2380 if (depth == min_depth)
2381 last_good = from;
2382 comstyle = 0;
2383 comnested = SYNTAX_COMMENT_NESTED (c);
2384 if (code == Sendcomment)
2385 comstyle = SYNTAX_COMMENT_STYLE (c);
2386 if (from > stop && SYNTAX_COMEND_SECOND (c)
2387 && prev_char_comend_first (from, from_byte)
2388 && parse_sexp_ignore_comments)
2389 {
2390 /* We must record the comment style encountered so that
2391 later, we can match only the proper comment begin
2392 sequence of the same style. */
2393 DEC_BOTH (from, from_byte);
2394 UPDATE_SYNTAX_TABLE_BACKWARD (from);
2395 code = Sendcomment;
2396 c1 = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2397 comstyle = SYNTAX_COMMENT_STYLE (c1);
2398 comnested = comnested || SYNTAX_COMMENT_NESTED (c1);
2399 }
2400
2401 /* Quoting turns anything except a comment-ender
2402 into a word character. Note that this cannot be true
2403 if we decremented FROM in the if-statement above. */
2404 if (code != Sendcomment && char_quoted (from, from_byte))
2405 code = Sword;
2406 else if (SYNTAX_PREFIX (c))
2407 continue;
2408
2409 switch (SWITCH_ENUM_CAST (code))
2410 {
2411 case Sword:
2412 case Ssymbol:
2413 case Sescape:
2414 case Scharquote:
2415 if (depth || !sexpflag) break;
2416 /* This word counts as a sexp; count object finished
2417 after passing it. */
2418 while (from > stop)
2419 {
2420 temp_pos = from_byte;
2421 if (! NILP (current_buffer->enable_multibyte_characters))
2422 DEC_POS (temp_pos);
2423 else
2424 temp_pos--;
2425 UPDATE_SYNTAX_TABLE_BACKWARD (from - 1);
2426 c1 = FETCH_CHAR_AS_MULTIBYTE (temp_pos);
2427 temp_code = SYNTAX_WITH_MULTIBYTE_CHECK (c1);
2428 /* Don't allow comment-end to be quoted. */
2429 if (temp_code == Sendcomment)
2430 goto done2;
2431 quoted = char_quoted (from - 1, temp_pos);
2432 if (quoted)
2433 {
2434 DEC_BOTH (from, from_byte);
2435 temp_pos = dec_bytepos (temp_pos);
2436 UPDATE_SYNTAX_TABLE_BACKWARD (from - 1);
2437 }
2438 c1 = FETCH_CHAR_AS_MULTIBYTE (temp_pos);
2439 temp_code = SYNTAX_WITH_MULTIBYTE_CHECK (c1);
2440 if (! (quoted || temp_code == Sword
2441 || temp_code == Ssymbol
2442 || temp_code == Squote))
2443 goto done2;
2444 DEC_BOTH (from, from_byte);
2445 }
2446 goto done2;
2447
2448 case Smath:
2449 if (!sexpflag)
2450 break;
2451 temp_pos = dec_bytepos (from_byte);
2452 UPDATE_SYNTAX_TABLE_BACKWARD (from - 1);
2453 if (from != stop && c == FETCH_CHAR_AS_MULTIBYTE (temp_pos))
2454 DEC_BOTH (from, from_byte);
2455 if (mathexit)
2456 {
2457 mathexit = 0;
2458 goto open2;
2459 }
2460 mathexit = 1;
2461
2462 case Sclose:
2463 if (!++depth) goto done2;
2464 break;
2465
2466 case Sopen:
2467 open2:
2468 if (!--depth) goto done2;
2469 if (depth < min_depth)
2470 Fsignal (Qscan_error,
2471 Fcons (build_string ("Containing expression ends prematurely"),
2472 Fcons (make_number (last_good),
2473 Fcons (make_number (from), Qnil))));
2474 break;
2475
2476 case Sendcomment:
2477 if (!parse_sexp_ignore_comments)
2478 break;
2479 found = back_comment (from, from_byte, stop, comnested, comstyle,
2480 &out_charpos, &out_bytepos);
2481 /* FIXME: if found == -1, then it really wasn't a comment-end.
2482 For single-char Sendcomment, we can't do much about it apart
2483 from skipping the char.
2484 For 2-char endcomments, we could try again, taking both
2485 chars as separate entities, but it's a lot of trouble
2486 for very little gain, so we don't bother either. -sm */
2487 if (found != -1)
2488 from = out_charpos, from_byte = out_bytepos;
2489 break;
2490
2491 case Scomment_fence:
2492 case Sstring_fence:
2493 while (1)
2494 {
2495 DEC_BOTH (from, from_byte);
2496 if (from == stop) goto lose;
2497 UPDATE_SYNTAX_TABLE_BACKWARD (from);
2498 if (!char_quoted (from, from_byte)
2499 && (c = FETCH_CHAR_AS_MULTIBYTE (from_byte),
2500 SYNTAX_WITH_MULTIBYTE_CHECK (c) == code))
2501 break;
2502 }
2503 if (code == Sstring_fence && !depth && sexpflag) goto done2;
2504 break;
2505
2506 case Sstring:
2507 stringterm = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2508 while (1)
2509 {
2510 if (from == stop) goto lose;
2511 temp_pos = from_byte;
2512 if (! NILP (current_buffer->enable_multibyte_characters))
2513 DEC_POS (temp_pos);
2514 else
2515 temp_pos--;
2516 UPDATE_SYNTAX_TABLE_BACKWARD (from - 1);
2517 if (!char_quoted (from - 1, temp_pos)
2518 && stringterm == (c = FETCH_CHAR_AS_MULTIBYTE (temp_pos))
2519 && SYNTAX_WITH_MULTIBYTE_CHECK (c) == Sstring)
2520 break;
2521 DEC_BOTH (from, from_byte);
2522 }
2523 DEC_BOTH (from, from_byte);
2524 if (!depth && sexpflag) goto done2;
2525 break;
2526 }
2527 }
2528
2529 /* Reached start of buffer. Error if within object, return nil if between */
2530 if (depth) goto lose;
2531
2532 immediate_quit = 0;
2533 return Qnil;
2534
2535 done2:
2536 count++;
2537 }
2538
2539
2540 immediate_quit = 0;
2541 XSETFASTINT (val, from);
2542 return val;
2543
2544 lose:
2545 Fsignal (Qscan_error,
2546 Fcons (build_string ("Unbalanced parentheses"),
2547 Fcons (make_number (last_good),
2548 Fcons (make_number (from), Qnil))));
2549
2550 /* NOTREACHED */
2551 }
2552
2553 DEFUN ("scan-lists", Fscan_lists, Sscan_lists, 3, 3, 0,
2554 doc: /* Scan from character number FROM by COUNT lists.
2555 Returns the character number of the position thus found.
2556
2557 If DEPTH is nonzero, paren depth begins counting from that value,
2558 only places where the depth in parentheses becomes zero
2559 are candidates for stopping; COUNT such places are counted.
2560 Thus, a positive value for DEPTH means go out levels.
2561
2562 Comments are ignored if `parse-sexp-ignore-comments' is non-nil.
2563
2564 If the beginning or end of (the accessible part of) the buffer is reached
2565 and the depth is wrong, an error is signaled.
2566 If the depth is right but the count is not used up, nil is returned. */)
2567 (from, count, depth)
2568 Lisp_Object from, count, depth;
2569 {
2570 CHECK_NUMBER (from);
2571 CHECK_NUMBER (count);
2572 CHECK_NUMBER (depth);
2573
2574 return scan_lists (XINT (from), XINT (count), XINT (depth), 0);
2575 }
2576
2577 DEFUN ("scan-sexps", Fscan_sexps, Sscan_sexps, 2, 2, 0,
2578 doc: /* Scan from character number FROM by COUNT balanced expressions.
2579 If COUNT is negative, scan backwards.
2580 Returns the character number of the position thus found.
2581
2582 Comments are ignored if `parse-sexp-ignore-comments' is non-nil.
2583
2584 If the beginning or end of (the accessible part of) the buffer is reached
2585 in the middle of a parenthetical grouping, an error is signaled.
2586 If the beginning or end is reached between groupings
2587 but before count is used up, nil is returned. */)
2588 (from, count)
2589 Lisp_Object from, count;
2590 {
2591 CHECK_NUMBER (from);
2592 CHECK_NUMBER (count);
2593
2594 return scan_lists (XINT (from), XINT (count), 0, 1);
2595 }
2596
2597 DEFUN ("backward-prefix-chars", Fbackward_prefix_chars, Sbackward_prefix_chars,
2598 0, 0, 0,
2599 doc: /* Move point backward over any number of chars with prefix syntax.
2600 This includes chars with "quote" or "prefix" syntax (' or p). */)
2601 ()
2602 {
2603 int beg = BEGV;
2604 int opoint = PT;
2605 int opoint_byte = PT_BYTE;
2606 int pos = PT;
2607 int pos_byte = PT_BYTE;
2608 int c;
2609
2610 if (pos <= beg)
2611 {
2612 SET_PT_BOTH (opoint, opoint_byte);
2613
2614 return Qnil;
2615 }
2616
2617 SETUP_SYNTAX_TABLE (pos, -1);
2618
2619 DEC_BOTH (pos, pos_byte);
2620
2621 while (!char_quoted (pos, pos_byte)
2622 /* Previous statement updates syntax table. */
2623 && ((c = FETCH_CHAR_AS_MULTIBYTE (pos_byte), SYNTAX (c) == Squote)
2624 || SYNTAX_PREFIX (c)))
2625 {
2626 opoint = pos;
2627 opoint_byte = pos_byte;
2628
2629 if (pos + 1 > beg)
2630 DEC_BOTH (pos, pos_byte);
2631 }
2632
2633 SET_PT_BOTH (opoint, opoint_byte);
2634
2635 return Qnil;
2636 }
2637 \f
2638 /* Parse forward from FROM / FROM_BYTE to END,
2639 assuming that FROM has state OLDSTATE (nil means FROM is start of function),
2640 and return a description of the state of the parse at END.
2641 If STOPBEFORE is nonzero, stop at the start of an atom.
2642 If COMMENTSTOP is 1, stop at the start of a comment.
2643 If COMMENTSTOP is -1, stop at the start or end of a comment,
2644 after the beginning of a string, or after the end of a string. */
2645
2646 static void
2647 scan_sexps_forward (stateptr, from, from_byte, end, targetdepth,
2648 stopbefore, oldstate, commentstop)
2649 struct lisp_parse_state *stateptr;
2650 register int from;
2651 int from_byte;
2652 int end, targetdepth, stopbefore;
2653 Lisp_Object oldstate;
2654 int commentstop;
2655 {
2656 struct lisp_parse_state state;
2657
2658 register enum syntaxcode code;
2659 int c1;
2660 int comnested;
2661 struct level { int last, prev; };
2662 struct level levelstart[100];
2663 register struct level *curlevel = levelstart;
2664 struct level *endlevel = levelstart + 100;
2665 register int depth; /* Paren depth of current scanning location.
2666 level - levelstart equals this except
2667 when the depth becomes negative. */
2668 int mindepth; /* Lowest DEPTH value seen. */
2669 int start_quoted = 0; /* Nonzero means starting after a char quote */
2670 Lisp_Object tem;
2671 int prev_from; /* Keep one character before FROM. */
2672 int prev_from_byte;
2673 int prev_from_syntax;
2674 int boundary_stop = commentstop == -1;
2675 int nofence;
2676 int found;
2677 int out_bytepos, out_charpos;
2678 int temp;
2679
2680 prev_from = from;
2681 prev_from_byte = from_byte;
2682 if (from != BEGV)
2683 DEC_BOTH (prev_from, prev_from_byte);
2684
2685 /* Use this macro instead of `from++'. */
2686 #define INC_FROM \
2687 do { prev_from = from; \
2688 prev_from_byte = from_byte; \
2689 prev_from_syntax \
2690 = SYNTAX_WITH_FLAGS (FETCH_CHAR (prev_from_byte)); \
2691 INC_BOTH (from, from_byte); \
2692 UPDATE_SYNTAX_TABLE_FORWARD (from); \
2693 } while (0)
2694
2695 immediate_quit = 1;
2696 QUIT;
2697
2698 if (NILP (oldstate))
2699 {
2700 depth = 0;
2701 state.instring = -1;
2702 state.incomment = 0;
2703 state.comstyle = 0; /* comment style a by default. */
2704 state.comstr_start = -1; /* no comment/string seen. */
2705 }
2706 else
2707 {
2708 tem = Fcar (oldstate);
2709 if (!NILP (tem))
2710 depth = XINT (tem);
2711 else
2712 depth = 0;
2713
2714 oldstate = Fcdr (oldstate);
2715 oldstate = Fcdr (oldstate);
2716 oldstate = Fcdr (oldstate);
2717 tem = Fcar (oldstate);
2718 /* Check whether we are inside string_fence-style string: */
2719 state.instring = (!NILP (tem)
2720 ? (INTEGERP (tem) ? XINT (tem) : ST_STRING_STYLE)
2721 : -1);
2722
2723 oldstate = Fcdr (oldstate);
2724 tem = Fcar (oldstate);
2725 state.incomment = (!NILP (tem)
2726 ? (INTEGERP (tem) ? XINT (tem) : -1)
2727 : 0);
2728
2729 oldstate = Fcdr (oldstate);
2730 tem = Fcar (oldstate);
2731 start_quoted = !NILP (tem);
2732
2733 /* if the eighth element of the list is nil, we are in comment
2734 style a. If it is non-nil, we are in comment style b */
2735 oldstate = Fcdr (oldstate);
2736 oldstate = Fcdr (oldstate);
2737 tem = Fcar (oldstate);
2738 state.comstyle = NILP (tem) ? 0 : (EQ (tem, Qsyntax_table)
2739 ? ST_COMMENT_STYLE : 1);
2740
2741 oldstate = Fcdr (oldstate);
2742 tem = Fcar (oldstate);
2743 state.comstr_start = NILP (tem) ? -1 : XINT (tem) ;
2744 oldstate = Fcdr (oldstate);
2745 tem = Fcar (oldstate);
2746 while (!NILP (tem)) /* >= second enclosing sexps. */
2747 {
2748 /* curlevel++->last ran into compiler bug on Apollo */
2749 curlevel->last = XINT (Fcar (tem));
2750 if (++curlevel == endlevel)
2751 curlevel--; /* error ("Nesting too deep for parser"); */
2752 curlevel->prev = -1;
2753 curlevel->last = -1;
2754 tem = Fcdr (tem);
2755 }
2756 }
2757 state.quoted = 0;
2758 mindepth = depth;
2759
2760 curlevel->prev = -1;
2761 curlevel->last = -1;
2762
2763 SETUP_SYNTAX_TABLE (prev_from, 1);
2764 prev_from_syntax = SYNTAX_WITH_FLAGS (FETCH_CHAR (prev_from_byte));
2765 UPDATE_SYNTAX_TABLE_FORWARD (from);
2766
2767 /* Enter the loop at a place appropriate for initial state. */
2768
2769 if (state.incomment)
2770 goto startincomment;
2771 if (state.instring >= 0)
2772 {
2773 nofence = state.instring != ST_STRING_STYLE;
2774 if (start_quoted)
2775 goto startquotedinstring;
2776 goto startinstring;
2777 }
2778 else if (start_quoted)
2779 goto startquoted;
2780
2781 #if 0 /* This seems to be redundant with the identical code above. */
2782 SETUP_SYNTAX_TABLE (prev_from, 1);
2783 prev_from_syntax = SYNTAX_WITH_FLAGS (FETCH_CHAR (prev_from_byte));
2784 UPDATE_SYNTAX_TABLE_FORWARD (from);
2785 #endif
2786
2787 while (from < end)
2788 {
2789 INC_FROM;
2790 code = prev_from_syntax & 0xff;
2791
2792 if (code == Scomment)
2793 {
2794 state.comstyle = SYNTAX_FLAGS_COMMENT_STYLE (prev_from_syntax);
2795 state.incomment = (SYNTAX_FLAGS_COMMENT_NESTED (prev_from_syntax) ?
2796 1 : -1);
2797 state.comstr_start = prev_from;
2798 }
2799 else if (code == Scomment_fence)
2800 {
2801 /* Record the comment style we have entered so that only
2802 the comment-end sequence of the same style actually
2803 terminates the comment section. */
2804 state.comstyle = ST_COMMENT_STYLE;
2805 state.incomment = -1;
2806 state.comstr_start = prev_from;
2807 code = Scomment;
2808 }
2809 else if (from < end)
2810 if (SYNTAX_FLAGS_COMSTART_FIRST (prev_from_syntax))
2811 if (c1 = FETCH_CHAR (from_byte),
2812 SYNTAX_COMSTART_SECOND (c1))
2813 /* Duplicate code to avoid a complex if-expression
2814 which causes trouble for the SGI compiler. */
2815 {
2816 /* Record the comment style we have entered so that only
2817 the comment-end sequence of the same style actually
2818 terminates the comment section. */
2819 state.comstyle = SYNTAX_COMMENT_STYLE (FETCH_CHAR (from_byte));
2820 comnested = SYNTAX_FLAGS_COMMENT_NESTED (prev_from_syntax);
2821 comnested = comnested || SYNTAX_COMMENT_NESTED (c1);
2822 state.incomment = comnested ? 1 : -1;
2823 state.comstr_start = prev_from;
2824 INC_FROM;
2825 code = Scomment;
2826 }
2827
2828 if (SYNTAX_FLAGS_PREFIX (prev_from_syntax))
2829 continue;
2830 switch (SWITCH_ENUM_CAST (code))
2831 {
2832 case Sescape:
2833 case Scharquote:
2834 if (stopbefore) goto stop; /* this arg means stop at sexp start */
2835 curlevel->last = prev_from;
2836 startquoted:
2837 if (from == end) goto endquoted;
2838 INC_FROM;
2839 goto symstarted;
2840 /* treat following character as a word constituent */
2841 case Sword:
2842 case Ssymbol:
2843 if (stopbefore) goto stop; /* this arg means stop at sexp start */
2844 curlevel->last = prev_from;
2845 symstarted:
2846 while (from < end)
2847 {
2848 /* Some compilers can't handle this inside the switch. */
2849 temp = SYNTAX (FETCH_CHAR_AS_MULTIBYTE (from_byte));
2850 switch (temp)
2851 {
2852 case Scharquote:
2853 case Sescape:
2854 INC_FROM;
2855 if (from == end) goto endquoted;
2856 break;
2857 case Sword:
2858 case Ssymbol:
2859 case Squote:
2860 break;
2861 default:
2862 goto symdone;
2863 }
2864 INC_FROM;
2865 }
2866 symdone:
2867 curlevel->prev = curlevel->last;
2868 break;
2869
2870 case Scomment:
2871 if (commentstop || boundary_stop) goto done;
2872 startincomment:
2873 /* The (from == BEGV) test was to enter the loop in the middle so
2874 that we find a 2-char comment ender even if we start in the
2875 middle of it. We don't want to do that if we're just at the
2876 beginning of the comment (think of (*) ... (*)). */
2877 found = forw_comment (from, from_byte, end,
2878 state.incomment, state.comstyle,
2879 (from == BEGV || from < state.comstr_start + 3)
2880 ? 0 : prev_from_syntax,
2881 &out_charpos, &out_bytepos, &state.incomment);
2882 from = out_charpos; from_byte = out_bytepos;
2883 /* Beware! prev_from and friends are invalid now.
2884 Luckily, the `done' doesn't use them and the INC_FROM
2885 sets them to a sane value without looking at them. */
2886 if (!found) goto done;
2887 INC_FROM;
2888 state.incomment = 0;
2889 state.comstyle = 0; /* reset the comment style */
2890 if (boundary_stop) goto done;
2891 break;
2892
2893 case Sopen:
2894 if (stopbefore) goto stop; /* this arg means stop at sexp start */
2895 depth++;
2896 /* curlevel++->last ran into compiler bug on Apollo */
2897 curlevel->last = prev_from;
2898 if (++curlevel == endlevel)
2899 curlevel--; /* error ("Nesting too deep for parser"); */
2900 curlevel->prev = -1;
2901 curlevel->last = -1;
2902 if (targetdepth == depth) goto done;
2903 break;
2904
2905 case Sclose:
2906 depth--;
2907 if (depth < mindepth)
2908 mindepth = depth;
2909 if (curlevel != levelstart)
2910 curlevel--;
2911 curlevel->prev = curlevel->last;
2912 if (targetdepth == depth) goto done;
2913 break;
2914
2915 case Sstring:
2916 case Sstring_fence:
2917 state.comstr_start = from - 1;
2918 if (stopbefore) goto stop; /* this arg means stop at sexp start */
2919 curlevel->last = prev_from;
2920 state.instring = (code == Sstring
2921 ? (FETCH_CHAR_AS_MULTIBYTE (prev_from_byte))
2922 : ST_STRING_STYLE);
2923 if (boundary_stop) goto done;
2924 startinstring:
2925 {
2926 nofence = state.instring != ST_STRING_STYLE;
2927
2928 while (1)
2929 {
2930 int c;
2931
2932 if (from >= end) goto done;
2933 c = FETCH_CHAR_AS_MULTIBYTE (from_byte);
2934 /* Some compilers can't handle this inside the switch. */
2935 temp = SYNTAX (c);
2936
2937 /* Check TEMP here so that if the char has
2938 a syntax-table property which says it is NOT
2939 a string character, it does not end the string. */
2940 if (nofence && c == state.instring && temp == Sstring)
2941 break;
2942
2943 switch (temp)
2944 {
2945 case Sstring_fence:
2946 if (!nofence) goto string_end;
2947 break;
2948 case Scharquote:
2949 case Sescape:
2950 INC_FROM;
2951 startquotedinstring:
2952 if (from >= end) goto endquoted;
2953 }
2954 INC_FROM;
2955 }
2956 }
2957 string_end:
2958 state.instring = -1;
2959 curlevel->prev = curlevel->last;
2960 INC_FROM;
2961 if (boundary_stop) goto done;
2962 break;
2963
2964 case Smath:
2965 break;
2966 }
2967 }
2968 goto done;
2969
2970 stop: /* Here if stopping before start of sexp. */
2971 from = prev_from; /* We have just fetched the char that starts it; */
2972 goto done; /* but return the position before it. */
2973
2974 endquoted:
2975 state.quoted = 1;
2976 done:
2977 state.depth = depth;
2978 state.mindepth = mindepth;
2979 state.thislevelstart = curlevel->prev;
2980 state.prevlevelstart
2981 = (curlevel == levelstart) ? -1 : (curlevel - 1)->last;
2982 state.location = from;
2983 state.levelstarts = Qnil;
2984 while (--curlevel >= levelstart)
2985 state.levelstarts = Fcons (make_number (curlevel->last),
2986 state.levelstarts);
2987 immediate_quit = 0;
2988
2989 *stateptr = state;
2990 }
2991
2992 DEFUN ("parse-partial-sexp", Fparse_partial_sexp, Sparse_partial_sexp, 2, 6, 0,
2993 doc: /* Parse Lisp syntax starting at FROM until TO; return status of parse at TO.
2994 Parsing stops at TO or when certain criteria are met;
2995 point is set to where parsing stops.
2996 If fifth arg OLDSTATE is omitted or nil,
2997 parsing assumes that FROM is the beginning of a function.
2998 Value is a list of ten elements describing final state of parsing:
2999 0. depth in parens.
3000 1. character address of start of innermost containing list; nil if none.
3001 2. character address of start of last complete sexp terminated.
3002 3. non-nil if inside a string.
3003 (it is the character that will terminate the string,
3004 or t if the string should be terminated by a generic string delimiter.)
3005 4. nil if outside a comment, t if inside a non-nestable comment,
3006 else an integer (the current comment nesting).
3007 5. t if following a quote character.
3008 6. the minimum paren-depth encountered during this scan.
3009 7. t if in a comment of style b; symbol `syntax-table' if the comment
3010 should be terminated by a generic comment delimiter.
3011 8. character address of start of comment or string; nil if not in one.
3012 9. Intermediate data for continuation of parsing (subject to change).
3013 If third arg TARGETDEPTH is non-nil, parsing stops if the depth
3014 in parentheses becomes equal to TARGETDEPTH.
3015 Fourth arg STOPBEFORE non-nil means stop when come to
3016 any character that starts a sexp.
3017 Fifth arg OLDSTATE is a nine-element list like what this function returns.
3018 It is used to initialize the state of the parse. Elements number 1, 2, 6
3019 and 8 are ignored; you can leave off element 8 (the last) entirely.
3020 Sixth arg COMMENTSTOP non-nil means stop at the start of a comment.
3021 If it is symbol `syntax-table', stop after the start of a comment or a
3022 string, or after end of a comment or a string. */)
3023 (from, to, targetdepth, stopbefore, oldstate, commentstop)
3024 Lisp_Object from, to, targetdepth, stopbefore, oldstate, commentstop;
3025 {
3026 struct lisp_parse_state state;
3027 int target;
3028
3029 if (!NILP (targetdepth))
3030 {
3031 CHECK_NUMBER (targetdepth);
3032 target = XINT (targetdepth);
3033 }
3034 else
3035 target = -100000; /* We won't reach this depth */
3036
3037 validate_region (&from, &to);
3038 scan_sexps_forward (&state, XINT (from), CHAR_TO_BYTE (XINT (from)),
3039 XINT (to),
3040 target, !NILP (stopbefore), oldstate,
3041 (NILP (commentstop)
3042 ? 0 : (EQ (commentstop, Qsyntax_table) ? -1 : 1)));
3043
3044 SET_PT (state.location);
3045
3046 return Fcons (make_number (state.depth),
3047 Fcons (state.prevlevelstart < 0 ? Qnil : make_number (state.prevlevelstart),
3048 Fcons (state.thislevelstart < 0 ? Qnil : make_number (state.thislevelstart),
3049 Fcons (state.instring >= 0
3050 ? (state.instring == ST_STRING_STYLE
3051 ? Qt : make_number (state.instring)) : Qnil,
3052 Fcons (state.incomment < 0 ? Qt :
3053 (state.incomment == 0 ? Qnil :
3054 make_number (state.incomment)),
3055 Fcons (state.quoted ? Qt : Qnil,
3056 Fcons (make_number (state.mindepth),
3057 Fcons ((state.comstyle
3058 ? (state.comstyle == ST_COMMENT_STYLE
3059 ? Qsyntax_table : Qt) :
3060 Qnil),
3061 Fcons (((state.incomment
3062 || (state.instring >= 0))
3063 ? make_number (state.comstr_start)
3064 : Qnil),
3065 Fcons (state.levelstarts, Qnil))))))))));
3066 }
3067 \f
3068 void
3069 init_syntax_once ()
3070 {
3071 register int i, c;
3072 Lisp_Object temp;
3073
3074 /* This has to be done here, before we call Fmake_char_table. */
3075 Qsyntax_table = intern ("syntax-table");
3076 staticpro (&Qsyntax_table);
3077
3078 /* Intern this now in case it isn't already done.
3079 Setting this variable twice is harmless.
3080 But don't staticpro it here--that is done in alloc.c. */
3081 Qchar_table_extra_slots = intern ("char-table-extra-slots");
3082
3083 /* Create objects which can be shared among syntax tables. */
3084 Vsyntax_code_object = Fmake_vector (make_number (Smax), Qnil);
3085 for (i = 0; i < XVECTOR (Vsyntax_code_object)->size; i++)
3086 XVECTOR (Vsyntax_code_object)->contents[i]
3087 = Fcons (make_number (i), Qnil);
3088
3089 /* Now we are ready to set up this property, so we can
3090 create syntax tables. */
3091 Fput (Qsyntax_table, Qchar_table_extra_slots, make_number (0));
3092
3093 temp = XVECTOR (Vsyntax_code_object)->contents[(int) Swhitespace];
3094
3095 Vstandard_syntax_table = Fmake_char_table (Qsyntax_table, temp);
3096
3097 temp = XVECTOR (Vsyntax_code_object)->contents[(int) Sword];
3098 for (i = 'a'; i <= 'z'; i++)
3099 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, i, temp);
3100 for (i = 'A'; i <= 'Z'; i++)
3101 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, i, temp);
3102 for (i = '0'; i <= '9'; i++)
3103 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, i, temp);
3104
3105 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, '$', temp);
3106 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, '%', temp);
3107
3108 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, '(',
3109 Fcons (make_number (Sopen), make_number (')')));
3110 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, ')',
3111 Fcons (make_number (Sclose), make_number ('(')));
3112 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, '[',
3113 Fcons (make_number (Sopen), make_number (']')));
3114 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, ']',
3115 Fcons (make_number (Sclose), make_number ('[')));
3116 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, '{',
3117 Fcons (make_number (Sopen), make_number ('}')));
3118 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, '}',
3119 Fcons (make_number (Sclose), make_number ('{')));
3120 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, '"',
3121 Fcons (make_number ((int) Sstring), Qnil));
3122 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, '\\',
3123 Fcons (make_number ((int) Sescape), Qnil));
3124
3125 temp = XVECTOR (Vsyntax_code_object)->contents[(int) Ssymbol];
3126 for (i = 0; i < 10; i++)
3127 {
3128 c = "_-+*/&|<>="[i];
3129 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, c, temp);
3130 }
3131
3132 temp = XVECTOR (Vsyntax_code_object)->contents[(int) Spunct];
3133 for (i = 0; i < 12; i++)
3134 {
3135 c = ".,;:?!#@~^'`"[i];
3136 SET_RAW_SYNTAX_ENTRY (Vstandard_syntax_table, c, temp);
3137 }
3138
3139 /* All multibyte characters have syntax `word' by default. */
3140 temp = XVECTOR (Vsyntax_code_object)->contents[(int) Sword];
3141 char_table_set_range (Vstandard_syntax_table, 0x80, MAX_CHAR, temp);
3142 }
3143
3144 void
3145 syms_of_syntax ()
3146 {
3147 Qsyntax_table_p = intern ("syntax-table-p");
3148 staticpro (&Qsyntax_table_p);
3149
3150 staticpro (&Vsyntax_code_object);
3151
3152 Qscan_error = intern ("scan-error");
3153 staticpro (&Qscan_error);
3154 Fput (Qscan_error, Qerror_conditions,
3155 Fcons (Qscan_error, Fcons (Qerror, Qnil)));
3156 Fput (Qscan_error, Qerror_message,
3157 build_string ("Scan error"));
3158
3159 DEFVAR_BOOL ("parse-sexp-ignore-comments", &parse_sexp_ignore_comments,
3160 doc: /* Non-nil means `forward-sexp', etc., should treat comments as whitespace. */);
3161
3162 DEFVAR_BOOL ("parse-sexp-lookup-properties", &parse_sexp_lookup_properties,
3163 doc: /* Non-nil means `forward-sexp', etc., obey `syntax-table' property.
3164 Otherwise, that text property is simply ignored.
3165 See the info node `(elisp)Syntax Properties' for a description of the
3166 `syntax-table' property. */);
3167
3168 words_include_escapes = 0;
3169 DEFVAR_BOOL ("words-include-escapes", &words_include_escapes,
3170 doc: /* Non-nil means `forward-word', etc., should treat escape chars part of words. */);
3171
3172 DEFVAR_BOOL ("multibyte-syntax-as-symbol", &multibyte_syntax_as_symbol,
3173 doc: /* Non-nil means `scan-sexps' treats all multibyte characters as symbol constituents. */);
3174 multibyte_syntax_as_symbol = 0;
3175
3176 DEFVAR_BOOL ("open-paren-in-column-0-is-defun-start",
3177 &open_paren_in_column_0_is_defun_start,
3178 doc: /* Non-nil means an open paren in column 0 denotes the start of a defun. */);
3179 open_paren_in_column_0_is_defun_start = 1;
3180
3181 DEFVAR_LISP ("next-word-boundary-function-table",
3182 &Vnext_word_boundary_function_table,
3183 doc: /*
3184 Char table of functions to search for the next word boundary.
3185 Each function is called with two arguments; POS and LIMIT.
3186 POS and LIMIT are character positions in the current buffer.
3187
3188 If POS is less than LIMIT, POS is at the first character of a word,
3189 and the return value of a function is a position after the last
3190 character of that word.
3191
3192 If POS is not less than LIMIT, POS is at the last character of a word,
3193 and the return value of a function is a position at the first
3194 character of that word.
3195
3196 In both cases, LIMIT bounds the search. */);
3197 Vnext_word_boundary_function_table = Fmake_char_table (Qnil, Qnil);
3198
3199 defsubr (&Ssyntax_table_p);
3200 defsubr (&Ssyntax_table);
3201 defsubr (&Sstandard_syntax_table);
3202 defsubr (&Scopy_syntax_table);
3203 defsubr (&Sset_syntax_table);
3204 defsubr (&Schar_syntax);
3205 defsubr (&Smatching_paren);
3206 defsubr (&Sstring_to_syntax);
3207 defsubr (&Smodify_syntax_entry);
3208 defsubr (&Sinternal_describe_syntax_value);
3209
3210 defsubr (&Sforward_word);
3211
3212 defsubr (&Sskip_chars_forward);
3213 defsubr (&Sskip_chars_backward);
3214 defsubr (&Sskip_syntax_forward);
3215 defsubr (&Sskip_syntax_backward);
3216
3217 defsubr (&Sforward_comment);
3218 defsubr (&Sscan_lists);
3219 defsubr (&Sscan_sexps);
3220 defsubr (&Sbackward_prefix_chars);
3221 defsubr (&Sparse_partial_sexp);
3222 }