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