(dired-get-filename): Don't call encode-coding-string
[bpt/emacs.git] / src / syntax.h
CommitLineData
9889c728 1/* Declarations having to do with GNU Emacs syntax tables.
4a2f9c6a 2 Copyright (C) 1985, 93, 94, 97, 1998 Free Software Foundation, Inc.
9889c728
JB
3
4This file is part of GNU Emacs.
5
6GNU Emacs is free software; you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
7c938215 8the Free Software Foundation; either version 2, or (at your option)
9889c728
JB
9any later version.
10
11GNU Emacs is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
17along with GNU Emacs; see the file COPYING. If not, write to
3b7ad313
EN
18the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19Boston, MA 02111-1307, USA. */
9889c728
JB
20
21
22extern Lisp_Object Qsyntax_table_p;
4c571d09 23extern void update_syntax_table P_ ((int, int, int, Lisp_Object));
9889c728
JB
24
25/* The standard syntax table is stored where it will automatically
26 be used in all new buffers. */
27#define Vstandard_syntax_table buffer_defaults.syntax_table
28
e46c910e
RS
29/* A syntax table is a chartable whose elements are cons cells
30 (CODE+FLAGS . MATCHING-CHAR). MATCHING-CHAR can be nil if the char
31 is not a kind of parenthesis.
9889c728 32
e46c910e 33 The low 8 bits of CODE+FLAGS is a code, as follows: */
9889c728
JB
34
35enum syntaxcode
36 {
37 Swhitespace, /* for a whitespace character */
38 Spunct, /* for random punctuation characters */
39 Sword, /* for a word constituent */
40 Ssymbol, /* symbol constituent but not word constituent */
41 Sopen, /* for a beginning delimiter */
42 Sclose, /* for an ending delimiter */
43 Squote, /* for a prefix character like Lisp ' */
44 Sstring, /* for a string-grouping character like Lisp " */
5eea1c5a 45 Smath, /* for delimiters like $ in Tex. */
9889c728
JB
46 Sescape, /* for a character that begins a C-style escape */
47 Scharquote, /* for a character that quotes the following character */
48 Scomment, /* for a comment-starting character */
49 Sendcomment, /* for a comment-ending character */
c8cdcb16 50 Sinherit, /* use the standard syntax table for this character */
5eea1c5a 51 Scomment_fence, /* Starts/ends comment which is delimited on the
47ab3db5 52 other side by any char with the same syntaxcode. */
5eea1c5a 53 Sstring_fence, /* Starts/ends string which is delimited on the
47ab3db5 54 other side by any char with the same syntaxcode. */
9889c728
JB
55 Smax /* Upper bound on codes that are meaningful */
56 };
57
e0b8ff93 58/* Set the syntax entry VAL for char C in table TABLE. */
e46c910e 59
0e35bfd8 60#define SET_RAW_SYNTAX_ENTRY(table, c, val) \
9ca6ab7d 61 ((c) < CHAR_TABLE_SINGLE_BYTE_SLOTS \
0e35bfd8
KH
62 ? (XCHAR_TABLE (table)->contents[(unsigned char) (c)] = (val)) \
63 : Faset ((table), make_number (c), (val)))
e0b8ff93
KH
64
65/* Fetch the syntax entry for char C in syntax table TABLE.
66 This macro is called only when C is less than CHAR_TABLE_ORDINARY_SLOTS.
67 Do inheritance. */
68
69#ifdef __GNUC__
70#define SYNTAX_ENTRY_FOLLOW_PARENT(table, c) \
71 ({ Lisp_Object tbl = table; \
72 Lisp_Object temp = XCHAR_TABLE (tbl)->contents[(c)]; \
73 while (NILP (temp)) \
74 { \
75 tbl = XCHAR_TABLE (tbl)->parent; \
76 if (NILP (tbl)) \
77 break; \
78 temp = XCHAR_TABLE (tbl)->contents[(c)]; \
79 } \
80 temp; })
c8cdcb16 81#else
e0b8ff93 82extern Lisp_Object syntax_temp;
4c571d09 83extern Lisp_Object syntax_parent_lookup P_ ((Lisp_Object, int));
e46c910e 84
e0b8ff93
KH
85#define SYNTAX_ENTRY_FOLLOW_PARENT(table, c) \
86 (syntax_temp = XCHAR_TABLE (table)->contents[(c)], \
87 (NILP (syntax_temp) \
88 ? syntax_parent_lookup (table, (c)) \
89 : syntax_temp))
c8cdcb16 90#endif
9889c728 91
5eea1c5a
RS
92/* SYNTAX_ENTRY fetches the information from the entry for character C
93 in syntax table TABLE, or from globally kept data (gl_state).
94 Does inheritance. */
95/* CURRENT_SYNTAX_TABLE gives the syntax table valid for current
96 position, it is either the buffer's syntax table, or syntax table
97 found in text properties. */
98
99#ifdef SYNTAX_ENTRY_VIA_PROPERTY
100# define SYNTAX_ENTRY(c) \
101 (gl_state.use_global ? gl_state.global_code : SYNTAX_ENTRY_INT (c))
102# define CURRENT_SYNTAX_TABLE gl_state.current_syntax_table
103#else
104# define SYNTAX_ENTRY SYNTAX_ENTRY_INT
105# define CURRENT_SYNTAX_TABLE current_buffer->syntax_table
106#endif
e0b8ff93 107
5eea1c5a 108#define SYNTAX_ENTRY_INT(c) \
9ca6ab7d 109 ((c) < CHAR_TABLE_SINGLE_BYTE_SLOTS \
5eea1c5a 110 ? SYNTAX_ENTRY_FOLLOW_PARENT (CURRENT_SYNTAX_TABLE, \
0e35bfd8 111 (unsigned char) (c)) \
5eea1c5a 112 : Faref (CURRENT_SYNTAX_TABLE, make_number ((c))))
e0b8ff93 113
e46c910e 114/* Extract the information from the entry for character C
e0b8ff93 115 in the current syntax table. */
c8cdcb16
RS
116
117#ifdef __GNUC__
e46c910e
RS
118#define SYNTAX(c) \
119 ({ Lisp_Object temp; \
120 temp = SYNTAX_ENTRY (c); \
121 (CONSP (temp) \
122 ? (enum syntaxcode) (XINT (XCONS (temp)->car) & 0xff) \
e0b8ff93 123 : Swhitespace); })
e46c910e
RS
124
125#define SYNTAX_WITH_FLAGS(c) \
126 ({ Lisp_Object temp; \
127 temp = SYNTAX_ENTRY (c); \
128 (CONSP (temp) \
129 ? XINT (XCONS (temp)->car) \
e0b8ff93 130 : (int) Swhitespace); })
e46c910e
RS
131
132#define SYNTAX_MATCH(c) \
133 ({ Lisp_Object temp; \
134 temp = SYNTAX_ENTRY (c); \
135 (CONSP (temp) \
2e34157c 136 ? XCONS (temp)->cdr \
e0b8ff93 137 : Qnil); })
c8cdcb16 138#else
e46c910e 139#define SYNTAX(c) \
9d40ebd2 140 (syntax_temp = SYNTAX_ENTRY ((c)), \
e46c910e
RS
141 (CONSP (syntax_temp) \
142 ? (enum syntaxcode) (XINT (XCONS (syntax_temp)->car) & 0xff) \
e0b8ff93 143 : Swhitespace))
e46c910e
RS
144
145#define SYNTAX_WITH_FLAGS(c) \
9d40ebd2 146 (syntax_temp = SYNTAX_ENTRY ((c)), \
e46c910e
RS
147 (CONSP (syntax_temp) \
148 ? XINT (XCONS (syntax_temp)->car) \
e0b8ff93 149 : (int) Swhitespace))
e46c910e
RS
150
151#define SYNTAX_MATCH(c) \
9d40ebd2 152 (syntax_temp = SYNTAX_ENTRY ((c)), \
e46c910e 153 (CONSP (syntax_temp) \
2e34157c 154 ? XCONS (syntax_temp)->cdr \
e0b8ff93 155 : Qnil))
c8cdcb16 156#endif
9889c728 157
a306d6f1 158/* Then there are six single-bit flags that have the following meanings:
9889c728
JB
159 1. This character is the first of a two-character comment-start sequence.
160 2. This character is the second of a two-character comment-start sequence.
161 3. This character is the first of a two-character comment-end sequence.
162 4. This character is the second of a two-character comment-end sequence.
163 5. This character is a prefix, for backward-prefix-chars.
a306d6f1
RS
164 Note that any two-character sequence whose first character has flag 1
165 and whose second character has flag 2 will be interpreted as a comment start.
166
167 bit 6 is used to discriminate between two different comment styles.
168 Languages such as C++ allow two orthogonal syntax start/end pairs
169 and bit 6 is used to determine whether a comment-end or Scommentend
5eea1c5a 170 ends style a or b. Comment start sequences can start style a or b.
a306d6f1
RS
171 Style a is always the default.
172 */
9889c728 173
e46c910e 174#define SYNTAX_COMSTART_FIRST(c) ((SYNTAX_WITH_FLAGS (c) >> 16) & 1)
c8cdcb16 175
e46c910e 176#define SYNTAX_COMSTART_SECOND(c) ((SYNTAX_WITH_FLAGS (c) >> 17) & 1)
c8cdcb16 177
e46c910e 178#define SYNTAX_COMEND_FIRST(c) ((SYNTAX_WITH_FLAGS (c) >> 18) & 1)
c8cdcb16 179
e46c910e 180#define SYNTAX_COMEND_SECOND(c) ((SYNTAX_WITH_FLAGS (c) >> 19) & 1)
c8cdcb16 181
e46c910e 182#define SYNTAX_PREFIX(c) ((SYNTAX_WITH_FLAGS (c) >> 20) & 1)
9889c728 183
a306d6f1 184/* extract the comment style bit from the syntax table entry */
e46c910e 185#define SYNTAX_COMMENT_STYLE(c) ((SYNTAX_WITH_FLAGS (c) >> 21) & 1)
a306d6f1 186
9889c728
JB
187/* This array, indexed by a character, contains the syntax code which that
188 character signifies (as a char). For example,
5eea1c5a 189 (enum syntaxcode) syntax_spec_code['w'] is Sword. */
9889c728
JB
190
191extern unsigned char syntax_spec_code[0400];
192
5eea1c5a
RS
193/* Indexed by syntax code, give the letter that describes it. */
194
195extern char syntax_code_spec[16];
196
c292db29 197/* Convert the byte offset BYTEPOS into a character position,
2f16e7fd
RS
198 for the object recorded in gl_state with SETUP_SYNTAX_TABLE_FOR_OBJECT.
199
200 The value is meant for use in the UPDATE_SYNTAX_TABLE... macros.
201 These macros do nothing when parse_sexp_lookup_properties is 0,
202 so we return 0 in that case, for speed. */
c292db29
RS
203
204#define SYNTAX_TABLE_BYTE_TO_CHAR(bytepos) \
2f16e7fd
RS
205 (! parse_sexp_lookup_properties \
206 ? 0 \
207 : STRINGP (gl_state.object) \
c292db29
RS
208 ? string_byte_to_char (gl_state.object, (bytepos)) \
209 : BUFFERP (gl_state.object) \
210 ? buf_bytepos_to_charpos (XBUFFER (gl_state.object), (bytepos)) \
211 : NILP (gl_state.object) \
212 ? BYTE_TO_CHAR ((bytepos)) \
213 : (bytepos))
214
5eea1c5a
RS
215/* Make syntax table state (gl_state) good for POS, assuming it is
216 currently good for a position before POS. */
5eea1c5a 217
c292db29 218#define UPDATE_SYNTAX_TABLE_FORWARD(pos) \
2f16e7fd
RS
219 (parse_sexp_lookup_properties \
220 && (pos) >= gl_state.e_property \
c292db29
RS
221 ? (update_syntax_table ((pos) + gl_state.offset, 1, 0, \
222 gl_state.object), \
223 1) \
224 : 0)
5eea1c5a
RS
225
226/* Make syntax table state (gl_state) good for POS, assuming it is
227 currently good for a position after POS. */
5eea1c5a 228
c292db29 229#define UPDATE_SYNTAX_TABLE_BACKWARD(pos) \
2f16e7fd
RS
230 (parse_sexp_lookup_properties \
231 && (pos) <= gl_state.b_property \
c292db29
RS
232 ? (update_syntax_table ((pos) + gl_state.offset, -1, 0, \
233 gl_state.object), \
234 1) \
235 : 0)
e2d8d746
RS
236
237/* Make syntax table good for POS. */
238
c292db29 239#define UPDATE_SYNTAX_TABLE(pos) \
2f16e7fd
RS
240 (parse_sexp_lookup_properties \
241 && (pos) <= gl_state.b_property \
c292db29
RS
242 ? (update_syntax_table ((pos) + gl_state.offset, -1, 0, \
243 gl_state.object), \
244 1) \
2f16e7fd
RS
245 : (parse_sexp_lookup_properties \
246 && (pos) >= gl_state.e_property \
c292db29
RS
247 ? (update_syntax_table ((pos) + gl_state.offset, 1, 0, \
248 gl_state.object), \
249 1) \
250 : 0))
5eea1c5a
RS
251
252/* This macro should be called with FROM at the start of forward
253 search, or after the last position of the backward search. It
254 makes sure that the first char is picked up with correct table, so
255 one does not need to call UPDATE_SYNTAX_TABLE immediately after the
256 call.
257 Sign of COUNT gives the direction of the search.
258 */
259
c292db29 260#define SETUP_SYNTAX_TABLE(FROM, COUNT) \
2f16e7fd
RS
261if (1) \
262 { \
263 gl_state.b_property = BEGV - 1; \
264 gl_state.e_property = ZV + 1; \
265 gl_state.object = Qnil; \
266 gl_state.use_global = 0; \
267 gl_state.offset = 0; \
268 gl_state.current_syntax_table = current_buffer->syntax_table; \
269 if (parse_sexp_lookup_properties) \
270 update_syntax_table ((COUNT) > 0 ? (FROM) : (FROM) - 1, (COUNT), \
271 1, Qnil); \
272 } \
273else
5eea1c5a
RS
274
275/* Same as above, but in OBJECT. If OBJECT is nil, use current buffer.
e2d8d746
RS
276 If it is t, ignore properties altogether.
277
278 This is meant for regex.c to use. For buffers, regex.c passes arguments
279 to the UPDATE_SYNTAX_TABLE macros which are relative to BEGV.
4bbd5bc3 280 So if it is a buffer, we set the offset field to BEGV. */
5eea1c5a 281
c292db29 282#define SETUP_SYNTAX_TABLE_FOR_OBJECT(OBJECT, FROM, COUNT) \
4bbd5bc3
RS
283if (1) \
284 { \
c292db29
RS
285 gl_state.object = (OBJECT); \
286 if (BUFFERP (gl_state.object)) \
287 { \
288 struct buffer *buf = XBUFFER (gl_state.object); \
1d1293dd
KH
289 gl_state.b_property = 0; \
290 gl_state.e_property = BUF_ZV (buf) - BUF_BEGV (buf) + 1; \
c292db29
RS
291 gl_state.offset = BUF_BEGV (buf) - 1; \
292 } \
293 else if (NILP (gl_state.object)) \
4bbd5bc3 294 { \
1d1293dd
KH
295 gl_state.b_property = 0; \
296 gl_state.e_property = ZV - BEGV + 1; \
4bbd5bc3
RS
297 gl_state.offset = BEGV - 1; \
298 } \
c292db29 299 else if (EQ (gl_state.object, Qt)) \
4bbd5bc3
RS
300 { \
301 gl_state.b_property = - 1; \
302 gl_state.e_property = 1500000000; \
303 gl_state.offset = 0; \
304 } \
305 else \
306 { \
307 gl_state.b_property = -1; \
c292db29 308 gl_state.e_property = 1 + XSTRING (gl_state.object)->size; \
4bbd5bc3
RS
309 gl_state.offset = 0; \
310 } \
311 gl_state.use_global = 0; \
312 gl_state.current_syntax_table = current_buffer->syntax_table; \
313 if (parse_sexp_lookup_properties) \
c292db29
RS
314 update_syntax_table ((BYTE_TO_CHAR ((FROM) + gl_state.offset) \
315 + (COUNT > 0 ? 0 : -1)), \
316 COUNT, 1, gl_state.object); \
4bbd5bc3
RS
317 } \
318else
5eea1c5a
RS
319
320struct gl_state_s
321{
c292db29 322 Lisp_Object object; /* The object we are scanning. */
5eea1c5a
RS
323 int start; /* Where to stop. */
324 int stop; /* Where to stop. */
325 int use_global; /* Whether to use global_code
326 or c_s_t. */
327 Lisp_Object global_code; /* Syntax code of current char. */
328 Lisp_Object current_syntax_table; /* Syntax table for current pos. */
329 Lisp_Object old_prop; /* Syntax-table prop at prev pos. */
330 int b_property; /* Last index where c_s_t is
331 not valid. */
332 int e_property; /* First index where c_s_t is
333 not valid. */
334 INTERVAL forward_i; /* Where to start lookup on forward */
335 INTERVAL backward_i; /* or backward movement. The
336 data in c_s_t is valid
337 between these intervals,
338 and possibly at the
339 intervals too, depending
340 on: */
e2d8d746
RS
341 /* Offset for positions specified to UPDATE_SYNTAX_TABLE. */
342 int offset;
5eea1c5a
RS
343 char left_ok;
344 char right_ok;
345};
346
347extern struct gl_state_s gl_state;
348extern int parse_sexp_lookup_properties;
4c571d09
AS
349extern INTERVAL interval_of P_ ((int, Lisp_Object));
350
351extern int scan_words P_ ((int, int));