Support resizing frames and windows pixelwise.
[emacs.git] / src / indent.c
blob502611b534a12366a701d456e5409e7648f50d01
1 /* Indentation functions.
2 Copyright (C) 1985-1988, 1993-1995, 1998, 2000-2013 Free Software
3 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 /* Get the display table to use for the current buffer. */
61 struct Lisp_Char_Table *
62 buffer_display_table (void)
64 Lisp_Object thisbuf;
66 thisbuf = BVAR (current_buffer, display_table);
67 if (DISP_TABLE_P (thisbuf))
68 return XCHAR_TABLE (thisbuf);
69 if (DISP_TABLE_P (Vstandard_display_table))
70 return XCHAR_TABLE (Vstandard_display_table);
71 return 0;
74 /* Width run cache considerations. */
76 /* Return the width of character C under display table DP. */
78 static int
79 character_width (int c, struct Lisp_Char_Table *dp)
81 Lisp_Object elt;
83 /* These width computations were determined by examining the cases
84 in display_text_line. */
86 /* Everything can be handled by the display table, if it's
87 present and the element is right. */
88 if (dp && (elt = DISP_CHAR_VECTOR (dp, c), VECTORP (elt)))
89 return ASIZE (elt);
91 /* Some characters are special. */
92 if (c == '\n' || c == '\t' || c == '\015')
93 return 0;
95 /* Printing characters have width 1. */
96 else if (c >= 040 && c < 0177)
97 return 1;
99 /* Everybody else (control characters, metacharacters) has other
100 widths. We could return their actual widths here, but they
101 depend on things like ctl_arrow and crud like that, and they're
102 not very common at all. So we'll just claim we don't know their
103 widths. */
104 else
105 return 0;
108 /* Return true if the display table DISPTAB specifies the same widths
109 for characters as WIDTHTAB. We use this to decide when to
110 invalidate the buffer's width_run_cache. */
112 bool
113 disptab_matches_widthtab (struct Lisp_Char_Table *disptab, struct Lisp_Vector *widthtab)
115 int i;
117 eassert (widthtab->header.size == 256);
119 for (i = 0; i < 256; i++)
120 if (character_width (i, disptab)
121 != XFASTINT (widthtab->contents[i]))
122 return 0;
124 return 1;
127 /* Recompute BUF's width table, using the display table DISPTAB. */
129 void
130 recompute_width_table (struct buffer *buf, struct Lisp_Char_Table *disptab)
132 int i;
133 struct Lisp_Vector *widthtab;
135 if (!VECTORP (BVAR (buf, width_table)))
136 bset_width_table (buf, make_uninit_vector (256));
137 widthtab = XVECTOR (BVAR (buf, width_table));
138 eassert (widthtab->header.size == 256);
140 for (i = 0; i < 256; i++)
141 XSETFASTINT (widthtab->contents[i], character_width (i, disptab));
144 /* Allocate or free the width run cache, as requested by the
145 current state of current_buffer's cache_long_scans variable. */
147 static void
148 width_run_cache_on_off (void)
150 if (NILP (BVAR (current_buffer, cache_long_scans))
151 /* And, for the moment, this feature doesn't work on multibyte
152 characters. */
153 || !NILP (BVAR (current_buffer, enable_multibyte_characters)))
155 /* It should be off. */
156 if (current_buffer->width_run_cache)
158 free_region_cache (current_buffer->width_run_cache);
159 current_buffer->width_run_cache = 0;
160 bset_width_table (current_buffer, Qnil);
163 else
165 /* It should be on. */
166 if (current_buffer->width_run_cache == 0)
168 current_buffer->width_run_cache = new_region_cache ();
169 recompute_width_table (current_buffer, buffer_display_table ());
175 /* Skip some invisible characters starting from POS.
176 This includes characters invisible because of text properties
177 and characters invisible because of overlays.
179 If position POS is followed by invisible characters,
180 skip some of them and return the position after them.
181 Otherwise return POS itself.
183 Set *NEXT_BOUNDARY_P to the next position at which
184 it will be necessary to call this function again.
186 Don't scan past TO, and don't set *NEXT_BOUNDARY_P
187 to a value greater than TO.
189 If WINDOW is non-nil, and this buffer is displayed in WINDOW,
190 take account of overlays that apply only in WINDOW.
192 We don't necessarily skip all the invisible characters after POS
193 because that could take a long time. We skip a reasonable number
194 which can be skipped quickly. If there might be more invisible
195 characters immediately following, then *NEXT_BOUNDARY_P
196 will equal the return value. */
198 ptrdiff_t
199 skip_invisible (ptrdiff_t pos, ptrdiff_t *next_boundary_p, ptrdiff_t to, Lisp_Object window)
201 Lisp_Object prop, position, overlay_limit, proplimit;
202 Lisp_Object buffer, tmp;
203 ptrdiff_t end;
204 int inv_p;
206 XSETFASTINT (position, pos);
207 XSETBUFFER (buffer, current_buffer);
209 /* Give faster response for overlay lookup near POS. */
210 recenter_overlay_lists (current_buffer, pos);
212 /* We must not advance farther than the next overlay change.
213 The overlay change might change the invisible property;
214 or there might be overlay strings to be displayed there. */
215 overlay_limit = Fnext_overlay_change (position);
216 /* As for text properties, this gives a lower bound
217 for where the invisible text property could change. */
218 proplimit = Fnext_property_change (position, buffer, Qt);
219 if (XFASTINT (overlay_limit) < XFASTINT (proplimit))
220 proplimit = overlay_limit;
221 /* PROPLIMIT is now a lower bound for the next change
222 in invisible status. If that is plenty far away,
223 use that lower bound. */
224 if (XFASTINT (proplimit) > pos + 100 || XFASTINT (proplimit) >= to)
225 *next_boundary_p = XFASTINT (proplimit);
226 /* Otherwise, scan for the next `invisible' property change. */
227 else
229 /* Don't scan terribly far. */
230 XSETFASTINT (proplimit, min (pos + 100, to));
231 /* No matter what, don't go past next overlay change. */
232 if (XFASTINT (overlay_limit) < XFASTINT (proplimit))
233 proplimit = overlay_limit;
234 tmp = Fnext_single_property_change (position, Qinvisible,
235 buffer, proplimit);
236 end = XFASTINT (tmp);
237 #if 0
238 /* Don't put the boundary in the middle of multibyte form if
239 there is no actual property change. */
240 if (end == pos + 100
241 && !NILP (current_buffer->enable_multibyte_characters)
242 && end < ZV)
243 while (pos < end && !CHAR_HEAD_P (POS_ADDR (end)))
244 end--;
245 #endif
246 *next_boundary_p = end;
248 /* if the `invisible' property is set, we can skip to
249 the next property change */
250 prop = Fget_char_property (position, Qinvisible,
251 (!NILP (window)
252 && EQ (XWINDOW (window)->contents, buffer))
253 ? window : buffer);
254 inv_p = TEXT_PROP_MEANS_INVISIBLE (prop);
255 /* When counting columns (window == nil), don't skip over ellipsis text. */
256 if (NILP (window) ? inv_p == 1 : inv_p)
257 return *next_boundary_p;
258 return pos;
261 /* Set variables WIDTH and BYTES for a multibyte sequence starting at P.
263 DP is a display table or NULL.
265 This macro is used in scan_for_column and in
266 compute_motion. */
268 #define MULTIBYTE_BYTES_WIDTH(p, dp, bytes, width) \
269 do { \
270 int ch; \
272 ch = STRING_CHAR_AND_LENGTH (p, bytes); \
273 if (BYTES_BY_CHAR_HEAD (*p) != bytes) \
274 width = bytes * 4; \
275 else \
277 if (dp != 0 && VECTORP (DISP_CHAR_VECTOR (dp, ch))) \
278 width = sanitize_char_width (ASIZE (DISP_CHAR_VECTOR (dp, ch))); \
279 else \
280 width = CHAR_WIDTH (ch); \
282 } while (0)
285 DEFUN ("current-column", Fcurrent_column, Scurrent_column, 0, 0, 0,
286 doc: /* Return the horizontal position of point. Beginning of line is column 0.
287 This is calculated by adding together the widths of all the displayed
288 representations of the character between the start of the previous line
289 and point (e.g., control characters will have a width of 2 or 4, tabs
290 will have a variable width).
291 Ignores finite width of frame, which means that this function may return
292 values greater than (frame-width).
293 Whether the line is visible (if `selective-display' is t) has no effect;
294 however, ^M is treated as end of line when `selective-display' is t.
295 Text that has an invisible property is considered as having width 0, unless
296 `buffer-invisibility-spec' specifies that it is replaced by an ellipsis. */)
297 (void)
299 Lisp_Object temp;
300 XSETFASTINT (temp, current_column ());
301 return temp;
304 /* Cancel any recorded value of the horizontal position. */
306 void
307 invalidate_current_column (void)
309 last_known_column_point = 0;
312 ptrdiff_t
313 current_column (void)
315 ptrdiff_t col;
316 unsigned char *ptr, *stop;
317 bool tab_seen;
318 ptrdiff_t post_tab;
319 int c;
320 int tab_width = SANE_TAB_WIDTH (current_buffer);
321 bool ctl_arrow = !NILP (BVAR (current_buffer, ctl_arrow));
322 struct Lisp_Char_Table *dp = buffer_display_table ();
324 if (PT == last_known_column_point
325 && MODIFF == last_known_column_modified)
326 return last_known_column;
328 /* If the buffer has overlays, text properties,
329 or multibyte characters, use a more general algorithm. */
330 if (buffer_intervals (current_buffer)
331 || buffer_has_overlays ()
332 || Z != Z_BYTE)
333 return current_column_1 ();
335 /* Scan backwards from point to the previous newline,
336 counting width. Tab characters are the only complicated case. */
338 /* Make a pointer for decrementing through the chars before point. */
339 ptr = BYTE_POS_ADDR (PT_BYTE - 1) + 1;
340 /* Make a pointer to where consecutive chars leave off,
341 going backwards from point. */
342 if (PT == BEGV)
343 stop = ptr;
344 else if (PT <= GPT || BEGV > GPT)
345 stop = BEGV_ADDR;
346 else
347 stop = GAP_END_ADDR;
349 col = 0, tab_seen = 0, post_tab = 0;
351 while (1)
353 ptrdiff_t i, n;
354 Lisp_Object charvec;
356 if (ptr == stop)
358 /* We stopped either for the beginning of the buffer
359 or for the gap. */
360 if (ptr == BEGV_ADDR)
361 break;
363 /* It was the gap. Jump back over it. */
364 stop = BEGV_ADDR;
365 ptr = GPT_ADDR;
367 /* Check whether that brings us to beginning of buffer. */
368 if (BEGV >= GPT)
369 break;
372 c = *--ptr;
374 if (dp && VECTORP (DISP_CHAR_VECTOR (dp, c)))
376 charvec = DISP_CHAR_VECTOR (dp, c);
377 n = ASIZE (charvec);
379 else
381 charvec = Qnil;
382 n = 1;
385 for (i = n - 1; i >= 0; --i)
387 if (VECTORP (charvec))
389 /* This should be handled the same as
390 next_element_from_display_vector does it. */
391 Lisp_Object entry = AREF (charvec, i);
393 if (GLYPH_CODE_P (entry))
394 c = GLYPH_CODE_CHAR (entry);
395 else
396 c = ' ';
399 if (c >= 040 && c < 0177)
400 col++;
401 else if (c == '\n'
402 || (c == '\r'
403 && EQ (BVAR (current_buffer, selective_display), Qt)))
405 ptr++;
406 goto start_of_line_found;
408 else if (c == '\t')
410 if (tab_seen)
411 col = ((col + tab_width) / tab_width) * tab_width;
413 post_tab += col;
414 col = 0;
415 tab_seen = 1;
417 else if (VECTORP (charvec))
418 /* With a display table entry, C is displayed as is, and
419 not displayed as \NNN or as ^N. If C is a single-byte
420 character, it takes one column. If C is multi-byte in
421 an unibyte buffer, it's translated to unibyte, so it
422 also takes one column. */
423 ++col;
424 else
425 col += (ctl_arrow && c < 0200) ? 2 : 4;
429 start_of_line_found:
431 if (tab_seen)
433 col = ((col + tab_width) / tab_width) * tab_width;
434 col += post_tab;
437 last_known_column = col;
438 last_known_column_point = PT;
439 last_known_column_modified = MODIFF;
441 return col;
445 /* Check the presence of a display property and compute its width.
446 If a property was found and its width was found as well, return
447 its width (>= 0) and set the position of the end of the property
448 in ENDPOS.
449 Otherwise just return -1. */
450 static int
451 check_display_width (ptrdiff_t pos, ptrdiff_t col, ptrdiff_t *endpos)
453 Lisp_Object val, overlay;
455 if (CONSP (val = get_char_property_and_overlay
456 (make_number (pos), Qdisplay, Qnil, &overlay))
457 && EQ (Qspace, XCAR (val)))
458 { /* FIXME: Use calc_pixel_width_or_height. */
459 Lisp_Object plist = XCDR (val), prop;
460 int width = -1;
461 EMACS_INT align_to_max =
462 (col < MOST_POSITIVE_FIXNUM - INT_MAX
463 ? (EMACS_INT) INT_MAX + col
464 : MOST_POSITIVE_FIXNUM);
466 if ((prop = Fplist_get (plist, QCwidth),
467 RANGED_INTEGERP (0, prop, INT_MAX)))
468 width = XINT (prop);
469 else if (FLOATP (prop) && 0 <= XFLOAT_DATA (prop)
470 && XFLOAT_DATA (prop) <= INT_MAX)
471 width = (int)(XFLOAT_DATA (prop) + 0.5);
472 else if ((prop = Fplist_get (plist, QCalign_to),
473 RANGED_INTEGERP (col, prop, align_to_max)))
474 width = XINT (prop) - col;
475 else if (FLOATP (prop) && col <= XFLOAT_DATA (prop)
476 && (XFLOAT_DATA (prop) <= align_to_max))
477 width = (int)(XFLOAT_DATA (prop) + 0.5) - col;
479 if (width >= 0)
481 ptrdiff_t start;
482 if (OVERLAYP (overlay))
483 *endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
484 else
485 get_property_and_range (pos, Qdisplay, &val, &start, endpos, Qnil);
486 return width;
489 return -1;
492 /* Scanning from the beginning of the current line, stop at the buffer
493 position ENDPOS or at the column GOALCOL or at the end of line, whichever
494 comes first.
495 Return the resulting buffer position and column in ENDPOS and GOALCOL.
496 PREVCOL gets set to the column of the previous position (it's always
497 strictly smaller than the goal column). */
498 static void
499 scan_for_column (ptrdiff_t *endpos, EMACS_INT *goalcol, ptrdiff_t *prevcol)
501 int tab_width = SANE_TAB_WIDTH (current_buffer);
502 bool ctl_arrow = !NILP (BVAR (current_buffer, ctl_arrow));
503 struct Lisp_Char_Table *dp = buffer_display_table ();
504 bool multibyte = !NILP (BVAR (current_buffer, enable_multibyte_characters));
505 struct composition_it cmp_it;
506 Lisp_Object window;
507 struct window *w;
509 /* Start the scan at the beginning of this line with column number 0. */
510 register ptrdiff_t col = 0, prev_col = 0;
511 EMACS_INT goal = goalcol ? *goalcol : MOST_POSITIVE_FIXNUM;
512 ptrdiff_t end = endpos ? *endpos : PT;
513 ptrdiff_t scan, scan_byte, next_boundary;
515 scan = find_newline (PT, PT_BYTE, BEGV, BEGV_BYTE, -1, NULL, &scan_byte, 1);
516 next_boundary = scan;
518 window = Fget_buffer_window (Fcurrent_buffer (), Qnil);
519 w = ! NILP (window) ? XWINDOW (window) : NULL;
521 memset (&cmp_it, 0, sizeof cmp_it);
522 cmp_it.id = -1;
523 composition_compute_stop_pos (&cmp_it, scan, scan_byte, end, Qnil);
525 /* Scan forward to the target position. */
526 while (scan < end)
528 int c;
530 /* Occasionally we may need to skip invisible text. */
531 while (scan == next_boundary)
533 ptrdiff_t old_scan = scan;
534 /* This updates NEXT_BOUNDARY to the next place
535 where we might need to skip more invisible text. */
536 scan = skip_invisible (scan, &next_boundary, end, Qnil);
537 if (scan != old_scan)
538 scan_byte = CHAR_TO_BYTE (scan);
539 if (scan >= end)
540 goto endloop;
543 /* Test reaching the goal column. We do this after skipping
544 invisible characters, so that we put point before the
545 character on which the cursor will appear. */
546 if (col >= goal)
547 break;
548 prev_col = col;
550 { /* Check display property. */
551 ptrdiff_t endp;
552 int width = check_display_width (scan, col, &endp);
553 if (width >= 0)
555 col += width;
556 if (endp > scan) /* Avoid infinite loops with 0-width overlays. */
558 scan = endp;
559 scan_byte = CHAR_TO_BYTE (scan);
560 continue;
565 /* Check composition sequence. */
566 if (cmp_it.id >= 0
567 || (scan == cmp_it.stop_pos
568 && composition_reseat_it (&cmp_it, scan, scan_byte, end,
569 w, NULL, Qnil)))
570 composition_update_it (&cmp_it, scan, scan_byte, Qnil);
571 if (cmp_it.id >= 0)
573 scan += cmp_it.nchars;
574 scan_byte += cmp_it.nbytes;
575 if (scan <= end)
576 col += cmp_it.width;
577 if (cmp_it.to == cmp_it.nglyphs)
579 cmp_it.id = -1;
580 composition_compute_stop_pos (&cmp_it, scan, scan_byte, end,
581 Qnil);
583 else
584 cmp_it.from = cmp_it.to;
585 continue;
588 c = FETCH_BYTE (scan_byte);
590 /* See if there is a display table and it relates
591 to this character. */
593 if (dp != 0
594 && ! (multibyte && LEADING_CODE_P (c))
595 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
597 Lisp_Object charvec;
598 ptrdiff_t i, n;
600 /* This character is displayed using a vector of glyphs.
601 Update the column/position based on those glyphs. */
603 charvec = DISP_CHAR_VECTOR (dp, c);
604 n = ASIZE (charvec);
606 for (i = 0; i < n; i++)
608 /* This should be handled the same as
609 next_element_from_display_vector does it. */
610 Lisp_Object entry = AREF (charvec, i);
612 if (GLYPH_CODE_P (entry))
613 c = GLYPH_CODE_CHAR (entry);
614 else
615 c = ' ';
617 if (c == '\n')
618 goto endloop;
619 if (c == '\r' && EQ (BVAR (current_buffer, selective_display), Qt))
620 goto endloop;
621 if (c == '\t')
623 col += tab_width;
624 col = col / tab_width * tab_width;
626 else
627 ++col;
630 else
632 /* The display table doesn't affect this character;
633 it displays as itself. */
635 if (c == '\n')
636 goto endloop;
637 if (c == '\r' && EQ (BVAR (current_buffer, selective_display), Qt))
638 goto endloop;
639 if (c == '\t')
641 col += tab_width;
642 col = col / tab_width * tab_width;
644 else if (multibyte && LEADING_CODE_P (c))
646 /* Start of multi-byte form. */
647 unsigned char *ptr;
648 int bytes, width;
650 ptr = BYTE_POS_ADDR (scan_byte);
651 MULTIBYTE_BYTES_WIDTH (ptr, dp, bytes, width);
652 /* Subtract one to compensate for the increment
653 that is going to happen below. */
654 scan_byte += bytes - 1;
655 col += width;
657 else if (ctl_arrow && (c < 040 || c == 0177))
658 col += 2;
659 else if (c < 040 || c >= 0177)
660 col += 4;
661 else
662 col++;
664 scan++;
665 scan_byte++;
668 endloop:
670 last_known_column = col;
671 last_known_column_point = PT;
672 last_known_column_modified = MODIFF;
674 if (goalcol)
675 *goalcol = col;
676 if (endpos)
677 *endpos = scan;
678 if (prevcol)
679 *prevcol = prev_col;
682 /* Return the column number of position POS
683 by scanning forward from the beginning of the line.
684 This function handles characters that are invisible
685 due to text properties or overlays. */
687 static ptrdiff_t
688 current_column_1 (void)
690 EMACS_INT col = MOST_POSITIVE_FIXNUM;
691 ptrdiff_t opoint = PT;
693 scan_for_column (&opoint, &col, NULL);
694 return col;
698 #if 0 /* Not used. */
700 /* Return the width in columns of the part of STRING from BEG to END.
701 If BEG is nil, that stands for the beginning of STRING.
702 If END is nil, that stands for the end of STRING. */
704 static double
705 string_display_width (Lisp_Object string, Lisp_Object beg, Lisp_Object end)
707 int col;
708 unsigned char *ptr, *stop;
709 bool tab_seen;
710 int post_tab;
711 int c;
712 int tab_width = SANE_TAB_WIDTH (current_buffer);
713 bool ctl_arrow = !NILP (current_buffer->ctl_arrow);
714 struct Lisp_Char_Table *dp = buffer_display_table ();
715 int b, e;
717 if (NILP (end))
718 e = SCHARS (string);
719 else
721 CHECK_NUMBER (end);
722 e = XINT (end);
725 if (NILP (beg))
726 b = 0;
727 else
729 CHECK_NUMBER (beg);
730 b = XINT (beg);
733 /* Make a pointer for decrementing through the chars before point. */
734 ptr = SDATA (string) + e;
735 /* Make a pointer to where consecutive chars leave off,
736 going backwards from point. */
737 stop = SDATA (string) + b;
739 col = 0, tab_seen = 0, post_tab = 0;
741 while (1)
743 if (ptr == stop)
744 break;
746 c = *--ptr;
747 if (dp != 0 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
748 col += ASIZE (DISP_CHAR_VECTOR (dp, c));
749 else if (c >= 040 && c < 0177)
750 col++;
751 else if (c == '\n')
752 break;
753 else if (c == '\t')
755 if (tab_seen)
756 col = ((col + tab_width) / tab_width) * tab_width;
758 post_tab += col;
759 col = 0;
760 tab_seen = 1;
762 else
763 col += (ctl_arrow && c < 0200) ? 2 : 4;
766 if (tab_seen)
768 col = ((col + tab_width) / tab_width) * tab_width;
769 col += post_tab;
772 return col;
775 #endif /* 0 */
778 DEFUN ("indent-to", Findent_to, Sindent_to, 1, 2, "NIndent to column: ",
779 doc: /* Indent from point with tabs and spaces until COLUMN is reached.
780 Optional second argument MINIMUM says always do at least MINIMUM spaces
781 even if that goes past COLUMN; by default, MINIMUM is zero.
783 The return value is COLUMN. */)
784 (Lisp_Object column, Lisp_Object minimum)
786 EMACS_INT mincol;
787 register ptrdiff_t fromcol;
788 int tab_width = SANE_TAB_WIDTH (current_buffer);
790 CHECK_NUMBER (column);
791 if (NILP (minimum))
792 XSETFASTINT (minimum, 0);
793 CHECK_NUMBER (minimum);
795 fromcol = current_column ();
796 mincol = fromcol + XINT (minimum);
797 if (mincol < XINT (column)) mincol = XINT (column);
799 if (fromcol == mincol)
800 return make_number (mincol);
802 if (indent_tabs_mode)
804 Lisp_Object n;
805 XSETFASTINT (n, mincol / tab_width - fromcol / tab_width);
806 if (XFASTINT (n) != 0)
808 Finsert_char (make_number ('\t'), n, Qt);
810 fromcol = (mincol / tab_width) * tab_width;
814 XSETFASTINT (column, mincol - fromcol);
815 Finsert_char (make_number (' '), column, Qt);
817 last_known_column = mincol;
818 last_known_column_point = PT;
819 last_known_column_modified = MODIFF;
821 XSETINT (column, mincol);
822 return column;
826 DEFUN ("current-indentation", Fcurrent_indentation, Scurrent_indentation,
827 0, 0, 0,
828 doc: /* Return the indentation of the current line.
829 This is the horizontal position of the character
830 following any initial whitespace. */)
831 (void)
833 ptrdiff_t posbyte;
835 find_newline (PT, PT_BYTE, BEGV, BEGV_BYTE, -1, NULL, &posbyte, 1);
836 return make_number (position_indentation (posbyte));
839 static ptrdiff_t
840 position_indentation (ptrdiff_t pos_byte)
842 register ptrdiff_t column = 0;
843 int tab_width = SANE_TAB_WIDTH (current_buffer);
844 register unsigned char *p;
845 register unsigned char *stop;
846 unsigned char *start;
847 ptrdiff_t next_boundary_byte = pos_byte;
848 ptrdiff_t ceiling = next_boundary_byte;
850 p = BYTE_POS_ADDR (pos_byte);
851 /* STOP records the value of P at which we will need
852 to think about the gap, or about invisible text,
853 or about the end of the buffer. */
854 stop = p;
855 /* START records the starting value of P. */
856 start = p;
857 while (1)
859 while (p == stop)
861 ptrdiff_t stop_pos_byte;
863 /* If we have updated P, set POS_BYTE to match.
864 The first time we enter the loop, POS_BYTE is already right. */
865 if (p != start)
866 pos_byte = PTR_BYTE_POS (p);
867 /* Consider the various reasons STOP might have been set here. */
868 if (pos_byte == ZV_BYTE)
869 return column;
870 if (pos_byte == next_boundary_byte)
872 ptrdiff_t next_boundary;
873 ptrdiff_t pos = BYTE_TO_CHAR (pos_byte);
874 pos = skip_invisible (pos, &next_boundary, ZV, Qnil);
875 pos_byte = CHAR_TO_BYTE (pos);
876 next_boundary_byte = CHAR_TO_BYTE (next_boundary);
878 if (pos_byte >= ceiling)
879 ceiling = BUFFER_CEILING_OF (pos_byte) + 1;
880 /* Compute the next place we need to stop and think,
881 and set STOP accordingly. */
882 stop_pos_byte = min (ceiling, next_boundary_byte);
883 /* The -1 and +1 arrange to point at the first byte of gap
884 (if STOP_POS_BYTE is the position of the gap)
885 rather than at the data after the gap. */
887 stop = BYTE_POS_ADDR (stop_pos_byte - 1) + 1;
888 p = BYTE_POS_ADDR (pos_byte);
890 switch (*p++)
892 case 0240:
893 if (! NILP (BVAR (current_buffer, enable_multibyte_characters)))
894 return column;
895 case ' ':
896 column++;
897 break;
898 case '\t':
899 column += tab_width - column % tab_width;
900 break;
901 default:
902 if (ASCII_BYTE_P (p[-1])
903 || NILP (BVAR (current_buffer, enable_multibyte_characters)))
904 return column;
906 int c;
907 pos_byte = PTR_BYTE_POS (p - 1);
908 c = FETCH_MULTIBYTE_CHAR (pos_byte);
909 if (CHAR_HAS_CATEGORY (c, ' '))
911 column++;
912 INC_POS (pos_byte);
913 p = BYTE_POS_ADDR (pos_byte);
915 else
916 return column;
922 /* Test whether the line beginning at POS is indented beyond COLUMN.
923 Blank lines are treated as if they had the same indentation as the
924 preceding line. */
926 bool
927 indented_beyond_p (ptrdiff_t pos, ptrdiff_t pos_byte, EMACS_INT column)
929 while (pos > BEGV && FETCH_BYTE (pos_byte) == '\n')
931 DEC_BOTH (pos, pos_byte);
932 pos = find_newline (pos, pos_byte, BEGV, BEGV_BYTE,
933 -1, NULL, &pos_byte, 0);
935 return position_indentation (pos_byte) >= column;
938 DEFUN ("move-to-column", Fmove_to_column, Smove_to_column, 1, 2,
939 "NMove to column: ",
940 doc: /* Move point to column COLUMN in the current line.
941 Interactively, COLUMN is the value of prefix numeric argument.
942 The column of a character is calculated by adding together the widths
943 as displayed of the previous characters in the line.
944 This function ignores line-continuation;
945 there is no upper limit on the column number a character can have
946 and horizontal scrolling has no effect.
948 If specified column is within a character, point goes after that character.
949 If it's past end of line, point goes to end of line.
951 Optional second argument FORCE non-nil means if COLUMN is in the
952 middle of a tab character, change it to spaces.
953 In addition, if FORCE is t, and the line is too short to reach
954 COLUMN, add spaces/tabs to get there.
956 The return value is the current column. */)
957 (Lisp_Object column, Lisp_Object force)
959 ptrdiff_t pos, prev_col;
960 EMACS_INT col;
961 EMACS_INT goal;
963 CHECK_NATNUM (column);
964 goal = XINT (column);
966 col = goal;
967 pos = ZV;
968 scan_for_column (&pos, &col, &prev_col);
970 SET_PT (pos);
972 /* If a tab char made us overshoot, change it to spaces
973 and scan through it again. */
974 if (!NILP (force) && col > goal)
976 int c;
977 ptrdiff_t pos_byte = PT_BYTE;
979 DEC_POS (pos_byte);
980 c = FETCH_CHAR (pos_byte);
981 if (c == '\t' && prev_col < goal)
983 ptrdiff_t goal_pt, goal_pt_byte;
985 /* Insert spaces in front of the tab to reach GOAL. Do this
986 first so that a marker at the end of the tab gets
987 adjusted. */
988 SET_PT_BOTH (PT - 1, PT_BYTE - 1);
989 Finsert_char (make_number (' '), make_number (goal - prev_col), Qt);
991 /* Now delete the tab, and indent to COL. */
992 del_range (PT, PT + 1);
993 goal_pt = PT;
994 goal_pt_byte = PT_BYTE;
995 Findent_to (make_number (col), Qnil);
996 SET_PT_BOTH (goal_pt, goal_pt_byte);
998 /* Set the last_known... vars consistently. */
999 col = goal;
1003 /* If line ends prematurely, add space to the end. */
1004 if (col < goal && EQ (force, Qt))
1005 Findent_to (make_number (col = goal), Qnil);
1007 last_known_column = col;
1008 last_known_column_point = PT;
1009 last_known_column_modified = MODIFF;
1011 return make_number (col);
1014 /* compute_motion: compute buffer posn given screen posn and vice versa */
1016 static struct position val_compute_motion;
1018 /* Scan the current buffer forward from offset FROM, pretending that
1019 this is at line FROMVPOS, column FROMHPOS, until reaching buffer
1020 offset TO or line TOVPOS, column TOHPOS (whichever comes first),
1021 and return the ending buffer position and screen location. If we
1022 can't hit the requested column exactly (because of a tab or other
1023 multi-column character), overshoot.
1025 DID_MOTION is true if FROMHPOS has already accounted for overlay strings
1026 at FROM. This is the case if FROMVPOS and FROMVPOS came from an
1027 earlier call to compute_motion. The other common case is that FROMHPOS
1028 is zero and FROM is a position that "belongs" at column zero, but might
1029 be shifted by overlay strings; in this case DID_MOTION should be false.
1031 WIDTH is the number of columns available to display text;
1032 compute_motion uses this to handle continuation lines and such.
1033 If WIDTH is -1, use width of window's text area adjusted for
1034 continuation glyph when needed.
1036 HSCROLL is the number of columns not being displayed at the left
1037 margin; this is usually taken from a window's hscroll member.
1038 TAB_OFFSET is the number of columns of the first tab that aren't
1039 being displayed, perhaps because of a continuation line or
1040 something.
1042 compute_motion returns a pointer to a struct position. The bufpos
1043 member gives the buffer position at the end of the scan, and hpos
1044 and vpos give its cartesian location. prevhpos is the column at
1045 which the character before bufpos started, and contin is non-zero
1046 if we reached the current line by continuing the previous.
1048 Note that FROMHPOS and TOHPOS should be expressed in real screen
1049 columns, taking HSCROLL and the truncation glyph at the left margin
1050 into account. That is, beginning-of-line moves you to the hpos
1051 -HSCROLL + (HSCROLL > 0).
1053 For example, to find the buffer position of column COL of line LINE
1054 of a certain window, pass the window's starting location as FROM
1055 and the window's upper-left coordinates as FROMVPOS and FROMHPOS.
1056 Pass the buffer's ZV as TO, to limit the scan to the end of the
1057 visible section of the buffer, and pass LINE and COL as TOVPOS and
1058 TOHPOS.
1060 When displaying in window w, a typical formula for WIDTH is:
1062 window_width - 1
1063 - (has_vertical_scroll_bars
1064 ? WINDOW_CONFIG_SCROLL_BAR_COLS (window)
1065 : (window_width + window_left != frame_cols))
1067 where
1068 window_width is w->total_cols,
1069 window_left is w->left_col,
1070 has_vertical_scroll_bars is
1071 WINDOW_HAS_VERTICAL_SCROLL_BAR (window)
1072 and frame_cols = FRAME_COLS (XFRAME (window->frame))
1074 Or you can let window_body_cols do this all for you, and write:
1075 window_body_cols (w) - 1
1077 The `-1' accounts for the continuation-line backslashes; the rest
1078 accounts for window borders if the window is split horizontally, and
1079 the scroll bars if they are turned on. */
1081 struct position *
1082 compute_motion (ptrdiff_t from, ptrdiff_t frombyte, EMACS_INT fromvpos,
1083 EMACS_INT fromhpos, bool did_motion, ptrdiff_t to,
1084 EMACS_INT tovpos, EMACS_INT tohpos, EMACS_INT width,
1085 ptrdiff_t hscroll, int tab_offset, struct window *win)
1087 EMACS_INT hpos = fromhpos;
1088 EMACS_INT vpos = fromvpos;
1090 ptrdiff_t pos;
1091 ptrdiff_t pos_byte;
1092 int c = 0;
1093 int tab_width = SANE_TAB_WIDTH (current_buffer);
1094 bool ctl_arrow = !NILP (BVAR (current_buffer, ctl_arrow));
1095 struct Lisp_Char_Table *dp = window_display_table (win);
1096 EMACS_INT selective
1097 = (INTEGERP (BVAR (current_buffer, selective_display))
1098 ? XINT (BVAR (current_buffer, selective_display))
1099 : !NILP (BVAR (current_buffer, selective_display)) ? -1 : 0);
1100 ptrdiff_t selective_rlen
1101 = (selective && dp && VECTORP (DISP_INVIS_VECTOR (dp))
1102 ? ASIZE (DISP_INVIS_VECTOR (dp)) : 0);
1103 /* The next location where the `invisible' property changes, or an
1104 overlay starts or ends. */
1105 ptrdiff_t next_boundary = from;
1107 /* For computing runs of characters with similar widths.
1108 Invariant: width_run_width is zero, or all the characters
1109 from width_run_start to width_run_end have a fixed width of
1110 width_run_width. */
1111 ptrdiff_t width_run_start = from;
1112 ptrdiff_t width_run_end = from;
1113 ptrdiff_t width_run_width = 0;
1114 Lisp_Object *width_table;
1116 /* The next buffer pos where we should consult the width run cache. */
1117 ptrdiff_t next_width_run = from;
1118 Lisp_Object window;
1120 bool multibyte = !NILP (BVAR (current_buffer, enable_multibyte_characters));
1121 /* If previous char scanned was a wide character,
1122 this is the column where it ended. Otherwise, this is 0. */
1123 EMACS_INT wide_column_end_hpos = 0;
1124 ptrdiff_t prev_pos; /* Previous buffer position. */
1125 ptrdiff_t prev_pos_byte; /* Previous buffer position. */
1126 EMACS_INT prev_hpos = 0;
1127 EMACS_INT prev_vpos = 0;
1128 EMACS_INT contin_hpos; /* HPOS of last column of continued line. */
1129 int prev_tab_offset; /* Previous tab offset. */
1130 int continuation_glyph_width;
1132 struct composition_it cmp_it;
1134 XSETWINDOW (window, win);
1136 width_run_cache_on_off ();
1137 if (dp == buffer_display_table ())
1138 width_table = (VECTORP (BVAR (current_buffer, width_table))
1139 ? XVECTOR (BVAR (current_buffer, width_table))->contents
1140 : 0);
1141 else
1142 /* If the window has its own display table, we can't use the width
1143 run cache, because that's based on the buffer's display table. */
1144 width_table = 0;
1146 /* Negative width means use all available text columns. */
1147 if (width < 0)
1149 width = window_body_width (win, 0);
1150 /* We must make room for continuation marks if we don't have fringes. */
1151 #ifdef HAVE_WINDOW_SYSTEM
1152 if (!FRAME_WINDOW_P (XFRAME (win->frame)))
1153 #endif
1154 width -= 1;
1157 continuation_glyph_width = 1;
1158 #ifdef HAVE_WINDOW_SYSTEM
1159 if (FRAME_WINDOW_P (XFRAME (win->frame)))
1160 continuation_glyph_width = 0; /* In the fringe. */
1161 #endif
1163 immediate_quit = 1;
1164 QUIT;
1166 /* It's just impossible to be too paranoid here. */
1167 eassert (from == BYTE_TO_CHAR (frombyte) && frombyte == CHAR_TO_BYTE (from));
1169 pos = prev_pos = from;
1170 pos_byte = prev_pos_byte = frombyte;
1171 contin_hpos = 0;
1172 prev_tab_offset = tab_offset;
1173 memset (&cmp_it, 0, sizeof cmp_it);
1174 cmp_it.id = -1;
1175 composition_compute_stop_pos (&cmp_it, pos, pos_byte, to, Qnil);
1177 while (1)
1179 while (pos == next_boundary)
1181 ptrdiff_t pos_here = pos;
1182 ptrdiff_t newpos;
1184 /* Don't skip invisible if we are already at the margin. */
1185 if (vpos > tovpos || (vpos == tovpos && hpos >= tohpos))
1187 if (contin_hpos && prev_hpos == 0
1188 && hpos > tohpos
1189 && (contin_hpos == width || wide_column_end_hpos > width))
1190 { /* Line breaks because we can't put the character at the
1191 previous line any more. It is not the multi-column
1192 character continued in middle. Go back to previous
1193 buffer position, screen position, and set tab offset
1194 to previous value. It's the beginning of the
1195 line. */
1196 pos = prev_pos;
1197 pos_byte = prev_pos_byte;
1198 hpos = prev_hpos;
1199 vpos = prev_vpos;
1200 tab_offset = prev_tab_offset;
1202 break;
1205 /* If the caller says that the screen position came from an earlier
1206 call to compute_motion, then we've already accounted for the
1207 overlay strings at point. This is only true the first time
1208 through, so clear the flag after testing it. */
1209 if (!did_motion)
1210 /* We need to skip past the overlay strings. Currently those
1211 strings must not contain TAB;
1212 if we want to relax that restriction, something will have
1213 to be changed here. */
1215 unsigned char *ovstr;
1216 ptrdiff_t ovlen = overlay_strings (pos, win, &ovstr);
1217 hpos += ((multibyte && ovlen > 0)
1218 ? strwidth ((char *) ovstr, ovlen) : ovlen);
1220 did_motion = 0;
1222 if (pos >= to)
1223 break;
1225 /* Advance POS past invisible characters
1226 (but not necessarily all that there are here),
1227 and store in next_boundary the next position where
1228 we need to call skip_invisible. */
1229 newpos = skip_invisible (pos, &next_boundary, to, window);
1231 if (newpos >= to)
1233 pos = min (to, newpos);
1234 pos_byte = CHAR_TO_BYTE (pos);
1235 goto after_loop;
1238 if (newpos != pos_here)
1240 pos = newpos;
1241 pos_byte = CHAR_TO_BYTE (pos);
1245 /* Handle right margin. */
1246 /* Note on a wide-column character.
1248 Characters are classified into the following three categories
1249 according to the width (columns occupied on screen).
1251 (1) single-column character: ex. `a'
1252 (2) multi-column character: ex. `^A', TAB, `\033'
1253 (3) wide-column character: ex. Japanese character, Chinese character
1254 (In the following example, `W_' stands for them.)
1256 Multi-column characters can be divided around the right margin,
1257 but wide-column characters cannot.
1259 NOTE:
1261 (*) The cursor is placed on the next character after the point.
1263 ----------
1264 abcdefghi\
1265 j ^---- next after the point
1266 ^--- next char. after the point.
1267 ----------
1268 In case of sigle-column character
1270 ----------
1271 abcdefgh\\
1272 033 ^---- next after the point, next char. after the point.
1273 ----------
1274 In case of multi-column character
1276 ----------
1277 abcdefgh\\
1278 W_ ^---- next after the point
1279 ^---- next char. after the point.
1280 ----------
1281 In case of wide-column character
1283 The problem here is continuation at a wide-column character.
1284 In this case, the line may shorter less than WIDTH.
1285 And we find the continuation AFTER it occurs.
1289 if (hpos > width)
1291 EMACS_INT total_width = width + continuation_glyph_width;
1292 bool truncate = 0;
1294 if (!NILP (Vtruncate_partial_width_windows)
1295 && (total_width < FRAME_COLS (XFRAME (WINDOW_FRAME (win)))))
1297 if (INTEGERP (Vtruncate_partial_width_windows))
1298 truncate
1299 = total_width < XFASTINT (Vtruncate_partial_width_windows);
1300 else
1301 truncate = 1;
1304 if (hscroll || truncate
1305 || !NILP (BVAR (current_buffer, truncate_lines)))
1307 /* Truncating: skip to newline, unless we are already past
1308 TO (we need to go back below). */
1309 if (pos <= to)
1311 pos = find_before_next_newline (pos, to, 1, &pos_byte);
1312 hpos = width;
1313 /* If we just skipped next_boundary,
1314 loop around in the main while
1315 and handle it. */
1316 if (pos >= next_boundary)
1317 next_boundary = pos + 1;
1318 prev_hpos = width;
1319 prev_vpos = vpos;
1320 prev_tab_offset = tab_offset;
1323 else
1325 /* Continuing. */
1326 /* Remember the previous value. */
1327 prev_tab_offset = tab_offset;
1329 if (wide_column_end_hpos > width)
1331 hpos -= prev_hpos;
1332 tab_offset += prev_hpos;
1334 else
1336 tab_offset += width;
1337 hpos -= width;
1339 vpos++;
1340 contin_hpos = prev_hpos;
1341 prev_hpos = 0;
1342 prev_vpos = vpos;
1346 /* Stop if past the target buffer position or screen position. */
1347 if (pos > to)
1349 /* Go back to the previous position. */
1350 pos = prev_pos;
1351 pos_byte = prev_pos_byte;
1352 hpos = prev_hpos;
1353 vpos = prev_vpos;
1354 tab_offset = prev_tab_offset;
1356 /* NOTE on contin_hpos, hpos, and prev_hpos.
1358 ----------
1359 abcdefgh\\
1360 W_ ^---- contin_hpos
1361 | ^----- hpos
1362 \---- prev_hpos
1363 ----------
1366 if (contin_hpos && prev_hpos == 0
1367 && contin_hpos < width && !wide_column_end_hpos)
1369 /* Line breaking occurs in the middle of multi-column
1370 character. Go back to previous line. */
1371 hpos = contin_hpos;
1372 vpos = vpos - 1;
1374 break;
1377 if (vpos > tovpos || (vpos == tovpos && hpos >= tohpos))
1379 if (contin_hpos && prev_hpos == 0
1380 && hpos > tohpos
1381 && (contin_hpos == width || wide_column_end_hpos > width))
1382 { /* Line breaks because we can't put the character at the
1383 previous line any more. It is not the multi-column
1384 character continued in middle. Go back to previous
1385 buffer position, screen position, and set tab offset
1386 to previous value. It's the beginning of the
1387 line. */
1388 pos = prev_pos;
1389 pos_byte = prev_pos_byte;
1390 hpos = prev_hpos;
1391 vpos = prev_vpos;
1392 tab_offset = prev_tab_offset;
1394 break;
1396 if (pos == ZV) /* We cannot go beyond ZV. Stop here. */
1397 break;
1399 prev_hpos = hpos;
1400 prev_vpos = vpos;
1401 prev_pos = pos;
1402 prev_pos_byte = pos_byte;
1403 wide_column_end_hpos = 0;
1405 /* Consult the width run cache to see if we can avoid inspecting
1406 the text character-by-character. */
1407 if (current_buffer->width_run_cache && pos >= next_width_run)
1409 ptrdiff_t run_end;
1410 int common_width
1411 = region_cache_forward (current_buffer,
1412 current_buffer->width_run_cache,
1413 pos, &run_end);
1415 /* A width of zero means the character's width varies (like
1416 a tab), is meaningless (like a newline), or we just don't
1417 want to skip over it for some other reason. */
1418 if (common_width != 0)
1420 ptrdiff_t run_end_hpos;
1422 /* Don't go past the final buffer posn the user
1423 requested. */
1424 if (run_end > to)
1425 run_end = to;
1427 run_end_hpos = hpos + (run_end - pos) * common_width;
1429 /* Don't go past the final horizontal position the user
1430 requested. */
1431 if (vpos == tovpos && run_end_hpos > tohpos)
1433 run_end = pos + (tohpos - hpos) / common_width;
1434 run_end_hpos = hpos + (run_end - pos) * common_width;
1437 /* Don't go past the margin. */
1438 if (run_end_hpos >= width)
1440 run_end = pos + (width - hpos) / common_width;
1441 run_end_hpos = hpos + (run_end - pos) * common_width;
1444 hpos = run_end_hpos;
1445 if (run_end > pos)
1446 prev_hpos = hpos - common_width;
1447 if (pos != run_end)
1449 pos = run_end;
1450 pos_byte = CHAR_TO_BYTE (pos);
1454 next_width_run = run_end + 1;
1457 /* We have to scan the text character-by-character. */
1458 else
1460 ptrdiff_t i, n;
1461 Lisp_Object charvec;
1463 /* Check composition sequence. */
1464 if (cmp_it.id >= 0
1465 || (pos == cmp_it.stop_pos
1466 && composition_reseat_it (&cmp_it, pos, pos_byte, to, win,
1467 NULL, Qnil)))
1468 composition_update_it (&cmp_it, pos, pos_byte, Qnil);
1469 if (cmp_it.id >= 0)
1471 pos += cmp_it.nchars;
1472 pos_byte += cmp_it.nbytes;
1473 hpos += cmp_it.width;
1474 if (cmp_it.to == cmp_it.nglyphs)
1476 cmp_it.id = -1;
1477 composition_compute_stop_pos (&cmp_it, pos, pos_byte, to,
1478 Qnil);
1480 else
1481 cmp_it.from = cmp_it.to;
1482 continue;
1485 c = FETCH_BYTE (pos_byte);
1486 pos++, pos_byte++;
1488 /* Perhaps add some info to the width_run_cache. */
1489 if (current_buffer->width_run_cache)
1491 /* Is this character part of the current run? If so, extend
1492 the run. */
1493 if (pos - 1 == width_run_end
1494 && XFASTINT (width_table[c]) == width_run_width)
1495 width_run_end = pos;
1497 /* The previous run is over, since this is a character at a
1498 different position, or a different width. */
1499 else
1501 /* Have we accumulated a run to put in the cache?
1502 (Currently, we only cache runs of width == 1). */
1503 if (width_run_start < width_run_end
1504 && width_run_width == 1)
1505 know_region_cache (current_buffer,
1506 current_buffer->width_run_cache,
1507 width_run_start, width_run_end);
1509 /* Start recording a new width run. */
1510 width_run_width = XFASTINT (width_table[c]);
1511 width_run_start = pos - 1;
1512 width_run_end = pos;
1516 if (dp != 0
1517 && ! (multibyte && LEADING_CODE_P (c))
1518 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
1520 charvec = DISP_CHAR_VECTOR (dp, c);
1521 n = ASIZE (charvec);
1523 else
1525 charvec = Qnil;
1526 n = 1;
1529 for (i = 0; i < n; ++i)
1531 if (VECTORP (charvec))
1533 /* This should be handled the same as
1534 next_element_from_display_vector does it. */
1535 Lisp_Object entry = AREF (charvec, i);
1537 if (GLYPH_CODE_P (entry))
1538 c = GLYPH_CODE_CHAR (entry);
1539 else
1540 c = ' ';
1543 if (c >= 040 && c < 0177)
1544 hpos++;
1545 else if (c == '\t')
1547 int tem = ((hpos + tab_offset + hscroll - (hscroll > 0))
1548 % tab_width);
1549 if (tem < 0)
1550 tem += tab_width;
1551 hpos += tab_width - tem;
1553 else if (c == '\n')
1555 if (selective > 0
1556 && indented_beyond_p (pos, pos_byte, selective))
1558 /* If (pos == to), we don't have to take care of
1559 selective display. */
1560 if (pos < to)
1562 /* Skip any number of invisible lines all at once */
1565 pos = find_before_next_newline (pos, to, 1, &pos_byte);
1566 if (pos < to)
1567 INC_BOTH (pos, pos_byte);
1569 while (pos < to
1570 && indented_beyond_p (pos, pos_byte,
1571 selective));
1572 /* Allow for the " ..." that is displayed for them. */
1573 if (selective_rlen)
1575 hpos += selective_rlen;
1576 if (hpos >= width)
1577 hpos = width;
1579 DEC_BOTH (pos, pos_byte);
1580 /* We have skipped the invis text, but not the
1581 newline after. */
1584 else
1586 /* A visible line. */
1587 vpos++;
1588 hpos = 0;
1589 hpos -= hscroll;
1590 /* Count the truncation glyph on column 0 */
1591 if (hscroll > 0)
1592 hpos += continuation_glyph_width;
1593 tab_offset = 0;
1595 contin_hpos = 0;
1597 else if (c == CR && selective < 0)
1599 /* In selective display mode,
1600 everything from a ^M to the end of the line is invisible.
1601 Stop *before* the real newline. */
1602 if (pos < to)
1603 pos = find_before_next_newline (pos, to, 1, &pos_byte);
1604 /* If we just skipped next_boundary,
1605 loop around in the main while
1606 and handle it. */
1607 if (pos > next_boundary)
1608 next_boundary = pos;
1609 /* Allow for the " ..." that is displayed for them. */
1610 if (selective_rlen)
1612 hpos += selective_rlen;
1613 if (hpos >= width)
1614 hpos = width;
1617 else if (multibyte && LEADING_CODE_P (c))
1619 /* Start of multi-byte form. */
1620 unsigned char *ptr;
1621 int mb_bytes, mb_width;
1623 pos_byte--; /* rewind POS_BYTE */
1624 ptr = BYTE_POS_ADDR (pos_byte);
1625 MULTIBYTE_BYTES_WIDTH (ptr, dp, mb_bytes, mb_width);
1626 pos_byte += mb_bytes;
1627 if (mb_width > 1 && BYTES_BY_CHAR_HEAD (*ptr) == mb_bytes)
1628 wide_column_end_hpos = hpos + mb_width;
1629 hpos += mb_width;
1631 else if (VECTORP (charvec))
1632 ++hpos;
1633 else
1634 hpos += (ctl_arrow && c < 0200) ? 2 : 4;
1639 after_loop:
1641 /* Remember any final width run in the cache. */
1642 if (current_buffer->width_run_cache
1643 && width_run_width == 1
1644 && width_run_start < width_run_end)
1645 know_region_cache (current_buffer, current_buffer->width_run_cache,
1646 width_run_start, width_run_end);
1648 val_compute_motion.bufpos = pos;
1649 val_compute_motion.bytepos = pos_byte;
1650 val_compute_motion.hpos = hpos;
1651 val_compute_motion.vpos = vpos;
1652 if (contin_hpos && prev_hpos == 0)
1653 val_compute_motion.prevhpos = contin_hpos;
1654 else
1655 val_compute_motion.prevhpos = prev_hpos;
1657 /* Nonzero if have just continued a line */
1658 val_compute_motion.contin = (contin_hpos && prev_hpos == 0);
1660 immediate_quit = 0;
1661 return &val_compute_motion;
1665 DEFUN ("compute-motion", Fcompute_motion, Scompute_motion, 7, 7, 0,
1666 doc: /* Scan through the current buffer, calculating screen position.
1667 Scan the current buffer forward from offset FROM,
1668 assuming it is at position FROMPOS--a cons of the form (HPOS . VPOS)--
1669 to position TO or position TOPOS--another cons of the form (HPOS . VPOS)--
1670 and return the ending buffer position and screen location.
1672 If TOPOS is nil, the actual width and height of the window's
1673 text area are used.
1675 There are three additional arguments:
1677 WIDTH is the number of columns available to display text;
1678 this affects handling of continuation lines. A value of nil
1679 corresponds to the actual number of available text columns.
1681 OFFSETS is either nil or a cons cell (HSCROLL . TAB-OFFSET).
1682 HSCROLL is the number of columns not being displayed at the left
1683 margin; this is usually taken from a window's hscroll member.
1684 TAB-OFFSET is the number of columns of the first tab that aren't
1685 being displayed, perhaps because the line was continued within it.
1686 If OFFSETS is nil, HSCROLL and TAB-OFFSET are assumed to be zero.
1688 WINDOW is the window to operate on. It is used to choose the display table;
1689 if it is showing the current buffer, it is used also for
1690 deciding which overlay properties apply.
1691 Note that `compute-motion' always operates on the current buffer.
1693 The value is a list of five elements:
1694 (POS HPOS VPOS PREVHPOS CONTIN)
1695 POS is the buffer position where the scan stopped.
1696 VPOS is the vertical position where the scan stopped.
1697 HPOS is the horizontal position where the scan stopped.
1699 PREVHPOS is the horizontal position one character back from POS.
1700 CONTIN is t if a line was continued after (or within) the previous character.
1702 For example, to find the buffer position of column COL of line LINE
1703 of a certain window, pass the window's starting location as FROM
1704 and the window's upper-left coordinates as FROMPOS.
1705 Pass the buffer's (point-max) as TO, to limit the scan to the end of the
1706 visible section of the buffer, and pass LINE and COL as TOPOS. */)
1707 (Lisp_Object from, Lisp_Object frompos, Lisp_Object to, Lisp_Object topos,
1708 Lisp_Object width, Lisp_Object offsets, Lisp_Object window)
1710 struct window *w;
1711 Lisp_Object bufpos, hpos, vpos, prevhpos;
1712 struct position *pos;
1713 ptrdiff_t hscroll;
1714 int tab_offset;
1716 CHECK_NUMBER_COERCE_MARKER (from);
1717 CHECK_CONS (frompos);
1718 CHECK_NUMBER_CAR (frompos);
1719 CHECK_NUMBER_CDR (frompos);
1720 CHECK_NUMBER_COERCE_MARKER (to);
1721 if (!NILP (topos))
1723 CHECK_CONS (topos);
1724 CHECK_NUMBER_CAR (topos);
1725 CHECK_NUMBER_CDR (topos);
1727 if (!NILP (width))
1728 CHECK_NUMBER (width);
1730 if (!NILP (offsets))
1732 CHECK_CONS (offsets);
1733 CHECK_NUMBER_CAR (offsets);
1734 CHECK_NUMBER_CDR (offsets);
1735 if (! (0 <= XINT (XCAR (offsets)) && XINT (XCAR (offsets)) <= PTRDIFF_MAX
1736 && 0 <= XINT (XCDR (offsets)) && XINT (XCDR (offsets)) <= INT_MAX))
1737 args_out_of_range (XCAR (offsets), XCDR (offsets));
1738 hscroll = XINT (XCAR (offsets));
1739 tab_offset = XINT (XCDR (offsets));
1741 else
1742 hscroll = tab_offset = 0;
1744 w = decode_live_window (window);
1746 if (XINT (from) < BEGV || XINT (from) > ZV)
1747 args_out_of_range_3 (from, make_number (BEGV), make_number (ZV));
1748 if (XINT (to) < BEGV || XINT (to) > ZV)
1749 args_out_of_range_3 (to, make_number (BEGV), make_number (ZV));
1751 pos = compute_motion (XINT (from), CHAR_TO_BYTE (XINT (from)),
1752 XINT (XCDR (frompos)),
1753 XINT (XCAR (frompos)), 0,
1754 XINT (to),
1755 (NILP (topos)
1756 ? window_internal_height (w)
1757 : XINT (XCDR (topos))),
1758 (NILP (topos)
1759 ? (window_body_width (w, 0)
1761 #ifdef HAVE_WINDOW_SYSTEM
1762 FRAME_WINDOW_P (XFRAME (w->frame)) ? 0 :
1763 #endif
1765 : XINT (XCAR (topos))),
1766 (NILP (width) ? -1 : XINT (width)),
1767 hscroll, tab_offset, w);
1769 XSETFASTINT (bufpos, pos->bufpos);
1770 XSETINT (hpos, pos->hpos);
1771 XSETINT (vpos, pos->vpos);
1772 XSETINT (prevhpos, pos->prevhpos);
1774 return list5 (bufpos, hpos, vpos, prevhpos, pos->contin ? Qt : Qnil);
1777 /* Fvertical_motion and vmotion. */
1779 static struct position val_vmotion;
1781 struct position *
1782 vmotion (register ptrdiff_t from, register ptrdiff_t from_byte,
1783 register EMACS_INT vtarget, struct window *w)
1785 ptrdiff_t hscroll = w->hscroll;
1786 struct position pos;
1787 /* VPOS is cumulative vertical position, changed as from is changed. */
1788 register EMACS_INT vpos = 0;
1789 ptrdiff_t prevline;
1790 register ptrdiff_t first;
1791 ptrdiff_t lmargin = hscroll > 0 ? 1 - hscroll : 0;
1792 ptrdiff_t selective
1793 = (INTEGERP (BVAR (current_buffer, selective_display))
1794 ? clip_to_bounds (-1, XINT (BVAR (current_buffer, selective_display)),
1795 PTRDIFF_MAX)
1796 : !NILP (BVAR (current_buffer, selective_display)) ? -1 : 0);
1797 Lisp_Object window;
1798 bool did_motion;
1799 /* This is the object we use for fetching character properties. */
1800 Lisp_Object text_prop_object;
1802 XSETWINDOW (window, w);
1804 /* If the window contains this buffer, use it for getting text properties.
1805 Otherwise use the current buffer as arg for doing that. */
1806 if (EQ (w->contents, Fcurrent_buffer ()))
1807 text_prop_object = window;
1808 else
1809 text_prop_object = Fcurrent_buffer ();
1811 if (vpos >= vtarget)
1813 /* To move upward, go a line at a time until
1814 we have gone at least far enough. */
1816 first = 1;
1818 while ((vpos > vtarget || first) && from > BEGV)
1820 ptrdiff_t bytepos = from_byte;
1821 Lisp_Object propval;
1823 prevline = from;
1824 DEC_BOTH (prevline, bytepos);
1825 prevline = find_newline_no_quit (prevline, bytepos, -1, &bytepos);
1827 while (prevline > BEGV
1828 && ((selective > 0
1829 && indented_beyond_p (prevline, bytepos, selective))
1830 /* Watch out for newlines with `invisible' property.
1831 When moving upward, check the newline before. */
1832 || (propval = Fget_char_property (make_number (prevline - 1),
1833 Qinvisible,
1834 text_prop_object),
1835 TEXT_PROP_MEANS_INVISIBLE (propval))))
1837 DEC_BOTH (prevline, bytepos);
1838 prevline = find_newline_no_quit (prevline, bytepos, -1, &bytepos);
1840 pos = *compute_motion (prevline, bytepos, 0, lmargin, 0, from,
1841 /* Don't care for VPOS... */
1842 1 << (BITS_PER_SHORT - 1),
1843 /* ... nor HPOS. */
1844 1 << (BITS_PER_SHORT - 1),
1845 -1, hscroll, 0, w);
1846 vpos -= pos.vpos;
1847 first = 0;
1848 from = prevline;
1849 from_byte = bytepos;
1852 /* If we made exactly the desired vertical distance, or
1853 if we hit beginning of buffer, return point found. */
1854 if (vpos >= vtarget)
1856 val_vmotion.bufpos = from;
1857 val_vmotion.bytepos = from_byte;
1858 val_vmotion.vpos = vpos;
1859 val_vmotion.hpos = lmargin;
1860 val_vmotion.contin = 0;
1861 val_vmotion.prevhpos = 0;
1862 return &val_vmotion;
1865 /* Otherwise find the correct spot by moving down. */
1868 /* Moving downward is simple, but must calculate from
1869 beg of line to determine hpos of starting point. */
1871 if (from > BEGV && FETCH_BYTE (from_byte - 1) != '\n')
1873 ptrdiff_t bytepos;
1874 Lisp_Object propval;
1876 prevline = find_newline_no_quit (from, from_byte, -1, &bytepos);
1877 while (prevline > BEGV
1878 && ((selective > 0
1879 && indented_beyond_p (prevline, bytepos, selective))
1880 /* Watch out for newlines with `invisible' property.
1881 When moving downward, check the newline after. */
1882 || (propval = Fget_char_property (make_number (prevline),
1883 Qinvisible,
1884 text_prop_object),
1885 TEXT_PROP_MEANS_INVISIBLE (propval))))
1887 DEC_BOTH (prevline, bytepos);
1888 prevline = find_newline_no_quit (prevline, bytepos, -1, &bytepos);
1890 pos = *compute_motion (prevline, bytepos, 0, lmargin, 0, from,
1891 /* Don't care for VPOS... */
1892 1 << (BITS_PER_SHORT - 1),
1893 /* ... nor HPOS. */
1894 1 << (BITS_PER_SHORT - 1),
1895 -1, hscroll, 0, w);
1896 did_motion = 1;
1898 else
1900 pos.hpos = lmargin;
1901 pos.vpos = 0;
1902 did_motion = 0;
1904 return compute_motion (from, from_byte, vpos, pos.hpos, did_motion,
1905 ZV, vtarget, - (1 << (BITS_PER_SHORT - 1)),
1906 -1, hscroll, 0, w);
1909 DEFUN ("vertical-motion", Fvertical_motion, Svertical_motion, 1, 2, 0,
1910 doc: /* Move point to start of the screen line LINES lines down.
1911 If LINES is negative, this means moving up.
1913 This function is an ordinary cursor motion function
1914 which calculates the new position based on how text would be displayed.
1915 The new position may be the start of a line,
1916 or just the start of a continuation line.
1917 The function returns number of screen lines moved over;
1918 that usually equals LINES, but may be closer to zero
1919 if beginning or end of buffer was reached.
1921 The optional second argument WINDOW specifies the window to use for
1922 parameters such as width, horizontal scrolling, and so on.
1923 The default is to use the selected window's parameters.
1925 LINES can optionally take the form (COLS . LINES), in which case
1926 the motion will not stop at the start of a screen line but on
1927 its column COLS (if such exists on that line, that is).
1929 `vertical-motion' always uses the current buffer,
1930 regardless of which buffer is displayed in WINDOW.
1931 This is consistent with other cursor motion functions
1932 and makes it possible to use `vertical-motion' in any buffer,
1933 whether or not it is currently displayed in some window. */)
1934 (Lisp_Object lines, Lisp_Object window)
1936 struct it it;
1937 struct text_pos pt;
1938 struct window *w;
1939 Lisp_Object old_buffer;
1940 EMACS_INT old_charpos IF_LINT (= 0), old_bytepos IF_LINT (= 0);
1941 struct gcpro gcpro1;
1942 Lisp_Object lcols = Qnil;
1943 double cols IF_LINT (= 0);
1944 void *itdata = NULL;
1946 /* Allow LINES to be of the form (HPOS . VPOS) aka (COLUMNS . LINES). */
1947 if (CONSP (lines) && (NUMBERP (XCAR (lines))))
1949 lcols = XCAR (lines);
1950 cols = INTEGERP (lcols) ? (double) XINT (lcols) : XFLOAT_DATA (lcols);
1951 lines = XCDR (lines);
1954 CHECK_NUMBER (lines);
1955 w = decode_live_window (window);
1957 old_buffer = Qnil;
1958 GCPRO1 (old_buffer);
1959 if (XBUFFER (w->contents) != current_buffer)
1961 /* Set the window's buffer temporarily to the current buffer. */
1962 old_buffer = w->contents;
1963 old_charpos = marker_position (w->pointm);
1964 old_bytepos = marker_byte_position (w->pointm);
1965 wset_buffer (w, Fcurrent_buffer ());
1966 set_marker_both (w->pointm, w->contents,
1967 BUF_PT (current_buffer), BUF_PT_BYTE (current_buffer));
1970 if (noninteractive)
1972 struct position pos;
1973 pos = *vmotion (PT, PT_BYTE, XINT (lines), w);
1974 SET_PT_BOTH (pos.bufpos, pos.bytepos);
1976 else
1978 ptrdiff_t it_start, it_overshoot_count = 0;
1979 int first_x;
1980 bool overshoot_handled = 0;
1981 bool disp_string_at_start_p = 0;
1983 itdata = bidi_shelve_cache ();
1984 SET_TEXT_POS (pt, PT, PT_BYTE);
1985 start_display (&it, w, pt);
1986 first_x = it.first_visible_x;
1987 it_start = IT_CHARPOS (it);
1989 /* See comments below for why we calculate this. */
1990 if (it.cmp_it.id >= 0)
1991 it_overshoot_count = 0;
1992 else if (it.method == GET_FROM_STRING)
1994 const char *s = SSDATA (it.string);
1995 const char *e = s + SBYTES (it.string);
1997 disp_string_at_start_p =
1998 /* If it.area is anything but TEXT_AREA, we need not bother
1999 about the display string, as it doesn't affect cursor
2000 positioning. */
2001 it.area == TEXT_AREA
2002 && it.string_from_display_prop_p
2003 /* A display string on anything but buffer text (e.g., on
2004 an overlay string) doesn't affect cursor positioning. */
2005 && (it.sp > 0 && it.stack[it.sp - 1].method == GET_FROM_BUFFER);
2006 while (s < e)
2008 if (*s++ == '\n')
2009 it_overshoot_count++;
2011 if (!it_overshoot_count)
2012 it_overshoot_count = -1;
2014 else
2015 it_overshoot_count =
2016 !(it.method == GET_FROM_IMAGE || it.method == GET_FROM_STRETCH);
2018 /* Scan from the start of the line containing PT. If we don't
2019 do this, we start moving with IT->current_x == 0, while PT is
2020 really at some x > 0. */
2021 reseat_at_previous_visible_line_start (&it);
2022 it.current_x = it.hpos = 0;
2023 if (IT_CHARPOS (it) != PT)
2024 /* We used to temporarily disable selective display here; the
2025 comment said this is "so we don't move too far" (2005-01-19
2026 checkin by kfs). But this does nothing useful that I can
2027 tell, and it causes Bug#2694 . -- cyd */
2028 /* When the position we started from is covered by a display
2029 string, move_it_to will overshoot it, while vertical-motion
2030 wants to put the cursor _before_ the display string. So in
2031 that case, we move to buffer position before the display
2032 string, and avoid overshooting. */
2033 move_it_to (&it, disp_string_at_start_p ? PT - 1 : PT,
2034 -1, -1, -1, MOVE_TO_POS);
2036 /* IT may move too far if truncate-lines is on and PT lies
2037 beyond the right margin. IT may also move too far if the
2038 starting point is on a Lisp string that has embedded
2039 newlines, or spans several screen lines. In these cases,
2040 backtrack. */
2041 if (IT_CHARPOS (it) > it_start)
2043 /* We need to backtrack also if the Lisp string contains no
2044 newlines, but there is a newline right after it. In this
2045 case, IT overshoots if there is an after-string just
2046 before the newline. */
2047 if (it_overshoot_count < 0
2048 && it.method == GET_FROM_BUFFER
2049 && it.c == '\n')
2050 it_overshoot_count = 1;
2051 else if (disp_string_at_start_p && it.vpos > 0)
2053 /* This is the case of a display string that spans
2054 several screen lines. In that case, we end up at the
2055 end of the string, and it.vpos tells us how many
2056 screen lines we need to backtrack. */
2057 it_overshoot_count = it.vpos;
2059 if (it_overshoot_count > 0)
2060 move_it_by_lines (&it, -it_overshoot_count);
2062 overshoot_handled = 1;
2064 if (XINT (lines) <= 0)
2066 it.vpos = 0;
2067 /* Do this even if LINES is 0, so that we move back to the
2068 beginning of the current line as we ought. */
2069 if (XINT (lines) == 0 || IT_CHARPOS (it) > 0)
2070 move_it_by_lines (&it, max (PTRDIFF_MIN, XINT (lines)));
2072 else if (overshoot_handled)
2074 it.vpos = 0;
2075 move_it_by_lines (&it, min (PTRDIFF_MAX, XINT (lines)));
2077 else
2079 /* Otherwise, we are at the first row occupied by PT, which
2080 might span multiple screen lines (e.g., if it's on a
2081 multi-line display string). We want to start from the
2082 last line that it occupies. */
2083 if (it_start < ZV)
2085 while (IT_CHARPOS (it) <= it_start)
2087 it.vpos = 0;
2088 move_it_by_lines (&it, 1);
2090 if (XINT (lines) > 1)
2091 move_it_by_lines (&it, min (PTRDIFF_MAX, XINT (lines) - 1));
2093 else
2095 it.vpos = 0;
2096 move_it_by_lines (&it, min (PTRDIFF_MAX, XINT (lines)));
2100 /* Move to the goal column, if one was specified. */
2101 if (!NILP (lcols))
2103 /* If the window was originally hscrolled, move forward by
2104 the hscrolled amount first. */
2105 if (first_x > 0)
2107 move_it_in_display_line (&it, ZV, first_x, MOVE_TO_X);
2108 it.current_x = 0;
2110 move_it_in_display_line
2111 (&it, ZV,
2112 (int)(cols * FRAME_COLUMN_WIDTH (XFRAME (w->frame)) + 0.5),
2113 MOVE_TO_X);
2116 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
2117 bidi_unshelve_cache (itdata, 0);
2120 if (BUFFERP (old_buffer))
2122 wset_buffer (w, old_buffer);
2123 set_marker_both (w->pointm, w->contents,
2124 old_charpos, old_bytepos);
2127 RETURN_UNGCPRO (make_number (it.vpos));
2132 /* File's initialization. */
2134 void
2135 syms_of_indent (void)
2137 DEFVAR_BOOL ("indent-tabs-mode", indent_tabs_mode,
2138 doc: /* Indentation can insert tabs if this is non-nil. */);
2139 indent_tabs_mode = 1;
2141 defsubr (&Scurrent_indentation);
2142 defsubr (&Sindent_to);
2143 defsubr (&Scurrent_column);
2144 defsubr (&Smove_to_column);
2145 defsubr (&Svertical_motion);
2146 defsubr (&Scompute_motion);