]> 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,2003
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 }
1413 }
1414
1415 /* Stop if past the target buffer position or screen position. */
1416 if (pos > to)
1417 {
1418 /* Go back to the previous position. */
1419 pos = prev_pos;
1420 pos_byte = prev_pos_byte;
1421 hpos = prev_hpos;
1422 vpos = prev_vpos;
1423 tab_offset = prev_tab_offset;
1424
1425 /* NOTE on contin_hpos, hpos, and prev_hpos.
1426
1427 ----------
1428 abcdefgh\\
1429 W_ ^---- contin_hpos
1430 | ^----- hpos
1431 \---- prev_hpos
1432 ----------
1433 */
1434
1435 if (contin_hpos && prev_hpos == 0
1436 && contin_hpos < width && !wide_column_end_hpos)
1437 {
1438 /* Line breaking occurs in the middle of multi-column
1439 character. Go back to previous line. */
1440 hpos = contin_hpos;
1441 vpos = vpos - 1;
1442 }
1443 break;
1444 }
1445
1446 if (vpos > tovpos || (vpos == tovpos && hpos >= tohpos))
1447 {
1448 if (contin_hpos && prev_hpos == 0
1449 && hpos > tohpos
1450 && (contin_hpos == width || wide_column_end_hpos > width))
1451 { /* Line breaks because we can't put the character at the
1452 previous line any more. It is not the multi-column
1453 character continued in middle. Go back to previous
1454 buffer position, screen position, and set tab offset
1455 to previous value. It's the beginning of the
1456 line. */
1457 pos = prev_pos;
1458 pos_byte = prev_pos_byte;
1459 hpos = prev_hpos;
1460 vpos = prev_vpos;
1461 tab_offset = prev_tab_offset;
1462 }
1463 break;
1464 }
1465 if (pos == ZV) /* We cannot go beyond ZV. Stop here. */
1466 break;
1467
1468 prev_hpos = hpos;
1469 prev_vpos = vpos;
1470 prev_pos = pos;
1471 prev_pos_byte = pos_byte;
1472 wide_column_end_hpos = 0;
1473
1474 /* Consult the width run cache to see if we can avoid inspecting
1475 the text character-by-character. */
1476 if (current_buffer->width_run_cache && pos >= next_width_run)
1477 {
1478 int run_end;
1479 int common_width
1480 = region_cache_forward (current_buffer,
1481 current_buffer->width_run_cache,
1482 pos, &run_end);
1483
1484 /* A width of zero means the character's width varies (like
1485 a tab), is meaningless (like a newline), or we just don't
1486 want to skip over it for some other reason. */
1487 if (common_width != 0)
1488 {
1489 int run_end_hpos;
1490
1491 /* Don't go past the final buffer posn the user
1492 requested. */
1493 if (run_end > to)
1494 run_end = to;
1495
1496 run_end_hpos = hpos + (run_end - pos) * common_width;
1497
1498 /* Don't go past the final horizontal position the user
1499 requested. */
1500 if (vpos == tovpos && run_end_hpos > tohpos)
1501 {
1502 run_end = pos + (tohpos - hpos) / common_width;
1503 run_end_hpos = hpos + (run_end - pos) * common_width;
1504 }
1505
1506 /* Don't go past the margin. */
1507 if (run_end_hpos >= width)
1508 {
1509 run_end = pos + (width - hpos) / common_width;
1510 run_end_hpos = hpos + (run_end - pos) * common_width;
1511 }
1512
1513 hpos = run_end_hpos;
1514 if (run_end > pos)
1515 prev_hpos = hpos - common_width;
1516 if (pos != run_end)
1517 {
1518 pos = run_end;
1519 pos_byte = CHAR_TO_BYTE (pos);
1520 }
1521 }
1522
1523 next_width_run = run_end + 1;
1524 }
1525
1526 /* We have to scan the text character-by-character. */
1527 else
1528 {
1529 EMACS_INT i, n;
1530 Lisp_Object charvec;
1531
1532 c = FETCH_BYTE (pos_byte);
1533
1534 /* Check composition sequence. */
1535 {
1536 int len, len_byte, width;
1537
1538 if (check_composition (pos, pos_byte, to, &len, &len_byte, &width))
1539 {
1540 pos += len;
1541 pos_byte += len_byte;
1542 hpos += width;
1543 continue;
1544 }
1545 }
1546
1547 pos++, pos_byte++;
1548
1549 /* Perhaps add some info to the width_run_cache. */
1550 if (current_buffer->width_run_cache)
1551 {
1552 /* Is this character part of the current run? If so, extend
1553 the run. */
1554 if (pos - 1 == width_run_end
1555 && XFASTINT (width_table[c]) == width_run_width)
1556 width_run_end = pos;
1557
1558 /* The previous run is over, since this is a character at a
1559 different position, or a different width. */
1560 else
1561 {
1562 /* Have we accumulated a run to put in the cache?
1563 (Currently, we only cache runs of width == 1). */
1564 if (width_run_start < width_run_end
1565 && width_run_width == 1)
1566 know_region_cache (current_buffer,
1567 current_buffer->width_run_cache,
1568 width_run_start, width_run_end);
1569
1570 /* Start recording a new width run. */
1571 width_run_width = XFASTINT (width_table[c]);
1572 width_run_start = pos - 1;
1573 width_run_end = pos;
1574 }
1575 }
1576
1577 if (dp != 0
1578 && ! (multibyte && BASE_LEADING_CODE_P (c))
1579 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
1580 {
1581 charvec = DISP_CHAR_VECTOR (dp, c);
1582 n = ASIZE (charvec);
1583 }
1584 else
1585 {
1586 charvec = Qnil;
1587 n = 1;
1588 }
1589
1590 for (i = n - 1; i >= 0; --i)
1591 {
1592 if (VECTORP (charvec))
1593 {
1594 /* This should be handled the same as
1595 next_element_from_display_vector does it. */
1596 Lisp_Object entry = AREF (charvec, i);
1597
1598 if (INTEGERP (entry)
1599 && GLYPH_CHAR_VALID_P (XFASTINT (entry)))
1600 c = FAST_GLYPH_CHAR (XFASTINT (entry));
1601 else
1602 c = ' ';
1603 }
1604
1605 if (c >= 040 && c < 0177)
1606 hpos++;
1607 else if (c == '\t')
1608 {
1609 int tem = ((hpos + tab_offset + hscroll - (hscroll > 0))
1610 % tab_width);
1611 if (tem < 0)
1612 tem += tab_width;
1613 hpos += tab_width - tem;
1614 }
1615 else if (c == '\n')
1616 {
1617 if (selective > 0
1618 && indented_beyond_p (pos, pos_byte,
1619 (double) selective)) /* iftc */
1620 {
1621 /* If (pos == to), we don't have to take care of
1622 selective display. */
1623 if (pos < to)
1624 {
1625 /* Skip any number of invisible lines all at once */
1626 do
1627 {
1628 pos = find_before_next_newline (pos, to, 1);
1629 if (pos < to)
1630 pos++;
1631 pos_byte = CHAR_TO_BYTE (pos);
1632 }
1633 while (pos < to
1634 && indented_beyond_p (pos, pos_byte,
1635 (double) selective)); /* iftc */
1636 /* Allow for the " ..." that is displayed for them. */
1637 if (selective_rlen)
1638 {
1639 hpos += selective_rlen;
1640 if (hpos >= width)
1641 hpos = width;
1642 }
1643 DEC_BOTH (pos, pos_byte);
1644 /* We have skipped the invis text, but not the
1645 newline after. */
1646 }
1647 }
1648 else
1649 {
1650 /* A visible line. */
1651 vpos++;
1652 hpos = 0;
1653 hpos -= hscroll;
1654 /* Count the truncation glyph on column 0 */
1655 if (hscroll > 0)
1656 hpos++;
1657 tab_offset = 0;
1658 }
1659 contin_hpos = 0;
1660 }
1661 else if (c == CR && selective < 0)
1662 {
1663 /* In selective display mode,
1664 everything from a ^M to the end of the line is invisible.
1665 Stop *before* the real newline. */
1666 if (pos < to)
1667 {
1668 pos = find_before_next_newline (pos, to, 1);
1669 pos_byte = CHAR_TO_BYTE (pos);
1670 }
1671 /* If we just skipped next_boundary,
1672 loop around in the main while
1673 and handle it. */
1674 if (pos > next_boundary)
1675 next_boundary = pos;
1676 /* Allow for the " ..." that is displayed for them. */
1677 if (selective_rlen)
1678 {
1679 hpos += selective_rlen;
1680 if (hpos >= width)
1681 hpos = width;
1682 }
1683 }
1684 else if (multibyte && BASE_LEADING_CODE_P (c))
1685 {
1686 /* Start of multi-byte form. */
1687 unsigned char *ptr;
1688 int bytes, width, wide_column;
1689
1690 pos_byte--; /* rewind POS_BYTE */
1691 ptr = BYTE_POS_ADDR (pos_byte);
1692 MULTIBYTE_BYTES_WIDTH (ptr, dp);
1693 pos_byte += bytes;
1694 if (wide_column)
1695 wide_column_end_hpos = hpos + wide_column;
1696 hpos += width;
1697 }
1698 else if (VECTORP (charvec))
1699 ++hpos;
1700 else
1701 hpos += (ctl_arrow && c < 0200) ? 2 : 4;
1702 }
1703 }
1704 }
1705
1706 after_loop:
1707
1708 /* Remember any final width run in the cache. */
1709 if (current_buffer->width_run_cache
1710 && width_run_width == 1
1711 && width_run_start < width_run_end)
1712 know_region_cache (current_buffer, current_buffer->width_run_cache,
1713 width_run_start, width_run_end);
1714
1715 val_compute_motion.bufpos = pos;
1716 val_compute_motion.bytepos = pos_byte;
1717 val_compute_motion.hpos = hpos;
1718 val_compute_motion.vpos = vpos;
1719 if (contin_hpos && prev_hpos == 0)
1720 val_compute_motion.prevhpos = contin_hpos;
1721 else
1722 val_compute_motion.prevhpos = prev_hpos;
1723 /* We alalways handle all of them here; none of them remain to do. */
1724 val_compute_motion.ovstring_chars_done = 0;
1725
1726 /* Nonzero if have just continued a line */
1727 val_compute_motion.contin = (contin_hpos && prev_hpos == 0);
1728
1729 immediate_quit = 0;
1730 return &val_compute_motion;
1731 }
1732
1733
1734 DEFUN ("compute-motion", Fcompute_motion, Scompute_motion, 7, 7, 0,
1735 doc: /* Scan through the current buffer, calculating screen position.
1736 Scan the current buffer forward from offset FROM,
1737 assuming it is at position FROMPOS--a cons of the form (HPOS . VPOS)--
1738 to position TO or position TOPOS--another cons of the form (HPOS . VPOS)--
1739 and return the ending buffer position and screen location.
1740
1741 There are three additional arguments:
1742
1743 WIDTH is the number of columns available to display text;
1744 this affects handling of continuation lines.
1745 This is usually the value returned by `window-width', less one (to allow
1746 for the continuation glyph).
1747
1748 OFFSETS is either nil or a cons cell (HSCROLL . TAB-OFFSET).
1749 HSCROLL is the number of columns not being displayed at the left
1750 margin; this is usually taken from a window's hscroll member.
1751 TAB-OFFSET is the number of columns of the first tab that aren't
1752 being displayed, perhaps because the line was continued within it.
1753 If OFFSETS is nil, HSCROLL and TAB-OFFSET are assumed to be zero.
1754
1755 WINDOW is the window to operate on. It is used to choose the display table;
1756 if it is showing the current buffer, it is used also for
1757 deciding which overlay properties apply.
1758 Note that `compute-motion' always operates on the current buffer.
1759
1760 The value is a list of five elements:
1761 (POS HPOS VPOS PREVHPOS CONTIN)
1762 POS is the buffer position where the scan stopped.
1763 VPOS is the vertical position where the scan stopped.
1764 HPOS is the horizontal position where the scan stopped.
1765
1766 PREVHPOS is the horizontal position one character back from POS.
1767 CONTIN is t if a line was continued after (or within) the previous character.
1768
1769 For example, to find the buffer position of column COL of line LINE
1770 of a certain window, pass the window's starting location as FROM
1771 and the window's upper-left coordinates as FROMPOS.
1772 Pass the buffer's (point-max) as TO, to limit the scan to the end of the
1773 visible section of the buffer, and pass LINE and COL as TOPOS. */)
1774 (from, frompos, to, topos, width, offsets, window)
1775 Lisp_Object from, frompos, to, topos;
1776 Lisp_Object width, offsets, window;
1777 {
1778 Lisp_Object bufpos, hpos, vpos, prevhpos;
1779 struct position *pos;
1780 int hscroll, tab_offset;
1781
1782 CHECK_NUMBER_COERCE_MARKER (from);
1783 CHECK_CONS (frompos);
1784 CHECK_NUMBER_CAR (frompos);
1785 CHECK_NUMBER_CDR (frompos);
1786 CHECK_NUMBER_COERCE_MARKER (to);
1787 CHECK_CONS (topos);
1788 CHECK_NUMBER_CAR (topos);
1789 CHECK_NUMBER_CDR (topos);
1790 CHECK_NUMBER (width);
1791 if (!NILP (offsets))
1792 {
1793 CHECK_CONS (offsets);
1794 CHECK_NUMBER_CAR (offsets);
1795 CHECK_NUMBER_CDR (offsets);
1796 hscroll = XINT (XCAR (offsets));
1797 tab_offset = XINT (XCDR (offsets));
1798 }
1799 else
1800 hscroll = tab_offset = 0;
1801
1802 if (NILP (window))
1803 window = Fselected_window ();
1804 else
1805 CHECK_LIVE_WINDOW (window);
1806
1807 if (XINT (from) < BEGV || XINT (from) > ZV)
1808 args_out_of_range_3 (from, make_number (BEGV), make_number (ZV));
1809 if (XINT (to) < BEGV || XINT (to) > ZV)
1810 args_out_of_range_3 (to, make_number (BEGV), make_number (ZV));
1811
1812 pos = compute_motion (XINT (from), XINT (XCDR (frompos)),
1813 XINT (XCAR (frompos)), 0,
1814 XINT (to), XINT (XCDR (topos)),
1815 XINT (XCAR (topos)),
1816 XINT (width), hscroll, tab_offset,
1817 XWINDOW (window));
1818
1819 XSETFASTINT (bufpos, pos->bufpos);
1820 XSETINT (hpos, pos->hpos);
1821 XSETINT (vpos, pos->vpos);
1822 XSETINT (prevhpos, pos->prevhpos);
1823
1824 return Fcons (bufpos,
1825 Fcons (hpos,
1826 Fcons (vpos,
1827 Fcons (prevhpos,
1828 Fcons (pos->contin ? Qt : Qnil, Qnil)))));
1829
1830 }
1831 \f
1832 /* Fvertical_motion and vmotion */
1833
1834 struct position val_vmotion;
1835
1836 struct position *
1837 vmotion (from, vtarget, w)
1838 register int from, vtarget;
1839 struct window *w;
1840 {
1841 int width = window_box_text_cols (w);
1842 int hscroll = XINT (w->hscroll);
1843 struct position pos;
1844 /* vpos is cumulative vertical position, changed as from is changed */
1845 register int vpos = 0;
1846 Lisp_Object prevline;
1847 register int first;
1848 int from_byte;
1849 int lmargin = hscroll > 0 ? 1 - hscroll : 0;
1850 int selective
1851 = (INTEGERP (current_buffer->selective_display)
1852 ? XINT (current_buffer->selective_display)
1853 : !NILP (current_buffer->selective_display) ? -1 : 0);
1854 Lisp_Object window;
1855 int start_hpos = 0;
1856 int did_motion;
1857 /* This is the object we use for fetching character properties. */
1858 Lisp_Object text_prop_object;
1859
1860 XSETWINDOW (window, w);
1861
1862 /* We must make room for continuation marks if we don't have fringes. */
1863 #ifdef HAVE_WINDOW_SYSTEM
1864 if (!FRAME_WINDOW_P (XFRAME (w->frame)))
1865 #endif
1866 width -= 1;
1867
1868 /* If the window contains this buffer, use it for getting text properties.
1869 Otherwise use the current buffer as arg for doing that. */
1870 if (EQ (w->buffer, Fcurrent_buffer ()))
1871 text_prop_object = window;
1872 else
1873 text_prop_object = Fcurrent_buffer ();
1874
1875 if (vpos >= vtarget)
1876 {
1877 /* To move upward, go a line at a time until
1878 we have gone at least far enough. */
1879
1880 first = 1;
1881
1882 while ((vpos > vtarget || first) && from > BEGV)
1883 {
1884 Lisp_Object propval;
1885
1886 XSETFASTINT (prevline, find_next_newline_no_quit (from - 1, -1));
1887 while (XFASTINT (prevline) > BEGV
1888 && ((selective > 0
1889 && indented_beyond_p (XFASTINT (prevline),
1890 CHAR_TO_BYTE (XFASTINT (prevline)),
1891 (double) selective)) /* iftc */
1892 /* watch out for newlines with `invisible' property */
1893 || (propval = Fget_char_property (prevline,
1894 Qinvisible,
1895 text_prop_object),
1896 TEXT_PROP_MEANS_INVISIBLE (propval))))
1897 XSETFASTINT (prevline,
1898 find_next_newline_no_quit (XFASTINT (prevline) - 1,
1899 -1));
1900 pos = *compute_motion (XFASTINT (prevline), 0,
1901 lmargin + (XFASTINT (prevline) == BEG
1902 ? start_hpos : 0),
1903 0,
1904 from,
1905 /* Don't care for VPOS... */
1906 1 << (BITS_PER_SHORT - 1),
1907 /* ... nor HPOS. */
1908 1 << (BITS_PER_SHORT - 1),
1909 width, hscroll,
1910 /* This compensates for start_hpos
1911 so that a tab as first character
1912 still occupies 8 columns. */
1913 (XFASTINT (prevline) == BEG
1914 ? -start_hpos : 0),
1915 w);
1916 vpos -= pos.vpos;
1917 first = 0;
1918 from = XFASTINT (prevline);
1919 }
1920
1921 /* If we made exactly the desired vertical distance,
1922 or if we hit beginning of buffer,
1923 return point found */
1924 if (vpos >= vtarget)
1925 {
1926 val_vmotion.bufpos = from;
1927 val_vmotion.bytepos = CHAR_TO_BYTE (from);
1928 val_vmotion.vpos = vpos;
1929 val_vmotion.hpos = lmargin;
1930 val_vmotion.contin = 0;
1931 val_vmotion.prevhpos = 0;
1932 val_vmotion.ovstring_chars_done = 0;
1933 val_vmotion.tab_offset = 0; /* For accumulating tab offset. */
1934 return &val_vmotion;
1935 }
1936
1937 /* Otherwise find the correct spot by moving down */
1938 }
1939 /* Moving downward is simple, but must calculate from beg of line
1940 to determine hpos of starting point */
1941 from_byte = CHAR_TO_BYTE (from);
1942 if (from > BEGV && FETCH_BYTE (from_byte - 1) != '\n')
1943 {
1944 Lisp_Object propval;
1945
1946 XSETFASTINT (prevline, find_next_newline_no_quit (from, -1));
1947 while (XFASTINT (prevline) > BEGV
1948 && ((selective > 0
1949 && indented_beyond_p (XFASTINT (prevline),
1950 CHAR_TO_BYTE (XFASTINT (prevline)),
1951 (double) selective)) /* iftc */
1952 /* watch out for newlines with `invisible' property */
1953 || (propval = Fget_char_property (prevline, Qinvisible,
1954 text_prop_object),
1955 TEXT_PROP_MEANS_INVISIBLE (propval))))
1956 XSETFASTINT (prevline,
1957 find_next_newline_no_quit (XFASTINT (prevline) - 1,
1958 -1));
1959 pos = *compute_motion (XFASTINT (prevline), 0,
1960 lmargin + (XFASTINT (prevline) == BEG
1961 ? start_hpos : 0),
1962 0,
1963 from,
1964 /* Don't care for VPOS... */
1965 1 << (BITS_PER_SHORT - 1),
1966 /* ... nor HPOS. */
1967 1 << (BITS_PER_SHORT - 1),
1968 width, hscroll,
1969 (XFASTINT (prevline) == BEG ? -start_hpos : 0),
1970 w);
1971 did_motion = 1;
1972 }
1973 else
1974 {
1975 pos.hpos = lmargin + (from == BEG ? start_hpos : 0);
1976 pos.vpos = 0;
1977 pos.tab_offset = 0;
1978 did_motion = 0;
1979 }
1980 return compute_motion (from, vpos, pos.hpos, did_motion,
1981 ZV, vtarget, - (1 << (BITS_PER_SHORT - 1)),
1982 width, hscroll,
1983 pos.tab_offset - (from == BEG ? start_hpos : 0),
1984 w);
1985 }
1986
1987 DEFUN ("vertical-motion", Fvertical_motion, Svertical_motion, 1, 2, 0,
1988 doc: /* Move point to start of the screen line LINES lines down.
1989 If LINES is negative, this means moving up.
1990
1991 This function is an ordinary cursor motion function
1992 which calculates the new position based on how text would be displayed.
1993 The new position may be the start of a line,
1994 or just the start of a continuation line.
1995 The function returns number of screen lines moved over;
1996 that usually equals LINES, but may be closer to zero
1997 if beginning or end of buffer was reached.
1998
1999 The optional second argument WINDOW specifies the window to use for
2000 parameters such as width, horizontal scrolling, and so on.
2001 The default is to use the selected window's parameters.
2002
2003 `vertical-motion' always uses the current buffer,
2004 regardless of which buffer is displayed in WINDOW.
2005 This is consistent with other cursor motion functions
2006 and makes it possible to use `vertical-motion' in any buffer,
2007 whether or not it is currently displayed in some window. */)
2008 (lines, window)
2009 Lisp_Object lines, window;
2010 {
2011 struct it it;
2012 struct text_pos pt;
2013 struct window *w;
2014 Lisp_Object old_buffer;
2015 struct gcpro gcpro1;
2016
2017 CHECK_NUMBER (lines);
2018 if (! NILP (window))
2019 CHECK_WINDOW (window);
2020 else
2021 window = selected_window;
2022 w = XWINDOW (window);
2023
2024 old_buffer = Qnil;
2025 GCPRO1 (old_buffer);
2026 if (XBUFFER (w->buffer) != current_buffer)
2027 {
2028 /* Set the window's buffer temporarily to the current buffer. */
2029 old_buffer = w->buffer;
2030 XSETBUFFER (w->buffer, current_buffer);
2031 }
2032
2033 SET_TEXT_POS (pt, PT, PT_BYTE);
2034 start_display (&it, w, pt);
2035
2036 /* Move to the start of the display line containing PT. If we don't
2037 do this, we start moving with IT->current_x == 0, while PT is
2038 really at some x > 0. The effect is, in continuation lines, that
2039 we end up with the iterator placed at where it thinks X is 0,
2040 while the end position is really at some X > 0, the same X that
2041 PT had. */
2042 move_it_by_lines (&it, 0, 0);
2043
2044 if (XINT (lines) != 0)
2045 move_it_by_lines (&it, XINT (lines), 0);
2046
2047 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
2048
2049 if (BUFFERP (old_buffer))
2050 w->buffer = old_buffer;
2051
2052 RETURN_UNGCPRO (make_number (it.vpos));
2053 }
2054
2055
2056 \f
2057 /* File's initialization. */
2058
2059 void
2060 syms_of_indent ()
2061 {
2062 DEFVAR_BOOL ("indent-tabs-mode", &indent_tabs_mode,
2063 doc: /* *Indentation can insert tabs if this is non-nil.
2064 Setting this variable automatically makes it local to the current buffer. */);
2065 indent_tabs_mode = 1;
2066
2067 defsubr (&Scurrent_indentation);
2068 defsubr (&Sindent_to);
2069 defsubr (&Scurrent_column);
2070 defsubr (&Smove_to_column);
2071 defsubr (&Svertical_motion);
2072 defsubr (&Scompute_motion);
2073 }
2074
2075 /* arch-tag: 9adfea44-71f7-4988-8ee3-96da15c502cc
2076 (do not change this comment) */