Fix bug #12927 with scrolling under hl-line-mode and scroll-conservatively.
[emacs.git] / src / indent.c
blobbbc944d251848c8842dae97c5e27559af2132aee
1 /* Indentation functions.
2 Copyright (C) 1985-1988, 1993-1995, 1998, 2000-2012
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
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 3 of the License, or
10 (at your option) any later version.
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.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
20 #include <config.h>
21 #include <stdio.h>
23 #include "lisp.h"
24 #include "character.h"
25 #include "buffer.h"
26 #include "category.h"
27 #include "composite.h"
28 #include "indent.h"
29 #include "keyboard.h"
30 #include "frame.h"
31 #include "window.h"
32 #include "termchar.h"
33 #include "disptab.h"
34 #include "intervals.h"
35 #include "dispextern.h"
36 #include "region-cache.h"
38 #define CR 015
40 /* These three values memorize the current column to avoid recalculation. */
42 /* Last value returned by current_column.
43 Some things in set last_known_column_point to -1
44 to mark the memorized value as invalid. */
46 static ptrdiff_t last_known_column;
48 /* Value of point when current_column was called. */
50 ptrdiff_t last_known_column_point;
52 /* Value of MODIFF when current_column was called. */
54 static EMACS_INT last_known_column_modified;
56 static ptrdiff_t current_column_1 (void);
57 static ptrdiff_t position_indentation (ptrdiff_t);
59 /* Cache of beginning of line found by the last call of
60 current_column. */
62 static ptrdiff_t current_column_bol_cache;
64 /* Get the display table to use for the current buffer. */
66 struct Lisp_Char_Table *
67 buffer_display_table (void)
69 Lisp_Object thisbuf;
71 thisbuf = BVAR (current_buffer, display_table);
72 if (DISP_TABLE_P (thisbuf))
73 return XCHAR_TABLE (thisbuf);
74 if (DISP_TABLE_P (Vstandard_display_table))
75 return XCHAR_TABLE (Vstandard_display_table);
76 return 0;
79 /* Width run cache considerations. */
81 /* Return the width of character C under display table DP. */
83 static int
84 character_width (int c, struct Lisp_Char_Table *dp)
86 Lisp_Object elt;
88 /* These width computations were determined by examining the cases
89 in display_text_line. */
91 /* Everything can be handled by the display table, if it's
92 present and the element is right. */
93 if (dp && (elt = DISP_CHAR_VECTOR (dp, c), VECTORP (elt)))
94 return ASIZE (elt);
96 /* Some characters are special. */
97 if (c == '\n' || c == '\t' || c == '\015')
98 return 0;
100 /* Printing characters have width 1. */
101 else if (c >= 040 && c < 0177)
102 return 1;
104 /* Everybody else (control characters, metacharacters) has other
105 widths. We could return their actual widths here, but they
106 depend on things like ctl_arrow and crud like that, and they're
107 not very common at all. So we'll just claim we don't know their
108 widths. */
109 else
110 return 0;
113 /* Return true if the display table DISPTAB specifies the same widths
114 for characters as WIDTHTAB. We use this to decide when to
115 invalidate the buffer's width_run_cache. */
117 bool
118 disptab_matches_widthtab (struct Lisp_Char_Table *disptab, struct Lisp_Vector *widthtab)
120 int i;
122 eassert (widthtab->header.size == 256);
124 for (i = 0; i < 256; i++)
125 if (character_width (i, disptab)
126 != XFASTINT (widthtab->contents[i]))
127 return 0;
129 return 1;
132 /* Recompute BUF's width table, using the display table DISPTAB. */
134 void
135 recompute_width_table (struct buffer *buf, struct Lisp_Char_Table *disptab)
137 int i;
138 struct Lisp_Vector *widthtab;
140 if (!VECTORP (BVAR (buf, width_table)))
141 bset_width_table (buf, Fmake_vector (make_number (256), make_number (0)));
142 widthtab = XVECTOR (BVAR (buf, width_table));
143 eassert (widthtab->header.size == 256);
145 for (i = 0; i < 256; i++)
146 XSETFASTINT (widthtab->contents[i], character_width (i, disptab));
149 /* Allocate or free the width run cache, as requested by the current
150 state of current_buffer's cache_long_line_scans variable. */
152 static void
153 width_run_cache_on_off (void)
155 if (NILP (BVAR (current_buffer, cache_long_line_scans))
156 /* And, for the moment, this feature doesn't work on multibyte
157 characters. */
158 || !NILP (BVAR (current_buffer, enable_multibyte_characters)))
160 /* It should be off. */
161 if (current_buffer->width_run_cache)
163 free_region_cache (current_buffer->width_run_cache);
164 current_buffer->width_run_cache = 0;
165 bset_width_table (current_buffer, Qnil);
168 else
170 /* It should be on. */
171 if (current_buffer->width_run_cache == 0)
173 current_buffer->width_run_cache = new_region_cache ();
174 recompute_width_table (current_buffer, buffer_display_table ());
180 /* Skip some invisible characters starting from POS.
181 This includes characters invisible because of text properties
182 and characters invisible because of overlays.
184 If position POS is followed by invisible characters,
185 skip some of them and return the position after them.
186 Otherwise return POS itself.
188 Set *NEXT_BOUNDARY_P to the next position at which
189 it will be necessary to call this function again.
191 Don't scan past TO, and don't set *NEXT_BOUNDARY_P
192 to a value greater than TO.
194 If WINDOW is non-nil, and this buffer is displayed in WINDOW,
195 take account of overlays that apply only in WINDOW.
197 We don't necessarily skip all the invisible characters after POS
198 because that could take a long time. We skip a reasonable number
199 which can be skipped quickly. If there might be more invisible
200 characters immediately following, then *NEXT_BOUNDARY_P
201 will equal the return value. */
203 ptrdiff_t
204 skip_invisible (ptrdiff_t pos, ptrdiff_t *next_boundary_p, ptrdiff_t to, Lisp_Object window)
206 Lisp_Object prop, position, overlay_limit, proplimit;
207 Lisp_Object buffer, tmp;
208 ptrdiff_t end;
209 int inv_p;
211 XSETFASTINT (position, pos);
212 XSETBUFFER (buffer, current_buffer);
214 /* Give faster response for overlay lookup near POS. */
215 recenter_overlay_lists (current_buffer, pos);
217 /* We must not advance farther than the next overlay change.
218 The overlay change might change the invisible property;
219 or there might be overlay strings to be displayed there. */
220 overlay_limit = Fnext_overlay_change (position);
221 /* As for text properties, this gives a lower bound
222 for where the invisible text property could change. */
223 proplimit = Fnext_property_change (position, buffer, Qt);
224 if (XFASTINT (overlay_limit) < XFASTINT (proplimit))
225 proplimit = overlay_limit;
226 /* PROPLIMIT is now a lower bound for the next change
227 in invisible status. If that is plenty far away,
228 use that lower bound. */
229 if (XFASTINT (proplimit) > pos + 100 || XFASTINT (proplimit) >= to)
230 *next_boundary_p = XFASTINT (proplimit);
231 /* Otherwise, scan for the next `invisible' property change. */
232 else
234 /* Don't scan terribly far. */
235 XSETFASTINT (proplimit, min (pos + 100, to));
236 /* No matter what, don't go past next overlay change. */
237 if (XFASTINT (overlay_limit) < XFASTINT (proplimit))
238 proplimit = overlay_limit;
239 tmp = Fnext_single_property_change (position, Qinvisible,
240 buffer, proplimit);
241 end = XFASTINT (tmp);
242 #if 0
243 /* Don't put the boundary in the middle of multibyte form if
244 there is no actual property change. */
245 if (end == pos + 100
246 && !NILP (current_buffer->enable_multibyte_characters)
247 && end < ZV)
248 while (pos < end && !CHAR_HEAD_P (POS_ADDR (end)))
249 end--;
250 #endif
251 *next_boundary_p = end;
253 /* if the `invisible' property is set, we can skip to
254 the next property change */
255 prop = Fget_char_property (position, Qinvisible,
256 (!NILP (window)
257 && EQ (XWINDOW (window)->buffer, buffer))
258 ? window : buffer);
259 inv_p = TEXT_PROP_MEANS_INVISIBLE (prop);
260 /* When counting columns (window == nil), don't skip over ellipsis text. */
261 if (NILP (window) ? inv_p == 1 : inv_p)
262 return *next_boundary_p;
263 return pos;
266 /* Set variables WIDTH and BYTES for a multibyte sequence starting at P.
268 DP is a display table or NULL.
270 This macro is used in scan_for_column and in
271 compute_motion. */
273 #define MULTIBYTE_BYTES_WIDTH(p, dp, bytes, width) \
274 do { \
275 int ch; \
277 ch = STRING_CHAR_AND_LENGTH (p, bytes); \
278 if (BYTES_BY_CHAR_HEAD (*p) != bytes) \
279 width = bytes * 4; \
280 else \
282 if (dp != 0 && VECTORP (DISP_CHAR_VECTOR (dp, ch))) \
283 width = sanitize_char_width (ASIZE (DISP_CHAR_VECTOR (dp, ch))); \
284 else \
285 width = CHAR_WIDTH (ch); \
287 } while (0)
290 DEFUN ("current-column", Fcurrent_column, Scurrent_column, 0, 0, 0,
291 doc: /* Return the horizontal position of point. Beginning of line is column 0.
292 This is calculated by adding together the widths of all the displayed
293 representations of the character between the start of the previous line
294 and point (eg. control characters will have a width of 2 or 4, tabs
295 will have a variable width).
296 Ignores finite width of frame, which means that this function may return
297 values greater than (frame-width).
298 Whether the line is visible (if `selective-display' is t) has no effect;
299 however, ^M is treated as end of line when `selective-display' is t.
300 Text that has an invisible property is considered as having width 0, unless
301 `buffer-invisibility-spec' specifies that it is replaced by an ellipsis. */)
302 (void)
304 Lisp_Object temp;
305 XSETFASTINT (temp, current_column ());
306 return temp;
309 /* Cancel any recorded value of the horizontal position. */
311 void
312 invalidate_current_column (void)
314 last_known_column_point = 0;
317 ptrdiff_t
318 current_column (void)
320 ptrdiff_t col;
321 unsigned char *ptr, *stop;
322 bool tab_seen;
323 ptrdiff_t post_tab;
324 int c;
325 int tab_width = SANE_TAB_WIDTH (current_buffer);
326 bool ctl_arrow = !NILP (BVAR (current_buffer, ctl_arrow));
327 struct Lisp_Char_Table *dp = buffer_display_table ();
329 if (PT == last_known_column_point
330 && MODIFF == last_known_column_modified)
331 return last_known_column;
333 /* If the buffer has overlays, text properties,
334 or multibyte characters, use a more general algorithm. */
335 if (buffer_intervals (current_buffer)
336 || buffer_has_overlays ()
337 || Z != Z_BYTE)
338 return current_column_1 ();
340 /* Scan backwards from point to the previous newline,
341 counting width. Tab characters are the only complicated case. */
343 /* Make a pointer for decrementing through the chars before point. */
344 ptr = BYTE_POS_ADDR (PT_BYTE - 1) + 1;
345 /* Make a pointer to where consecutive chars leave off,
346 going backwards from point. */
347 if (PT == BEGV)
348 stop = ptr;
349 else if (PT <= GPT || BEGV > GPT)
350 stop = BEGV_ADDR;
351 else
352 stop = GAP_END_ADDR;
354 col = 0, tab_seen = 0, post_tab = 0;
356 while (1)
358 ptrdiff_t i, n;
359 Lisp_Object charvec;
361 if (ptr == stop)
363 /* We stopped either for the beginning of the buffer
364 or for the gap. */
365 if (ptr == BEGV_ADDR)
366 break;
368 /* It was the gap. Jump back over it. */
369 stop = BEGV_ADDR;
370 ptr = GPT_ADDR;
372 /* Check whether that brings us to beginning of buffer. */
373 if (BEGV >= GPT)
374 break;
377 c = *--ptr;
379 if (dp && VECTORP (DISP_CHAR_VECTOR (dp, c)))
381 charvec = DISP_CHAR_VECTOR (dp, c);
382 n = ASIZE (charvec);
384 else
386 charvec = Qnil;
387 n = 1;
390 for (i = n - 1; i >= 0; --i)
392 if (VECTORP (charvec))
394 /* This should be handled the same as
395 next_element_from_display_vector does it. */
396 Lisp_Object entry = AREF (charvec, i);
398 if (GLYPH_CODE_P (entry))
399 c = GLYPH_CODE_CHAR (entry);
400 else
401 c = ' ';
404 if (c >= 040 && c < 0177)
405 col++;
406 else if (c == '\n'
407 || (c == '\r'
408 && EQ (BVAR (current_buffer, selective_display), Qt)))
410 ptr++;
411 goto start_of_line_found;
413 else if (c == '\t')
415 if (tab_seen)
416 col = ((col + tab_width) / tab_width) * tab_width;
418 post_tab += col;
419 col = 0;
420 tab_seen = 1;
422 else if (VECTORP (charvec))
423 /* With a display table entry, C is displayed as is, and
424 not displayed as \NNN or as ^N. If C is a single-byte
425 character, it takes one column. If C is multi-byte in
426 an unibyte buffer, it's translated to unibyte, so it
427 also takes one column. */
428 ++col;
429 else
430 col += (ctl_arrow && c < 0200) ? 2 : 4;
434 start_of_line_found:
436 if (tab_seen)
438 col = ((col + tab_width) / tab_width) * tab_width;
439 col += post_tab;
442 if (ptr == BEGV_ADDR)
443 current_column_bol_cache = BEGV;
444 else
445 current_column_bol_cache = BYTE_TO_CHAR (PTR_BYTE_POS (ptr));
447 last_known_column = col;
448 last_known_column_point = PT;
449 last_known_column_modified = MODIFF;
451 return col;
455 /* Check the presence of a display property and compute its width.
456 If a property was found and its width was found as well, return
457 its width (>= 0) and set the position of the end of the property
458 in ENDPOS.
459 Otherwise just return -1. */
460 static int
461 check_display_width (ptrdiff_t pos, ptrdiff_t col, ptrdiff_t *endpos)
463 Lisp_Object val, overlay;
465 if (CONSP (val = get_char_property_and_overlay
466 (make_number (pos), Qdisplay, Qnil, &overlay))
467 && EQ (Qspace, XCAR (val)))
468 { /* FIXME: Use calc_pixel_width_or_height. */
469 Lisp_Object plist = XCDR (val), prop;
470 int width = -1;
471 EMACS_INT align_to_max =
472 (col < MOST_POSITIVE_FIXNUM - INT_MAX
473 ? (EMACS_INT) INT_MAX + col
474 : MOST_POSITIVE_FIXNUM);
476 if ((prop = Fplist_get (plist, QCwidth),
477 RANGED_INTEGERP (0, prop, INT_MAX)))
478 width = XINT (prop);
479 else if (FLOATP (prop) && 0 <= XFLOAT_DATA (prop)
480 && XFLOAT_DATA (prop) <= INT_MAX)
481 width = (int)(XFLOAT_DATA (prop) + 0.5);
482 else if ((prop = Fplist_get (plist, QCalign_to),
483 RANGED_INTEGERP (col, prop, align_to_max)))
484 width = XINT (prop) - col;
485 else if (FLOATP (prop) && col <= XFLOAT_DATA (prop)
486 && (XFLOAT_DATA (prop) <= align_to_max))
487 width = (int)(XFLOAT_DATA (prop) + 0.5) - col;
489 if (width >= 0)
491 ptrdiff_t start;
492 if (OVERLAYP (overlay))
493 *endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
494 else
495 get_property_and_range (pos, Qdisplay, &val, &start, endpos, Qnil);
496 return width;
499 return -1;
502 /* Scanning from the beginning of the current line, stop at the buffer
503 position ENDPOS or at the column GOALCOL or at the end of line, whichever
504 comes first.
505 Return the resulting buffer position and column in ENDPOS and GOALCOL.
506 PREVCOL gets set to the column of the previous position (it's always
507 strictly smaller than the goal column). */
508 static void
509 scan_for_column (ptrdiff_t *endpos, EMACS_INT *goalcol, ptrdiff_t *prevcol)
511 int tab_width = SANE_TAB_WIDTH (current_buffer);
512 bool ctl_arrow = !NILP (BVAR (current_buffer, ctl_arrow));
513 struct Lisp_Char_Table *dp = buffer_display_table ();
514 bool multibyte = !NILP (BVAR (current_buffer, enable_multibyte_characters));
515 struct composition_it cmp_it;
516 Lisp_Object window;
517 struct window *w;
519 /* Start the scan at the beginning of this line with column number 0. */
520 register ptrdiff_t col = 0, prev_col = 0;
521 EMACS_INT goal = goalcol ? *goalcol : MOST_POSITIVE_FIXNUM;
522 ptrdiff_t end = endpos ? *endpos : PT;
523 ptrdiff_t scan, scan_byte;
524 ptrdiff_t next_boundary;
526 ptrdiff_t opoint = PT, opoint_byte = PT_BYTE;
527 scan_newline (PT, PT_BYTE, BEGV, BEGV_BYTE, -1, 1);
528 current_column_bol_cache = PT;
529 scan = PT, scan_byte = PT_BYTE;
530 SET_PT_BOTH (opoint, opoint_byte);
531 next_boundary = scan;
534 window = Fget_buffer_window (Fcurrent_buffer (), Qnil);
535 w = ! NILP (window) ? XWINDOW (window) : NULL;
537 memset (&cmp_it, 0, sizeof cmp_it);
538 cmp_it.id = -1;
539 composition_compute_stop_pos (&cmp_it, scan, scan_byte, end, Qnil);
541 /* Scan forward to the target position. */
542 while (scan < end)
544 int c;
546 /* Occasionally we may need to skip invisible text. */
547 while (scan == next_boundary)
549 ptrdiff_t old_scan = scan;
550 /* This updates NEXT_BOUNDARY to the next place
551 where we might need to skip more invisible text. */
552 scan = skip_invisible (scan, &next_boundary, end, Qnil);
553 if (scan != old_scan)
554 scan_byte = CHAR_TO_BYTE (scan);
555 if (scan >= end)
556 goto endloop;
559 /* Test reaching the goal column. We do this after skipping
560 invisible characters, so that we put point before the
561 character on which the cursor will appear. */
562 if (col >= goal)
563 break;
564 prev_col = col;
566 { /* Check display property. */
567 ptrdiff_t endp;
568 int width = check_display_width (scan, col, &endp);
569 if (width >= 0)
571 col += width;
572 if (endp > scan) /* Avoid infinite loops with 0-width overlays. */
574 scan = endp; scan_byte = charpos_to_bytepos (scan);
575 continue;
580 /* Check composition sequence. */
581 if (cmp_it.id >= 0
582 || (scan == cmp_it.stop_pos
583 && composition_reseat_it (&cmp_it, scan, scan_byte, end,
584 w, NULL, Qnil)))
585 composition_update_it (&cmp_it, scan, scan_byte, Qnil);
586 if (cmp_it.id >= 0)
588 scan += cmp_it.nchars;
589 scan_byte += cmp_it.nbytes;
590 if (scan <= end)
591 col += cmp_it.width;
592 if (cmp_it.to == cmp_it.nglyphs)
594 cmp_it.id = -1;
595 composition_compute_stop_pos (&cmp_it, scan, scan_byte, end,
596 Qnil);
598 else
599 cmp_it.from = cmp_it.to;
600 continue;
603 c = FETCH_BYTE (scan_byte);
605 /* See if there is a display table and it relates
606 to this character. */
608 if (dp != 0
609 && ! (multibyte && LEADING_CODE_P (c))
610 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
612 Lisp_Object charvec;
613 ptrdiff_t i, n;
615 /* This character is displayed using a vector of glyphs.
616 Update the column/position based on those glyphs. */
618 charvec = DISP_CHAR_VECTOR (dp, c);
619 n = ASIZE (charvec);
621 for (i = 0; i < n; i++)
623 /* This should be handled the same as
624 next_element_from_display_vector does it. */
625 Lisp_Object entry = AREF (charvec, i);
627 if (GLYPH_CODE_P (entry))
628 c = GLYPH_CODE_CHAR (entry);
629 else
630 c = ' ';
632 if (c == '\n')
633 goto endloop;
634 if (c == '\r' && EQ (BVAR (current_buffer, selective_display), Qt))
635 goto endloop;
636 if (c == '\t')
638 col += tab_width;
639 col = col / tab_width * tab_width;
641 else
642 ++col;
645 else
647 /* The display table doesn't affect this character;
648 it displays as itself. */
650 if (c == '\n')
651 goto endloop;
652 if (c == '\r' && EQ (BVAR (current_buffer, selective_display), Qt))
653 goto endloop;
654 if (c == '\t')
656 col += tab_width;
657 col = col / tab_width * tab_width;
659 else if (multibyte && LEADING_CODE_P (c))
661 /* Start of multi-byte form. */
662 unsigned char *ptr;
663 int bytes, width;
665 ptr = BYTE_POS_ADDR (scan_byte);
666 MULTIBYTE_BYTES_WIDTH (ptr, dp, bytes, width);
667 /* Subtract one to compensate for the increment
668 that is going to happen below. */
669 scan_byte += bytes - 1;
670 col += width;
672 else if (ctl_arrow && (c < 040 || c == 0177))
673 col += 2;
674 else if (c < 040 || c >= 0177)
675 col += 4;
676 else
677 col++;
679 scan++;
680 scan_byte++;
683 endloop:
685 last_known_column = col;
686 last_known_column_point = PT;
687 last_known_column_modified = MODIFF;
689 if (goalcol)
690 *goalcol = col;
691 if (endpos)
692 *endpos = scan;
693 if (prevcol)
694 *prevcol = prev_col;
697 /* Return the column number of position POS
698 by scanning forward from the beginning of the line.
699 This function handles characters that are invisible
700 due to text properties or overlays. */
702 static ptrdiff_t
703 current_column_1 (void)
705 EMACS_INT col = MOST_POSITIVE_FIXNUM;
706 ptrdiff_t opoint = PT;
708 scan_for_column (&opoint, &col, NULL);
709 return col;
713 #if 0 /* Not used. */
715 /* Return the width in columns of the part of STRING from BEG to END.
716 If BEG is nil, that stands for the beginning of STRING.
717 If END is nil, that stands for the end of STRING. */
719 static double
720 string_display_width (Lisp_Object string, Lisp_Object beg, Lisp_Object end)
722 int col;
723 unsigned char *ptr, *stop;
724 bool tab_seen;
725 int post_tab;
726 int c;
727 int tab_width = SANE_TAB_WIDTH (current_buffer);
728 bool ctl_arrow = !NILP (current_buffer->ctl_arrow);
729 struct Lisp_Char_Table *dp = buffer_display_table ();
730 int b, e;
732 if (NILP (end))
733 e = SCHARS (string);
734 else
736 CHECK_NUMBER (end);
737 e = XINT (end);
740 if (NILP (beg))
741 b = 0;
742 else
744 CHECK_NUMBER (beg);
745 b = XINT (beg);
748 /* Make a pointer for decrementing through the chars before point. */
749 ptr = SDATA (string) + e;
750 /* Make a pointer to where consecutive chars leave off,
751 going backwards from point. */
752 stop = SDATA (string) + b;
754 col = 0, tab_seen = 0, post_tab = 0;
756 while (1)
758 if (ptr == stop)
759 break;
761 c = *--ptr;
762 if (dp != 0 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
763 col += ASIZE (DISP_CHAR_VECTOR (dp, c));
764 else if (c >= 040 && c < 0177)
765 col++;
766 else if (c == '\n')
767 break;
768 else if (c == '\t')
770 if (tab_seen)
771 col = ((col + tab_width) / tab_width) * tab_width;
773 post_tab += col;
774 col = 0;
775 tab_seen = 1;
777 else
778 col += (ctl_arrow && c < 0200) ? 2 : 4;
781 if (tab_seen)
783 col = ((col + tab_width) / tab_width) * tab_width;
784 col += post_tab;
787 return col;
790 #endif /* 0 */
793 DEFUN ("indent-to", Findent_to, Sindent_to, 1, 2, "NIndent to column: ",
794 doc: /* Indent from point with tabs and spaces until COLUMN is reached.
795 Optional second argument MINIMUM says always do at least MINIMUM spaces
796 even if that goes past COLUMN; by default, MINIMUM is zero.
798 The return value is COLUMN. */)
799 (Lisp_Object column, Lisp_Object minimum)
801 EMACS_INT mincol;
802 register ptrdiff_t fromcol;
803 int tab_width = SANE_TAB_WIDTH (current_buffer);
805 CHECK_NUMBER (column);
806 if (NILP (minimum))
807 XSETFASTINT (minimum, 0);
808 CHECK_NUMBER (minimum);
810 fromcol = current_column ();
811 mincol = fromcol + XINT (minimum);
812 if (mincol < XINT (column)) mincol = XINT (column);
814 if (fromcol == mincol)
815 return make_number (mincol);
817 if (indent_tabs_mode)
819 Lisp_Object n;
820 XSETFASTINT (n, mincol / tab_width - fromcol / tab_width);
821 if (XFASTINT (n) != 0)
823 Finsert_char (make_number ('\t'), n, Qt);
825 fromcol = (mincol / tab_width) * tab_width;
829 XSETFASTINT (column, mincol - fromcol);
830 Finsert_char (make_number (' '), column, Qt);
832 last_known_column = mincol;
833 last_known_column_point = PT;
834 last_known_column_modified = MODIFF;
836 XSETINT (column, mincol);
837 return column;
841 DEFUN ("current-indentation", Fcurrent_indentation, Scurrent_indentation,
842 0, 0, 0,
843 doc: /* Return the indentation of the current line.
844 This is the horizontal position of the character
845 following any initial whitespace. */)
846 (void)
848 Lisp_Object val;
849 ptrdiff_t opoint = PT, opoint_byte = PT_BYTE;
851 scan_newline (PT, PT_BYTE, BEGV, BEGV_BYTE, -1, 1);
853 XSETFASTINT (val, position_indentation (PT_BYTE));
854 SET_PT_BOTH (opoint, opoint_byte);
855 return val;
858 static ptrdiff_t
859 position_indentation (ptrdiff_t pos_byte)
861 register ptrdiff_t column = 0;
862 int tab_width = SANE_TAB_WIDTH (current_buffer);
863 register unsigned char *p;
864 register unsigned char *stop;
865 unsigned char *start;
866 ptrdiff_t next_boundary_byte = pos_byte;
867 ptrdiff_t ceiling = next_boundary_byte;
869 p = BYTE_POS_ADDR (pos_byte);
870 /* STOP records the value of P at which we will need
871 to think about the gap, or about invisible text,
872 or about the end of the buffer. */
873 stop = p;
874 /* START records the starting value of P. */
875 start = p;
876 while (1)
878 while (p == stop)
880 ptrdiff_t stop_pos_byte;
882 /* If we have updated P, set POS_BYTE to match.
883 The first time we enter the loop, POS_BYTE is already right. */
884 if (p != start)
885 pos_byte = PTR_BYTE_POS (p);
886 /* Consider the various reasons STOP might have been set here. */
887 if (pos_byte == ZV_BYTE)
888 return column;
889 if (pos_byte == next_boundary_byte)
891 ptrdiff_t next_boundary;
892 ptrdiff_t pos = BYTE_TO_CHAR (pos_byte);
893 pos = skip_invisible (pos, &next_boundary, ZV, Qnil);
894 pos_byte = CHAR_TO_BYTE (pos);
895 next_boundary_byte = CHAR_TO_BYTE (next_boundary);
897 if (pos_byte >= ceiling)
898 ceiling = BUFFER_CEILING_OF (pos_byte) + 1;
899 /* Compute the next place we need to stop and think,
900 and set STOP accordingly. */
901 stop_pos_byte = min (ceiling, next_boundary_byte);
902 /* The -1 and +1 arrange to point at the first byte of gap
903 (if STOP_POS_BYTE is the position of the gap)
904 rather than at the data after the gap. */
906 stop = BYTE_POS_ADDR (stop_pos_byte - 1) + 1;
907 p = BYTE_POS_ADDR (pos_byte);
909 switch (*p++)
911 case 0240:
912 if (! NILP (BVAR (current_buffer, enable_multibyte_characters)))
913 return column;
914 case ' ':
915 column++;
916 break;
917 case '\t':
918 column += tab_width - column % tab_width;
919 break;
920 default:
921 if (ASCII_BYTE_P (p[-1])
922 || NILP (BVAR (current_buffer, enable_multibyte_characters)))
923 return column;
925 int c;
926 pos_byte = PTR_BYTE_POS (p - 1);
927 c = FETCH_MULTIBYTE_CHAR (pos_byte);
928 if (CHAR_HAS_CATEGORY (c, ' '))
930 column++;
931 INC_POS (pos_byte);
932 p = BYTE_POS_ADDR (pos_byte);
934 else
935 return column;
941 /* Test whether the line beginning at POS is indented beyond COLUMN.
942 Blank lines are treated as if they had the same indentation as the
943 preceding line. */
945 bool
946 indented_beyond_p (ptrdiff_t pos, ptrdiff_t pos_byte, EMACS_INT column)
948 ptrdiff_t val;
949 ptrdiff_t opoint = PT, opoint_byte = PT_BYTE;
951 SET_PT_BOTH (pos, pos_byte);
952 while (PT > BEGV && FETCH_BYTE (PT_BYTE) == '\n')
953 scan_newline (PT - 1, PT_BYTE - 1, BEGV, BEGV_BYTE, -1, 0);
955 val = position_indentation (PT_BYTE);
956 SET_PT_BOTH (opoint, opoint_byte);
957 return val >= column;
960 DEFUN ("move-to-column", Fmove_to_column, Smove_to_column, 1, 2,
961 "NMove to column: ",
962 doc: /* Move point to column COLUMN in the current line.
963 Interactively, COLUMN is the value of prefix numeric argument.
964 The column of a character is calculated by adding together the widths
965 as displayed of the previous characters in the line.
966 This function ignores line-continuation;
967 there is no upper limit on the column number a character can have
968 and horizontal scrolling has no effect.
970 If specified column is within a character, point goes after that character.
971 If it's past end of line, point goes to end of line.
973 Optional second argument FORCE non-nil means if COLUMN is in the
974 middle of a tab character, change it to spaces.
975 In addition, if FORCE is t, and the line is too short to reach
976 COLUMN, add spaces/tabs to get there.
978 The return value is the current column. */)
979 (Lisp_Object column, Lisp_Object force)
981 ptrdiff_t pos, prev_col;
982 EMACS_INT col;
983 EMACS_INT goal;
985 CHECK_NATNUM (column);
986 goal = XINT (column);
988 col = goal;
989 pos = ZV;
990 scan_for_column (&pos, &col, &prev_col);
992 SET_PT (pos);
994 /* If a tab char made us overshoot, change it to spaces
995 and scan through it again. */
996 if (!NILP (force) && col > goal)
998 int c;
999 ptrdiff_t pos_byte = PT_BYTE;
1001 DEC_POS (pos_byte);
1002 c = FETCH_CHAR (pos_byte);
1003 if (c == '\t' && prev_col < goal)
1005 ptrdiff_t goal_pt, goal_pt_byte;
1007 /* Insert spaces in front of the tab to reach GOAL. Do this
1008 first so that a marker at the end of the tab gets
1009 adjusted. */
1010 SET_PT_BOTH (PT - 1, PT_BYTE - 1);
1011 Finsert_char (make_number (' '), make_number (goal - prev_col), Qt);
1013 /* Now delete the tab, and indent to COL. */
1014 del_range (PT, PT + 1);
1015 goal_pt = PT;
1016 goal_pt_byte = PT_BYTE;
1017 Findent_to (make_number (col), Qnil);
1018 SET_PT_BOTH (goal_pt, goal_pt_byte);
1020 /* Set the last_known... vars consistently. */
1021 col = goal;
1025 /* If line ends prematurely, add space to the end. */
1026 if (col < goal && EQ (force, Qt))
1027 Findent_to (make_number (col = goal), Qnil);
1029 last_known_column = col;
1030 last_known_column_point = PT;
1031 last_known_column_modified = MODIFF;
1033 return make_number (col);
1036 /* compute_motion: compute buffer posn given screen posn and vice versa */
1038 static struct position val_compute_motion;
1040 /* Scan the current buffer forward from offset FROM, pretending that
1041 this is at line FROMVPOS, column FROMHPOS, until reaching buffer
1042 offset TO or line TOVPOS, column TOHPOS (whichever comes first),
1043 and return the ending buffer position and screen location. If we
1044 can't hit the requested column exactly (because of a tab or other
1045 multi-column character), overshoot.
1047 DID_MOTION is true if FROMHPOS has already accounted for overlay strings
1048 at FROM. This is the case if FROMVPOS and FROMVPOS came from an
1049 earlier call to compute_motion. The other common case is that FROMHPOS
1050 is zero and FROM is a position that "belongs" at column zero, but might
1051 be shifted by overlay strings; in this case DID_MOTION should be false.
1053 WIDTH is the number of columns available to display text;
1054 compute_motion uses this to handle continuation lines and such.
1055 If WIDTH is -1, use width of window's text area adjusted for
1056 continuation glyph when needed.
1058 HSCROLL is the number of columns not being displayed at the left
1059 margin; this is usually taken from a window's hscroll member.
1060 TAB_OFFSET is the number of columns of the first tab that aren't
1061 being displayed, perhaps because of a continuation line or
1062 something.
1064 compute_motion returns a pointer to a struct position. The bufpos
1065 member gives the buffer position at the end of the scan, and hpos
1066 and vpos give its cartesian location. prevhpos is the column at
1067 which the character before bufpos started, and contin is non-zero
1068 if we reached the current line by continuing the previous.
1070 Note that FROMHPOS and TOHPOS should be expressed in real screen
1071 columns, taking HSCROLL and the truncation glyph at the left margin
1072 into account. That is, beginning-of-line moves you to the hpos
1073 -HSCROLL + (HSCROLL > 0).
1075 For example, to find the buffer position of column COL of line LINE
1076 of a certain window, pass the window's starting location as FROM
1077 and the window's upper-left coordinates as FROMVPOS and FROMHPOS.
1078 Pass the buffer's ZV as TO, to limit the scan to the end of the
1079 visible section of the buffer, and pass LINE and COL as TOVPOS and
1080 TOHPOS.
1082 When displaying in window w, a typical formula for WIDTH is:
1084 window_width - 1
1085 - (has_vertical_scroll_bars
1086 ? WINDOW_CONFIG_SCROLL_BAR_COLS (window)
1087 : (window_width + window_left != frame_cols))
1089 where
1090 window_width is XFASTINT (w->total_cols),
1091 window_left is XFASTINT (w->left_col),
1092 has_vertical_scroll_bars is
1093 WINDOW_HAS_VERTICAL_SCROLL_BAR (window)
1094 and frame_cols = FRAME_COLS (XFRAME (window->frame))
1096 Or you can let window_body_cols do this all for you, and write:
1097 window_body_cols (w) - 1
1099 The `-1' accounts for the continuation-line backslashes; the rest
1100 accounts for window borders if the window is split horizontally, and
1101 the scroll bars if they are turned on. */
1103 struct position *
1104 compute_motion (ptrdiff_t from, EMACS_INT fromvpos, EMACS_INT fromhpos,
1105 bool did_motion, ptrdiff_t to,
1106 EMACS_INT tovpos, EMACS_INT tohpos, EMACS_INT width,
1107 ptrdiff_t hscroll, int tab_offset, struct window *win)
1109 EMACS_INT hpos = fromhpos;
1110 EMACS_INT vpos = fromvpos;
1112 ptrdiff_t pos;
1113 ptrdiff_t pos_byte;
1114 int c = 0;
1115 int tab_width = SANE_TAB_WIDTH (current_buffer);
1116 bool ctl_arrow = !NILP (BVAR (current_buffer, ctl_arrow));
1117 struct Lisp_Char_Table *dp = window_display_table (win);
1118 EMACS_INT selective
1119 = (INTEGERP (BVAR (current_buffer, selective_display))
1120 ? XINT (BVAR (current_buffer, selective_display))
1121 : !NILP (BVAR (current_buffer, selective_display)) ? -1 : 0);
1122 ptrdiff_t selective_rlen
1123 = (selective && dp && VECTORP (DISP_INVIS_VECTOR (dp))
1124 ? ASIZE (DISP_INVIS_VECTOR (dp)) : 0);
1125 /* The next location where the `invisible' property changes, or an
1126 overlay starts or ends. */
1127 ptrdiff_t next_boundary = from;
1129 /* For computing runs of characters with similar widths.
1130 Invariant: width_run_width is zero, or all the characters
1131 from width_run_start to width_run_end have a fixed width of
1132 width_run_width. */
1133 ptrdiff_t width_run_start = from;
1134 ptrdiff_t width_run_end = from;
1135 ptrdiff_t width_run_width = 0;
1136 Lisp_Object *width_table;
1138 /* The next buffer pos where we should consult the width run cache. */
1139 ptrdiff_t next_width_run = from;
1140 Lisp_Object window;
1142 bool multibyte = !NILP (BVAR (current_buffer, enable_multibyte_characters));
1143 /* If previous char scanned was a wide character,
1144 this is the column where it ended. Otherwise, this is 0. */
1145 EMACS_INT wide_column_end_hpos = 0;
1146 ptrdiff_t prev_pos; /* Previous buffer position. */
1147 ptrdiff_t prev_pos_byte; /* Previous buffer position. */
1148 EMACS_INT prev_hpos = 0;
1149 EMACS_INT prev_vpos = 0;
1150 EMACS_INT contin_hpos; /* HPOS of last column of continued line. */
1151 int prev_tab_offset; /* Previous tab offset. */
1152 int continuation_glyph_width;
1154 struct composition_it cmp_it;
1156 XSETWINDOW (window, win);
1158 width_run_cache_on_off ();
1159 if (dp == buffer_display_table ())
1160 width_table = (VECTORP (BVAR (current_buffer, width_table))
1161 ? XVECTOR (BVAR (current_buffer, width_table))->contents
1162 : 0);
1163 else
1164 /* If the window has its own display table, we can't use the width
1165 run cache, because that's based on the buffer's display table. */
1166 width_table = 0;
1168 /* Negative width means use all available text columns. */
1169 if (width < 0)
1171 width = window_body_cols (win);
1172 /* We must make room for continuation marks if we don't have fringes. */
1173 #ifdef HAVE_WINDOW_SYSTEM
1174 if (!FRAME_WINDOW_P (XFRAME (win->frame)))
1175 #endif
1176 width -= 1;
1179 continuation_glyph_width = 1;
1180 #ifdef HAVE_WINDOW_SYSTEM
1181 if (FRAME_WINDOW_P (XFRAME (win->frame)))
1182 continuation_glyph_width = 0; /* In the fringe. */
1183 #endif
1185 immediate_quit = 1;
1186 QUIT;
1188 pos = prev_pos = from;
1189 pos_byte = prev_pos_byte = CHAR_TO_BYTE (from);
1190 contin_hpos = 0;
1191 prev_tab_offset = tab_offset;
1192 memset (&cmp_it, 0, sizeof cmp_it);
1193 cmp_it.id = -1;
1194 composition_compute_stop_pos (&cmp_it, pos, pos_byte, to, Qnil);
1196 while (1)
1198 while (pos == next_boundary)
1200 ptrdiff_t pos_here = pos;
1201 ptrdiff_t newpos;
1203 /* Don't skip invisible if we are already at the margin. */
1204 if (vpos > tovpos || (vpos == tovpos && hpos >= tohpos))
1206 if (contin_hpos && prev_hpos == 0
1207 && hpos > tohpos
1208 && (contin_hpos == width || wide_column_end_hpos > width))
1209 { /* Line breaks because we can't put the character at the
1210 previous line any more. It is not the multi-column
1211 character continued in middle. Go back to previous
1212 buffer position, screen position, and set tab offset
1213 to previous value. It's the beginning of the
1214 line. */
1215 pos = prev_pos;
1216 pos_byte = prev_pos_byte;
1217 hpos = prev_hpos;
1218 vpos = prev_vpos;
1219 tab_offset = prev_tab_offset;
1221 break;
1224 /* If the caller says that the screen position came from an earlier
1225 call to compute_motion, then we've already accounted for the
1226 overlay strings at point. This is only true the first time
1227 through, so clear the flag after testing it. */
1228 if (!did_motion)
1229 /* We need to skip past the overlay strings. Currently those
1230 strings must not contain TAB;
1231 if we want to relax that restriction, something will have
1232 to be changed here. */
1234 unsigned char *ovstr;
1235 ptrdiff_t ovlen = overlay_strings (pos, win, &ovstr);
1236 hpos += ((multibyte && ovlen > 0)
1237 ? strwidth ((char *) ovstr, ovlen) : ovlen);
1239 did_motion = 0;
1241 if (pos >= to)
1242 break;
1244 /* Advance POS past invisible characters
1245 (but not necessarily all that there are here),
1246 and store in next_boundary the next position where
1247 we need to call skip_invisible. */
1248 newpos = skip_invisible (pos, &next_boundary, to, window);
1250 if (newpos >= to)
1252 pos = min (to, newpos);
1253 pos_byte = CHAR_TO_BYTE (pos);
1254 goto after_loop;
1257 if (newpos != pos_here)
1259 pos = newpos;
1260 pos_byte = CHAR_TO_BYTE (pos);
1264 /* Handle right margin. */
1265 /* Note on a wide-column character.
1267 Characters are classified into the following three categories
1268 according to the width (columns occupied on screen).
1270 (1) single-column character: ex. `a'
1271 (2) multi-column character: ex. `^A', TAB, `\033'
1272 (3) wide-column character: ex. Japanese character, Chinese character
1273 (In the following example, `W_' stands for them.)
1275 Multi-column characters can be divided around the right margin,
1276 but wide-column characters cannot.
1278 NOTE:
1280 (*) The cursor is placed on the next character after the point.
1282 ----------
1283 abcdefghi\
1284 j ^---- next after the point
1285 ^--- next char. after the point.
1286 ----------
1287 In case of sigle-column character
1289 ----------
1290 abcdefgh\\
1291 033 ^---- next after the point, next char. after the point.
1292 ----------
1293 In case of multi-column character
1295 ----------
1296 abcdefgh\\
1297 W_ ^---- next after the point
1298 ^---- next char. after the point.
1299 ----------
1300 In case of wide-column character
1302 The problem here is continuation at a wide-column character.
1303 In this case, the line may shorter less than WIDTH.
1304 And we find the continuation AFTER it occurs.
1308 if (hpos > width)
1310 EMACS_INT total_width = width + continuation_glyph_width;
1311 bool truncate = 0;
1313 if (!NILP (Vtruncate_partial_width_windows)
1314 && (total_width < FRAME_COLS (XFRAME (WINDOW_FRAME (win)))))
1316 if (INTEGERP (Vtruncate_partial_width_windows))
1317 truncate
1318 = total_width < XFASTINT (Vtruncate_partial_width_windows);
1319 else
1320 truncate = 1;
1323 if (hscroll || truncate
1324 || !NILP (BVAR (current_buffer, truncate_lines)))
1326 /* Truncating: skip to newline, unless we are already past
1327 TO (we need to go back below). */
1328 if (pos <= to)
1330 pos = find_before_next_newline (pos, to, 1);
1331 pos_byte = CHAR_TO_BYTE (pos);
1332 hpos = width;
1333 /* If we just skipped next_boundary,
1334 loop around in the main while
1335 and handle it. */
1336 if (pos >= next_boundary)
1337 next_boundary = pos + 1;
1338 prev_hpos = width;
1339 prev_vpos = vpos;
1340 prev_tab_offset = tab_offset;
1343 else
1345 /* Continuing. */
1346 /* Remember the previous value. */
1347 prev_tab_offset = tab_offset;
1349 if (wide_column_end_hpos > width)
1351 hpos -= prev_hpos;
1352 tab_offset += prev_hpos;
1354 else
1356 tab_offset += width;
1357 hpos -= width;
1359 vpos++;
1360 contin_hpos = prev_hpos;
1361 prev_hpos = 0;
1362 prev_vpos = vpos;
1366 /* Stop if past the target buffer position or screen position. */
1367 if (pos > to)
1369 /* Go back to the previous position. */
1370 pos = prev_pos;
1371 pos_byte = prev_pos_byte;
1372 hpos = prev_hpos;
1373 vpos = prev_vpos;
1374 tab_offset = prev_tab_offset;
1376 /* NOTE on contin_hpos, hpos, and prev_hpos.
1378 ----------
1379 abcdefgh\\
1380 W_ ^---- contin_hpos
1381 | ^----- hpos
1382 \---- prev_hpos
1383 ----------
1386 if (contin_hpos && prev_hpos == 0
1387 && contin_hpos < width && !wide_column_end_hpos)
1389 /* Line breaking occurs in the middle of multi-column
1390 character. Go back to previous line. */
1391 hpos = contin_hpos;
1392 vpos = vpos - 1;
1394 break;
1397 if (vpos > tovpos || (vpos == tovpos && hpos >= tohpos))
1399 if (contin_hpos && prev_hpos == 0
1400 && hpos > tohpos
1401 && (contin_hpos == width || wide_column_end_hpos > width))
1402 { /* Line breaks because we can't put the character at the
1403 previous line any more. It is not the multi-column
1404 character continued in middle. Go back to previous
1405 buffer position, screen position, and set tab offset
1406 to previous value. It's the beginning of the
1407 line. */
1408 pos = prev_pos;
1409 pos_byte = prev_pos_byte;
1410 hpos = prev_hpos;
1411 vpos = prev_vpos;
1412 tab_offset = prev_tab_offset;
1414 break;
1416 if (pos == ZV) /* We cannot go beyond ZV. Stop here. */
1417 break;
1419 prev_hpos = hpos;
1420 prev_vpos = vpos;
1421 prev_pos = pos;
1422 prev_pos_byte = pos_byte;
1423 wide_column_end_hpos = 0;
1425 /* Consult the width run cache to see if we can avoid inspecting
1426 the text character-by-character. */
1427 if (current_buffer->width_run_cache && pos >= next_width_run)
1429 ptrdiff_t run_end;
1430 int common_width
1431 = region_cache_forward (current_buffer,
1432 current_buffer->width_run_cache,
1433 pos, &run_end);
1435 /* A width of zero means the character's width varies (like
1436 a tab), is meaningless (like a newline), or we just don't
1437 want to skip over it for some other reason. */
1438 if (common_width != 0)
1440 ptrdiff_t run_end_hpos;
1442 /* Don't go past the final buffer posn the user
1443 requested. */
1444 if (run_end > to)
1445 run_end = to;
1447 run_end_hpos = hpos + (run_end - pos) * common_width;
1449 /* Don't go past the final horizontal position the user
1450 requested. */
1451 if (vpos == tovpos && run_end_hpos > tohpos)
1453 run_end = pos + (tohpos - hpos) / common_width;
1454 run_end_hpos = hpos + (run_end - pos) * common_width;
1457 /* Don't go past the margin. */
1458 if (run_end_hpos >= width)
1460 run_end = pos + (width - hpos) / common_width;
1461 run_end_hpos = hpos + (run_end - pos) * common_width;
1464 hpos = run_end_hpos;
1465 if (run_end > pos)
1466 prev_hpos = hpos - common_width;
1467 if (pos != run_end)
1469 pos = run_end;
1470 pos_byte = CHAR_TO_BYTE (pos);
1474 next_width_run = run_end + 1;
1477 /* We have to scan the text character-by-character. */
1478 else
1480 ptrdiff_t i, n;
1481 Lisp_Object charvec;
1483 /* Check composition sequence. */
1484 if (cmp_it.id >= 0
1485 || (pos == cmp_it.stop_pos
1486 && composition_reseat_it (&cmp_it, pos, pos_byte, to, win,
1487 NULL, Qnil)))
1488 composition_update_it (&cmp_it, pos, pos_byte, Qnil);
1489 if (cmp_it.id >= 0)
1491 pos += cmp_it.nchars;
1492 pos_byte += cmp_it.nbytes;
1493 hpos += cmp_it.width;
1494 if (cmp_it.to == cmp_it.nglyphs)
1496 cmp_it.id = -1;
1497 composition_compute_stop_pos (&cmp_it, pos, pos_byte, to,
1498 Qnil);
1500 else
1501 cmp_it.from = cmp_it.to;
1502 continue;
1505 c = FETCH_BYTE (pos_byte);
1506 pos++, pos_byte++;
1508 /* Perhaps add some info to the width_run_cache. */
1509 if (current_buffer->width_run_cache)
1511 /* Is this character part of the current run? If so, extend
1512 the run. */
1513 if (pos - 1 == width_run_end
1514 && XFASTINT (width_table[c]) == width_run_width)
1515 width_run_end = pos;
1517 /* The previous run is over, since this is a character at a
1518 different position, or a different width. */
1519 else
1521 /* Have we accumulated a run to put in the cache?
1522 (Currently, we only cache runs of width == 1). */
1523 if (width_run_start < width_run_end
1524 && width_run_width == 1)
1525 know_region_cache (current_buffer,
1526 current_buffer->width_run_cache,
1527 width_run_start, width_run_end);
1529 /* Start recording a new width run. */
1530 width_run_width = XFASTINT (width_table[c]);
1531 width_run_start = pos - 1;
1532 width_run_end = pos;
1536 if (dp != 0
1537 && ! (multibyte && LEADING_CODE_P (c))
1538 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
1540 charvec = DISP_CHAR_VECTOR (dp, c);
1541 n = ASIZE (charvec);
1543 else
1545 charvec = Qnil;
1546 n = 1;
1549 for (i = 0; i < n; ++i)
1551 if (VECTORP (charvec))
1553 /* This should be handled the same as
1554 next_element_from_display_vector does it. */
1555 Lisp_Object entry = AREF (charvec, i);
1557 if (GLYPH_CODE_P (entry))
1558 c = GLYPH_CODE_CHAR (entry);
1559 else
1560 c = ' ';
1563 if (c >= 040 && c < 0177)
1564 hpos++;
1565 else if (c == '\t')
1567 int tem = ((hpos + tab_offset + hscroll - (hscroll > 0))
1568 % tab_width);
1569 if (tem < 0)
1570 tem += tab_width;
1571 hpos += tab_width - tem;
1573 else if (c == '\n')
1575 if (selective > 0
1576 && indented_beyond_p (pos, pos_byte, selective))
1578 /* If (pos == to), we don't have to take care of
1579 selective display. */
1580 if (pos < to)
1582 /* Skip any number of invisible lines all at once */
1585 pos = find_before_next_newline (pos, to, 1);
1586 if (pos < to)
1587 pos++;
1588 pos_byte = CHAR_TO_BYTE (pos);
1590 while (pos < to
1591 && indented_beyond_p (pos, pos_byte,
1592 selective));
1593 /* Allow for the " ..." that is displayed for them. */
1594 if (selective_rlen)
1596 hpos += selective_rlen;
1597 if (hpos >= width)
1598 hpos = width;
1600 DEC_BOTH (pos, pos_byte);
1601 /* We have skipped the invis text, but not the
1602 newline after. */
1605 else
1607 /* A visible line. */
1608 vpos++;
1609 hpos = 0;
1610 hpos -= hscroll;
1611 /* Count the truncation glyph on column 0 */
1612 if (hscroll > 0)
1613 hpos += continuation_glyph_width;
1614 tab_offset = 0;
1616 contin_hpos = 0;
1618 else if (c == CR && selective < 0)
1620 /* In selective display mode,
1621 everything from a ^M to the end of the line is invisible.
1622 Stop *before* the real newline. */
1623 if (pos < to)
1625 pos = find_before_next_newline (pos, to, 1);
1626 pos_byte = CHAR_TO_BYTE (pos);
1628 /* If we just skipped next_boundary,
1629 loop around in the main while
1630 and handle it. */
1631 if (pos > next_boundary)
1632 next_boundary = pos;
1633 /* Allow for the " ..." that is displayed for them. */
1634 if (selective_rlen)
1636 hpos += selective_rlen;
1637 if (hpos >= width)
1638 hpos = width;
1641 else if (multibyte && LEADING_CODE_P (c))
1643 /* Start of multi-byte form. */
1644 unsigned char *ptr;
1645 int mb_bytes, mb_width;
1647 pos_byte--; /* rewind POS_BYTE */
1648 ptr = BYTE_POS_ADDR (pos_byte);
1649 MULTIBYTE_BYTES_WIDTH (ptr, dp, mb_bytes, mb_width);
1650 pos_byte += mb_bytes;
1651 if (mb_width > 1 && BYTES_BY_CHAR_HEAD (*ptr) == mb_bytes)
1652 wide_column_end_hpos = hpos + mb_width;
1653 hpos += mb_width;
1655 else if (VECTORP (charvec))
1656 ++hpos;
1657 else
1658 hpos += (ctl_arrow && c < 0200) ? 2 : 4;
1663 after_loop:
1665 /* Remember any final width run in the cache. */
1666 if (current_buffer->width_run_cache
1667 && width_run_width == 1
1668 && width_run_start < width_run_end)
1669 know_region_cache (current_buffer, current_buffer->width_run_cache,
1670 width_run_start, width_run_end);
1672 val_compute_motion.bufpos = pos;
1673 val_compute_motion.bytepos = pos_byte;
1674 val_compute_motion.hpos = hpos;
1675 val_compute_motion.vpos = vpos;
1676 if (contin_hpos && prev_hpos == 0)
1677 val_compute_motion.prevhpos = contin_hpos;
1678 else
1679 val_compute_motion.prevhpos = prev_hpos;
1681 /* Nonzero if have just continued a line */
1682 val_compute_motion.contin = (contin_hpos && prev_hpos == 0);
1684 immediate_quit = 0;
1685 return &val_compute_motion;
1689 DEFUN ("compute-motion", Fcompute_motion, Scompute_motion, 7, 7, 0,
1690 doc: /* Scan through the current buffer, calculating screen position.
1691 Scan the current buffer forward from offset FROM,
1692 assuming it is at position FROMPOS--a cons of the form (HPOS . VPOS)--
1693 to position TO or position TOPOS--another cons of the form (HPOS . VPOS)--
1694 and return the ending buffer position and screen location.
1696 If TOPOS is nil, the actual width and height of the window's
1697 text area are used.
1699 There are three additional arguments:
1701 WIDTH is the number of columns available to display text;
1702 this affects handling of continuation lines. A value of nil
1703 corresponds to the actual number of available text columns.
1705 OFFSETS is either nil or a cons cell (HSCROLL . TAB-OFFSET).
1706 HSCROLL is the number of columns not being displayed at the left
1707 margin; this is usually taken from a window's hscroll member.
1708 TAB-OFFSET is the number of columns of the first tab that aren't
1709 being displayed, perhaps because the line was continued within it.
1710 If OFFSETS is nil, HSCROLL and TAB-OFFSET are assumed to be zero.
1712 WINDOW is the window to operate on. It is used to choose the display table;
1713 if it is showing the current buffer, it is used also for
1714 deciding which overlay properties apply.
1715 Note that `compute-motion' always operates on the current buffer.
1717 The value is a list of five elements:
1718 (POS HPOS VPOS PREVHPOS CONTIN)
1719 POS is the buffer position where the scan stopped.
1720 VPOS is the vertical position where the scan stopped.
1721 HPOS is the horizontal position where the scan stopped.
1723 PREVHPOS is the horizontal position one character back from POS.
1724 CONTIN is t if a line was continued after (or within) the previous character.
1726 For example, to find the buffer position of column COL of line LINE
1727 of a certain window, pass the window's starting location as FROM
1728 and the window's upper-left coordinates as FROMPOS.
1729 Pass the buffer's (point-max) as TO, to limit the scan to the end of the
1730 visible section of the buffer, and pass LINE and COL as TOPOS. */)
1731 (Lisp_Object from, Lisp_Object frompos, Lisp_Object to, Lisp_Object topos, Lisp_Object width, Lisp_Object offsets, Lisp_Object window)
1733 struct window *w;
1734 Lisp_Object bufpos, hpos, vpos, prevhpos;
1735 struct position *pos;
1736 ptrdiff_t hscroll;
1737 int tab_offset;
1739 CHECK_NUMBER_COERCE_MARKER (from);
1740 CHECK_CONS (frompos);
1741 CHECK_NUMBER_CAR (frompos);
1742 CHECK_NUMBER_CDR (frompos);
1743 CHECK_NUMBER_COERCE_MARKER (to);
1744 if (!NILP (topos))
1746 CHECK_CONS (topos);
1747 CHECK_NUMBER_CAR (topos);
1748 CHECK_NUMBER_CDR (topos);
1750 if (!NILP (width))
1751 CHECK_NUMBER (width);
1753 if (!NILP (offsets))
1755 CHECK_CONS (offsets);
1756 CHECK_NUMBER_CAR (offsets);
1757 CHECK_NUMBER_CDR (offsets);
1758 if (! (0 <= XINT (XCAR (offsets)) && XINT (XCAR (offsets)) <= PTRDIFF_MAX
1759 && 0 <= XINT (XCDR (offsets)) && XINT (XCDR (offsets)) <= INT_MAX))
1760 args_out_of_range (XCAR (offsets), XCDR (offsets));
1761 hscroll = XINT (XCAR (offsets));
1762 tab_offset = XINT (XCDR (offsets));
1764 else
1765 hscroll = tab_offset = 0;
1767 if (NILP (window))
1768 window = Fselected_window ();
1769 else
1770 CHECK_LIVE_WINDOW (window);
1771 w = XWINDOW (window);
1773 if (XINT (from) < BEGV || XINT (from) > ZV)
1774 args_out_of_range_3 (from, make_number (BEGV), make_number (ZV));
1775 if (XINT (to) < BEGV || XINT (to) > ZV)
1776 args_out_of_range_3 (to, make_number (BEGV), make_number (ZV));
1778 pos = compute_motion (XINT (from), XINT (XCDR (frompos)),
1779 XINT (XCAR (frompos)), 0,
1780 XINT (to),
1781 (NILP (topos)
1782 ? window_internal_height (w)
1783 : XINT (XCDR (topos))),
1784 (NILP (topos)
1785 ? (window_body_cols (w)
1787 #ifdef HAVE_WINDOW_SYSTEM
1788 FRAME_WINDOW_P (XFRAME (w->frame)) ? 0 :
1789 #endif
1791 : XINT (XCAR (topos))),
1792 (NILP (width) ? -1 : XINT (width)),
1793 hscroll, tab_offset,
1794 XWINDOW (window));
1796 XSETFASTINT (bufpos, pos->bufpos);
1797 XSETINT (hpos, pos->hpos);
1798 XSETINT (vpos, pos->vpos);
1799 XSETINT (prevhpos, pos->prevhpos);
1801 return Fcons (bufpos,
1802 Fcons (hpos,
1803 Fcons (vpos,
1804 Fcons (prevhpos,
1805 Fcons (pos->contin ? Qt : Qnil, Qnil)))));
1809 /* Fvertical_motion and vmotion */
1811 static struct position val_vmotion;
1813 struct position *
1814 vmotion (register ptrdiff_t from, register EMACS_INT vtarget, struct window *w)
1816 ptrdiff_t hscroll = w->hscroll;
1817 struct position pos;
1818 /* vpos is cumulative vertical position, changed as from is changed */
1819 register EMACS_INT vpos = 0;
1820 ptrdiff_t prevline;
1821 register ptrdiff_t first;
1822 ptrdiff_t from_byte;
1823 ptrdiff_t lmargin = hscroll > 0 ? 1 - hscroll : 0;
1824 ptrdiff_t selective
1825 = (INTEGERP (BVAR (current_buffer, selective_display))
1826 ? clip_to_bounds (-1, XINT (BVAR (current_buffer, selective_display)),
1827 PTRDIFF_MAX)
1828 : !NILP (BVAR (current_buffer, selective_display)) ? -1 : 0);
1829 Lisp_Object window;
1830 bool did_motion;
1831 /* This is the object we use for fetching character properties. */
1832 Lisp_Object text_prop_object;
1834 XSETWINDOW (window, w);
1836 /* If the window contains this buffer, use it for getting text properties.
1837 Otherwise use the current buffer as arg for doing that. */
1838 if (EQ (w->buffer, Fcurrent_buffer ()))
1839 text_prop_object = window;
1840 else
1841 text_prop_object = Fcurrent_buffer ();
1843 if (vpos >= vtarget)
1845 /* To move upward, go a line at a time until
1846 we have gone at least far enough. */
1848 first = 1;
1850 while ((vpos > vtarget || first) && from > BEGV)
1852 Lisp_Object propval;
1854 prevline = find_next_newline_no_quit (from - 1, -1);
1855 while (prevline > BEGV
1856 && ((selective > 0
1857 && indented_beyond_p (prevline,
1858 CHAR_TO_BYTE (prevline),
1859 selective))
1860 /* Watch out for newlines with `invisible' property.
1861 When moving upward, check the newline before. */
1862 || (propval = Fget_char_property (make_number (prevline - 1),
1863 Qinvisible,
1864 text_prop_object),
1865 TEXT_PROP_MEANS_INVISIBLE (propval))))
1866 prevline = find_next_newline_no_quit (prevline - 1, -1);
1867 pos = *compute_motion (prevline, 0,
1868 lmargin,
1870 from,
1871 /* Don't care for VPOS... */
1872 1 << (BITS_PER_SHORT - 1),
1873 /* ... nor HPOS. */
1874 1 << (BITS_PER_SHORT - 1),
1875 -1, hscroll,
1878 vpos -= pos.vpos;
1879 first = 0;
1880 from = prevline;
1883 /* If we made exactly the desired vertical distance,
1884 or if we hit beginning of buffer,
1885 return point found */
1886 if (vpos >= vtarget)
1888 val_vmotion.bufpos = from;
1889 val_vmotion.bytepos = CHAR_TO_BYTE (from);
1890 val_vmotion.vpos = vpos;
1891 val_vmotion.hpos = lmargin;
1892 val_vmotion.contin = 0;
1893 val_vmotion.prevhpos = 0;
1894 return &val_vmotion;
1897 /* Otherwise find the correct spot by moving down */
1899 /* Moving downward is simple, but must calculate from beg of line
1900 to determine hpos of starting point */
1901 from_byte = CHAR_TO_BYTE (from);
1902 if (from > BEGV && FETCH_BYTE (from_byte - 1) != '\n')
1904 Lisp_Object propval;
1906 prevline = find_next_newline_no_quit (from, -1);
1907 while (prevline > BEGV
1908 && ((selective > 0
1909 && indented_beyond_p (prevline,
1910 CHAR_TO_BYTE (prevline),
1911 selective))
1912 /* Watch out for newlines with `invisible' property.
1913 When moving downward, check the newline after. */
1914 || (propval = Fget_char_property (make_number (prevline),
1915 Qinvisible,
1916 text_prop_object),
1917 TEXT_PROP_MEANS_INVISIBLE (propval))))
1918 prevline = find_next_newline_no_quit (prevline - 1, -1);
1919 pos = *compute_motion (prevline, 0,
1920 lmargin,
1922 from,
1923 /* Don't care for VPOS... */
1924 1 << (BITS_PER_SHORT - 1),
1925 /* ... nor HPOS. */
1926 1 << (BITS_PER_SHORT - 1),
1927 -1, hscroll,
1930 did_motion = 1;
1932 else
1934 pos.hpos = lmargin;
1935 pos.vpos = 0;
1936 did_motion = 0;
1938 return compute_motion (from, vpos, pos.hpos, did_motion,
1939 ZV, vtarget, - (1 << (BITS_PER_SHORT - 1)),
1940 -1, hscroll,
1945 DEFUN ("vertical-motion", Fvertical_motion, Svertical_motion, 1, 2, 0,
1946 doc: /* Move point to start of the screen line LINES lines down.
1947 If LINES is negative, this means moving up.
1949 This function is an ordinary cursor motion function
1950 which calculates the new position based on how text would be displayed.
1951 The new position may be the start of a line,
1952 or just the start of a continuation line.
1953 The function returns number of screen lines moved over;
1954 that usually equals LINES, but may be closer to zero
1955 if beginning or end of buffer was reached.
1957 The optional second argument WINDOW specifies the window to use for
1958 parameters such as width, horizontal scrolling, and so on.
1959 The default is to use the selected window's parameters.
1961 LINES can optionally take the form (COLS . LINES), in which case
1962 the motion will not stop at the start of a screen line but on
1963 its column COLS (if such exists on that line, that is).
1965 `vertical-motion' always uses the current buffer,
1966 regardless of which buffer is displayed in WINDOW.
1967 This is consistent with other cursor motion functions
1968 and makes it possible to use `vertical-motion' in any buffer,
1969 whether or not it is currently displayed in some window. */)
1970 (Lisp_Object lines, Lisp_Object window)
1972 struct it it;
1973 struct text_pos pt;
1974 struct window *w;
1975 Lisp_Object old_buffer;
1976 EMACS_INT old_charpos IF_LINT (= 0), old_bytepos IF_LINT (= 0);
1977 struct gcpro gcpro1, gcpro2, gcpro3;
1978 Lisp_Object lcols = Qnil;
1979 double cols IF_LINT (= 0);
1980 void *itdata = NULL;
1982 /* Allow LINES to be of the form (HPOS . VPOS) aka (COLUMNS . LINES). */
1983 if (CONSP (lines) && (NUMBERP (XCAR (lines))))
1985 lcols = XCAR (lines);
1986 cols = INTEGERP (lcols) ? (double) XINT (lcols) : XFLOAT_DATA (lcols);
1987 lines = XCDR (lines);
1990 CHECK_NUMBER (lines);
1991 if (! NILP (window))
1992 CHECK_WINDOW (window);
1993 else
1994 window = selected_window;
1995 w = XWINDOW (window);
1997 old_buffer = Qnil;
1998 GCPRO3 (old_buffer, old_charpos, old_bytepos);
1999 if (XBUFFER (w->buffer) != current_buffer)
2001 /* Set the window's buffer temporarily to the current buffer. */
2002 old_buffer = w->buffer;
2003 old_charpos = XMARKER (w->pointm)->charpos;
2004 old_bytepos = XMARKER (w->pointm)->bytepos;
2005 wset_buffer (w, Fcurrent_buffer ());
2006 set_marker_both (w->pointm, w->buffer,
2007 BUF_PT (current_buffer), BUF_PT_BYTE (current_buffer));
2010 if (noninteractive)
2012 struct position pos;
2013 pos = *vmotion (PT, XINT (lines), w);
2014 SET_PT_BOTH (pos.bufpos, pos.bytepos);
2016 else
2018 ptrdiff_t it_start, it_overshoot_count = 0;
2019 int first_x;
2020 bool overshoot_handled = 0;
2021 bool disp_string_at_start_p = 0;
2023 itdata = bidi_shelve_cache ();
2024 SET_TEXT_POS (pt, PT, PT_BYTE);
2025 start_display (&it, w, pt);
2026 first_x = it.first_visible_x;
2027 it_start = IT_CHARPOS (it);
2029 /* See comments below for why we calculate this. */
2030 if (it.cmp_it.id >= 0)
2031 it_overshoot_count = 0;
2032 else if (it.method == GET_FROM_STRING)
2034 const char *s = SSDATA (it.string);
2035 const char *e = s + SBYTES (it.string);
2037 disp_string_at_start_p = it.string_from_display_prop_p;
2038 while (s < e)
2040 if (*s++ == '\n')
2041 it_overshoot_count++;
2043 if (!it_overshoot_count)
2044 it_overshoot_count = -1;
2046 else
2047 it_overshoot_count =
2048 !(it.method == GET_FROM_IMAGE || it.method == GET_FROM_STRETCH);
2050 /* Scan from the start of the line containing PT. If we don't
2051 do this, we start moving with IT->current_x == 0, while PT is
2052 really at some x > 0. */
2053 reseat_at_previous_visible_line_start (&it);
2054 it.current_x = it.hpos = 0;
2055 if (IT_CHARPOS (it) != PT)
2056 /* We used to temporarily disable selective display here; the
2057 comment said this is "so we don't move too far" (2005-01-19
2058 checkin by kfs). But this does nothing useful that I can
2059 tell, and it causes Bug#2694 . -- cyd */
2060 move_it_to (&it, PT, -1, -1, -1, MOVE_TO_POS);
2062 /* IT may move too far if truncate-lines is on and PT lies
2063 beyond the right margin. IT may also move too far if the
2064 starting point is on a Lisp string that has embedded
2065 newlines, or spans several screen lines. In these cases,
2066 backtrack. */
2067 if (IT_CHARPOS (it) > it_start)
2069 /* We need to backtrack also if the Lisp string contains no
2070 newlines, but there is a newline right after it. In this
2071 case, IT overshoots if there is an after-string just
2072 before the newline. */
2073 if (it_overshoot_count < 0
2074 && it.method == GET_FROM_BUFFER
2075 && it.c == '\n')
2076 it_overshoot_count = 1;
2077 else if (disp_string_at_start_p && it.vpos > 0)
2079 /* This is the case of a display string that spans
2080 several screen lines. In that case, we end up at the
2081 end of the string, and it.vpos tells us how many
2082 screen lines we need to backtrack. */
2083 it_overshoot_count = it.vpos;
2085 if (it_overshoot_count > 0)
2086 move_it_by_lines (&it, -it_overshoot_count);
2088 overshoot_handled = 1;
2090 if (XINT (lines) <= 0)
2092 it.vpos = 0;
2093 /* Do this even if LINES is 0, so that we move back to the
2094 beginning of the current line as we ought. */
2095 if (XINT (lines) == 0 || IT_CHARPOS (it) > 0)
2096 move_it_by_lines (&it, max (PTRDIFF_MIN, XINT (lines)));
2098 else if (overshoot_handled)
2100 it.vpos = 0;
2101 move_it_by_lines (&it, min (PTRDIFF_MAX, XINT (lines)));
2103 else
2105 /* Otherwise, we are at the first row occupied by PT, which
2106 might span multiple screen lines (e.g., if it's on a
2107 multi-line display string). We want to start from the
2108 last line that it occupies. */
2109 if (it_start < ZV)
2111 while (IT_CHARPOS (it) <= it_start)
2113 it.vpos = 0;
2114 move_it_by_lines (&it, 1);
2116 if (XINT (lines) > 1)
2117 move_it_by_lines (&it, min (PTRDIFF_MAX, XINT (lines) - 1));
2119 else
2121 it.vpos = 0;
2122 move_it_by_lines (&it, min (PTRDIFF_MAX, XINT (lines)));
2126 /* Move to the goal column, if one was specified. */
2127 if (!NILP (lcols))
2129 /* If the window was originally hscrolled, move forward by
2130 the hscrolled amount first. */
2131 if (first_x > 0)
2133 move_it_in_display_line (&it, ZV, first_x, MOVE_TO_X);
2134 it.current_x = 0;
2136 move_it_in_display_line
2137 (&it, ZV,
2138 (int)(cols * FRAME_COLUMN_WIDTH (XFRAME (w->frame)) + 0.5),
2139 MOVE_TO_X);
2142 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
2143 bidi_unshelve_cache (itdata, 0);
2146 if (BUFFERP (old_buffer))
2148 wset_buffer (w, old_buffer);
2149 set_marker_both (w->pointm, w->buffer,
2150 old_charpos, old_bytepos);
2153 RETURN_UNGCPRO (make_number (it.vpos));
2158 /* File's initialization. */
2160 void
2161 syms_of_indent (void)
2163 DEFVAR_BOOL ("indent-tabs-mode", indent_tabs_mode,
2164 doc: /* Indentation can insert tabs if this is non-nil. */);
2165 indent_tabs_mode = 1;
2167 defsubr (&Scurrent_indentation);
2168 defsubr (&Sindent_to);
2169 defsubr (&Scurrent_column);
2170 defsubr (&Smove_to_column);
2171 defsubr (&Svertical_motion);
2172 defsubr (&Scompute_motion);