1 /* Indentation functions.
2 Copyright (C) 1985-1988, 1993-1995, 1998, 2000-2013 Free Software
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/>. */
24 #include "character.h"
27 #include "composite.h"
34 #include "intervals.h"
35 #include "dispextern.h"
36 #include "region-cache.h"
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)
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
);
74 /* Width run cache considerations. */
76 /* Return the width of character C under display table DP. */
79 character_width (int c
, struct Lisp_Char_Table
*dp
)
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
)))
91 /* Some characters are special. */
92 if (c
== '\n' || c
== '\t' || c
== '\015')
95 /* Printing characters have width 1. */
96 else if (c
>= 040 && c
< 0177)
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
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. */
113 disptab_matches_widthtab (struct Lisp_Char_Table
*disptab
, struct Lisp_Vector
*widthtab
)
117 eassert (widthtab
->header
.size
== 256);
119 for (i
= 0; i
< 256; i
++)
120 if (character_width (i
, disptab
)
121 != XFASTINT (widthtab
->contents
[i
]))
127 /* Recompute BUF's width table, using the display table DISPTAB. */
130 recompute_width_table (struct buffer
*buf
, struct Lisp_Char_Table
*disptab
)
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. */
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
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
);
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. */
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
;
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. */
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
,
236 end
= XFASTINT (tmp
);
238 /* Don't put the boundary in the middle of multibyte form if
239 there is no actual property change. */
241 && !NILP (current_buffer
->enable_multibyte_characters
)
243 while (pos
< end
&& !CHAR_HEAD_P (POS_ADDR (end
)))
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
,
252 && EQ (XWINDOW (window
)->contents
, 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
;
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
268 #define MULTIBYTE_BYTES_WIDTH(p, dp, bytes, width) \
272 ch = STRING_CHAR_AND_LENGTH (p, bytes); \
273 if (BYTES_BY_CHAR_HEAD (*p) != bytes) \
277 if (dp != 0 && VECTORP (DISP_CHAR_VECTOR (dp, ch))) \
278 width = sanitize_char_width (ASIZE (DISP_CHAR_VECTOR (dp, ch))); \
280 width = CHAR_WIDTH (ch); \
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. */)
300 XSETFASTINT (temp
, current_column ());
304 /* Cancel any recorded value of the horizontal position. */
307 invalidate_current_column (void)
309 last_known_column_point
= 0;
313 current_column (void)
316 unsigned char *ptr
, *stop
;
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 ()
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. */
344 else if (PT
<= GPT
|| BEGV
> GPT
)
349 col
= 0, tab_seen
= 0, post_tab
= 0;
358 /* We stopped either for the beginning of the buffer
360 if (ptr
== BEGV_ADDR
)
363 /* It was the gap. Jump back over it. */
367 /* Check whether that brings us to beginning of buffer. */
374 if (dp
&& VECTORP (DISP_CHAR_VECTOR (dp
, c
)))
376 charvec
= DISP_CHAR_VECTOR (dp
, c
);
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
);
399 if (c
>= 040 && c
< 0177)
403 && EQ (BVAR (current_buffer
, selective_display
), Qt
)))
406 goto start_of_line_found
;
411 col
= ((col
+ tab_width
) / tab_width
) * tab_width
;
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. */
425 col
+= (ctl_arrow
&& c
< 0200) ? 2 : 4;
433 col
= ((col
+ tab_width
) / tab_width
) * tab_width
;
437 last_known_column
= col
;
438 last_known_column_point
= PT
;
439 last_known_column_modified
= MODIFF
;
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
449 Otherwise just return -1. */
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
;
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
)))
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
;
482 if (OVERLAYP (overlay
))
483 *endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
485 get_property_and_range (pos
, Qdisplay
, &val
, &start
, endpos
, Qnil
);
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
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). */
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
;
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
);
523 composition_compute_stop_pos (&cmp_it
, scan
, scan_byte
, end
, Qnil
);
525 /* Scan forward to the target position. */
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
);
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. */
550 { /* Check display property. */
552 int width
= check_display_width (scan
, col
, &endp
);
556 if (endp
> scan
) /* Avoid infinite loops with 0-width overlays. */
559 scan_byte
= CHAR_TO_BYTE (scan
);
565 /* Check composition sequence. */
567 || (scan
== cmp_it
.stop_pos
568 && composition_reseat_it (&cmp_it
, scan
, scan_byte
, end
,
570 composition_update_it (&cmp_it
, scan
, scan_byte
, Qnil
);
573 scan
+= cmp_it
.nchars
;
574 scan_byte
+= cmp_it
.nbytes
;
577 if (cmp_it
.to
== cmp_it
.nglyphs
)
580 composition_compute_stop_pos (&cmp_it
, scan
, scan_byte
, end
,
584 cmp_it
.from
= cmp_it
.to
;
588 c
= FETCH_BYTE (scan_byte
);
590 /* See if there is a display table and it relates
591 to this character. */
594 && ! (multibyte
&& LEADING_CODE_P (c
))
595 && VECTORP (DISP_CHAR_VECTOR (dp
, c
)))
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
);
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
);
619 if (c
== '\r' && EQ (BVAR (current_buffer
, selective_display
), Qt
))
624 col
= col
/ tab_width
* tab_width
;
632 /* The display table doesn't affect this character;
633 it displays as itself. */
637 if (c
== '\r' && EQ (BVAR (current_buffer
, selective_display
), Qt
))
642 col
= col
/ tab_width
* tab_width
;
644 else if (multibyte
&& LEADING_CODE_P (c
))
646 /* Start of multi-byte form. */
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;
657 else if (ctl_arrow
&& (c
< 040 || c
== 0177))
659 else if (c
< 040 || c
>= 0177)
670 last_known_column
= col
;
671 last_known_column_point
= PT
;
672 last_known_column_modified
= MODIFF
;
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. */
688 current_column_1 (void)
690 EMACS_INT col
= MOST_POSITIVE_FIXNUM
;
691 ptrdiff_t opoint
= PT
;
693 scan_for_column (&opoint
, &col
, NULL
);
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. */
705 string_display_width (Lisp_Object string
, Lisp_Object beg
, Lisp_Object end
)
708 unsigned char *ptr
, *stop
;
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 ();
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;
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)
756 col
= ((col
+ tab_width
) / tab_width
) * tab_width
;
763 col
+= (ctl_arrow
&& c
< 0200) ? 2 : 4;
768 col
= ((col
+ tab_width
) / tab_width
) * tab_width
;
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
)
787 register ptrdiff_t fromcol
;
788 int tab_width
= SANE_TAB_WIDTH (current_buffer
);
790 CHECK_NUMBER (column
);
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
)
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
);
826 DEFUN ("current-indentation", Fcurrent_indentation
, Scurrent_indentation
,
828 doc
: /* Return the indentation of the current line.
829 This is the horizontal position of the character
830 following any initial whitespace. */)
835 find_newline (PT
, PT_BYTE
, BEGV
, BEGV_BYTE
, -1, NULL
, &posbyte
, 1);
836 return make_number (position_indentation (posbyte
));
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. */
855 /* START records the starting value of P. */
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. */
866 pos_byte
= PTR_BYTE_POS (p
);
867 /* Consider the various reasons STOP might have been set here. */
868 if (pos_byte
== ZV_BYTE
)
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
);
893 if (! NILP (BVAR (current_buffer
, enable_multibyte_characters
)))
899 column
+= tab_width
- column
% tab_width
;
902 if (ASCII_BYTE_P (p
[-1])
903 || NILP (BVAR (current_buffer
, enable_multibyte_characters
)))
907 pos_byte
= PTR_BYTE_POS (p
- 1);
908 c
= FETCH_MULTIBYTE_CHAR (pos_byte
);
909 if (CHAR_HAS_CATEGORY (c
, ' '))
913 p
= BYTE_POS_ADDR (pos_byte
);
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
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,
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
;
963 CHECK_NATNUM (column
);
964 goal
= XINT (column
);
968 scan_for_column (&pos
, &col
, &prev_col
);
972 /* If a tab char made us overshoot, change it to spaces
973 and scan through it again. */
974 if (!NILP (force
) && col
> goal
)
977 ptrdiff_t pos_byte
= PT_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
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);
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. */
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
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
1060 When displaying in window w, a typical formula for WIDTH is:
1063 - (has_vertical_scroll_bars
1064 ? WINDOW_CONFIG_SCROLL_BAR_COLS (window)
1065 : (window_width + window_left != frame_cols))
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. */
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
;
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
);
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
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
;
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
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. */
1146 /* Negative width means use all available text columns. */
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
)))
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. */
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
;
1172 prev_tab_offset
= tab_offset
;
1173 memset (&cmp_it
, 0, sizeof cmp_it
);
1175 composition_compute_stop_pos (&cmp_it
, pos
, pos_byte
, to
, Qnil
);
1179 while (pos
== next_boundary
)
1181 ptrdiff_t pos_here
= pos
;
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
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
1197 pos_byte
= prev_pos_byte
;
1200 tab_offset
= prev_tab_offset
;
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. */
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
);
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
);
1233 pos
= min (to
, newpos
);
1234 pos_byte
= CHAR_TO_BYTE (pos
);
1238 if (newpos
!= pos_here
)
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.
1261 (*) The cursor is placed on the next character after the point.
1265 j ^---- next after the point
1266 ^--- next char. after the point.
1268 In case of sigle-column character
1272 033 ^---- next after the point, next char. after the point.
1274 In case of multi-column character
1278 W_ ^---- next after the point
1279 ^---- next char. after the point.
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.
1291 EMACS_INT total_width
= width
+ continuation_glyph_width
;
1294 if (!NILP (Vtruncate_partial_width_windows
)
1295 && (total_width
< FRAME_COLS (XFRAME (WINDOW_FRAME (win
)))))
1297 if (INTEGERP (Vtruncate_partial_width_windows
))
1299 = total_width
< XFASTINT (Vtruncate_partial_width_windows
);
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). */
1311 pos
= find_before_next_newline (pos
, to
, 1, &pos_byte
);
1313 /* If we just skipped next_boundary,
1314 loop around in the main while
1316 if (pos
>= next_boundary
)
1317 next_boundary
= pos
+ 1;
1320 prev_tab_offset
= tab_offset
;
1326 /* Remember the previous value. */
1327 prev_tab_offset
= tab_offset
;
1329 if (wide_column_end_hpos
> width
)
1332 tab_offset
+= prev_hpos
;
1336 tab_offset
+= width
;
1340 contin_hpos
= prev_hpos
;
1346 /* Stop if past the target buffer position or screen position. */
1349 /* Go back to the previous position. */
1351 pos_byte
= prev_pos_byte
;
1354 tab_offset
= prev_tab_offset
;
1356 /* NOTE on contin_hpos, hpos, and prev_hpos.
1360 W_ ^---- contin_hpos
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. */
1377 if (vpos
> tovpos
|| (vpos
== tovpos
&& hpos
>= tohpos
))
1379 if (contin_hpos
&& prev_hpos
== 0
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
1389 pos_byte
= prev_pos_byte
;
1392 tab_offset
= prev_tab_offset
;
1396 if (pos
== ZV
) /* We cannot go beyond ZV. Stop here. */
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
)
1411 = region_cache_forward (current_buffer
,
1412 current_buffer
->width_run_cache
,
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
1427 run_end_hpos
= hpos
+ (run_end
- pos
) * common_width
;
1429 /* Don't go past the final horizontal position the user
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
;
1446 prev_hpos
= hpos
- common_width
;
1450 pos_byte
= CHAR_TO_BYTE (pos
);
1454 next_width_run
= run_end
+ 1;
1457 /* We have to scan the text character-by-character. */
1461 Lisp_Object charvec
;
1463 /* Check composition sequence. */
1465 || (pos
== cmp_it
.stop_pos
1466 && composition_reseat_it (&cmp_it
, pos
, pos_byte
, to
, win
,
1468 composition_update_it (&cmp_it
, pos
, pos_byte
, Qnil
);
1471 pos
+= cmp_it
.nchars
;
1472 pos_byte
+= cmp_it
.nbytes
;
1473 hpos
+= cmp_it
.width
;
1474 if (cmp_it
.to
== cmp_it
.nglyphs
)
1477 composition_compute_stop_pos (&cmp_it
, pos
, pos_byte
, to
,
1481 cmp_it
.from
= cmp_it
.to
;
1485 c
= FETCH_BYTE (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
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. */
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
;
1517 && ! (multibyte
&& LEADING_CODE_P (c
))
1518 && VECTORP (DISP_CHAR_VECTOR (dp
, c
)))
1520 charvec
= DISP_CHAR_VECTOR (dp
, c
);
1521 n
= ASIZE (charvec
);
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
);
1543 if (c
>= 040 && c
< 0177)
1547 int tem
= ((hpos
+ tab_offset
+ hscroll
- (hscroll
> 0))
1551 hpos
+= tab_width
- tem
;
1556 && indented_beyond_p (pos
, pos_byte
, selective
))
1558 /* If (pos == to), we don't have to take care of
1559 selective display. */
1562 /* Skip any number of invisible lines all at once */
1565 pos
= find_before_next_newline (pos
, to
, 1, &pos_byte
);
1567 INC_BOTH (pos
, pos_byte
);
1570 && indented_beyond_p (pos
, pos_byte
,
1572 /* Allow for the " ..." that is displayed for them. */
1575 hpos
+= selective_rlen
;
1579 DEC_BOTH (pos
, pos_byte
);
1580 /* We have skipped the invis text, but not the
1586 /* A visible line. */
1590 /* Count the truncation glyph on column 0 */
1592 hpos
+= continuation_glyph_width
;
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. */
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
1607 if (pos
> next_boundary
)
1608 next_boundary
= pos
;
1609 /* Allow for the " ..." that is displayed for them. */
1612 hpos
+= selective_rlen
;
1617 else if (multibyte
&& LEADING_CODE_P (c
))
1619 /* Start of multi-byte form. */
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
;
1631 else if (VECTORP (charvec
))
1634 hpos
+= (ctl_arrow
&& c
< 0200) ? 2 : 4;
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
;
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);
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
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
)
1711 Lisp_Object bufpos
, hpos
, vpos
, prevhpos
;
1712 struct position
*pos
;
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
);
1724 CHECK_NUMBER_CAR (topos
);
1725 CHECK_NUMBER_CDR (topos
);
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
));
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,
1756 ? window_internal_height (w
)
1757 : XINT (XCDR (topos
))),
1759 ? (window_body_width (w
, 0)
1761 #ifdef HAVE_WINDOW_SYSTEM
1762 FRAME_WINDOW_P (XFRAME (w
->frame
)) ? 0 :
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
;
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;
1790 register ptrdiff_t first
;
1791 ptrdiff_t lmargin
= hscroll
> 0 ? 1 - hscroll
: 0;
1793 = (INTEGERP (BVAR (current_buffer
, selective_display
))
1794 ? clip_to_bounds (-1, XINT (BVAR (current_buffer
, selective_display
)),
1796 : !NILP (BVAR (current_buffer
, selective_display
)) ? -1 : 0);
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
;
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. */
1818 while ((vpos
> vtarget
|| first
) && from
> BEGV
)
1820 ptrdiff_t bytepos
= from_byte
;
1821 Lisp_Object propval
;
1824 DEC_BOTH (prevline
, bytepos
);
1825 prevline
= find_newline_no_quit (prevline
, bytepos
, -1, &bytepos
);
1827 while (prevline
> BEGV
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),
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),
1844 1 << (BITS_PER_SHORT
- 1),
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')
1874 Lisp_Object propval
;
1876 prevline
= find_newline_no_quit (from
, from_byte
, -1, &bytepos
);
1877 while (prevline
> BEGV
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
),
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),
1894 1 << (BITS_PER_SHORT
- 1),
1904 return compute_motion (from
, from_byte
, vpos
, pos
.hpos
, did_motion
,
1905 ZV
, vtarget
, - (1 << (BITS_PER_SHORT
- 1)),
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
)
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
);
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
));
1972 struct position pos
;
1973 pos
= *vmotion (PT
, PT_BYTE
, XINT (lines
), w
);
1974 SET_PT_BOTH (pos
.bufpos
, pos
.bytepos
);
1978 ptrdiff_t it_start
, it_overshoot_count
= 0;
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
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
);
2009 it_overshoot_count
++;
2011 if (!it_overshoot_count
)
2012 it_overshoot_count
= -1;
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,
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
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)
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
)
2075 move_it_by_lines (&it
, min (PTRDIFF_MAX
, XINT (lines
)));
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. */
2085 while (IT_CHARPOS (it
) <= it_start
)
2088 move_it_by_lines (&it
, 1);
2090 if (XINT (lines
) > 1)
2091 move_it_by_lines (&it
, min (PTRDIFF_MAX
, XINT (lines
) - 1));
2096 move_it_by_lines (&it
, min (PTRDIFF_MAX
, XINT (lines
)));
2100 /* Move to the goal column, if one was specified. */
2103 /* If the window was originally hscrolled, move forward by
2104 the hscrolled amount first. */
2107 move_it_in_display_line (&it
, ZV
, first_x
, MOVE_TO_X
);
2110 move_it_in_display_line
2112 (int)(cols
* FRAME_COLUMN_WIDTH (XFRAME (w
->frame
)) + 0.5),
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. */
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
);