]> code.delx.au - gnu-emacs/blob - src/indent.c
Merged in changes from CVS trunk.
[gnu-emacs] / src / indent.c
1 /* Indentation functions.
2 Copyright (C) 1985,86,87,88,93,94,95,98,2000,01,02,03,2004
3 Free Software Foundation, Inc.
4
5 This file is part of GNU Emacs.
6
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
11
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
21
22 #include <config.h>
23 #include <stdio.h>
24
25 #include "lisp.h"
26 #include "buffer.h"
27 #include "charset.h"
28 #include "category.h"
29 #include "indent.h"
30 #include "keyboard.h"
31 #include "frame.h"
32 #include "window.h"
33 #include "termchar.h"
34 #include "termopts.h"
35 #include "disptab.h"
36 #include "intervals.h"
37 #include "region-cache.h"
38
39 /* Indentation can insert tabs if this is non-zero;
40 otherwise always uses spaces. */
41
42 int indent_tabs_mode;
43
44 #define CR 015
45
46 /* These three values memorize the current column to avoid recalculation. */
47
48 /* Last value returned by current_column.
49 Some things in set last_known_column_point to -1
50 to mark the memorized value as invalid. */
51
52 double last_known_column;
53
54 /* Value of point when current_column was called. */
55
56 int last_known_column_point;
57
58 /* Value of MODIFF when current_column was called. */
59
60 int last_known_column_modified;
61
62 static double current_column_1 P_ ((void));
63 static double position_indentation P_ ((int));
64
65 /* Cache of beginning of line found by the last call of
66 current_column. */
67
68 int current_column_bol_cache;
69
70 /* Get the display table to use for the current buffer. */
71
72 struct Lisp_Char_Table *
73 buffer_display_table ()
74 {
75 Lisp_Object thisbuf;
76
77 thisbuf = current_buffer->display_table;
78 if (DISP_TABLE_P (thisbuf))
79 return XCHAR_TABLE (thisbuf);
80 if (DISP_TABLE_P (Vstandard_display_table))
81 return XCHAR_TABLE (Vstandard_display_table);
82 return 0;
83 }
84 \f
85 /* Width run cache considerations. */
86
87 /* Return the width of character C under display table DP. */
88
89 static int
90 character_width (c, dp)
91 int c;
92 struct Lisp_Char_Table *dp;
93 {
94 Lisp_Object elt;
95
96 /* These width computations were determined by examining the cases
97 in display_text_line. */
98
99 /* Everything can be handled by the display table, if it's
100 present and the element is right. */
101 if (dp && (elt = DISP_CHAR_VECTOR (dp, c), VECTORP (elt)))
102 return XVECTOR (elt)->size;
103
104 /* Some characters are special. */
105 if (c == '\n' || c == '\t' || c == '\015')
106 return 0;
107
108 /* Printing characters have width 1. */
109 else if (c >= 040 && c < 0177)
110 return 1;
111
112 /* Everybody else (control characters, metacharacters) has other
113 widths. We could return their actual widths here, but they
114 depend on things like ctl_arrow and crud like that, and they're
115 not very common at all. So we'll just claim we don't know their
116 widths. */
117 else
118 return 0;
119 }
120
121 /* Return true iff the display table DISPTAB specifies the same widths
122 for characters as WIDTHTAB. We use this to decide when to
123 invalidate the buffer's width_run_cache. */
124
125 int
126 disptab_matches_widthtab (disptab, widthtab)
127 struct Lisp_Char_Table *disptab;
128 struct Lisp_Vector *widthtab;
129 {
130 int i;
131
132 if (widthtab->size != 256)
133 abort ();
134
135 for (i = 0; i < 256; i++)
136 if (character_width (i, disptab)
137 != XFASTINT (widthtab->contents[i]))
138 return 0;
139
140 return 1;
141 }
142
143 /* Recompute BUF's width table, using the display table DISPTAB. */
144
145 void
146 recompute_width_table (buf, disptab)
147 struct buffer *buf;
148 struct Lisp_Char_Table *disptab;
149 {
150 int i;
151 struct Lisp_Vector *widthtab;
152
153 if (!VECTORP (buf->width_table))
154 buf->width_table = Fmake_vector (make_number (256), make_number (0));
155 widthtab = XVECTOR (buf->width_table);
156 if (widthtab->size != 256)
157 abort ();
158
159 for (i = 0; i < 256; i++)
160 XSETFASTINT (widthtab->contents[i], character_width (i, disptab));
161 }
162
163 /* Allocate or free the width run cache, as requested by the current
164 state of current_buffer's cache_long_line_scans variable. */
165
166 static void
167 width_run_cache_on_off ()
168 {
169 if (NILP (current_buffer->cache_long_line_scans)
170 /* And, for the moment, this feature doesn't work on multibyte
171 characters. */
172 || !NILP (current_buffer->enable_multibyte_characters))
173 {
174 /* It should be off. */
175 if (current_buffer->width_run_cache)
176 {
177 free_region_cache (current_buffer->width_run_cache);
178 current_buffer->width_run_cache = 0;
179 current_buffer->width_table = Qnil;
180 }
181 }
182 else
183 {
184 /* It should be on. */
185 if (current_buffer->width_run_cache == 0)
186 {
187 current_buffer->width_run_cache = new_region_cache ();
188 recompute_width_table (current_buffer, buffer_display_table ());
189 }
190 }
191 }
192
193 \f
194 /* Skip some invisible characters starting from POS.
195 This includes characters invisible because of text properties
196 and characters invisible because of overlays.
197
198 If position POS is followed by invisible characters,
199 skip some of them and return the position after them.
200 Otherwise return POS itself.
201
202 Set *NEXT_BOUNDARY_P to the next position at which
203 it will be necessary to call this function again.
204
205 Don't scan past TO, and don't set *NEXT_BOUNDARY_P
206 to a value greater than TO.
207
208 If WINDOW is non-nil, and this buffer is displayed in WINDOW,
209 take account of overlays that apply only in WINDOW.
210
211 We don't necessarily skip all the invisible characters after POS
212 because that could take a long time. We skip a reasonable number
213 which can be skipped quickly. If there might be more invisible
214 characters immediately following, then *NEXT_BOUNDARY_P
215 will equal the return value. */
216
217 int
218 skip_invisible (pos, next_boundary_p, to, window)
219 int pos;
220 int *next_boundary_p;
221 int to;
222 Lisp_Object window;
223 {
224 Lisp_Object prop, position, overlay_limit, proplimit;
225 Lisp_Object buffer;
226 int end, inv_p;
227
228 XSETFASTINT (position, pos);
229 XSETBUFFER (buffer, current_buffer);
230
231 /* Give faster response for overlay lookup near POS. */
232 recenter_overlay_lists (current_buffer, pos);
233
234 /* We must not advance farther than the next overlay change.
235 The overlay change might change the invisible property;
236 or there might be overlay strings to be displayed there. */
237 overlay_limit = Fnext_overlay_change (position);
238 /* As for text properties, this gives a lower bound
239 for where the invisible text property could change. */
240 proplimit = Fnext_property_change (position, buffer, Qt);
241 if (XFASTINT (overlay_limit) < XFASTINT (proplimit))
242 proplimit = overlay_limit;
243 /* PROPLIMIT is now a lower bound for the next change
244 in invisible status. If that is plenty far away,
245 use that lower bound. */
246 if (XFASTINT (proplimit) > pos + 100 || XFASTINT (proplimit) >= to)
247 *next_boundary_p = XFASTINT (proplimit);
248 /* Otherwise, scan for the next `invisible' property change. */
249 else
250 {
251 /* Don't scan terribly far. */
252 XSETFASTINT (proplimit, min (pos + 100, to));
253 /* No matter what. don't go past next overlay change. */
254 if (XFASTINT (overlay_limit) < XFASTINT (proplimit))
255 proplimit = overlay_limit;
256 end = XFASTINT (Fnext_single_property_change (position, Qinvisible,
257 buffer, proplimit));
258 #if 0
259 /* Don't put the boundary in the middle of multibyte form if
260 there is no actual property change. */
261 if (end == pos + 100
262 && !NILP (current_buffer->enable_multibyte_characters)
263 && end < ZV)
264 while (pos < end && !CHAR_HEAD_P (POS_ADDR (end)))
265 end--;
266 #endif
267 *next_boundary_p = end;
268 }
269 /* if the `invisible' property is set, we can skip to
270 the next property change */
271 prop = Fget_char_property (position, Qinvisible,
272 (!NILP (window)
273 && EQ (XWINDOW (window)->buffer, buffer))
274 ? window : buffer);
275 inv_p = TEXT_PROP_MEANS_INVISIBLE (prop);
276 /* When counting columns (window == nil), don't skip over ellipsis text. */
277 if (NILP (window) ? inv_p == 1 : inv_p)
278 return *next_boundary_p;
279 return pos;
280 }
281 \f
282 /* If a composition starts at POS/POS_BYTE and it doesn't stride over
283 POINT, set *LEN / *LEN_BYTE to the character and byte lengths, *WIDTH
284 to the width, and return 1. Otherwise, return 0. */
285
286 static int
287 check_composition (pos, pos_byte, point, len, len_byte, width)
288 int pos, pos_byte, point;
289 int *len, *len_byte, *width;
290 {
291 Lisp_Object prop;
292 int start, end;
293 int id;
294
295 if (! find_composition (pos, -1, &start, &end, &prop, Qnil)
296 || pos != start || point < end
297 || !COMPOSITION_VALID_P (start, end, prop))
298 return 0;
299 if ((id = get_composition_id (pos, pos_byte, end - pos, prop, Qnil)) < 0)
300 return 0;
301
302 *len = COMPOSITION_LENGTH (prop);
303 *len_byte = CHAR_TO_BYTE (end) - pos_byte;
304 *width = composition_table[id]->width;
305 return 1;
306 }
307 \f
308 /* Set variables WIDTH and BYTES for a multibyte sequence starting at P.
309
310 DP is a display table or NULL.
311
312 This macro is used in current_column_1, Fmove_to_column, and
313 compute_motion. */
314
315 #define MULTIBYTE_BYTES_WIDTH(p, dp) \
316 do { \
317 int c; \
318 \
319 wide_column = 0; \
320 c = STRING_CHAR_AND_LENGTH (p, MAX_MULTIBYTE_LENGTH, bytes); \
321 if (BYTES_BY_CHAR_HEAD (*p) != bytes) \
322 width = bytes * 4; \
323 else \
324 { \
325 if (dp != 0 && VECTORP (DISP_CHAR_VECTOR (dp, c))) \
326 width = XVECTOR (DISP_CHAR_VECTOR (dp, c))->size; \
327 else \
328 width = WIDTH_BY_CHAR_HEAD (*p); \
329 if (width > 1) \
330 wide_column = width; \
331 } \
332 } while (0)
333
334
335 DEFUN ("current-column", Fcurrent_column, Scurrent_column, 0, 0, 0,
336 doc: /* Return the horizontal position of point. Beginning of line is column 0.
337 This is calculated by adding together the widths of all the displayed
338 representations of the character between the start of the previous line
339 and point. (eg control characters will have a width of 2 or 4, tabs
340 will have a variable width)
341 Ignores finite width of frame, which means that this function may return
342 values greater than (frame-width).
343 Whether the line is visible (if `selective-display' is t) has no effect;
344 however, ^M is treated as end of line when `selective-display' is t. */)
345 ()
346 {
347 Lisp_Object temp;
348 XSETFASTINT (temp, (int) current_column ()); /* iftc */
349 return temp;
350 }
351
352 /* Cancel any recorded value of the horizontal position. */
353
354 void
355 invalidate_current_column ()
356 {
357 last_known_column_point = 0;
358 }
359
360 double
361 current_column ()
362 {
363 register int col;
364 register unsigned char *ptr, *stop;
365 register int tab_seen;
366 int post_tab;
367 register int c;
368 register int tab_width = XINT (current_buffer->tab_width);
369 int ctl_arrow = !NILP (current_buffer->ctl_arrow);
370 register struct Lisp_Char_Table *dp = buffer_display_table ();
371
372 if (PT == last_known_column_point
373 && MODIFF == last_known_column_modified)
374 return last_known_column;
375
376 /* If the buffer has overlays, text properties,
377 or multibyte characters, use a more general algorithm. */
378 if (BUF_INTERVALS (current_buffer)
379 || current_buffer->overlays_before
380 || current_buffer->overlays_after
381 || Z != Z_BYTE)
382 return current_column_1 ();
383
384 /* Scan backwards from point to the previous newline,
385 counting width. Tab characters are the only complicated case. */
386
387 /* Make a pointer for decrementing through the chars before point. */
388 ptr = BYTE_POS_ADDR (PT_BYTE - 1) + 1;
389 /* Make a pointer to where consecutive chars leave off,
390 going backwards from point. */
391 if (PT == BEGV)
392 stop = ptr;
393 else if (PT <= GPT || BEGV > GPT)
394 stop = BEGV_ADDR;
395 else
396 stop = GAP_END_ADDR;
397
398 if (tab_width <= 0 || tab_width > 1000)
399 tab_width = 8;
400
401 col = 0, tab_seen = 0, post_tab = 0;
402
403 while (1)
404 {
405 EMACS_INT i, n;
406 Lisp_Object charvec;
407
408 if (ptr == stop)
409 {
410 /* We stopped either for the beginning of the buffer
411 or for the gap. */
412 if (ptr == BEGV_ADDR)
413 break;
414
415 /* It was the gap. Jump back over it. */
416 stop = BEGV_ADDR;
417 ptr = GPT_ADDR;
418
419 /* Check whether that brings us to beginning of buffer. */
420 if (BEGV >= GPT)
421 break;
422 }
423
424 c = *--ptr;
425
426 if (dp && VECTORP (DISP_CHAR_VECTOR (dp, c)))
427 {
428 charvec = DISP_CHAR_VECTOR (dp, c);
429 n = ASIZE (charvec);
430 }
431 else
432 {
433 charvec = Qnil;
434 n = 1;
435 }
436
437 for (i = n - 1; i >= 0; --i)
438 {
439 if (VECTORP (charvec))
440 {
441 /* This should be handled the same as
442 next_element_from_display_vector does it. */
443 Lisp_Object entry = AREF (charvec, i);
444
445 if (INTEGERP (entry)
446 && GLYPH_CHAR_VALID_P (XFASTINT (entry)))
447 c = FAST_GLYPH_CHAR (XFASTINT (entry));
448 else
449 c = ' ';
450 }
451
452 if (c >= 040 && c < 0177)
453 col++;
454 else if (c == '\n'
455 || (c == '\r'
456 && EQ (current_buffer->selective_display, Qt)))
457 {
458 ptr++;
459 goto start_of_line_found;
460 }
461 else if (c == '\t')
462 {
463 if (tab_seen)
464 col = ((col + tab_width) / tab_width) * tab_width;
465
466 post_tab += col;
467 col = 0;
468 tab_seen = 1;
469 }
470 else if (VECTORP (charvec))
471 /* With a display table entry, C is displayed as is, and
472 not displayed as \NNN or as ^N. If C is a single-byte
473 character, it takes one column. If C is multi-byte in
474 an unibyte buffer, it's translated to unibyte, so it
475 also takes one column. */
476 ++col;
477 else
478 col += (ctl_arrow && c < 0200) ? 2 : 4;
479 }
480 }
481
482 start_of_line_found:
483
484 if (tab_seen)
485 {
486 col = ((col + tab_width) / tab_width) * tab_width;
487 col += post_tab;
488 }
489
490 if (ptr == BEGV_ADDR)
491 current_column_bol_cache = BEGV;
492 else
493 current_column_bol_cache = BYTE_TO_CHAR (PTR_BYTE_POS (ptr));
494
495 last_known_column = col;
496 last_known_column_point = PT;
497 last_known_column_modified = MODIFF;
498
499 return col;
500 }
501 \f
502 /* Return the column number of position POS
503 by scanning forward from the beginning of the line.
504 This function handles characters that are invisible
505 due to text properties or overlays. */
506
507 static double
508 current_column_1 ()
509 {
510 register int tab_width = XINT (current_buffer->tab_width);
511 register int ctl_arrow = !NILP (current_buffer->ctl_arrow);
512 register struct Lisp_Char_Table *dp = buffer_display_table ();
513 int multibyte = !NILP (current_buffer->enable_multibyte_characters);
514
515 /* Start the scan at the beginning of this line with column number 0. */
516 register int col = 0;
517 int scan, scan_byte;
518 int next_boundary;
519 int opoint = PT, opoint_byte = PT_BYTE;
520
521 scan_newline (PT, PT_BYTE, BEGV, BEGV_BYTE, -1, 1);
522 current_column_bol_cache = PT;
523 scan = PT, scan_byte = PT_BYTE;
524 SET_PT_BOTH (opoint, opoint_byte);
525 next_boundary = scan;
526
527 if (tab_width <= 0 || tab_width > 1000) tab_width = 8;
528
529 /* Scan forward to the target position. */
530 while (scan < opoint)
531 {
532 int c;
533
534 /* Occasionally we may need to skip invisible text. */
535 while (scan == next_boundary)
536 {
537 int old_scan = scan;
538 /* This updates NEXT_BOUNDARY to the next place
539 where we might need to skip more invisible text. */
540 scan = skip_invisible (scan, &next_boundary, opoint, Qnil);
541 if (scan >= opoint)
542 goto endloop;
543 if (scan != old_scan)
544 scan_byte = CHAR_TO_BYTE (scan);
545 }
546
547 /* Check composition sequence. */
548 {
549 int len, len_byte, width;
550
551 if (check_composition (scan, scan_byte, opoint,
552 &len, &len_byte, &width))
553 {
554 scan += len;
555 scan_byte += len_byte;
556 if (scan <= opoint)
557 col += width;
558 continue;
559 }
560 }
561
562 c = FETCH_BYTE (scan_byte);
563
564 if (dp != 0
565 && ! (multibyte && BASE_LEADING_CODE_P (c))
566 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
567 {
568 Lisp_Object charvec;
569 EMACS_INT i, n;
570
571 /* This character is displayed using a vector of glyphs.
572 Update the column based on those glyphs. */
573
574 charvec = DISP_CHAR_VECTOR (dp, c);
575 n = ASIZE (charvec);
576
577 for (i = 0; i < n; i++)
578 {
579 /* This should be handled the same as
580 next_element_from_display_vector does it. */
581 Lisp_Object entry;
582 entry = AREF (charvec, i);
583
584 if (INTEGERP (entry)
585 && GLYPH_CHAR_VALID_P (XFASTINT (entry)))
586 c = FAST_GLYPH_CHAR (XFASTINT (entry));
587 else
588 c = ' ';
589
590 if (c == '\n')
591 goto endloop;
592 if (c == '\r' && EQ (current_buffer->selective_display, Qt))
593 goto endloop;
594 if (c == '\t')
595 {
596 col += tab_width;
597 col = col / tab_width * tab_width;
598 }
599 else
600 ++col;
601 }
602 }
603 else
604 {
605 /* The display table says nothing for this character.
606 Display it as itself. */
607
608 if (c == '\n')
609 goto endloop;
610 if (c == '\r' && EQ (current_buffer->selective_display, Qt))
611 goto endloop;
612 if (c == '\t')
613 {
614 col += tab_width;
615 col = col / tab_width * tab_width;
616 }
617 else if (multibyte && BASE_LEADING_CODE_P (c))
618 {
619 unsigned char *ptr;
620 int bytes, width, wide_column;
621
622 ptr = BYTE_POS_ADDR (scan_byte);
623 MULTIBYTE_BYTES_WIDTH (ptr, dp);
624 scan_byte += bytes;
625 /* Subtract one to compensate for the increment
626 that is going to happen below. */
627 scan_byte--;
628 col += width;
629 }
630 else if (ctl_arrow && (c < 040 || c == 0177))
631 col += 2;
632 else if (c < 040 || c >= 0177)
633 col += 4;
634 else
635 col++;
636 }
637 scan++;
638 scan_byte++;
639
640 }
641 endloop:
642
643 last_known_column = col;
644 last_known_column_point = PT;
645 last_known_column_modified = MODIFF;
646
647 return col;
648 }
649 \f
650
651 #if 0 /* Not used. */
652
653 /* Return the width in columns of the part of STRING from BEG to END.
654 If BEG is nil, that stands for the beginning of STRING.
655 If END is nil, that stands for the end of STRING. */
656
657 static double
658 string_display_width (string, beg, end)
659 Lisp_Object string, beg, end;
660 {
661 register int col;
662 register unsigned char *ptr, *stop;
663 register int tab_seen;
664 int post_tab;
665 register int c;
666 register int tab_width = XINT (current_buffer->tab_width);
667 int ctl_arrow = !NILP (current_buffer->ctl_arrow);
668 register struct Lisp_Char_Table *dp = buffer_display_table ();
669 int b, e;
670
671 if (NILP (end))
672 e = SCHARS (string);
673 else
674 {
675 CHECK_NUMBER (end);
676 e = XINT (end);
677 }
678
679 if (NILP (beg))
680 b = 0;
681 else
682 {
683 CHECK_NUMBER (beg);
684 b = XINT (beg);
685 }
686
687 /* Make a pointer for decrementing through the chars before point. */
688 ptr = SDATA (string) + e;
689 /* Make a pointer to where consecutive chars leave off,
690 going backwards from point. */
691 stop = SDATA (string) + b;
692
693 if (tab_width <= 0 || tab_width > 1000) tab_width = 8;
694
695 col = 0, tab_seen = 0, post_tab = 0;
696
697 while (1)
698 {
699 if (ptr == stop)
700 break;
701
702 c = *--ptr;
703 if (dp != 0 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
704 col += XVECTOR (DISP_CHAR_VECTOR (dp, c))->size;
705 else if (c >= 040 && c < 0177)
706 col++;
707 else if (c == '\n')
708 break;
709 else if (c == '\t')
710 {
711 if (tab_seen)
712 col = ((col + tab_width) / tab_width) * tab_width;
713
714 post_tab += col;
715 col = 0;
716 tab_seen = 1;
717 }
718 else
719 col += (ctl_arrow && c < 0200) ? 2 : 4;
720 }
721
722 if (tab_seen)
723 {
724 col = ((col + tab_width) / tab_width) * tab_width;
725 col += post_tab;
726 }
727
728 return col;
729 }
730
731 #endif /* 0 */
732
733 \f
734 DEFUN ("indent-to", Findent_to, Sindent_to, 1, 2, "NIndent to column: ",
735 doc: /* Indent from point with tabs and spaces until COLUMN is reached.
736 Optional second argument MININUM says always do at least MININUM spaces
737 even if that goes past COLUMN; by default, MININUM is zero. */)
738 (column, minimum)
739 Lisp_Object column, minimum;
740 {
741 int mincol;
742 register int fromcol;
743 register int tab_width = XINT (current_buffer->tab_width);
744
745 CHECK_NUMBER (column);
746 if (NILP (minimum))
747 XSETFASTINT (minimum, 0);
748 CHECK_NUMBER (minimum);
749
750 fromcol = current_column ();
751 mincol = fromcol + XINT (minimum);
752 if (mincol < XINT (column)) mincol = XINT (column);
753
754 if (fromcol == mincol)
755 return make_number (mincol);
756
757 if (tab_width <= 0 || tab_width > 1000) tab_width = 8;
758
759 if (indent_tabs_mode)
760 {
761 Lisp_Object n;
762 XSETFASTINT (n, mincol / tab_width - fromcol / tab_width);
763 if (XFASTINT (n) != 0)
764 {
765 Finsert_char (make_number ('\t'), n, Qt);
766
767 fromcol = (mincol / tab_width) * tab_width;
768 }
769 }
770
771 XSETFASTINT (column, mincol - fromcol);
772 Finsert_char (make_number (' '), column, Qt);
773
774 last_known_column = mincol;
775 last_known_column_point = PT;
776 last_known_column_modified = MODIFF;
777
778 XSETINT (column, mincol);
779 return column;
780 }
781
782 \f
783 static double position_indentation P_ ((int));
784
785 DEFUN ("current-indentation", Fcurrent_indentation, Scurrent_indentation,
786 0, 0, 0,
787 doc: /* Return the indentation of the current line.
788 This is the horizontal position of the character
789 following any initial whitespace. */)
790 ()
791 {
792 Lisp_Object val;
793 int opoint = PT, opoint_byte = PT_BYTE;
794
795 scan_newline (PT, PT_BYTE, BEGV, BEGV_BYTE, -1, 1);
796
797 XSETFASTINT (val, (int) position_indentation (PT_BYTE)); /* iftc */
798 SET_PT_BOTH (opoint, opoint_byte);
799 return val;
800 }
801
802 static double
803 position_indentation (pos_byte)
804 register int pos_byte;
805 {
806 register int column = 0;
807 register int tab_width = XINT (current_buffer->tab_width);
808 register unsigned char *p;
809 register unsigned char *stop;
810 unsigned char *start;
811 int next_boundary_byte = pos_byte;
812 int ceiling = next_boundary_byte;
813
814 if (tab_width <= 0 || tab_width > 1000) tab_width = 8;
815
816 p = BYTE_POS_ADDR (pos_byte);
817 /* STOP records the value of P at which we will need
818 to think about the gap, or about invisible text,
819 or about the end of the buffer. */
820 stop = p;
821 /* START records the starting value of P. */
822 start = p;
823 while (1)
824 {
825 while (p == stop)
826 {
827 int stop_pos_byte;
828
829 /* If we have updated P, set POS_BYTE to match.
830 The first time we enter the loop, POS_BYTE is already right. */
831 if (p != start)
832 pos_byte = PTR_BYTE_POS (p);
833 /* Consider the various reasons STOP might have been set here. */
834 if (pos_byte == ZV_BYTE)
835 return column;
836 if (pos_byte == next_boundary_byte)
837 {
838 int next_boundary;
839 int pos = BYTE_TO_CHAR (pos_byte);
840 pos = skip_invisible (pos, &next_boundary, ZV, Qnil);
841 pos_byte = CHAR_TO_BYTE (pos);
842 next_boundary_byte = CHAR_TO_BYTE (next_boundary);
843 }
844 if (pos_byte >= ceiling)
845 ceiling = BUFFER_CEILING_OF (pos_byte) + 1;
846 /* Compute the next place we need to stop and think,
847 and set STOP accordingly. */
848 stop_pos_byte = min (ceiling, next_boundary_byte);
849 /* The -1 and +1 arrange to point at the first byte of gap
850 (if STOP_POS_BYTE is the position of the gap)
851 rather than at the data after the gap. */
852
853 stop = BYTE_POS_ADDR (stop_pos_byte - 1) + 1;
854 p = BYTE_POS_ADDR (pos_byte);
855 }
856 switch (*p++)
857 {
858 case 0240:
859 if (! NILP (current_buffer->enable_multibyte_characters))
860 return column;
861 case ' ':
862 column++;
863 break;
864 case '\t':
865 column += tab_width - column % tab_width;
866 break;
867 default:
868 if (ASCII_BYTE_P (p[-1])
869 || NILP (current_buffer->enable_multibyte_characters))
870 return column;
871 {
872 int c;
873 pos_byte = PTR_BYTE_POS (p - 1);
874 c = FETCH_MULTIBYTE_CHAR (pos_byte);
875 if (CHAR_HAS_CATEGORY (c, ' '))
876 {
877 column++;
878 INC_POS (pos_byte);
879 p = BYTE_POS_ADDR (pos_byte);
880 }
881 else
882 return column;
883 }
884 }
885 }
886 }
887
888 /* Test whether the line beginning at POS is indented beyond COLUMN.
889 Blank lines are treated as if they had the same indentation as the
890 preceding line. */
891
892 int
893 indented_beyond_p (pos, pos_byte, column)
894 int pos, pos_byte;
895 double column;
896 {
897 double val;
898 int opoint = PT, opoint_byte = PT_BYTE;
899
900 SET_PT_BOTH (pos, pos_byte);
901 while (PT > BEGV && FETCH_BYTE (PT_BYTE) == '\n')
902 scan_newline (PT - 1, PT_BYTE - 1, BEGV, BEGV_BYTE, -1, 0);
903
904 val = position_indentation (PT_BYTE);
905 SET_PT_BOTH (opoint, opoint_byte);
906 return val >= column; /* hmm, float comparison */
907 }
908 \f
909 DEFUN ("move-to-column", Fmove_to_column, Smove_to_column, 1, 2, "p",
910 doc: /* Move point to column COLUMN in the current line.
911 The column of a character is calculated by adding together the widths
912 as displayed of the previous characters in the line.
913 This function ignores line-continuation;
914 there is no upper limit on the column number a character can have
915 and horizontal scrolling has no effect.
916
917 If specified column is within a character, point goes after that character.
918 If it's past end of line, point goes to end of line.
919
920 A non-nil second (optional) argument FORCE means,
921 if COLUMN is in the middle of a tab character, change it to spaces.
922 In addition, if FORCE is t, and the line is too short
923 to reach column COLUMN, add spaces/tabs to get there.
924
925 The return value is the current column. */)
926 (column, force)
927 Lisp_Object column, force;
928 {
929 register int pos;
930 register int col = current_column ();
931 register int goal;
932 register int end;
933 register int tab_width = XINT (current_buffer->tab_width);
934 register int ctl_arrow = !NILP (current_buffer->ctl_arrow);
935 register struct Lisp_Char_Table *dp = buffer_display_table ();
936 register int multibyte = !NILP (current_buffer->enable_multibyte_characters);
937
938 Lisp_Object val;
939 int prev_col = 0;
940 int c = 0;
941 int next_boundary, pos_byte;
942
943 if (tab_width <= 0 || tab_width > 1000) tab_width = 8;
944 CHECK_NATNUM (column);
945 goal = XINT (column);
946
947 pos = PT;
948 pos_byte = PT_BYTE;
949 end = ZV;
950 next_boundary = pos;
951
952 /* If we're starting past the desired column,
953 back up to beginning of line and scan from there. */
954 if (col > goal)
955 {
956 end = pos;
957 pos = current_column_bol_cache;
958 pos_byte = CHAR_TO_BYTE (pos);
959 col = 0;
960 }
961
962 while (pos < end)
963 {
964 while (pos == next_boundary)
965 {
966 int prev = pos;
967 pos = skip_invisible (pos, &next_boundary, end, Qnil);
968 if (pos != prev)
969 pos_byte = CHAR_TO_BYTE (pos);
970 if (pos >= end)
971 goto endloop;
972 }
973
974 /* Test reaching the goal column. We do this after skipping
975 invisible characters, so that we put point before the
976 character on which the cursor will appear. */
977 if (col >= goal)
978 break;
979
980 /* Check composition sequence. */
981 {
982 int len, len_byte, width;
983
984 if (check_composition (pos, pos_byte, Z, &len, &len_byte, &width))
985 {
986 pos += len;
987 pos_byte += len_byte;
988 col += width;
989 continue;
990 }
991 }
992
993 c = FETCH_BYTE (pos_byte);
994
995 /* See if there is a display table and it relates
996 to this character. */
997
998 if (dp != 0
999 && ! (multibyte && BASE_LEADING_CODE_P (c))
1000 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
1001 {
1002 Lisp_Object charvec;
1003 EMACS_INT i, n;
1004
1005 /* This character is displayed using a vector of glyphs.
1006 Update the position based on those glyphs. */
1007
1008 charvec = DISP_CHAR_VECTOR (dp, c);
1009 n = ASIZE (charvec);
1010
1011 for (i = 0; i < n; i++)
1012 {
1013 /* This should be handled the same as
1014 next_element_from_display_vector does it. */
1015
1016 Lisp_Object entry;
1017 entry = AREF (charvec, i);
1018
1019 if (INTEGERP (entry)
1020 && GLYPH_CHAR_VALID_P (XFASTINT (entry)))
1021 c = FAST_GLYPH_CHAR (XFASTINT (entry));
1022 else
1023 c = ' ';
1024
1025 if (c == '\n')
1026 goto endloop;
1027 if (c == '\r' && EQ (current_buffer->selective_display, Qt))
1028 goto endloop;
1029 if (c == '\t')
1030 {
1031 prev_col = col;
1032 col += tab_width;
1033 col = col / tab_width * tab_width;
1034 }
1035 else
1036 ++col;
1037 }
1038 }
1039 else
1040 {
1041 /* The display table doesn't affect this character;
1042 it displays as itself. */
1043
1044 if (c == '\n')
1045 goto endloop;
1046 if (c == '\r' && EQ (current_buffer->selective_display, Qt))
1047 goto endloop;
1048 if (c == '\t')
1049 {
1050 prev_col = col;
1051 col += tab_width;
1052 col = col / tab_width * tab_width;
1053 }
1054 else if (ctl_arrow && (c < 040 || c == 0177))
1055 col += 2;
1056 else if (c < 040 || c == 0177)
1057 col += 4;
1058 else if (c < 0177)
1059 col++;
1060 else if (multibyte && BASE_LEADING_CODE_P (c))
1061 {
1062 /* Start of multi-byte form. */
1063 unsigned char *ptr;
1064 int bytes, width, wide_column;
1065
1066 ptr = BYTE_POS_ADDR (pos_byte);
1067 MULTIBYTE_BYTES_WIDTH (ptr, dp);
1068 pos_byte += bytes - 1;
1069 col += width;
1070 }
1071 else
1072 col += 4;
1073 }
1074
1075 pos++;
1076 pos_byte++;
1077 }
1078 endloop:
1079
1080 SET_PT_BOTH (pos, pos_byte);
1081
1082 /* If a tab char made us overshoot, change it to spaces
1083 and scan through it again. */
1084 if (!NILP (force) && col > goal && c == '\t' && prev_col < goal)
1085 {
1086 int goal_pt, goal_pt_byte;
1087
1088 /* Insert spaces in front of the tab to reach GOAL. Do this
1089 first so that a marker at the end of the tab gets
1090 adjusted. */
1091 SET_PT_BOTH (PT - 1, PT_BYTE - 1);
1092 Finsert_char (make_number (' '), make_number (goal - prev_col), Qt);
1093
1094 /* Now delete the tab, and indent to COL. */
1095 del_range (PT, PT + 1);
1096 goal_pt = PT;
1097 goal_pt_byte = PT_BYTE;
1098 Findent_to (make_number (col), Qnil);
1099 SET_PT_BOTH (goal_pt, goal_pt_byte);
1100
1101 /* Set the last_known... vars consistently. */
1102 col = goal;
1103 }
1104
1105 /* If line ends prematurely, add space to the end. */
1106 if (col < goal && EQ (force, Qt))
1107 Findent_to (make_number (col = goal), Qnil);
1108
1109 last_known_column = col;
1110 last_known_column_point = PT;
1111 last_known_column_modified = MODIFF;
1112
1113 XSETFASTINT (val, col);
1114 return val;
1115 }
1116 \f
1117 /* compute_motion: compute buffer posn given screen posn and vice versa */
1118
1119 struct position val_compute_motion;
1120
1121 /* Scan the current buffer forward from offset FROM, pretending that
1122 this is at line FROMVPOS, column FROMHPOS, until reaching buffer
1123 offset TO or line TOVPOS, column TOHPOS (whichever comes first),
1124 and return the ending buffer position and screen location. If we
1125 can't hit the requested column exactly (because of a tab or other
1126 multi-column character), overshoot.
1127
1128 DID_MOTION is 1 if FROMHPOS has already accounted for overlay strings
1129 at FROM. This is the case if FROMVPOS and FROMVPOS came from an
1130 earlier call to compute_motion. The other common case is that FROMHPOS
1131 is zero and FROM is a position that "belongs" at column zero, but might
1132 be shifted by overlay strings; in this case DID_MOTION should be 0.
1133
1134 WIDTH is the number of columns available to display text;
1135 compute_motion uses this to handle continuation lines and such.
1136 HSCROLL is the number of columns not being displayed at the left
1137 margin; this is usually taken from a window's hscroll member.
1138 TAB_OFFSET is the number of columns of the first tab that aren't
1139 being displayed, perhaps because of a continuation line or
1140 something.
1141
1142 compute_motion returns a pointer to a struct position. The bufpos
1143 member gives the buffer position at the end of the scan, and hpos
1144 and vpos give its cartesian location. prevhpos is the column at
1145 which the character before bufpos started, and contin is non-zero
1146 if we reached the current line by continuing the previous.
1147
1148 Note that FROMHPOS and TOHPOS should be expressed in real screen
1149 columns, taking HSCROLL and the truncation glyph at the left margin
1150 into account. That is, beginning-of-line moves you to the hpos
1151 -HSCROLL + (HSCROLL > 0).
1152
1153 For example, to find the buffer position of column COL of line LINE
1154 of a certain window, pass the window's starting location as FROM
1155 and the window's upper-left coordinates as FROMVPOS and FROMHPOS.
1156 Pass the buffer's ZV as TO, to limit the scan to the end of the
1157 visible section of the buffer, and pass LINE and COL as TOVPOS and
1158 TOHPOS.
1159
1160 When displaying in window w, a typical formula for WIDTH is:
1161
1162 window_width - 1
1163 - (has_vertical_scroll_bars
1164 ? WINDOW_CONFIG_SCROLL_BAR_COLS (window)
1165 : (window_width + window_left != frame_cols))
1166
1167 where
1168 window_width is XFASTINT (w->total_cols),
1169 window_left is XFASTINT (w->left_col),
1170 has_vertical_scroll_bars is
1171 WINDOW_HAS_VERTICAL_SCROLL_BAR (window)
1172 and frame_cols = FRAME_COLS (XFRAME (window->frame))
1173
1174 Or you can let window_box_text_cols do this all for you, and write:
1175 window_box_text_cols (w) - 1
1176
1177 The `-1' accounts for the continuation-line backslashes; the rest
1178 accounts for window borders if the window is split horizontally, and
1179 the scroll bars if they are turned on. */
1180
1181 struct position *
1182 compute_motion (from, fromvpos, fromhpos, did_motion, to, tovpos, tohpos, width, hscroll, tab_offset, win)
1183 int from, fromvpos, fromhpos, to, tovpos, tohpos;
1184 int did_motion;
1185 register int width;
1186 int hscroll, tab_offset;
1187 struct window *win;
1188 {
1189 register int hpos = fromhpos;
1190 register int vpos = fromvpos;
1191
1192 register int pos;
1193 int pos_byte;
1194 register int c = 0;
1195 register int tab_width = XFASTINT (current_buffer->tab_width);
1196 register int ctl_arrow = !NILP (current_buffer->ctl_arrow);
1197 register struct Lisp_Char_Table *dp = window_display_table (win);
1198 int selective
1199 = (INTEGERP (current_buffer->selective_display)
1200 ? XINT (current_buffer->selective_display)
1201 : !NILP (current_buffer->selective_display) ? -1 : 0);
1202 int selective_rlen
1203 = (selective && dp && VECTORP (DISP_INVIS_VECTOR (dp))
1204 ? XVECTOR (DISP_INVIS_VECTOR (dp))->size : 0);
1205 /* The next location where the `invisible' property changes, or an
1206 overlay starts or ends. */
1207 int next_boundary = from;
1208
1209 /* For computing runs of characters with similar widths.
1210 Invariant: width_run_width is zero, or all the characters
1211 from width_run_start to width_run_end have a fixed width of
1212 width_run_width. */
1213 int width_run_start = from;
1214 int width_run_end = from;
1215 int width_run_width = 0;
1216 Lisp_Object *width_table;
1217 Lisp_Object buffer;
1218
1219 /* The next buffer pos where we should consult the width run cache. */
1220 int next_width_run = from;
1221 Lisp_Object window;
1222
1223 int multibyte = !NILP (current_buffer->enable_multibyte_characters);
1224 /* If previous char scanned was a wide character,
1225 this is the column where it ended. Otherwise, this is 0. */
1226 int wide_column_end_hpos = 0;
1227 int prev_pos; /* Previous buffer position. */
1228 int prev_pos_byte; /* Previous buffer position. */
1229 int prev_hpos = 0;
1230 int prev_vpos = 0;
1231 int contin_hpos; /* HPOS of last column of continued line. */
1232 int prev_tab_offset; /* Previous tab offset. */
1233
1234 XSETBUFFER (buffer, current_buffer);
1235 XSETWINDOW (window, win);
1236
1237 width_run_cache_on_off ();
1238 if (dp == buffer_display_table ())
1239 width_table = (VECTORP (current_buffer->width_table)
1240 ? XVECTOR (current_buffer->width_table)->contents
1241 : 0);
1242 else
1243 /* If the window has its own display table, we can't use the width
1244 run cache, because that's based on the buffer's display table. */
1245 width_table = 0;
1246
1247 if (tab_width <= 0 || tab_width > 1000)
1248 tab_width = 8;
1249
1250 immediate_quit = 1;
1251 QUIT;
1252
1253 pos = prev_pos = from;
1254 pos_byte = prev_pos_byte = CHAR_TO_BYTE (from);
1255 contin_hpos = 0;
1256 prev_tab_offset = tab_offset;
1257 while (1)
1258 {
1259 while (pos == next_boundary)
1260 {
1261 int pos_here = pos;
1262 int newpos;
1263
1264 /* Don't skip invisible if we are already at the margin. */
1265 if (vpos > tovpos || (vpos == tovpos && hpos >= tohpos))
1266 {
1267 if (contin_hpos && prev_hpos == 0
1268 && hpos > tohpos
1269 && (contin_hpos == width || wide_column_end_hpos > width))
1270 { /* Line breaks because we can't put the character at the
1271 previous line any more. It is not the multi-column
1272 character continued in middle. Go back to previous
1273 buffer position, screen position, and set tab offset
1274 to previous value. It's the beginning of the
1275 line. */
1276 pos = prev_pos;
1277 pos_byte = prev_pos_byte;
1278 hpos = prev_hpos;
1279 vpos = prev_vpos;
1280 tab_offset = prev_tab_offset;
1281 }
1282 break;
1283 }
1284
1285 /* If the caller says that the screen position came from an earlier
1286 call to compute_motion, then we've already accounted for the
1287 overlay strings at point. This is only true the first time
1288 through, so clear the flag after testing it. */
1289 if (!did_motion)
1290 /* We need to skip past the overlay strings. Currently those
1291 strings must not contain TAB;
1292 if we want to relax that restriction, something will have
1293 to be changed here. */
1294 {
1295 unsigned char *ovstr;
1296 int ovlen = overlay_strings (pos, win, &ovstr);
1297 hpos += ((multibyte && ovlen > 0)
1298 ? strwidth (ovstr, ovlen) : ovlen);
1299 }
1300 did_motion = 0;
1301
1302 if (pos >= to)
1303 break;
1304
1305 /* Advance POS past invisible characters
1306 (but not necessarily all that there are here),
1307 and store in next_boundary the next position where
1308 we need to call skip_invisible. */
1309 newpos = skip_invisible (pos, &next_boundary, to, window);
1310
1311 if (newpos >= to)
1312 {
1313 pos = min (to, newpos);
1314 pos_byte = CHAR_TO_BYTE (pos);
1315 goto after_loop;
1316 }
1317
1318 if (newpos != pos_here)
1319 {
1320 pos = newpos;
1321 pos_byte = CHAR_TO_BYTE (pos);
1322 }
1323 }
1324
1325 /* Handle right margin. */
1326 /* Note on a wide-column character.
1327
1328 Characters are classified into the following three categories
1329 according to the width (columns occupied on screen).
1330
1331 (1) single-column character: ex. `a'
1332 (2) multi-column character: ex. `^A', TAB, `\033'
1333 (3) wide-column character: ex. Japanese character, Chinese character
1334 (In the following example, `W_' stands for them.)
1335
1336 Multi-column characters can be divided around the right margin,
1337 but wide-column characters cannot.
1338
1339 NOTE:
1340
1341 (*) The cursor is placed on the next character after the point.
1342
1343 ----------
1344 abcdefghi\
1345 j ^---- next after the point
1346 ^--- next char. after the point.
1347 ----------
1348 In case of sigle-column character
1349
1350 ----------
1351 abcdefgh\\
1352 033 ^---- next after the point, next char. after the point.
1353 ----------
1354 In case of multi-column character
1355
1356 ----------
1357 abcdefgh\\
1358 W_ ^---- next after the point
1359 ^---- next char. after the point.
1360 ----------
1361 In case of wide-column character
1362
1363 The problem here is continuation at a wide-column character.
1364 In this case, the line may shorter less than WIDTH.
1365 And we find the continuation AFTER it occurs.
1366
1367 */
1368
1369 if (hpos > width)
1370 {
1371 if (hscroll
1372 || (truncate_partial_width_windows
1373 && width + 1 < FRAME_COLS (XFRAME (WINDOW_FRAME (win))))
1374 || !NILP (current_buffer->truncate_lines))
1375 {
1376 /* Truncating: skip to newline, unless we are already past
1377 TO (we need to go back below). */
1378 if (pos <= to)
1379 {
1380 pos = find_before_next_newline (pos, to, 1);
1381 pos_byte = CHAR_TO_BYTE (pos);
1382 hpos = width;
1383 /* If we just skipped next_boundary,
1384 loop around in the main while
1385 and handle it. */
1386 if (pos >= next_boundary)
1387 next_boundary = pos + 1;
1388 prev_hpos = width;
1389 prev_vpos = vpos;
1390 prev_tab_offset = tab_offset;
1391 }
1392 }
1393 else
1394 {
1395 /* Continuing. */
1396 /* Remember the previous value. */
1397 prev_tab_offset = tab_offset;
1398
1399 if (wide_column_end_hpos > width)
1400 {
1401 hpos -= prev_hpos;
1402 tab_offset += prev_hpos;
1403 }
1404 else
1405 {
1406 tab_offset += width;
1407 hpos -= width;
1408 }
1409 vpos++;
1410 contin_hpos = prev_hpos;
1411 prev_hpos = 0;
1412 prev_vpos = vpos;
1413 }
1414 }
1415
1416 /* Stop if past the target buffer position or screen position. */
1417 if (pos > to)
1418 {
1419 /* Go back to the previous position. */
1420 pos = prev_pos;
1421 pos_byte = prev_pos_byte;
1422 hpos = prev_hpos;
1423 vpos = prev_vpos;
1424 tab_offset = prev_tab_offset;
1425
1426 /* NOTE on contin_hpos, hpos, and prev_hpos.
1427
1428 ----------
1429 abcdefgh\\
1430 W_ ^---- contin_hpos
1431 | ^----- hpos
1432 \---- prev_hpos
1433 ----------
1434 */
1435
1436 if (contin_hpos && prev_hpos == 0
1437 && contin_hpos < width && !wide_column_end_hpos)
1438 {
1439 /* Line breaking occurs in the middle of multi-column
1440 character. Go back to previous line. */
1441 hpos = contin_hpos;
1442 vpos = vpos - 1;
1443 }
1444 break;
1445 }
1446
1447 if (vpos > tovpos || (vpos == tovpos && hpos >= tohpos))
1448 {
1449 if (contin_hpos && prev_hpos == 0
1450 && hpos > tohpos
1451 && (contin_hpos == width || wide_column_end_hpos > width))
1452 { /* Line breaks because we can't put the character at the
1453 previous line any more. It is not the multi-column
1454 character continued in middle. Go back to previous
1455 buffer position, screen position, and set tab offset
1456 to previous value. It's the beginning of the
1457 line. */
1458 pos = prev_pos;
1459 pos_byte = prev_pos_byte;
1460 hpos = prev_hpos;
1461 vpos = prev_vpos;
1462 tab_offset = prev_tab_offset;
1463 }
1464 break;
1465 }
1466 if (pos == ZV) /* We cannot go beyond ZV. Stop here. */
1467 break;
1468
1469 prev_hpos = hpos;
1470 prev_vpos = vpos;
1471 prev_pos = pos;
1472 prev_pos_byte = pos_byte;
1473 wide_column_end_hpos = 0;
1474
1475 /* Consult the width run cache to see if we can avoid inspecting
1476 the text character-by-character. */
1477 if (current_buffer->width_run_cache && pos >= next_width_run)
1478 {
1479 int run_end;
1480 int common_width
1481 = region_cache_forward (current_buffer,
1482 current_buffer->width_run_cache,
1483 pos, &run_end);
1484
1485 /* A width of zero means the character's width varies (like
1486 a tab), is meaningless (like a newline), or we just don't
1487 want to skip over it for some other reason. */
1488 if (common_width != 0)
1489 {
1490 int run_end_hpos;
1491
1492 /* Don't go past the final buffer posn the user
1493 requested. */
1494 if (run_end > to)
1495 run_end = to;
1496
1497 run_end_hpos = hpos + (run_end - pos) * common_width;
1498
1499 /* Don't go past the final horizontal position the user
1500 requested. */
1501 if (vpos == tovpos && run_end_hpos > tohpos)
1502 {
1503 run_end = pos + (tohpos - hpos) / common_width;
1504 run_end_hpos = hpos + (run_end - pos) * common_width;
1505 }
1506
1507 /* Don't go past the margin. */
1508 if (run_end_hpos >= width)
1509 {
1510 run_end = pos + (width - hpos) / common_width;
1511 run_end_hpos = hpos + (run_end - pos) * common_width;
1512 }
1513
1514 hpos = run_end_hpos;
1515 if (run_end > pos)
1516 prev_hpos = hpos - common_width;
1517 if (pos != run_end)
1518 {
1519 pos = run_end;
1520 pos_byte = CHAR_TO_BYTE (pos);
1521 }
1522 }
1523
1524 next_width_run = run_end + 1;
1525 }
1526
1527 /* We have to scan the text character-by-character. */
1528 else
1529 {
1530 EMACS_INT i, n;
1531 Lisp_Object charvec;
1532
1533 c = FETCH_BYTE (pos_byte);
1534
1535 /* Check composition sequence. */
1536 {
1537 int len, len_byte, width;
1538
1539 if (check_composition (pos, pos_byte, to, &len, &len_byte, &width))
1540 {
1541 pos += len;
1542 pos_byte += len_byte;
1543 hpos += width;
1544 continue;
1545 }
1546 }
1547
1548 pos++, pos_byte++;
1549
1550 /* Perhaps add some info to the width_run_cache. */
1551 if (current_buffer->width_run_cache)
1552 {
1553 /* Is this character part of the current run? If so, extend
1554 the run. */
1555 if (pos - 1 == width_run_end
1556 && XFASTINT (width_table[c]) == width_run_width)
1557 width_run_end = pos;
1558
1559 /* The previous run is over, since this is a character at a
1560 different position, or a different width. */
1561 else
1562 {
1563 /* Have we accumulated a run to put in the cache?
1564 (Currently, we only cache runs of width == 1). */
1565 if (width_run_start < width_run_end
1566 && width_run_width == 1)
1567 know_region_cache (current_buffer,
1568 current_buffer->width_run_cache,
1569 width_run_start, width_run_end);
1570
1571 /* Start recording a new width run. */
1572 width_run_width = XFASTINT (width_table[c]);
1573 width_run_start = pos - 1;
1574 width_run_end = pos;
1575 }
1576 }
1577
1578 if (dp != 0
1579 && ! (multibyte && BASE_LEADING_CODE_P (c))
1580 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
1581 {
1582 charvec = DISP_CHAR_VECTOR (dp, c);
1583 n = ASIZE (charvec);
1584 }
1585 else
1586 {
1587 charvec = Qnil;
1588 n = 1;
1589 }
1590
1591 for (i = n - 1; i >= 0; --i)
1592 {
1593 if (VECTORP (charvec))
1594 {
1595 /* This should be handled the same as
1596 next_element_from_display_vector does it. */
1597 Lisp_Object entry = AREF (charvec, i);
1598
1599 if (INTEGERP (entry)
1600 && GLYPH_CHAR_VALID_P (XFASTINT (entry)))
1601 c = FAST_GLYPH_CHAR (XFASTINT (entry));
1602 else
1603 c = ' ';
1604 }
1605
1606 if (c >= 040 && c < 0177)
1607 hpos++;
1608 else if (c == '\t')
1609 {
1610 int tem = ((hpos + tab_offset + hscroll - (hscroll > 0))
1611 % tab_width);
1612 if (tem < 0)
1613 tem += tab_width;
1614 hpos += tab_width - tem;
1615 }
1616 else if (c == '\n')
1617 {
1618 if (selective > 0
1619 && indented_beyond_p (pos, pos_byte,
1620 (double) selective)) /* iftc */
1621 {
1622 /* If (pos == to), we don't have to take care of
1623 selective display. */
1624 if (pos < to)
1625 {
1626 /* Skip any number of invisible lines all at once */
1627 do
1628 {
1629 pos = find_before_next_newline (pos, to, 1);
1630 if (pos < to)
1631 pos++;
1632 pos_byte = CHAR_TO_BYTE (pos);
1633 }
1634 while (pos < to
1635 && indented_beyond_p (pos, pos_byte,
1636 (double) selective)); /* iftc */
1637 /* Allow for the " ..." that is displayed for them. */
1638 if (selective_rlen)
1639 {
1640 hpos += selective_rlen;
1641 if (hpos >= width)
1642 hpos = width;
1643 }
1644 DEC_BOTH (pos, pos_byte);
1645 /* We have skipped the invis text, but not the
1646 newline after. */
1647 }
1648 }
1649 else
1650 {
1651 /* A visible line. */
1652 vpos++;
1653 hpos = 0;
1654 hpos -= hscroll;
1655 /* Count the truncation glyph on column 0 */
1656 if (hscroll > 0)
1657 hpos++;
1658 tab_offset = 0;
1659 }
1660 contin_hpos = 0;
1661 }
1662 else if (c == CR && selective < 0)
1663 {
1664 /* In selective display mode,
1665 everything from a ^M to the end of the line is invisible.
1666 Stop *before* the real newline. */
1667 if (pos < to)
1668 {
1669 pos = find_before_next_newline (pos, to, 1);
1670 pos_byte = CHAR_TO_BYTE (pos);
1671 }
1672 /* If we just skipped next_boundary,
1673 loop around in the main while
1674 and handle it. */
1675 if (pos > next_boundary)
1676 next_boundary = pos;
1677 /* Allow for the " ..." that is displayed for them. */
1678 if (selective_rlen)
1679 {
1680 hpos += selective_rlen;
1681 if (hpos >= width)
1682 hpos = width;
1683 }
1684 }
1685 else if (multibyte && BASE_LEADING_CODE_P (c))
1686 {
1687 /* Start of multi-byte form. */
1688 unsigned char *ptr;
1689 int bytes, width, wide_column;
1690
1691 pos_byte--; /* rewind POS_BYTE */
1692 ptr = BYTE_POS_ADDR (pos_byte);
1693 MULTIBYTE_BYTES_WIDTH (ptr, dp);
1694 pos_byte += bytes;
1695 if (wide_column)
1696 wide_column_end_hpos = hpos + wide_column;
1697 hpos += width;
1698 }
1699 else if (VECTORP (charvec))
1700 ++hpos;
1701 else
1702 hpos += (ctl_arrow && c < 0200) ? 2 : 4;
1703 }
1704 }
1705 }
1706
1707 after_loop:
1708
1709 /* Remember any final width run in the cache. */
1710 if (current_buffer->width_run_cache
1711 && width_run_width == 1
1712 && width_run_start < width_run_end)
1713 know_region_cache (current_buffer, current_buffer->width_run_cache,
1714 width_run_start, width_run_end);
1715
1716 val_compute_motion.bufpos = pos;
1717 val_compute_motion.bytepos = pos_byte;
1718 val_compute_motion.hpos = hpos;
1719 val_compute_motion.vpos = vpos;
1720 if (contin_hpos && prev_hpos == 0)
1721 val_compute_motion.prevhpos = contin_hpos;
1722 else
1723 val_compute_motion.prevhpos = prev_hpos;
1724 /* We alalways handle all of them here; none of them remain to do. */
1725 val_compute_motion.ovstring_chars_done = 0;
1726
1727 /* Nonzero if have just continued a line */
1728 val_compute_motion.contin = (contin_hpos && prev_hpos == 0);
1729
1730 immediate_quit = 0;
1731 return &val_compute_motion;
1732 }
1733
1734
1735 DEFUN ("compute-motion", Fcompute_motion, Scompute_motion, 7, 7, 0,
1736 doc: /* Scan through the current buffer, calculating screen position.
1737 Scan the current buffer forward from offset FROM,
1738 assuming it is at position FROMPOS--a cons of the form (HPOS . VPOS)--
1739 to position TO or position TOPOS--another cons of the form (HPOS . VPOS)--
1740 and return the ending buffer position and screen location.
1741
1742 There are three additional arguments:
1743
1744 WIDTH is the number of columns available to display text;
1745 this affects handling of continuation lines.
1746 This is usually the value returned by `window-width', less one (to allow
1747 for the continuation glyph).
1748
1749 OFFSETS is either nil or a cons cell (HSCROLL . TAB-OFFSET).
1750 HSCROLL is the number of columns not being displayed at the left
1751 margin; this is usually taken from a window's hscroll member.
1752 TAB-OFFSET is the number of columns of the first tab that aren't
1753 being displayed, perhaps because the line was continued within it.
1754 If OFFSETS is nil, HSCROLL and TAB-OFFSET are assumed to be zero.
1755
1756 WINDOW is the window to operate on. It is used to choose the display table;
1757 if it is showing the current buffer, it is used also for
1758 deciding which overlay properties apply.
1759 Note that `compute-motion' always operates on the current buffer.
1760
1761 The value is a list of five elements:
1762 (POS HPOS VPOS PREVHPOS CONTIN)
1763 POS is the buffer position where the scan stopped.
1764 VPOS is the vertical position where the scan stopped.
1765 HPOS is the horizontal position where the scan stopped.
1766
1767 PREVHPOS is the horizontal position one character back from POS.
1768 CONTIN is t if a line was continued after (or within) the previous character.
1769
1770 For example, to find the buffer position of column COL of line LINE
1771 of a certain window, pass the window's starting location as FROM
1772 and the window's upper-left coordinates as FROMPOS.
1773 Pass the buffer's (point-max) as TO, to limit the scan to the end of the
1774 visible section of the buffer, and pass LINE and COL as TOPOS. */)
1775 (from, frompos, to, topos, width, offsets, window)
1776 Lisp_Object from, frompos, to, topos;
1777 Lisp_Object width, offsets, window;
1778 {
1779 Lisp_Object bufpos, hpos, vpos, prevhpos;
1780 struct position *pos;
1781 int hscroll, tab_offset;
1782
1783 CHECK_NUMBER_COERCE_MARKER (from);
1784 CHECK_CONS (frompos);
1785 CHECK_NUMBER_CAR (frompos);
1786 CHECK_NUMBER_CDR (frompos);
1787 CHECK_NUMBER_COERCE_MARKER (to);
1788 CHECK_CONS (topos);
1789 CHECK_NUMBER_CAR (topos);
1790 CHECK_NUMBER_CDR (topos);
1791 CHECK_NUMBER (width);
1792 if (!NILP (offsets))
1793 {
1794 CHECK_CONS (offsets);
1795 CHECK_NUMBER_CAR (offsets);
1796 CHECK_NUMBER_CDR (offsets);
1797 hscroll = XINT (XCAR (offsets));
1798 tab_offset = XINT (XCDR (offsets));
1799 }
1800 else
1801 hscroll = tab_offset = 0;
1802
1803 if (NILP (window))
1804 window = Fselected_window ();
1805 else
1806 CHECK_LIVE_WINDOW (window);
1807
1808 if (XINT (from) < BEGV || XINT (from) > ZV)
1809 args_out_of_range_3 (from, make_number (BEGV), make_number (ZV));
1810 if (XINT (to) < BEGV || XINT (to) > ZV)
1811 args_out_of_range_3 (to, make_number (BEGV), make_number (ZV));
1812
1813 pos = compute_motion (XINT (from), XINT (XCDR (frompos)),
1814 XINT (XCAR (frompos)), 0,
1815 XINT (to), XINT (XCDR (topos)),
1816 XINT (XCAR (topos)),
1817 XINT (width), hscroll, tab_offset,
1818 XWINDOW (window));
1819
1820 XSETFASTINT (bufpos, pos->bufpos);
1821 XSETINT (hpos, pos->hpos);
1822 XSETINT (vpos, pos->vpos);
1823 XSETINT (prevhpos, pos->prevhpos);
1824
1825 return Fcons (bufpos,
1826 Fcons (hpos,
1827 Fcons (vpos,
1828 Fcons (prevhpos,
1829 Fcons (pos->contin ? Qt : Qnil, Qnil)))));
1830
1831 }
1832 \f
1833 /* Fvertical_motion and vmotion */
1834
1835 struct position val_vmotion;
1836
1837 struct position *
1838 vmotion (from, vtarget, w)
1839 register int from, vtarget;
1840 struct window *w;
1841 {
1842 int width = window_box_text_cols (w);
1843 int hscroll = XINT (w->hscroll);
1844 struct position pos;
1845 /* vpos is cumulative vertical position, changed as from is changed */
1846 register int vpos = 0;
1847 Lisp_Object prevline;
1848 register int first;
1849 int from_byte;
1850 int lmargin = hscroll > 0 ? 1 - hscroll : 0;
1851 int selective
1852 = (INTEGERP (current_buffer->selective_display)
1853 ? XINT (current_buffer->selective_display)
1854 : !NILP (current_buffer->selective_display) ? -1 : 0);
1855 Lisp_Object window;
1856 int start_hpos = 0;
1857 int did_motion;
1858 /* This is the object we use for fetching character properties. */
1859 Lisp_Object text_prop_object;
1860
1861 XSETWINDOW (window, w);
1862
1863 /* We must make room for continuation marks if we don't have fringes. */
1864 #ifdef HAVE_WINDOW_SYSTEM
1865 if (!FRAME_WINDOW_P (XFRAME (w->frame)))
1866 #endif
1867 width -= 1;
1868
1869 /* If the window contains this buffer, use it for getting text properties.
1870 Otherwise use the current buffer as arg for doing that. */
1871 if (EQ (w->buffer, Fcurrent_buffer ()))
1872 text_prop_object = window;
1873 else
1874 text_prop_object = Fcurrent_buffer ();
1875
1876 if (vpos >= vtarget)
1877 {
1878 /* To move upward, go a line at a time until
1879 we have gone at least far enough. */
1880
1881 first = 1;
1882
1883 while ((vpos > vtarget || first) && from > BEGV)
1884 {
1885 Lisp_Object propval;
1886
1887 XSETFASTINT (prevline, find_next_newline_no_quit (from - 1, -1));
1888 while (XFASTINT (prevline) > BEGV
1889 && ((selective > 0
1890 && indented_beyond_p (XFASTINT (prevline),
1891 CHAR_TO_BYTE (XFASTINT (prevline)),
1892 (double) selective)) /* iftc */
1893 /* watch out for newlines with `invisible' property */
1894 || (propval = Fget_char_property (prevline,
1895 Qinvisible,
1896 text_prop_object),
1897 TEXT_PROP_MEANS_INVISIBLE (propval))))
1898 XSETFASTINT (prevline,
1899 find_next_newline_no_quit (XFASTINT (prevline) - 1,
1900 -1));
1901 pos = *compute_motion (XFASTINT (prevline), 0,
1902 lmargin + (XFASTINT (prevline) == BEG
1903 ? start_hpos : 0),
1904 0,
1905 from,
1906 /* Don't care for VPOS... */
1907 1 << (BITS_PER_SHORT - 1),
1908 /* ... nor HPOS. */
1909 1 << (BITS_PER_SHORT - 1),
1910 width, hscroll,
1911 /* This compensates for start_hpos
1912 so that a tab as first character
1913 still occupies 8 columns. */
1914 (XFASTINT (prevline) == BEG
1915 ? -start_hpos : 0),
1916 w);
1917 vpos -= pos.vpos;
1918 first = 0;
1919 from = XFASTINT (prevline);
1920 }
1921
1922 /* If we made exactly the desired vertical distance,
1923 or if we hit beginning of buffer,
1924 return point found */
1925 if (vpos >= vtarget)
1926 {
1927 val_vmotion.bufpos = from;
1928 val_vmotion.bytepos = CHAR_TO_BYTE (from);
1929 val_vmotion.vpos = vpos;
1930 val_vmotion.hpos = lmargin;
1931 val_vmotion.contin = 0;
1932 val_vmotion.prevhpos = 0;
1933 val_vmotion.ovstring_chars_done = 0;
1934 val_vmotion.tab_offset = 0; /* For accumulating tab offset. */
1935 return &val_vmotion;
1936 }
1937
1938 /* Otherwise find the correct spot by moving down */
1939 }
1940 /* Moving downward is simple, but must calculate from beg of line
1941 to determine hpos of starting point */
1942 from_byte = CHAR_TO_BYTE (from);
1943 if (from > BEGV && FETCH_BYTE (from_byte - 1) != '\n')
1944 {
1945 Lisp_Object propval;
1946
1947 XSETFASTINT (prevline, find_next_newline_no_quit (from, -1));
1948 while (XFASTINT (prevline) > BEGV
1949 && ((selective > 0
1950 && indented_beyond_p (XFASTINT (prevline),
1951 CHAR_TO_BYTE (XFASTINT (prevline)),
1952 (double) selective)) /* iftc */
1953 /* watch out for newlines with `invisible' property */
1954 || (propval = Fget_char_property (prevline, Qinvisible,
1955 text_prop_object),
1956 TEXT_PROP_MEANS_INVISIBLE (propval))))
1957 XSETFASTINT (prevline,
1958 find_next_newline_no_quit (XFASTINT (prevline) - 1,
1959 -1));
1960 pos = *compute_motion (XFASTINT (prevline), 0,
1961 lmargin + (XFASTINT (prevline) == BEG
1962 ? start_hpos : 0),
1963 0,
1964 from,
1965 /* Don't care for VPOS... */
1966 1 << (BITS_PER_SHORT - 1),
1967 /* ... nor HPOS. */
1968 1 << (BITS_PER_SHORT - 1),
1969 width, hscroll,
1970 (XFASTINT (prevline) == BEG ? -start_hpos : 0),
1971 w);
1972 did_motion = 1;
1973 }
1974 else
1975 {
1976 pos.hpos = lmargin + (from == BEG ? start_hpos : 0);
1977 pos.vpos = 0;
1978 pos.tab_offset = 0;
1979 did_motion = 0;
1980 }
1981 return compute_motion (from, vpos, pos.hpos, did_motion,
1982 ZV, vtarget, - (1 << (BITS_PER_SHORT - 1)),
1983 width, hscroll,
1984 pos.tab_offset - (from == BEG ? start_hpos : 0),
1985 w);
1986 }
1987
1988 DEFUN ("vertical-motion", Fvertical_motion, Svertical_motion, 1, 2, 0,
1989 doc: /* Move point to start of the screen line LINES lines down.
1990 If LINES is negative, this means moving up.
1991
1992 This function is an ordinary cursor motion function
1993 which calculates the new position based on how text would be displayed.
1994 The new position may be the start of a line,
1995 or just the start of a continuation line.
1996 The function returns number of screen lines moved over;
1997 that usually equals LINES, but may be closer to zero
1998 if beginning or end of buffer was reached.
1999
2000 The optional second argument WINDOW specifies the window to use for
2001 parameters such as width, horizontal scrolling, and so on.
2002 The default is to use the selected window's parameters.
2003
2004 `vertical-motion' always uses the current buffer,
2005 regardless of which buffer is displayed in WINDOW.
2006 This is consistent with other cursor motion functions
2007 and makes it possible to use `vertical-motion' in any buffer,
2008 whether or not it is currently displayed in some window. */)
2009 (lines, window)
2010 Lisp_Object lines, window;
2011 {
2012 struct it it;
2013 struct text_pos pt;
2014 struct window *w;
2015 Lisp_Object old_buffer;
2016 struct gcpro gcpro1;
2017
2018 CHECK_NUMBER (lines);
2019 if (! NILP (window))
2020 CHECK_WINDOW (window);
2021 else
2022 window = selected_window;
2023 w = XWINDOW (window);
2024
2025 old_buffer = Qnil;
2026 GCPRO1 (old_buffer);
2027 if (XBUFFER (w->buffer) != current_buffer)
2028 {
2029 /* Set the window's buffer temporarily to the current buffer. */
2030 old_buffer = w->buffer;
2031 XSETBUFFER (w->buffer, current_buffer);
2032 }
2033
2034 SET_TEXT_POS (pt, PT, PT_BYTE);
2035 start_display (&it, w, pt);
2036
2037 /* Move to the start of the display line containing PT. If we don't
2038 do this, we start moving with IT->current_x == 0, while PT is
2039 really at some x > 0. The effect is, in continuation lines, that
2040 we end up with the iterator placed at where it thinks X is 0,
2041 while the end position is really at some X > 0, the same X that
2042 PT had. */
2043 move_it_by_lines (&it, 0, 0);
2044
2045 if (XINT (lines) != 0)
2046 move_it_by_lines (&it, XINT (lines), 0);
2047
2048 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
2049
2050 if (BUFFERP (old_buffer))
2051 w->buffer = old_buffer;
2052
2053 RETURN_UNGCPRO (make_number (it.vpos));
2054 }
2055
2056
2057 \f
2058 /* File's initialization. */
2059
2060 void
2061 syms_of_indent ()
2062 {
2063 DEFVAR_BOOL ("indent-tabs-mode", &indent_tabs_mode,
2064 doc: /* *Indentation can insert tabs if this is non-nil.
2065 Setting this variable automatically makes it local to the current buffer. */);
2066 indent_tabs_mode = 1;
2067
2068 defsubr (&Scurrent_indentation);
2069 defsubr (&Sindent_to);
2070 defsubr (&Scurrent_column);
2071 defsubr (&Smove_to_column);
2072 defsubr (&Svertical_motion);
2073 defsubr (&Scompute_motion);
2074 }
2075
2076 /* arch-tag: 9adfea44-71f7-4988-8ee3-96da15c502cc
2077 (do not change this comment) */