(Ffind_charset_region): Optimization for unibyte buffer.
[bpt/emacs.git] / src / editfns.c
CommitLineData
35692fe0 1/* Lisp functions pertaining to editing.
31c8f881 2 Copyright (C) 1985,86,87,89,93,94,95,96,97,98 Free Software Foundation, Inc.
35692fe0
JB
3
4This file is part of GNU Emacs.
5
6GNU Emacs is free software; you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
7c938215 8the Free Software Foundation; either version 2, or (at your option)
35692fe0
JB
9any later version.
10
11GNU Emacs is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
17along with GNU Emacs; see the file COPYING. If not, write to
5a7670bf
RS
18the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19Boston, MA 02111-1307, USA. */
35692fe0
JB
20
21
738429d1
JB
22#include <sys/types.h>
23
18160b98 24#include <config.h>
bfb61299
JB
25
26#ifdef VMS
956ace37 27#include "vms-pwd.h"
bfb61299 28#else
35692fe0 29#include <pwd.h>
bfb61299
JB
30#endif
31
dfcf069d
AS
32#ifdef STDC_HEADERS
33#include <stdlib.h>
34#endif
35
36#ifdef HAVE_UNISTD_H
37#include <unistd.h>
38#endif
39
35692fe0 40#include "lisp.h"
74d6d8c5 41#include "intervals.h"
35692fe0 42#include "buffer.h"
fb8106e8 43#include "charset.h"
35692fe0
JB
44#include "window.h"
45
956ace37 46#include "systime.h"
35692fe0
JB
47
48#define min(a, b) ((a) < (b) ? (a) : (b))
49#define max(a, b) ((a) > (b) ? (a) : (b))
50
a03eaf1c
RS
51#ifndef NULL
52#define NULL 0
53#endif
54
c59b5089
PE
55extern char **environ;
56extern Lisp_Object make_time ();
b1b0ee5a 57extern void insert_from_buffer ();
94751666 58static int tm_diff ();
260e2e2a 59static void update_buffer_properties ();
b771d0da 60size_t emacs_strftime ();
a92ae0ce 61void set_time_zone_rule ();
260e2e2a
KH
62
63Lisp_Object Vbuffer_access_fontify_functions;
64Lisp_Object Qbuffer_access_fontify_functions;
65Lisp_Object Vbuffer_access_fontified_property;
b1b0ee5a 66
e3ed8469
KH
67Lisp_Object Fuser_full_name ();
68
35692fe0
JB
69/* Some static data, and a function to initialize it for each run */
70
71Lisp_Object Vsystem_name;
35b34f72
KH
72Lisp_Object Vuser_real_login_name; /* login name of current user ID */
73Lisp_Object Vuser_full_name; /* full name of current user */
74Lisp_Object Vuser_login_name; /* user name from LOGNAME or USER */
35692fe0
JB
75
76void
77init_editfns ()
78{
52b14ac0 79 char *user_name;
35692fe0
JB
80 register unsigned char *p, *q, *r;
81 struct passwd *pw; /* password entry for the current user */
35692fe0
JB
82 Lisp_Object tem;
83
84 /* Set up system_name even when dumping. */
ac988277 85 init_system_name ();
35692fe0
JB
86
87#ifndef CANNOT_DUMP
88 /* Don't bother with this on initial start when just dumping out */
89 if (!initialized)
90 return;
91#endif /* not CANNOT_DUMP */
92
93 pw = (struct passwd *) getpwuid (getuid ());
87485d6f
MW
94#ifdef MSDOS
95 /* We let the real user name default to "root" because that's quite
96 accurate on MSDOG and because it lets Emacs find the init file.
97 (The DVX libraries override the Djgpp libraries here.) */
35b34f72 98 Vuser_real_login_name = build_string (pw ? pw->pw_name : "root");
87485d6f 99#else
35b34f72 100 Vuser_real_login_name = build_string (pw ? pw->pw_name : "unknown");
87485d6f 101#endif
35692fe0 102
52b14ac0
JB
103 /* Get the effective user name, by consulting environment variables,
104 or the effective uid if those are unset. */
2c9ae24e 105 user_name = (char *) getenv ("LOGNAME");
35692fe0 106 if (!user_name)
4691c06d
RS
107#ifdef WINDOWSNT
108 user_name = (char *) getenv ("USERNAME"); /* it's USERNAME on NT */
109#else /* WINDOWSNT */
2c9ae24e 110 user_name = (char *) getenv ("USER");
4691c06d 111#endif /* WINDOWSNT */
52b14ac0
JB
112 if (!user_name)
113 {
114 pw = (struct passwd *) getpwuid (geteuid ());
115 user_name = (char *) (pw ? pw->pw_name : "unknown");
116 }
35b34f72 117 Vuser_login_name = build_string (user_name);
35692fe0 118
52b14ac0
JB
119 /* If the user name claimed in the environment vars differs from
120 the real uid, use the claimed name to find the full name. */
35b34f72 121 tem = Fstring_equal (Vuser_login_name, Vuser_real_login_name);
3415b0e9
RS
122 Vuser_full_name = Fuser_full_name (NILP (tem)? make_number (geteuid())
123 : Vuser_login_name);
35692fe0 124
8f1e2d16 125 p = (unsigned char *) getenv ("NAME");
9d36d071
RS
126 if (p)
127 Vuser_full_name = build_string (p);
3347526c
RS
128 else if (NILP (Vuser_full_name))
129 Vuser_full_name = build_string ("unknown");
35692fe0
JB
130}
131\f
132DEFUN ("char-to-string", Fchar_to_string, Schar_to_string, 1, 1, 0,
5f75e666 133 "Convert arg CHAR to a string containing that character.")
2591ec64
EN
134 (character)
135 Lisp_Object character;
35692fe0 136{
fb8106e8 137 int len;
d11ba98c 138 unsigned char workbuf[4], *str;
fb8106e8 139
2591ec64 140 CHECK_NUMBER (character, 0);
35692fe0 141
fb8106e8 142 len = CHAR_STRING (XFASTINT (character), workbuf, str);
5f75e666 143 return make_string_from_bytes (str, 1, len);
35692fe0
JB
144}
145
146DEFUN ("string-to-char", Fstring_to_char, Sstring_to_char, 1, 1, 0,
fb8106e8
KH
147 "Convert arg STRING to a character, the first character of that string.\n\
148A multibyte character is handled correctly.")
2591ec64
EN
149 (string)
150 register Lisp_Object string;
35692fe0
JB
151{
152 register Lisp_Object val;
153 register struct Lisp_String *p;
2591ec64 154 CHECK_STRING (string, 0);
2591ec64 155 p = XSTRING (string);
35692fe0 156 if (p->size)
dc3620af 157 XSETFASTINT (val, STRING_CHAR (p->data, STRING_BYTES (p)));
35692fe0 158 else
55561c63 159 XSETFASTINT (val, 0);
35692fe0
JB
160 return val;
161}
162\f
163static Lisp_Object
ec1c14f6
RS
164buildmark (charpos, bytepos)
165 int charpos, bytepos;
35692fe0
JB
166{
167 register Lisp_Object mark;
168 mark = Fmake_marker ();
ec1c14f6 169 set_marker_both (mark, Qnil, charpos, bytepos);
35692fe0
JB
170 return mark;
171}
172
173DEFUN ("point", Fpoint, Spoint, 0, 0, 0,
174 "Return value of point, as an integer.\n\
175Beginning of buffer is position (point-min)")
176 ()
177{
178 Lisp_Object temp;
6ec8bbd2 179 XSETFASTINT (temp, PT);
35692fe0
JB
180 return temp;
181}
182
183DEFUN ("point-marker", Fpoint_marker, Spoint_marker, 0, 0, 0,
184 "Return value of point, as a marker object.")
185 ()
186{
ec1c14f6 187 return buildmark (PT, PT_BYTE);
35692fe0
JB
188}
189
190int
191clip_to_bounds (lower, num, upper)
192 int lower, num, upper;
193{
194 if (num < lower)
195 return lower;
196 else if (num > upper)
197 return upper;
198 else
199 return num;
200}
201
202DEFUN ("goto-char", Fgoto_char, Sgoto_char, 1, 1, "NGoto char: ",
203 "Set point to POSITION, a number or marker.\n\
fb8106e8
KH
204Beginning of buffer is position (point-min), end is (point-max).\n\
205If the position is in the middle of a multibyte form,\n\
206the actual point is set at the head of the multibyte form\n\
207except in the case that `enable-multibyte-characters' is nil.")
2591ec64
EN
208 (position)
209 register Lisp_Object position;
35692fe0 210{
fb8106e8
KH
211 int pos;
212 unsigned char *p;
213
72ef82ec
RS
214 if (MARKERP (position)
215 && current_buffer == XMARKER (position)->buffer)
ec1c14f6
RS
216 {
217 pos = marker_position (position);
218 if (pos < BEGV)
219 SET_PT_BOTH (BEGV, BEGV_BYTE);
220 else if (pos > ZV)
221 SET_PT_BOTH (ZV, ZV_BYTE);
222 else
223 SET_PT_BOTH (pos, marker_byte_position (position));
224
225 return position;
226 }
227
2591ec64 228 CHECK_NUMBER_COERCE_MARKER (position, 0);
35692fe0 229
fb8106e8 230 pos = clip_to_bounds (BEGV, XINT (position), ZV);
fb8106e8 231 SET_PT (pos);
2591ec64 232 return position;
35692fe0
JB
233}
234
235static Lisp_Object
236region_limit (beginningp)
237 int beginningp;
238{
646d9d18 239 extern Lisp_Object Vmark_even_if_inactive; /* Defined in callint.c. */
35692fe0 240 register Lisp_Object m;
c9dd14e1
RM
241 if (!NILP (Vtransient_mark_mode) && NILP (Vmark_even_if_inactive)
242 && NILP (current_buffer->mark_active))
243 Fsignal (Qmark_inactive, Qnil);
35692fe0 244 m = Fmarker_position (current_buffer->mark);
56a98455 245 if (NILP (m)) error ("There is no region now");
6ec8bbd2
KH
246 if ((PT < XFASTINT (m)) == beginningp)
247 return (make_number (PT));
35692fe0
JB
248 else
249 return (m);
250}
251
252DEFUN ("region-beginning", Fregion_beginning, Sregion_beginning, 0, 0, 0,
253 "Return position of beginning of region, as an integer.")
254 ()
255{
256 return (region_limit (1));
257}
258
259DEFUN ("region-end", Fregion_end, Sregion_end, 0, 0, 0,
260 "Return position of end of region, as an integer.")
261 ()
262{
263 return (region_limit (0));
264}
265
35692fe0
JB
266DEFUN ("mark-marker", Fmark_marker, Smark_marker, 0, 0, 0,
267 "Return this buffer's mark, as a marker object.\n\
268Watch out! Moving this marker changes the mark position.\n\
269If you set the marker not to point anywhere, the buffer will have no mark.")
270 ()
271{
272 return current_buffer->mark;
273}
c9ed721d
RS
274\f
275DEFUN ("line-beginning-position", Fline_beginning_position, Sline_beginning_position,
276 0, 1, 0,
277 "Return the character position of the first character on the current line.\n\
278With argument N not nil or 1, move forward N - 1 lines first.\n\
279If scan reaches end of buffer, return that position.\n\
280This function does not move point.")
281 (n)
282 Lisp_Object n;
283{
ec1c14f6 284 register int orig, orig_byte, end;
c9ed721d
RS
285
286 if (NILP (n))
287 XSETFASTINT (n, 1);
288 else
289 CHECK_NUMBER (n, 0);
290
291 orig = PT;
ec1c14f6 292 orig_byte = PT_BYTE;
c9ed721d
RS
293 Fforward_line (make_number (XINT (n) - 1));
294 end = PT;
ec1c14f6 295 SET_PT_BOTH (orig, orig_byte);
35692fe0 296
c9ed721d
RS
297 return make_number (end);
298}
299
300DEFUN ("line-end-position", Fline_end_position, Sline_end_position,
301 0, 1, 0,
302 "Return the character position of the last character on the current line.\n\
303With argument N not nil or 1, move forward N - 1 lines first.\n\
304If scan reaches end of buffer, return that position.\n\
305This function does not move point.")
306 (n)
307 Lisp_Object n;
308{
309 if (NILP (n))
310 XSETFASTINT (n, 1);
311 else
312 CHECK_NUMBER (n, 0);
313
314 return make_number (find_before_next_newline
315 (PT, 0, XINT (n) - (XINT (n) <= 0)));
316}
317\f
35692fe0
JB
318Lisp_Object
319save_excursion_save ()
320{
0e2c9c70
JB
321 register int visible = (XBUFFER (XWINDOW (selected_window)->buffer)
322 == current_buffer);
35692fe0
JB
323
324 return Fcons (Fpoint_marker (),
aea4a109 325 Fcons (Fcopy_marker (current_buffer->mark, Qnil),
9772455e
RS
326 Fcons (visible ? Qt : Qnil,
327 current_buffer->mark_active)));
35692fe0
JB
328}
329
330Lisp_Object
331save_excursion_restore (info)
4ad8681a 332 Lisp_Object info;
35692fe0 333{
4ad8681a
RS
334 Lisp_Object tem, tem1, omark, nmark;
335 struct gcpro gcpro1, gcpro2, gcpro3;
35692fe0
JB
336
337 tem = Fmarker_buffer (Fcar (info));
338 /* If buffer being returned to is now deleted, avoid error */
339 /* Otherwise could get error here while unwinding to top level
340 and crash */
341 /* In that case, Fmarker_buffer returns nil now. */
56a98455 342 if (NILP (tem))
35692fe0 343 return Qnil;
4ad8681a
RS
344
345 omark = nmark = Qnil;
346 GCPRO3 (info, omark, nmark);
347
35692fe0
JB
348 Fset_buffer (tem);
349 tem = Fcar (info);
350 Fgoto_char (tem);
351 unchain_marker (tem);
352 tem = Fcar (Fcdr (info));
03d18690 353 omark = Fmarker_position (current_buffer->mark);
35692fe0 354 Fset_marker (current_buffer->mark, tem, Fcurrent_buffer ());
03d18690 355 nmark = Fmarker_position (tem);
35692fe0
JB
356 unchain_marker (tem);
357 tem = Fcdr (Fcdr (info));
ef580991
RS
358#if 0 /* We used to make the current buffer visible in the selected window
359 if that was true previously. That avoids some anomalies.
360 But it creates others, and it wasn't documented, and it is simpler
361 and cleaner never to alter the window/buffer connections. */
9772455e
RS
362 tem1 = Fcar (tem);
363 if (!NILP (tem1)
0e2c9c70 364 && current_buffer != XBUFFER (XWINDOW (selected_window)->buffer))
35692fe0 365 Fswitch_to_buffer (Fcurrent_buffer (), Qnil);
ef580991 366#endif /* 0 */
9772455e
RS
367
368 tem1 = current_buffer->mark_active;
369 current_buffer->mark_active = Fcdr (tem);
9fed2b18
RS
370 if (!NILP (Vrun_hooks))
371 {
03d18690
RS
372 /* If mark is active now, and either was not active
373 or was at a different place, run the activate hook. */
9fed2b18 374 if (! NILP (current_buffer->mark_active))
03d18690
RS
375 {
376 if (! EQ (omark, nmark))
377 call1 (Vrun_hooks, intern ("activate-mark-hook"));
378 }
379 /* If mark has ceased to be active, run deactivate hook. */
9fed2b18
RS
380 else if (! NILP (tem1))
381 call1 (Vrun_hooks, intern ("deactivate-mark-hook"));
382 }
4ad8681a 383 UNGCPRO;
35692fe0
JB
384 return Qnil;
385}
386
387DEFUN ("save-excursion", Fsave_excursion, Ssave_excursion, 0, UNEVALLED, 0,
388 "Save point, mark, and current buffer; execute BODY; restore those things.\n\
389Executes BODY just like `progn'.\n\
390The values of point, mark and the current buffer are restored\n\
9772455e 391even in case of abnormal exit (throw or error).\n\
85cac557
RS
392The state of activation of the mark is also restored.\n\
393\n\
394This construct does not save `deactivate-mark', and therefore\n\
395functions that change the buffer will still cause deactivation\n\
396of the mark at the end of the command. To prevent that, bind\n\
397`deactivate-mark' with `let'.")
35692fe0
JB
398 (args)
399 Lisp_Object args;
400{
401 register Lisp_Object val;
402 int count = specpdl_ptr - specpdl;
403
404 record_unwind_protect (save_excursion_restore, save_excursion_save ());
4bc8c7d2
RS
405
406 val = Fprogn (args);
407 return unbind_to (count, val);
408}
409
410DEFUN ("save-current-buffer", Fsave_current_buffer, Ssave_current_buffer, 0, UNEVALLED, 0,
411 "Save the current buffer; execute BODY; restore the current buffer.\n\
412Executes BODY just like `progn'.")
413 (args)
414 Lisp_Object args;
415{
416 register Lisp_Object val;
417 int count = specpdl_ptr - specpdl;
418
cb5e5f74 419 record_unwind_protect (set_buffer_if_live, Fcurrent_buffer ());
4bc8c7d2 420
35692fe0
JB
421 val = Fprogn (args);
422 return unbind_to (count, val);
423}
424\f
425DEFUN ("buffer-size", Fbufsize, Sbufsize, 0, 0, 0,
426 "Return the number of characters in the current buffer.")
427 ()
428{
429 Lisp_Object temp;
55561c63 430 XSETFASTINT (temp, Z - BEG);
35692fe0
JB
431 return temp;
432}
433
434DEFUN ("point-min", Fpoint_min, Spoint_min, 0, 0, 0,
435 "Return the minimum permissible value of point in the current buffer.\n\
4c390850 436This is 1, unless narrowing (a buffer restriction) is in effect.")
35692fe0
JB
437 ()
438{
439 Lisp_Object temp;
55561c63 440 XSETFASTINT (temp, BEGV);
35692fe0
JB
441 return temp;
442}
443
444DEFUN ("point-min-marker", Fpoint_min_marker, Spoint_min_marker, 0, 0, 0,
445 "Return a marker to the minimum permissible value of point in this buffer.\n\
4c390850 446This is the beginning, unless narrowing (a buffer restriction) is in effect.")
35692fe0
JB
447 ()
448{
ec1c14f6 449 return buildmark (BEGV, BEGV_BYTE);
35692fe0
JB
450}
451
452DEFUN ("point-max", Fpoint_max, Spoint_max, 0, 0, 0,
453 "Return the maximum permissible value of point in the current buffer.\n\
4c390850
RS
454This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
455is in effect, in which case it is less.")
35692fe0
JB
456 ()
457{
458 Lisp_Object temp;
55561c63 459 XSETFASTINT (temp, ZV);
35692fe0
JB
460 return temp;
461}
462
463DEFUN ("point-max-marker", Fpoint_max_marker, Spoint_max_marker, 0, 0, 0,
464 "Return a marker to the maximum permissible value of point in this buffer.\n\
4c390850
RS
465This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
466is in effect, in which case it is less.")
35692fe0
JB
467 ()
468{
ec1c14f6 469 return buildmark (ZV, ZV_BYTE);
35692fe0
JB
470}
471
c86212b9
RS
472DEFUN ("gap-position", Fgap_position, Sgap_position, 0, 0, 0,
473 "Return the position of the gap, in the current buffer.\n\
474See also `gap-size'.")
475 ()
476{
477 Lisp_Object temp;
478 XSETFASTINT (temp, GPT);
479 return temp;
480}
481
482DEFUN ("gap-size", Fgap_size, Sgap_size, 0, 0, 0,
483 "Return the size of the current buffer's gap.\n\
484See also `gap-position'.")
485 ()
486{
487 Lisp_Object temp;
488 XSETFASTINT (temp, GAP_SIZE);
489 return temp;
490}
491
7df74da6 492DEFUN ("position-bytes", Fposition_bytes, Sposition_bytes, 1, 1, 0,
fcf9683e
KH
493 "Return the byte position for character position POSITION.\n\
494If POSITION is out of range, the value is nil.")
7df74da6 495 (position)
80e01f8d 496 Lisp_Object position;
7df74da6 497{
fa8a5a15 498 CHECK_NUMBER_COERCE_MARKER (position, 1);
fcf9683e
KH
499 if (XINT (position) < BEG || XINT (position) > Z)
500 return Qnil;
fa8a5a15 501 return make_number (CHAR_TO_BYTE (XINT (position)));
7df74da6 502}
3ab0732d
RS
503
504DEFUN ("byte-to-position", Fbyte_to_position, Sbyte_to_position, 1, 1, 0,
fcf9683e
KH
505 "Return the character position for byte position BYTEPOS.\n\
506If BYTEPOS is out of range, the value is nil.")
3ab0732d
RS
507 (bytepos)
508 Lisp_Object bytepos;
509{
510 CHECK_NUMBER (bytepos, 1);
fcf9683e
KH
511 if (XINT (bytepos) < BEG_BYTE || XINT (bytepos) > Z_BYTE)
512 return Qnil;
3ab0732d
RS
513 return make_number (BYTE_TO_CHAR (XINT (bytepos)));
514}
7df74da6 515\f
850a8179
JB
516DEFUN ("following-char", Ffollowing_char, Sfollowing_char, 0, 0, 0,
517 "Return the character following point, as a number.\n\
fb8106e8
KH
518At the end of the buffer or accessible region, return 0.\n\
519If `enable-multibyte-characters' is nil or point is not\n\
520 at character boundary, multibyte form is ignored,\n\
521 and only one byte following point is returned as a character.")
35692fe0
JB
522 ()
523{
524 Lisp_Object temp;
6ec8bbd2 525 if (PT >= ZV)
55561c63 526 XSETFASTINT (temp, 0);
850a8179 527 else
ec1c14f6 528 XSETFASTINT (temp, FETCH_CHAR (PT_BYTE));
35692fe0
JB
529 return temp;
530}
531
850a8179
JB
532DEFUN ("preceding-char", Fprevious_char, Sprevious_char, 0, 0, 0,
533 "Return the character preceding point, as a number.\n\
fb8106e8
KH
534At the beginning of the buffer or accessible region, return 0.\n\
535If `enable-multibyte-characters' is nil or point is not\n\
536 at character boundary, multi-byte form is ignored,\n\
537 and only one byte preceding point is returned as a character.")
35692fe0
JB
538 ()
539{
540 Lisp_Object temp;
6ec8bbd2 541 if (PT <= BEGV)
55561c63 542 XSETFASTINT (temp, 0);
fb8106e8
KH
543 else if (!NILP (current_buffer->enable_multibyte_characters))
544 {
ec1c14f6 545 int pos = PT_BYTE;
fb8106e8
KH
546 DEC_POS (pos);
547 XSETFASTINT (temp, FETCH_CHAR (pos));
548 }
35692fe0 549 else
ec1c14f6 550 XSETFASTINT (temp, FETCH_BYTE (PT_BYTE - 1));
35692fe0
JB
551 return temp;
552}
553
554DEFUN ("bobp", Fbobp, Sbobp, 0, 0, 0,
ec1c14f6 555 "Return t if point is at the beginning of the buffer.\n\
35692fe0
JB
556If the buffer is narrowed, this means the beginning of the narrowed part.")
557 ()
558{
6ec8bbd2 559 if (PT == BEGV)
35692fe0
JB
560 return Qt;
561 return Qnil;
562}
563
564DEFUN ("eobp", Feobp, Seobp, 0, 0, 0,
ec1c14f6 565 "Return t if point is at the end of the buffer.\n\
35692fe0
JB
566If the buffer is narrowed, this means the end of the narrowed part.")
567 ()
568{
6ec8bbd2 569 if (PT == ZV)
35692fe0
JB
570 return Qt;
571 return Qnil;
572}
573
574DEFUN ("bolp", Fbolp, Sbolp, 0, 0, 0,
ec1c14f6 575 "Return t if point is at the beginning of a line.")
35692fe0
JB
576 ()
577{
ec1c14f6 578 if (PT == BEGV || FETCH_BYTE (PT_BYTE - 1) == '\n')
35692fe0
JB
579 return Qt;
580 return Qnil;
581}
582
583DEFUN ("eolp", Feolp, Seolp, 0, 0, 0,
ec1c14f6 584 "Return t if point is at the end of a line.\n\
35692fe0
JB
585`End of a line' includes point being at the end of the buffer.")
586 ()
587{
ec1c14f6 588 if (PT == ZV || FETCH_BYTE (PT_BYTE) == '\n')
35692fe0
JB
589 return Qt;
590 return Qnil;
591}
592
fa1d3816 593DEFUN ("char-after", Fchar_after, Schar_after, 0, 1, 0,
35692fe0
JB
594 "Return character in current buffer at position POS.\n\
595POS is an integer or a buffer pointer.\n\
39a4c932 596If POS is out of range, the value is nil.")
35692fe0
JB
597 (pos)
598 Lisp_Object pos;
599{
ec1c14f6 600 register int pos_byte;
35692fe0 601 register Lisp_Object val;
35692fe0 602
fa1d3816 603 if (NILP (pos))
39a4c932
RS
604 {
605 pos_byte = PT_BYTE;
606 pos = PT;
607 }
608
609 if (MARKERP (pos))
85cac557
RS
610 {
611 pos_byte = marker_byte_position (pos);
612 if (pos_byte < BEGV_BYTE || pos_byte >= ZV_BYTE)
613 return Qnil;
614 }
fa1d3816
RS
615 else
616 {
617 CHECK_NUMBER_COERCE_MARKER (pos, 0);
b98ef0dc 618 if (XINT (pos) < BEGV || XINT (pos) >= ZV)
85cac557 619 return Qnil;
ec1c14f6
RS
620
621 pos_byte = CHAR_TO_BYTE (XINT (pos));
fa1d3816 622 }
35692fe0 623
ec1c14f6 624 return make_number (FETCH_CHAR (pos_byte));
35692fe0 625}
fb8106e8 626
fa1d3816 627DEFUN ("char-before", Fchar_before, Schar_before, 0, 1, 0,
fb8106e8
KH
628 "Return character in current buffer preceding position POS.\n\
629POS is an integer or a buffer pointer.\n\
39a4c932 630If POS is out of range, the value is nil.")
fb8106e8
KH
631 (pos)
632 Lisp_Object pos;
633{
634 register Lisp_Object val;
ec1c14f6 635 register int pos_byte;
fb8106e8 636
fa1d3816 637 if (NILP (pos))
39a4c932
RS
638 {
639 pos_byte = PT_BYTE;
640 pos = PT;
641 }
642
643 if (MARKERP (pos))
85cac557
RS
644 {
645 pos_byte = marker_byte_position (pos);
646
647 if (pos_byte <= BEGV_BYTE || pos_byte > ZV_BYTE)
648 return Qnil;
649 }
fa1d3816
RS
650 else
651 {
652 CHECK_NUMBER_COERCE_MARKER (pos, 0);
fb8106e8 653
b98ef0dc 654 if (XINT (pos) <= BEGV || XINT (pos) > ZV)
85cac557
RS
655 return Qnil;
656
ec1c14f6 657 pos_byte = CHAR_TO_BYTE (XINT (pos));
fa1d3816 658 }
fb8106e8
KH
659
660 if (!NILP (current_buffer->enable_multibyte_characters))
661 {
ec1c14f6
RS
662 DEC_POS (pos_byte);
663 XSETFASTINT (val, FETCH_CHAR (pos_byte));
fb8106e8
KH
664 }
665 else
666 {
ec1c14f6
RS
667 pos_byte--;
668 XSETFASTINT (val, FETCH_BYTE (pos_byte));
fb8106e8
KH
669 }
670 return val;
671}
35692fe0 672\f
87485d6f 673DEFUN ("user-login-name", Fuser_login_name, Suser_login_name, 0, 1, 0,
35692fe0
JB
674 "Return the name under which the user logged in, as a string.\n\
675This is based on the effective uid, not the real uid.\n\
2c9ae24e 676Also, if the environment variable LOGNAME or USER is set,\n\
87485d6f
MW
677that determines the value of this function.\n\n\
678If optional argument UID is an integer, return the login name of the user\n\
679with that uid, or nil if there is no such user.")
680 (uid)
681 Lisp_Object uid;
35692fe0 682{
87485d6f
MW
683 struct passwd *pw;
684
f8a0e364
RS
685 /* Set up the user name info if we didn't do it before.
686 (That can happen if Emacs is dumpable
687 but you decide to run `temacs -l loadup' and not dump. */
35b34f72 688 if (INTEGERP (Vuser_login_name))
f8a0e364 689 init_editfns ();
87485d6f
MW
690
691 if (NILP (uid))
35b34f72 692 return Vuser_login_name;
87485d6f
MW
693
694 CHECK_NUMBER (uid, 0);
695 pw = (struct passwd *) getpwuid (XINT (uid));
696 return (pw ? build_string (pw->pw_name) : Qnil);
35692fe0
JB
697}
698
699DEFUN ("user-real-login-name", Fuser_real_login_name, Suser_real_login_name,
700 0, 0, 0,
701 "Return the name of the user's real uid, as a string.\n\
9658bdd0 702This ignores the environment variables LOGNAME and USER, so it differs from\n\
b1da234a 703`user-login-name' when running under `su'.")
35692fe0
JB
704 ()
705{
f8a0e364
RS
706 /* Set up the user name info if we didn't do it before.
707 (That can happen if Emacs is dumpable
708 but you decide to run `temacs -l loadup' and not dump. */
35b34f72 709 if (INTEGERP (Vuser_login_name))
f8a0e364 710 init_editfns ();
35b34f72 711 return Vuser_real_login_name;
35692fe0
JB
712}
713
714DEFUN ("user-uid", Fuser_uid, Suser_uid, 0, 0, 0,
715 "Return the effective uid of Emacs, as an integer.")
716 ()
717{
718 return make_number (geteuid ());
719}
720
721DEFUN ("user-real-uid", Fuser_real_uid, Suser_real_uid, 0, 0, 0,
722 "Return the real uid of Emacs, as an integer.")
723 ()
724{
725 return make_number (getuid ());
726}
727
c9ed721d
RS
728DEFUN ("user-full-name", Fuser_full_name, Suser_full_name, 0, 1, 0,
729 "Return the full name of the user logged in, as a string.\n\
730If optional argument UID is an integer, return the full name of the user\n\
ca38bbb2 731with that uid, or \"unknown\" if there is no such user.\n\
3415b0e9
RS
732If UID is a string, return the full name of the user with that login\n\
733name, or \"unknown\" if no such user could be found.")
c9ed721d
RS
734 (uid)
735 Lisp_Object uid;
35692fe0 736{
c9ed721d 737 struct passwd *pw;
b0e92acd 738 register unsigned char *p, *q;
3415b0e9
RS
739 extern char *index ();
740 Lisp_Object full;
c9ed721d
RS
741
742 if (NILP (uid))
3415b0e9
RS
743 return Vuser_full_name;
744 else if (NUMBERP (uid))
745 pw = (struct passwd *) getpwuid (XINT (uid));
746 else if (STRINGP (uid))
747 pw = (struct passwd *) getpwnam (XSTRING (uid)->data);
748 else
749 error ("Invalid UID specification");
c9ed721d 750
3415b0e9 751 if (!pw)
3347526c 752 return Qnil;
3415b0e9
RS
753
754 p = (unsigned char *) USER_FULL_NAME;
755 /* Chop off everything after the first comma. */
756 q = (unsigned char *) index (p, ',');
757 full = make_string (p, q ? q - p : strlen (p));
758
759#ifdef AMPERSAND_FULL_NAME
760 p = XSTRING (full)->data;
761 q = (unsigned char *) index (p, '&');
762 /* Substitute the login name for the &, upcasing the first character. */
763 if (q)
764 {
b0e92acd 765 register unsigned char *r;
3415b0e9
RS
766 Lisp_Object login;
767
768 login = Fuser_login_name (make_number (pw->pw_uid));
769 r = (unsigned char *) alloca (strlen (p) + XSTRING (login)->size + 1);
770 bcopy (p, r, q - p);
771 r[q - p] = 0;
772 strcat (r, XSTRING (login)->data);
773 r[q - p] = UPCASE (r[q - p]);
774 strcat (r, q + 1);
775 full = build_string (r);
776 }
777#endif /* AMPERSAND_FULL_NAME */
778
779 return full;
35692fe0
JB
780}
781
782DEFUN ("system-name", Fsystem_name, Ssystem_name, 0, 0, 0,
783 "Return the name of the machine you are running on, as a string.")
784 ()
785{
786 return Vsystem_name;
787}
788
ac988277
KH
789/* For the benefit of callers who don't want to include lisp.h */
790char *
791get_system_name ()
792{
3d976a9a
RS
793 if (STRINGP (Vsystem_name))
794 return (char *) XSTRING (Vsystem_name)->data;
795 else
796 return "";
ac988277
KH
797}
798
7fd233b3
RS
799DEFUN ("emacs-pid", Femacs_pid, Semacs_pid, 0, 0, 0,
800 "Return the process ID of Emacs, as an integer.")
801 ()
802{
803 return make_number (getpid ());
804}
805
d940e0e4 806DEFUN ("current-time", Fcurrent_time, Scurrent_time, 0, 0, 0,
e983fdb2 807 "Return the current time, as the number of seconds since 1970-01-01 00:00:00.\n\
956ace37
JB
808The time is returned as a list of three integers. The first has the\n\
809most significant 16 bits of the seconds, while the second has the\n\
810least significant 16 bits. The third integer gives the microsecond\n\
811count.\n\
812\n\
813The microsecond count is zero on systems that do not provide\n\
814resolution finer than a second.")
d940e0e4
JB
815 ()
816{
956ace37
JB
817 EMACS_TIME t;
818 Lisp_Object result[3];
819
820 EMACS_GET_TIME (t);
d2fd0445
KH
821 XSETINT (result[0], (EMACS_SECS (t) >> 16) & 0xffff);
822 XSETINT (result[1], (EMACS_SECS (t) >> 0) & 0xffff);
823 XSETINT (result[2], EMACS_USECS (t));
956ace37
JB
824
825 return Flist (3, result);
d940e0e4
JB
826}
827\f
828
e3120ab5
JB
829static int
830lisp_time_argument (specified_time, result)
831 Lisp_Object specified_time;
832 time_t *result;
833{
834 if (NILP (specified_time))
835 return time (result) != -1;
836 else
837 {
838 Lisp_Object high, low;
839 high = Fcar (specified_time);
840 CHECK_NUMBER (high, 0);
841 low = Fcdr (specified_time);
ae683129 842 if (CONSP (low))
e3120ab5
JB
843 low = Fcar (low);
844 CHECK_NUMBER (low, 0);
845 *result = (XINT (high) << 16) + (XINT (low) & 0xffff);
846 return *result >> 16 == XINT (high);
847 }
848}
849
3efcc98a 850/*
b48382a0
RS
851DEFUN ("format-time-string", Fformat_time_string, Sformat_time_string, 1, 3, 0,
852 "Use FORMAT-STRING to format the time TIME, or now if omitted.\n\
853TIME is specified as (HIGH LOW . IGNORED) or (HIGH . LOW), as returned by\n\
854`current-time' or `file-attributes'.\n\
855The third, optional, argument UNIVERSAL, if non-nil, means describe TIME\n\
856as Universal Time; nil means describe TIME in the local time zone.\n\
857The value is a copy of FORMAT-STRING, but with certain constructs replaced\n\
858by text that describes the specified date and time in TIME:\n\
a82d387c 859\n\
b48382a0
RS
860%Y is the year, %y within the century, %C the century.\n\
861%G is the year corresponding to the ISO week, %g within the century.\n\
b771d0da
PE
862%m is the numeric month.\n\
863%b and %h are the locale's abbreviated month name, %B the full name.\n\
b48382a0
RS
864%d is the day of the month, zero-padded, %e is blank-padded.\n\
865%u is the numeric day of week from 1 (Monday) to 7, %w from 0 (Sunday) to 6.\n\
b771d0da 866%a is the locale's abbreviated name of the day of week, %A the full name.\n\
b48382a0
RS
867%U is the week number starting on Sunday, %W starting on Monday,\n\
868 %V according to ISO 8601.\n\
869%j is the day of the year.\n\
870\n\
871%H is the hour on a 24-hour clock, %I is on a 12-hour clock, %k is like %H\n\
872 only blank-padded, %l is like %I blank-padded.\n\
b771d0da 873%p is the locale's equivalent of either AM or PM.\n\
b48382a0
RS
874%M is the minute.\n\
875%S is the second.\n\
876%Z is the time zone name, %z is the numeric form.\n\
877%s is the number of seconds since 1970-01-01 00:00:00 +0000.\n\
878\n\
879%c is the locale's date and time format.\n\
880%x is the locale's \"preferred\" date format.\n\
881%D is like \"%m/%d/%y\".\n\
882\n\
883%R is like \"%H:%M\", %T is like \"%H:%M:%S\", %r is like \"%I:%M:%S %p\".\n\
884%X is the locale's \"preferred\" time format.\n\
885\n\
b771d0da 886Finally, %n is a newline, %t is a tab, %% is a literal %.\n\
b48382a0 887\n\
3efcc98a 888Certain flags and modifiers are available with some format controls.\n\
b48382a0
RS
889The flags are `_' and `-'. For certain characters X, %_X is like %X,\n\
890but padded with blanks; %-X is like %X, but without padding.\n\
891%NX (where N stands for an integer) is like %X,\n\
892but takes up at least N (a number) positions.\n\
893The modifiers are `E' and `O'. For certain characters X,\n\
894%EX is a locale's alternative version of %X;\n\
895%OX is like %X, but uses the locale's number symbols.\n\
896\n\
897For example, to produce full ISO 8601 format, use \"%Y-%m-%dT%T%z\".")
726ed0da 898 (format_string, time, universal)
3efcc98a
RS
899*/
900
901DEFUN ("format-time-string", Fformat_time_string, Sformat_time_string, 1, 3, 0,
902 0 /* See immediately above */)
b48382a0
RS
903 (format_string, time, universal)
904 Lisp_Object format_string, time, universal;
a82d387c
RS
905{
906 time_t value;
907 int size;
177ea5f1 908 struct tm *tm;
a82d387c
RS
909
910 CHECK_STRING (format_string, 1);
911
912 if (! lisp_time_argument (time, &value))
913 error ("Invalid time specification");
914
915 /* This is probably enough. */
dc3620af 916 size = STRING_BYTES (XSTRING (format_string)) * 6 + 50;
a82d387c 917
177ea5f1
PE
918 tm = NILP (universal) ? localtime (&value) : gmtime (&value);
919 if (! tm)
920 error ("Specified time is not representable");
921
a82d387c
RS
922 while (1)
923 {
b48382a0
RS
924 char *buf = (char *) alloca (size + 1);
925 int result;
926
bfbcc5ee 927 buf[0] = '\1';
b48382a0 928 result = emacs_strftime (buf, size, XSTRING (format_string)->data,
177ea5f1 929 tm);
bfbcc5ee 930 if ((result > 0 && result < size) || (result == 0 && buf[0] == '\0'))
a82d387c 931 return build_string (buf);
b48382a0
RS
932
933 /* If buffer was too small, make it bigger and try again. */
bfbcc5ee 934 result = emacs_strftime (NULL, 0x7fffffff, XSTRING (format_string)->data,
177ea5f1 935 tm);
b48382a0 936 size = result + 1;
a82d387c
RS
937 }
938}
939
4691c06d
RS
940DEFUN ("decode-time", Fdecode_time, Sdecode_time, 0, 1, 0,
941 "Decode a time value as (SEC MINUTE HOUR DAY MONTH YEAR DOW DST ZONE).\n\
942The optional SPECIFIED-TIME should be a list of (HIGH LOW . IGNORED)\n\
943or (HIGH . LOW), as from `current-time' and `file-attributes', or `nil'\n\
944to use the current time. The list has the following nine members:\n\
145b0681
RS
945SEC is an integer between 0 and 60; SEC is 60 for a leap second, which\n\
946only some operating systems support. MINUTE is an integer between 0 and 59.\n\
4691c06d
RS
947HOUR is an integer between 0 and 23. DAY is an integer between 1 and 31.\n\
948MONTH is an integer between 1 and 12. YEAR is an integer indicating the\n\
949four-digit year. DOW is the day of week, an integer between 0 and 6, where\n\
9500 is Sunday. DST is t if daylight savings time is effect, otherwise nil.\n\
951ZONE is an integer indicating the number of seconds east of Greenwich.\n\
2c6c7c72 952\(Note that Common Lisp has different meanings for DOW and ZONE.)")
4691c06d
RS
953 (specified_time)
954 Lisp_Object specified_time;
955{
956 time_t time_spec;
3c887943 957 struct tm save_tm;
4691c06d
RS
958 struct tm *decoded_time;
959 Lisp_Object list_args[9];
960
961 if (! lisp_time_argument (specified_time, &time_spec))
962 error ("Invalid time specification");
963
964 decoded_time = localtime (&time_spec);
177ea5f1
PE
965 if (! decoded_time)
966 error ("Specified time is not representable");
3c887943
KH
967 XSETFASTINT (list_args[0], decoded_time->tm_sec);
968 XSETFASTINT (list_args[1], decoded_time->tm_min);
969 XSETFASTINT (list_args[2], decoded_time->tm_hour);
970 XSETFASTINT (list_args[3], decoded_time->tm_mday);
971 XSETFASTINT (list_args[4], decoded_time->tm_mon + 1);
236ebf35 972 XSETINT (list_args[5], decoded_time->tm_year + 1900);
3c887943 973 XSETFASTINT (list_args[6], decoded_time->tm_wday);
4691c06d 974 list_args[7] = (decoded_time->tm_isdst)? Qt : Qnil;
3c887943
KH
975
976 /* Make a copy, in case gmtime modifies the struct. */
977 save_tm = *decoded_time;
978 decoded_time = gmtime (&time_spec);
979 if (decoded_time == 0)
980 list_args[8] = Qnil;
981 else
94751666 982 XSETINT (list_args[8], tm_diff (&save_tm, decoded_time));
4691c06d
RS
983 return Flist (9, list_args);
984}
985
6ee9061c 986DEFUN ("encode-time", Fencode_time, Sencode_time, 6, MANY, 0,
2591ec64 987 "Convert SECOND, MINUTE, HOUR, DAY, MONTH, YEAR and ZONE to internal time.\n\
6ee9061c
RS
988This is the reverse operation of `decode-time', which see.\n\
989ZONE defaults to the current time zone rule. This can\n\
085e9fcb 990be a string or t (as from `set-time-zone-rule'), or it can be a list\n\
7459d65b 991\(as from `current-time-zone') or an integer (as from `decode-time')\n\
c59b5089 992applied without consideration for daylight savings time.\n\
6ee9061c
RS
993\n\
994You can pass more than 7 arguments; then the first six arguments\n\
995are used as SECOND through YEAR, and the *last* argument is used as ZONE.\n\
996The intervening arguments are ignored.\n\
997This feature lets (apply 'encode-time (decode-time ...)) work.\n\
998\n\
c59b5089
PE
999Out-of-range values for SEC, MINUTE, HOUR, DAY, or MONTH are allowed;\n\
1000for example, a DAY of 0 means the day preceding the given month.\n\
01ba8cce 1001Year numbers less than 100 are treated just like other year numbers.\n\
c59b5089 1002If you want them to stand for years in this century, you must do that yourself.")
6ee9061c
RS
1003 (nargs, args)
1004 int nargs;
1005 register Lisp_Object *args;
cce7b8a0 1006{
1b8fa736 1007 time_t time;
c59b5089 1008 struct tm tm;
60653898 1009 Lisp_Object zone = (nargs > 6 ? args[nargs - 1] : Qnil);
6ee9061c
RS
1010
1011 CHECK_NUMBER (args[0], 0); /* second */
1012 CHECK_NUMBER (args[1], 1); /* minute */
1013 CHECK_NUMBER (args[2], 2); /* hour */
1014 CHECK_NUMBER (args[3], 3); /* day */
1015 CHECK_NUMBER (args[4], 4); /* month */
1016 CHECK_NUMBER (args[5], 5); /* year */
1017
1018 tm.tm_sec = XINT (args[0]);
1019 tm.tm_min = XINT (args[1]);
1020 tm.tm_hour = XINT (args[2]);
1021 tm.tm_mday = XINT (args[3]);
1022 tm.tm_mon = XINT (args[4]) - 1;
1023 tm.tm_year = XINT (args[5]) - 1900;
c59b5089
PE
1024 tm.tm_isdst = -1;
1025
1026 if (CONSP (zone))
1027 zone = Fcar (zone);
1b8fa736 1028 if (NILP (zone))
c59b5089
PE
1029 time = mktime (&tm);
1030 else
1b8fa736 1031 {
c59b5089
PE
1032 char tzbuf[100];
1033 char *tzstring;
1034 char **oldenv = environ, **newenv;
1035
2e34157c 1036 if (EQ (zone, Qt))
085e9fcb
EN
1037 tzstring = "UTC0";
1038 else if (STRINGP (zone))
4d4c1514 1039 tzstring = (char *) XSTRING (zone)->data;
c59b5089 1040 else if (INTEGERP (zone))
1b8fa736 1041 {
c59b5089
PE
1042 int abszone = abs (XINT (zone));
1043 sprintf (tzbuf, "XXX%s%d:%02d:%02d", "-" + (XINT (zone) < 0),
1044 abszone / (60*60), (abszone/60) % 60, abszone % 60);
1045 tzstring = tzbuf;
1b8fa736 1046 }
c59b5089
PE
1047 else
1048 error ("Invalid time zone specification");
1049
1050 /* Set TZ before calling mktime; merely adjusting mktime's returned
1051 value doesn't suffice, since that would mishandle leap seconds. */
1052 set_time_zone_rule (tzstring);
1053
1054 time = mktime (&tm);
1055
1056 /* Restore TZ to previous value. */
1057 newenv = environ;
1058 environ = oldenv;
c0efcacf 1059 xfree (newenv);
c59b5089
PE
1060#ifdef LOCALTIME_CACHE
1061 tzset ();
1062#endif
1b8fa736 1063 }
1b8fa736 1064
c59b5089
PE
1065 if (time == (time_t) -1)
1066 error ("Specified time is not representable");
1067
1068 return make_time (time);
cce7b8a0
RS
1069}
1070
2148f2b4 1071DEFUN ("current-time-string", Fcurrent_time_string, Scurrent_time_string, 0, 1, 0,
35692fe0 1072 "Return the current time, as a human-readable string.\n\
2148f2b4
RS
1073Programs can use this function to decode a time,\n\
1074since the number of columns in each field is fixed.\n\
1075The format is `Sun Sep 16 01:03:52 1973'.\n\
7a8630da
RS
1076However, see also the functions `decode-time' and `format-time-string'\n\
1077which provide a much more powerful and general facility.\n\
1078\n\
2148f2b4
RS
1079If an argument is given, it specifies a time to format\n\
1080instead of the current time. The argument should have the form:\n\
1081 (HIGH . LOW)\n\
1082or the form:\n\
1083 (HIGH LOW . IGNORED).\n\
1084Thus, you can use times obtained from `current-time'\n\
1085and from `file-attributes'.")
1086 (specified_time)
1087 Lisp_Object specified_time;
1088{
e3120ab5 1089 time_t value;
35692fe0 1090 char buf[30];
2148f2b4
RS
1091 register char *tem;
1092
e3120ab5
JB
1093 if (! lisp_time_argument (specified_time, &value))
1094 value = -1;
2148f2b4 1095 tem = (char *) ctime (&value);
35692fe0
JB
1096
1097 strncpy (buf, tem, 24);
1098 buf[24] = 0;
1099
1100 return build_string (buf);
1101}
c2662aea 1102
94751666 1103#define TM_YEAR_BASE 1900
e3120ab5 1104
94751666
PE
1105/* Yield A - B, measured in seconds.
1106 This function is copied from the GNU C Library. */
1107static int
1108tm_diff (a, b)
e3120ab5
JB
1109 struct tm *a, *b;
1110{
94751666
PE
1111 /* Compute intervening leap days correctly even if year is negative.
1112 Take care to avoid int overflow in leap day calculations,
1113 but it's OK to assume that A and B are close to each other. */
1114 int a4 = (a->tm_year >> 2) + (TM_YEAR_BASE >> 2) - ! (a->tm_year & 3);
1115 int b4 = (b->tm_year >> 2) + (TM_YEAR_BASE >> 2) - ! (b->tm_year & 3);
1116 int a100 = a4 / 25 - (a4 % 25 < 0);
1117 int b100 = b4 / 25 - (b4 % 25 < 0);
1118 int a400 = a100 >> 2;
1119 int b400 = b100 >> 2;
1120 int intervening_leap_days = (a4 - b4) - (a100 - b100) + (a400 - b400);
1121 int years = a->tm_year - b->tm_year;
1122 int days = (365 * years + intervening_leap_days
1123 + (a->tm_yday - b->tm_yday));
1124 return (60 * (60 * (24 * days + (a->tm_hour - b->tm_hour))
1125 + (a->tm_min - b->tm_min))
8e718b4e 1126 + (a->tm_sec - b->tm_sec));
e3120ab5
JB
1127}
1128
1129DEFUN ("current-time-zone", Fcurrent_time_zone, Scurrent_time_zone, 0, 1, 0,
1130 "Return the offset and name for the local time zone.\n\
1131This returns a list of the form (OFFSET NAME).\n\
1132OFFSET is an integer number of seconds ahead of UTC (east of Greenwich).\n\
1133 A negative value means west of Greenwich.\n\
1134NAME is a string giving the name of the time zone.\n\
1135If an argument is given, it specifies when the time zone offset is determined\n\
1136instead of using the current time. The argument should have the form:\n\
1137 (HIGH . LOW)\n\
1138or the form:\n\
1139 (HIGH LOW . IGNORED).\n\
1140Thus, you can use times obtained from `current-time'\n\
1141and from `file-attributes'.\n\
773c1fd3
JB
1142\n\
1143Some operating systems cannot provide all this information to Emacs;\n\
2d88f747 1144in this case, `current-time-zone' returns a list containing nil for\n\
773c1fd3 1145the data it can't find.")
e3120ab5
JB
1146 (specified_time)
1147 Lisp_Object specified_time;
c2662aea 1148{
e3120ab5
JB
1149 time_t value;
1150 struct tm *t;
177ea5f1 1151 struct tm gmt;
c2662aea 1152
e3120ab5 1153 if (lisp_time_argument (specified_time, &value)
177ea5f1
PE
1154 && (t = gmtime (&value)) != 0
1155 && (gmt = *t, t = localtime (&value)) != 0)
e3120ab5 1156 {
177ea5f1
PE
1157 int offset = tm_diff (t, &gmt);
1158 char *s = 0;
1159 char buf[6];
e3120ab5
JB
1160#ifdef HAVE_TM_ZONE
1161 if (t->tm_zone)
5fd4de15 1162 s = (char *)t->tm_zone;
a7971c39
RS
1163#else /* not HAVE_TM_ZONE */
1164#ifdef HAVE_TZNAME
1165 if (t->tm_isdst == 0 || t->tm_isdst == 1)
1166 s = tzname[t->tm_isdst];
c2662aea 1167#endif
a7971c39 1168#endif /* not HAVE_TM_ZONE */
e3120ab5
JB
1169 if (!s)
1170 {
1171 /* No local time zone name is available; use "+-NNNN" instead. */
00fc94d0 1172 int am = (offset < 0 ? -offset : offset) / 60;
e3120ab5
JB
1173 sprintf (buf, "%c%02d%02d", (offset < 0 ? '-' : '+'), am/60, am%60);
1174 s = buf;
1175 }
1176 return Fcons (make_number (offset), Fcons (build_string (s), Qnil));
1177 }
1178 else
09dbcf71 1179 return Fmake_list (make_number (2), Qnil);
c2662aea
JB
1180}
1181
260e2e2a
KH
1182/* This holds the value of `environ' produced by the previous
1183 call to Fset_time_zone_rule, or 0 if Fset_time_zone_rule
1184 has never been called. */
1185static char **environbuf;
1186
143cb9a9
RS
1187DEFUN ("set-time-zone-rule", Fset_time_zone_rule, Sset_time_zone_rule, 1, 1, 0,
1188 "Set the local time zone using TZ, a string specifying a time zone rule.\n\
085e9fcb
EN
1189If TZ is nil, use implementation-defined default time zone information.\n\
1190If TZ is t, use Universal Time.")
143cb9a9
RS
1191 (tz)
1192 Lisp_Object tz;
1193{
143cb9a9
RS
1194 char *tzstring;
1195
1196 if (NILP (tz))
1197 tzstring = 0;
2e34157c 1198 else if (EQ (tz, Qt))
085e9fcb 1199 tzstring = "UTC0";
143cb9a9
RS
1200 else
1201 {
1202 CHECK_STRING (tz, 0);
4d4c1514 1203 tzstring = (char *) XSTRING (tz)->data;
143cb9a9
RS
1204 }
1205
c59b5089
PE
1206 set_time_zone_rule (tzstring);
1207 if (environbuf)
1208 free (environbuf);
1209 environbuf = environ;
1210
1211 return Qnil;
1212}
1213
e0bf9faf
PE
1214#ifdef LOCALTIME_CACHE
1215
1216/* These two values are known to load tz files in buggy implementations,
1217 i.e. Solaris 1 executables running under either Solaris 1 or Solaris 2.
1155c453
RS
1218 Their values shouldn't matter in non-buggy implementations.
1219 We don't use string literals for these strings,
1220 since if a string in the environment is in readonly
1221 storage, it runs afoul of bugs in SVR4 and Solaris 2.3.
1222 See Sun bugs 1113095 and 1114114, ``Timezone routines
1223 improperly modify environment''. */
1224
e0bf9faf
PE
1225static char set_time_zone_rule_tz1[] = "TZ=GMT+0";
1226static char set_time_zone_rule_tz2[] = "TZ=GMT+1";
1227
1228#endif
1155c453 1229
c59b5089
PE
1230/* Set the local time zone rule to TZSTRING.
1231 This allocates memory into `environ', which it is the caller's
1232 responsibility to free. */
a92ae0ce 1233void
c59b5089
PE
1234set_time_zone_rule (tzstring)
1235 char *tzstring;
1236{
1237 int envptrs;
1238 char **from, **to, **newenv;
1239
aafe5147 1240 /* Make the ENVIRON vector longer with room for TZSTRING. */
143cb9a9
RS
1241 for (from = environ; *from; from++)
1242 continue;
1243 envptrs = from - environ + 2;
1244 newenv = to = (char **) xmalloc (envptrs * sizeof (char *)
1245 + (tzstring ? strlen (tzstring) + 4 : 0));
aafe5147
RS
1246
1247 /* Add TZSTRING to the end of environ, as a value for TZ. */
143cb9a9
RS
1248 if (tzstring)
1249 {
1250 char *t = (char *) (to + envptrs);
1251 strcpy (t, "TZ=");
1252 strcat (t, tzstring);
1253 *to++ = t;
1254 }
1255
aafe5147
RS
1256 /* Copy the old environ vector elements into NEWENV,
1257 but don't copy the TZ variable.
1258 So we have only one definition of TZ, which came from TZSTRING. */
143cb9a9
RS
1259 for (from = environ; *from; from++)
1260 if (strncmp (*from, "TZ=", 3) != 0)
1261 *to++ = *from;
1262 *to = 0;
1263
1264 environ = newenv;
143cb9a9 1265
aafe5147
RS
1266 /* If we do have a TZSTRING, NEWENV points to the vector slot where
1267 the TZ variable is stored. If we do not have a TZSTRING,
1268 TO points to the vector slot which has the terminating null. */
1269
143cb9a9 1270#ifdef LOCALTIME_CACHE
aafe5147
RS
1271 {
1272 /* In SunOS 4.1.3_U1 and 4.1.4, if TZ has a value like
1273 "US/Pacific" that loads a tz file, then changes to a value like
1274 "XXX0" that does not load a tz file, and then changes back to
1275 its original value, the last change is (incorrectly) ignored.
1276 Also, if TZ changes twice in succession to values that do
1277 not load a tz file, tzset can dump core (see Sun bug#1225179).
1278 The following code works around these bugs. */
1279
aafe5147
RS
1280 if (tzstring)
1281 {
1282 /* Temporarily set TZ to a value that loads a tz file
1283 and that differs from tzstring. */
1284 char *tz = *newenv;
1155c453
RS
1285 *newenv = (strcmp (tzstring, set_time_zone_rule_tz1 + 3) == 0
1286 ? set_time_zone_rule_tz2 : set_time_zone_rule_tz1);
aafe5147
RS
1287 tzset ();
1288 *newenv = tz;
1289 }
1290 else
1291 {
1292 /* The implied tzstring is unknown, so temporarily set TZ to
1293 two different values that each load a tz file. */
1155c453 1294 *to = set_time_zone_rule_tz1;
aafe5147
RS
1295 to[1] = 0;
1296 tzset ();
1155c453 1297 *to = set_time_zone_rule_tz2;
aafe5147
RS
1298 tzset ();
1299 *to = 0;
1300 }
1301
1302 /* Now TZ has the desired value, and tzset can be invoked safely. */
1303 }
1304
143cb9a9
RS
1305 tzset ();
1306#endif
143cb9a9 1307}
35692fe0 1308\f
fb8106e8
KH
1309/* Insert NARGS Lisp objects in the array ARGS by calling INSERT_FUNC
1310 (if a type of object is Lisp_Int) or INSERT_FROM_STRING_FUNC (if a
1311 type of object is Lisp_String). INHERIT is passed to
1312 INSERT_FROM_STRING_FUNC as the last argument. */
1313
d11ba98c 1314void
fb8106e8
KH
1315general_insert_function (insert_func, insert_from_string_func,
1316 inherit, nargs, args)
d11ba98c 1317 void (*insert_func) P_ ((unsigned char *, int));
1f24f4fd 1318 void (*insert_from_string_func) P_ ((Lisp_Object, int, int, int, int, int));
fb8106e8
KH
1319 int inherit, nargs;
1320 register Lisp_Object *args;
1321{
1322 register int argnum;
1323 register Lisp_Object val;
1324
1325 for (argnum = 0; argnum < nargs; argnum++)
1326 {
1327 val = args[argnum];
1328 retry:
1329 if (INTEGERP (val))
1330 {
d11ba98c 1331 unsigned char workbuf[4], *str;
fb8106e8
KH
1332 int len;
1333
1334 if (!NILP (current_buffer->enable_multibyte_characters))
1335 len = CHAR_STRING (XFASTINT (val), workbuf, str);
1336 else
13c148b8
KH
1337 {
1338 workbuf[0] = (SINGLE_BYTE_CHAR_P (XINT (val))
1339 ? XINT (val)
1340 : multibyte_char_to_unibyte (XINT (val), Qnil));
1341 str = workbuf;
1342 len = 1;
1343 }
fb8106e8
KH
1344 (*insert_func) (str, len);
1345 }
1346 else if (STRINGP (val))
1347 {
1f24f4fd
RS
1348 (*insert_from_string_func) (val, 0, 0,
1349 XSTRING (val)->size,
dc3620af 1350 STRING_BYTES (XSTRING (val)),
1f24f4fd 1351 inherit);
fb8106e8
KH
1352 }
1353 else
1354 {
1355 val = wrong_type_argument (Qchar_or_string_p, val);
1356 goto retry;
1357 }
1358 }
1359}
1360
35692fe0
JB
1361void
1362insert1 (arg)
1363 Lisp_Object arg;
1364{
1365 Finsert (1, &arg);
1366}
1367
52b14ac0
JB
1368
1369/* Callers passing one argument to Finsert need not gcpro the
1370 argument "array", since the only element of the array will
1371 not be used after calling insert or insert_from_string, so
1372 we don't care if it gets trashed. */
1373
35692fe0
JB
1374DEFUN ("insert", Finsert, Sinsert, 0, MANY, 0,
1375 "Insert the arguments, either strings or characters, at point.\n\
24d6bf26 1376Point and before-insertion markers move forward to end up\n\
fb8106e8 1377 after the inserted text.\n\
24d6bf26
RS
1378Any other markers at the point of insertion remain before the text.\n\
1379\n\
1380If the current buffer is multibyte, unibyte strings are converted\n\
1381to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
13903932 1382If the current buffer is unibyte, multibyte strings are converted\n\
24d6bf26 1383to unibyte for insertion.")
35692fe0
JB
1384 (nargs, args)
1385 int nargs;
1386 register Lisp_Object *args;
1387{
fb8106e8 1388 general_insert_function (insert, insert_from_string, 0, nargs, args);
be91036a
RS
1389 return Qnil;
1390}
1391
1392DEFUN ("insert-and-inherit", Finsert_and_inherit, Sinsert_and_inherit,
1393 0, MANY, 0,
1394 "Insert the arguments at point, inheriting properties from adjoining text.\n\
24d6bf26 1395Point and before-insertion markers move forward to end up\n\
fb8106e8 1396 after the inserted text.\n\
24d6bf26
RS
1397Any other markers at the point of insertion remain before the text.\n\
1398\n\
1399If the current buffer is multibyte, unibyte strings are converted\n\
1400to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
13903932 1401If the current buffer is unibyte, multibyte strings are converted\n\
24d6bf26 1402to unibyte for insertion.")
be91036a
RS
1403 (nargs, args)
1404 int nargs;
1405 register Lisp_Object *args;
1406{
fb8106e8
KH
1407 general_insert_function (insert_and_inherit, insert_from_string, 1,
1408 nargs, args);
35692fe0
JB
1409 return Qnil;
1410}
1411
1412DEFUN ("insert-before-markers", Finsert_before_markers, Sinsert_before_markers, 0, MANY, 0,
1413 "Insert strings or characters at point, relocating markers after the text.\n\
24d6bf26
RS
1414Point and markers move forward to end up after the inserted text.\n\
1415\n\
1416If the current buffer is multibyte, unibyte strings are converted\n\
1417to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
13903932 1418If the current buffer is unibyte, multibyte strings are converted\n\
24d6bf26 1419to unibyte for insertion.")
35692fe0
JB
1420 (nargs, args)
1421 int nargs;
1422 register Lisp_Object *args;
1423{
fb8106e8
KH
1424 general_insert_function (insert_before_markers,
1425 insert_from_string_before_markers, 0,
1426 nargs, args);
be91036a
RS
1427 return Qnil;
1428}
1429
a0d76c27
EN
1430DEFUN ("insert-before-markers-and-inherit", Finsert_and_inherit_before_markers,
1431 Sinsert_and_inherit_before_markers, 0, MANY, 0,
be91036a 1432 "Insert text at point, relocating markers and inheriting properties.\n\
24d6bf26
RS
1433Point and markers move forward to end up after the inserted text.\n\
1434\n\
1435If the current buffer is multibyte, unibyte strings are converted\n\
1436to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
13903932 1437If the current buffer is unibyte, multibyte strings are converted\n\
24d6bf26 1438to unibyte for insertion.")
be91036a
RS
1439 (nargs, args)
1440 int nargs;
1441 register Lisp_Object *args;
1442{
fb8106e8
KH
1443 general_insert_function (insert_before_markers_and_inherit,
1444 insert_from_string_before_markers, 1,
1445 nargs, args);
35692fe0
JB
1446 return Qnil;
1447}
1448\f
e2eeabbb 1449DEFUN ("insert-char", Finsert_char, Sinsert_char, 2, 3, 0,
2591ec64 1450 "Insert COUNT (second arg) copies of CHARACTER (first arg).\n\
e2eeabbb 1451Both arguments are required.\n\
ba88b322 1452Point, and before-insertion markers, are relocated as in the function `insert'.\n\
e2eeabbb
RS
1453The optional third arg INHERIT, if non-nil, says to inherit text properties\n\
1454from adjoining text, if those properties are sticky.")
2591ec64
EN
1455 (character, count, inherit)
1456 Lisp_Object character, count, inherit;
35692fe0
JB
1457{
1458 register unsigned char *string;
1459 register int strlen;
1460 register int i, n;
fb8106e8
KH
1461 int len;
1462 unsigned char workbuf[4], *str;
35692fe0 1463
2591ec64 1464 CHECK_NUMBER (character, 0);
35692fe0
JB
1465 CHECK_NUMBER (count, 1);
1466
fb8106e8
KH
1467 if (!NILP (current_buffer->enable_multibyte_characters))
1468 len = CHAR_STRING (XFASTINT (character), workbuf, str);
1469 else
1470 workbuf[0] = XFASTINT (character), str = workbuf, len = 1;
1471 n = XINT (count) * len;
35692fe0
JB
1472 if (n <= 0)
1473 return Qnil;
fb8106e8 1474 strlen = min (n, 256 * len);
35692fe0
JB
1475 string = (unsigned char *) alloca (strlen);
1476 for (i = 0; i < strlen; i++)
fb8106e8 1477 string[i] = str[i % len];
35692fe0
JB
1478 while (n >= strlen)
1479 {
54e42e2d 1480 QUIT;
e2eeabbb
RS
1481 if (!NILP (inherit))
1482 insert_and_inherit (string, strlen);
1483 else
1484 insert (string, strlen);
35692fe0
JB
1485 n -= strlen;
1486 }
1487 if (n > 0)
83951f1e
KH
1488 {
1489 if (!NILP (inherit))
1490 insert_and_inherit (string, n);
1491 else
1492 insert (string, n);
1493 }
35692fe0
JB
1494 return Qnil;
1495}
1496
1497\f
ffd56f97
JB
1498/* Making strings from buffer contents. */
1499
1500/* Return a Lisp_String containing the text of the current buffer from
74d6d8c5 1501 START to END. If text properties are in use and the current buffer
eb8c3be9 1502 has properties in the range specified, the resulting string will also
260e2e2a 1503 have them, if PROPS is nonzero.
ffd56f97
JB
1504
1505 We don't want to use plain old make_string here, because it calls
1506 make_uninit_string, which can cause the buffer arena to be
1507 compacted. make_string has no way of knowing that the data has
1508 been moved, and thus copies the wrong data into the string. This
1509 doesn't effect most of the other users of make_string, so it should
1510 be left as is. But we should use this function when conjuring
1511 buffer substrings. */
74d6d8c5 1512
ffd56f97 1513Lisp_Object
260e2e2a 1514make_buffer_string (start, end, props)
ffd56f97 1515 int start, end;
260e2e2a 1516 int props;
ffd56f97 1517{
ec1c14f6
RS
1518 int start_byte = CHAR_TO_BYTE (start);
1519 int end_byte = CHAR_TO_BYTE (end);
ffd56f97 1520
88441c8e
RS
1521 return make_buffer_string_both (start, start_byte, end, end_byte, props);
1522}
1523
1524/* Return a Lisp_String containing the text of the current buffer from
1525 START / START_BYTE to END / END_BYTE.
1526
1527 If text properties are in use and the current buffer
1528 has properties in the range specified, the resulting string will also
1529 have them, if PROPS is nonzero.
1530
1531 We don't want to use plain old make_string here, because it calls
1532 make_uninit_string, which can cause the buffer arena to be
1533 compacted. make_string has no way of knowing that the data has
1534 been moved, and thus copies the wrong data into the string. This
1535 doesn't effect most of the other users of make_string, so it should
1536 be left as is. But we should use this function when conjuring
1537 buffer substrings. */
1538
1539Lisp_Object
1540make_buffer_string_both (start, start_byte, end, end_byte, props)
1541 int start, start_byte, end, end_byte;
1542 int props;
1543{
1544 Lisp_Object result, tem, tem1;
1545
ffd56f97
JB
1546 if (start < GPT && GPT < end)
1547 move_gap (start);
1548
5f75e666
RS
1549 if (! NILP (current_buffer->enable_multibyte_characters))
1550 result = make_uninit_multibyte_string (end - start, end_byte - start_byte);
1551 else
1552 result = make_uninit_string (end - start);
ec1c14f6
RS
1553 bcopy (BYTE_POS_ADDR (start_byte), XSTRING (result)->data,
1554 end_byte - start_byte);
ffd56f97 1555
260e2e2a 1556 /* If desired, update and copy the text properties. */
60b96ee7 1557#ifdef USE_TEXT_PROPERTIES
260e2e2a
KH
1558 if (props)
1559 {
1560 update_buffer_properties (start, end);
1561
1562 tem = Fnext_property_change (make_number (start), Qnil, make_number (end));
1563 tem1 = Ftext_properties_at (make_number (start), Qnil);
1564
1565 if (XINT (tem) != end || !NILP (tem1))
ec1c14f6
RS
1566 copy_intervals_to_string (result, current_buffer, start,
1567 end - start);
260e2e2a 1568 }
60b96ee7 1569#endif
74d6d8c5 1570
ffd56f97
JB
1571 return result;
1572}
35692fe0 1573
260e2e2a
KH
1574/* Call Vbuffer_access_fontify_functions for the range START ... END
1575 in the current buffer, if necessary. */
1576
1577static void
1578update_buffer_properties (start, end)
1579 int start, end;
1580{
1581#ifdef USE_TEXT_PROPERTIES
1582 /* If this buffer has some access functions,
1583 call them, specifying the range of the buffer being accessed. */
1584 if (!NILP (Vbuffer_access_fontify_functions))
1585 {
1586 Lisp_Object args[3];
1587 Lisp_Object tem;
1588
1589 args[0] = Qbuffer_access_fontify_functions;
1590 XSETINT (args[1], start);
1591 XSETINT (args[2], end);
1592
1593 /* But don't call them if we can tell that the work
1594 has already been done. */
1595 if (!NILP (Vbuffer_access_fontified_property))
1596 {
1597 tem = Ftext_property_any (args[1], args[2],
1598 Vbuffer_access_fontified_property,
1599 Qnil, Qnil);
1600 if (! NILP (tem))
ced1d19a 1601 Frun_hook_with_args (3, args);
260e2e2a
KH
1602 }
1603 else
ced1d19a 1604 Frun_hook_with_args (3, args);
260e2e2a
KH
1605 }
1606#endif
1607}
1608
35692fe0
JB
1609DEFUN ("buffer-substring", Fbuffer_substring, Sbuffer_substring, 2, 2, 0,
1610 "Return the contents of part of the current buffer as a string.\n\
1611The two arguments START and END are character positions;\n\
24d6bf26
RS
1612they can be in either order.\n\
1613The string returned is multibyte if the buffer is multibyte.")
2591ec64
EN
1614 (start, end)
1615 Lisp_Object start, end;
35692fe0 1616{
2591ec64 1617 register int b, e;
35692fe0 1618
2591ec64
EN
1619 validate_region (&start, &end);
1620 b = XINT (start);
1621 e = XINT (end);
35692fe0 1622
2591ec64 1623 return make_buffer_string (b, e, 1);
260e2e2a
KH
1624}
1625
1626DEFUN ("buffer-substring-no-properties", Fbuffer_substring_no_properties,
1627 Sbuffer_substring_no_properties, 2, 2, 0,
1628 "Return the characters of part of the buffer, without the text properties.\n\
1629The two arguments START and END are character positions;\n\
1630they can be in either order.")
2591ec64
EN
1631 (start, end)
1632 Lisp_Object start, end;
260e2e2a 1633{
2591ec64 1634 register int b, e;
260e2e2a 1635
2591ec64
EN
1636 validate_region (&start, &end);
1637 b = XINT (start);
1638 e = XINT (end);
260e2e2a 1639
2591ec64 1640 return make_buffer_string (b, e, 0);
35692fe0
JB
1641}
1642
1643DEFUN ("buffer-string", Fbuffer_string, Sbuffer_string, 0, 0, 0,
af7bd86c
KH
1644 "Return the contents of the current buffer as a string.\n\
1645If narrowing is in effect, this function returns only the visible part\n\
1646of the buffer.")
35692fe0
JB
1647 ()
1648{
260e2e2a 1649 return make_buffer_string (BEGV, ZV, 1);
35692fe0
JB
1650}
1651
1652DEFUN ("insert-buffer-substring", Finsert_buffer_substring, Sinsert_buffer_substring,
1653 1, 3, 0,
83ea6fc2 1654 "Insert before point a substring of the contents of buffer BUFFER.\n\
35692fe0
JB
1655BUFFER may be a buffer or a buffer name.\n\
1656Arguments START and END are character numbers specifying the substring.\n\
1657They default to the beginning and the end of BUFFER.")
2591ec64
EN
1658 (buf, start, end)
1659 Lisp_Object buf, start, end;
35692fe0 1660{
2591ec64 1661 register int b, e, temp;
260e2e2a 1662 register struct buffer *bp, *obuf;
3fff2dfa 1663 Lisp_Object buffer;
35692fe0 1664
3fff2dfa
RS
1665 buffer = Fget_buffer (buf);
1666 if (NILP (buffer))
1667 nsberror (buf);
1668 bp = XBUFFER (buffer);
93b62e82
KH
1669 if (NILP (bp->name))
1670 error ("Selecting deleted buffer");
35692fe0 1671
2591ec64
EN
1672 if (NILP (start))
1673 b = BUF_BEGV (bp);
35692fe0
JB
1674 else
1675 {
2591ec64
EN
1676 CHECK_NUMBER_COERCE_MARKER (start, 0);
1677 b = XINT (start);
35692fe0 1678 }
2591ec64
EN
1679 if (NILP (end))
1680 e = BUF_ZV (bp);
35692fe0
JB
1681 else
1682 {
2591ec64
EN
1683 CHECK_NUMBER_COERCE_MARKER (end, 1);
1684 e = XINT (end);
35692fe0
JB
1685 }
1686
2591ec64
EN
1687 if (b > e)
1688 temp = b, b = e, e = temp;
35692fe0 1689
2591ec64
EN
1690 if (!(BUF_BEGV (bp) <= b && e <= BUF_ZV (bp)))
1691 args_out_of_range (start, end);
35692fe0 1692
260e2e2a
KH
1693 obuf = current_buffer;
1694 set_buffer_internal_1 (bp);
2591ec64 1695 update_buffer_properties (b, e);
260e2e2a
KH
1696 set_buffer_internal_1 (obuf);
1697
2591ec64 1698 insert_from_buffer (bp, b, e - b, 0);
35692fe0
JB
1699 return Qnil;
1700}
e9cf2084
RS
1701
1702DEFUN ("compare-buffer-substrings", Fcompare_buffer_substrings, Scompare_buffer_substrings,
1703 6, 6, 0,
1704 "Compare two substrings of two buffers; return result as number.\n\
1705the value is -N if first string is less after N-1 chars,\n\
1706+N if first string is greater after N-1 chars, or 0 if strings match.\n\
1707Each substring is represented as three arguments: BUFFER, START and END.\n\
1708That makes six args in all, three for each substring.\n\n\
1709The value of `case-fold-search' in the current buffer\n\
1710determines whether case is significant or ignored.")
1711 (buffer1, start1, end1, buffer2, start2, end2)
1712 Lisp_Object buffer1, start1, end1, buffer2, start2, end2;
1713{
07422a12 1714 register int begp1, endp1, begp2, endp2, temp;
e9cf2084 1715 register struct buffer *bp1, *bp2;
2a8b0ff0 1716 register Lisp_Object *trt
e9cf2084 1717 = (!NILP (current_buffer->case_fold_search)
2a8b0ff0 1718 ? XCHAR_TABLE (current_buffer->case_canon_table)->contents : 0);
ec1c14f6 1719 int chars = 0;
07422a12 1720 int i1, i2, i1_byte, i2_byte;
e9cf2084
RS
1721
1722 /* Find the first buffer and its substring. */
1723
1724 if (NILP (buffer1))
1725 bp1 = current_buffer;
1726 else
1727 {
3fff2dfa
RS
1728 Lisp_Object buf1;
1729 buf1 = Fget_buffer (buffer1);
1730 if (NILP (buf1))
1731 nsberror (buffer1);
1732 bp1 = XBUFFER (buf1);
93b62e82
KH
1733 if (NILP (bp1->name))
1734 error ("Selecting deleted buffer");
e9cf2084
RS
1735 }
1736
1737 if (NILP (start1))
1738 begp1 = BUF_BEGV (bp1);
1739 else
1740 {
1741 CHECK_NUMBER_COERCE_MARKER (start1, 1);
1742 begp1 = XINT (start1);
1743 }
1744 if (NILP (end1))
1745 endp1 = BUF_ZV (bp1);
1746 else
1747 {
1748 CHECK_NUMBER_COERCE_MARKER (end1, 2);
1749 endp1 = XINT (end1);
1750 }
1751
1752 if (begp1 > endp1)
1753 temp = begp1, begp1 = endp1, endp1 = temp;
1754
1755 if (!(BUF_BEGV (bp1) <= begp1
1756 && begp1 <= endp1
1757 && endp1 <= BUF_ZV (bp1)))
1758 args_out_of_range (start1, end1);
1759
1760 /* Likewise for second substring. */
1761
1762 if (NILP (buffer2))
1763 bp2 = current_buffer;
1764 else
1765 {
3fff2dfa
RS
1766 Lisp_Object buf2;
1767 buf2 = Fget_buffer (buffer2);
1768 if (NILP (buf2))
1769 nsberror (buffer2);
3b1fdd85 1770 bp2 = XBUFFER (buf2);
93b62e82
KH
1771 if (NILP (bp2->name))
1772 error ("Selecting deleted buffer");
e9cf2084
RS
1773 }
1774
1775 if (NILP (start2))
1776 begp2 = BUF_BEGV (bp2);
1777 else
1778 {
1779 CHECK_NUMBER_COERCE_MARKER (start2, 4);
1780 begp2 = XINT (start2);
1781 }
1782 if (NILP (end2))
1783 endp2 = BUF_ZV (bp2);
1784 else
1785 {
1786 CHECK_NUMBER_COERCE_MARKER (end2, 5);
1787 endp2 = XINT (end2);
1788 }
1789
1790 if (begp2 > endp2)
1791 temp = begp2, begp2 = endp2, endp2 = temp;
1792
1793 if (!(BUF_BEGV (bp2) <= begp2
1794 && begp2 <= endp2
1795 && endp2 <= BUF_ZV (bp2)))
1796 args_out_of_range (start2, end2);
1797
07422a12
RS
1798 i1 = begp1;
1799 i2 = begp2;
1800 i1_byte = buf_charpos_to_bytepos (bp1, i1);
1801 i2_byte = buf_charpos_to_bytepos (bp2, i2);
e9cf2084 1802
07422a12 1803 while (i1 < endp1 && i2 < endp2)
e9cf2084 1804 {
07422a12
RS
1805 /* When we find a mismatch, we must compare the
1806 characters, not just the bytes. */
1807 int c1, c2;
ec1c14f6 1808
07422a12
RS
1809 if (! NILP (bp1->enable_multibyte_characters))
1810 {
1811 c1 = BUF_FETCH_MULTIBYTE_CHAR (bp1, i1_byte);
1812 BUF_INC_POS (bp1, i1_byte);
1813 i1++;
1814 }
1815 else
1816 {
1817 c1 = BUF_FETCH_BYTE (bp1, i1);
1818 c1 = unibyte_char_to_multibyte (c1);
1819 i1++;
1820 }
1821
1822 if (! NILP (bp2->enable_multibyte_characters))
1823 {
1824 c2 = BUF_FETCH_MULTIBYTE_CHAR (bp2, i2_byte);
1825 BUF_INC_POS (bp2, i2_byte);
1826 i2++;
1827 }
1828 else
1829 {
1830 c2 = BUF_FETCH_BYTE (bp2, i2);
1831 c2 = unibyte_char_to_multibyte (c2);
1832 i2++;
1833 }
ec1c14f6 1834
e9cf2084
RS
1835 if (trt)
1836 {
1b10fb77
RS
1837 c1 = XINT (trt[c1]);
1838 c2 = XINT (trt[c2]);
e9cf2084
RS
1839 }
1840 if (c1 < c2)
ec1c14f6 1841 return make_number (- 1 - chars);
e9cf2084 1842 if (c1 > c2)
ec1c14f6 1843 return make_number (chars + 1);
07422a12
RS
1844
1845 chars++;
e9cf2084
RS
1846 }
1847
1848 /* The strings match as far as they go.
1849 If one is shorter, that one is less. */
07422a12 1850 if (chars < endp1 - begp1)
ec1c14f6 1851 return make_number (chars + 1);
07422a12 1852 else if (chars < endp2 - begp2)
ec1c14f6 1853 return make_number (- chars - 1);
e9cf2084
RS
1854
1855 /* Same length too => they are equal. */
1856 return make_number (0);
1857}
35692fe0 1858\f
d5a539cd
RS
1859static Lisp_Object
1860subst_char_in_region_unwind (arg)
1861 Lisp_Object arg;
1862{
1863 return current_buffer->undo_list = arg;
1864}
1865
c8e76b47
RS
1866static Lisp_Object
1867subst_char_in_region_unwind_1 (arg)
1868 Lisp_Object arg;
1869{
1870 return current_buffer->filename = arg;
1871}
1872
35692fe0
JB
1873DEFUN ("subst-char-in-region", Fsubst_char_in_region,
1874 Ssubst_char_in_region, 4, 5, 0,
1875 "From START to END, replace FROMCHAR with TOCHAR each time it occurs.\n\
1876If optional arg NOUNDO is non-nil, don't record this change for undo\n\
fb8106e8
KH
1877and don't mark the buffer as really changed.\n\
1878Both characters must have the same length of multi-byte form.")
35692fe0
JB
1879 (start, end, fromchar, tochar, noundo)
1880 Lisp_Object start, end, fromchar, tochar, noundo;
1881{
84246b95 1882 register int pos, pos_byte, stop, i, len, end_byte;
60b96ee7 1883 int changed = 0;
fb8106e8 1884 unsigned char fromwork[4], *fromstr, towork[4], *tostr, *p;
d5a539cd 1885 int count = specpdl_ptr - specpdl;
35692fe0
JB
1886
1887 validate_region (&start, &end);
1888 CHECK_NUMBER (fromchar, 2);
1889 CHECK_NUMBER (tochar, 3);
1890
fb8106e8
KH
1891 if (! NILP (current_buffer->enable_multibyte_characters))
1892 {
1893 len = CHAR_STRING (XFASTINT (fromchar), fromwork, fromstr);
1894 if (CHAR_STRING (XFASTINT (tochar), towork, tostr) != len)
1895 error ("Characters in subst-char-in-region have different byte-lengths");
1896 }
1897 else
1898 {
1899 len = 1;
1900 fromwork[0] = XFASTINT (fromchar), fromstr = fromwork;
1901 towork[0] = XFASTINT (tochar), tostr = towork;
1902 }
1903
84246b95
KH
1904 pos = XINT (start);
1905 pos_byte = CHAR_TO_BYTE (pos);
ec1c14f6
RS
1906 stop = CHAR_TO_BYTE (XINT (end));
1907 end_byte = stop;
35692fe0 1908
d5a539cd
RS
1909 /* If we don't want undo, turn off putting stuff on the list.
1910 That's faster than getting rid of things,
c8e76b47
RS
1911 and it prevents even the entry for a first change.
1912 Also inhibit locking the file. */
d5a539cd
RS
1913 if (!NILP (noundo))
1914 {
1915 record_unwind_protect (subst_char_in_region_unwind,
1916 current_buffer->undo_list);
1917 current_buffer->undo_list = Qt;
c8e76b47
RS
1918 /* Don't do file-locking. */
1919 record_unwind_protect (subst_char_in_region_unwind_1,
1920 current_buffer->filename);
1921 current_buffer->filename = Qnil;
d5a539cd
RS
1922 }
1923
84246b95 1924 if (pos_byte < GPT_BYTE)
ec1c14f6 1925 stop = min (stop, GPT_BYTE);
fb8106e8 1926 while (1)
35692fe0 1927 {
84246b95 1928 if (pos_byte >= stop)
fb8106e8 1929 {
84246b95 1930 if (pos_byte >= end_byte) break;
ec1c14f6 1931 stop = end_byte;
fb8106e8 1932 }
84246b95 1933 p = BYTE_POS_ADDR (pos_byte);
fb8106e8
KH
1934 if (p[0] == fromstr[0]
1935 && (len == 1
1936 || (p[1] == fromstr[1]
1937 && (len == 2 || (p[2] == fromstr[2]
1938 && (len == 3 || p[3] == fromstr[3]))))))
35692fe0 1939 {
60b96ee7
RS
1940 if (! changed)
1941 {
fb8106e8 1942 modify_region (current_buffer, XINT (start), XINT (end));
7653d030
RS
1943
1944 if (! NILP (noundo))
1945 {
1e158d25
RS
1946 if (MODIFF - 1 == SAVE_MODIFF)
1947 SAVE_MODIFF++;
7653d030
RS
1948 if (MODIFF - 1 == current_buffer->auto_save_modified)
1949 current_buffer->auto_save_modified++;
1950 }
1951
fb8106e8 1952 changed = 1;
60b96ee7
RS
1953 }
1954
0c1e3b85
RS
1955 /* Take care of the case where the new character
1956 combines with neighboring bytes. */
1957 if (len == 1
1958 && ((! CHAR_HEAD_P (tostr[0])
1959 && pos_byte > BEGV_BYTE
1960 && ! ASCII_BYTE_P (FETCH_BYTE (pos_byte - 1)))
1961 ||
1962 (! ASCII_BYTE_P (tostr[0])
1963 && pos_byte + 1 < ZV_BYTE
1964 && ! CHAR_HEAD_P (FETCH_BYTE (pos_byte + 1)))))
1965 {
1966 Lisp_Object tem, string;
1967
1968 struct gcpro gcpro1;
1969
1970 tem = current_buffer->undo_list;
1971 GCPRO1 (tem);
1972
1973 /* Make a multibyte string containing this
1974 single-byte character. */
1975 string = Fmake_string (make_number (1),
1976 make_number (tochar));
1977 SET_STRING_BYTES (XSTRING (string), 1);
1978 /* replace_range is less efficient, because it moves the gap,
1979 but it handles combining correctly. */
1980 replace_range (pos, pos + 1, string,
1981 0, 0, 0);
1982 if (! NILP (noundo))
1983 current_buffer->undo_list = tem;
1984
1985 UNGCPRO;
1986 }
1987 else
1988 {
1989 if (NILP (noundo))
1990 record_change (pos, 1);
1991 for (i = 0; i < len; i++) *p++ = tostr[i];
1992 }
35692fe0 1993 }
84246b95 1994 INC_BOTH (pos, pos_byte);
35692fe0
JB
1995 }
1996
60b96ee7
RS
1997 if (changed)
1998 signal_after_change (XINT (start),
84246b95 1999 XINT (end) - XINT (start), XINT (end) - XINT (start));
60b96ee7 2000
d5a539cd 2001 unbind_to (count, Qnil);
35692fe0
JB
2002 return Qnil;
2003}
2004
2005DEFUN ("translate-region", Ftranslate_region, Stranslate_region, 3, 3, 0,
2006 "From START to END, translate characters according to TABLE.\n\
2007TABLE is a string; the Nth character in it is the mapping\n\
1f24f4fd
RS
2008for the character with code N.\n\
2009This function does not alter multibyte characters.\n\
2010It returns the number of characters changed.")
35692fe0
JB
2011 (start, end, table)
2012 Lisp_Object start;
2013 Lisp_Object end;
2014 register Lisp_Object table;
2015{
ec1c14f6 2016 register int pos_byte, stop; /* Limits of the region. */
35692fe0 2017 register unsigned char *tt; /* Trans table. */
35692fe0
JB
2018 register int nc; /* New character. */
2019 int cnt; /* Number of changes made. */
35692fe0 2020 int size; /* Size of translate table. */
1f24f4fd 2021 int pos;
35692fe0
JB
2022
2023 validate_region (&start, &end);
2024 CHECK_STRING (table, 2);
2025
dc3620af 2026 size = STRING_BYTES (XSTRING (table));
35692fe0
JB
2027 tt = XSTRING (table)->data;
2028
ec1c14f6
RS
2029 pos_byte = CHAR_TO_BYTE (XINT (start));
2030 stop = CHAR_TO_BYTE (XINT (end));
2031 modify_region (current_buffer, XINT (start), XINT (end));
1f24f4fd 2032 pos = XINT (start);
35692fe0
JB
2033
2034 cnt = 0;
1f24f4fd 2035 for (; pos_byte < stop; )
35692fe0 2036 {
ec1c14f6 2037 register unsigned char *p = BYTE_POS_ADDR (pos_byte);
1f24f4fd
RS
2038 int len;
2039 int oc;
ec1c14f6 2040
1f24f4fd
RS
2041 oc = STRING_CHAR_AND_LENGTH (p, stop - pos_byte, len);
2042 if (oc < size && len == 1)
35692fe0
JB
2043 {
2044 nc = tt[oc];
2045 if (nc != oc)
2046 {
0c1e3b85
RS
2047 /* Take care of the case where the new character
2048 combines with neighboring bytes. */
2049 if ((! CHAR_HEAD_P (nc)
2050 && pos_byte > BEGV_BYTE
2051 && ! ASCII_BYTE_P (FETCH_BYTE (pos_byte - 1)))
2052 ||
2053 (! ASCII_BYTE_P (nc)
2054 && pos_byte + 1 < ZV_BYTE
2055 && ! CHAR_HEAD_P (FETCH_BYTE (pos_byte + 1))))
2056 {
2057 Lisp_Object string;
2058
2059 string = Fmake_string (make_number (1),
2060 make_number (nc));
2061 SET_STRING_BYTES (XSTRING (string), 1);
2062
2063 /* This is less efficient, because it moves the gap,
2064 but it handles combining correctly. */
2065 replace_range (pos, pos + 1, string,
2066 1, 0, 0);
2067 }
2068 else
2069 {
2070 record_change (pos, 1);
2071 *p = nc;
2072 signal_after_change (pos, 1, 1);
2073 }
35692fe0
JB
2074 ++cnt;
2075 }
2076 }
1f24f4fd
RS
2077 pos_byte += len;
2078 pos++;
35692fe0
JB
2079 }
2080
ec1c14f6 2081 return make_number (cnt);
35692fe0
JB
2082}
2083
2084DEFUN ("delete-region", Fdelete_region, Sdelete_region, 2, 2, "r",
2085 "Delete the text between point and mark.\n\
2086When called from a program, expects two arguments,\n\
2087positions (integers or markers) specifying the stretch to be deleted.")
2591ec64
EN
2088 (start, end)
2089 Lisp_Object start, end;
35692fe0 2090{
2591ec64
EN
2091 validate_region (&start, &end);
2092 del_range (XINT (start), XINT (end));
35692fe0
JB
2093 return Qnil;
2094}
2095\f
2096DEFUN ("widen", Fwiden, Swiden, 0, 0, "",
2097 "Remove restrictions (narrowing) from current buffer.\n\
2098This allows the buffer's full text to be seen and edited.")
2099 ()
2100{
2cad2e34
RS
2101 if (BEG != BEGV || Z != ZV)
2102 current_buffer->clip_changed = 1;
35692fe0 2103 BEGV = BEG;
ec1c14f6
RS
2104 BEGV_BYTE = BEG_BYTE;
2105 SET_BUF_ZV_BOTH (current_buffer, Z, Z_BYTE);
52b14ac0
JB
2106 /* Changing the buffer bounds invalidates any recorded current column. */
2107 invalidate_current_column ();
35692fe0
JB
2108 return Qnil;
2109}
2110
2111DEFUN ("narrow-to-region", Fnarrow_to_region, Snarrow_to_region, 2, 2, "r",
2112 "Restrict editing in this buffer to the current region.\n\
2113The rest of the text becomes temporarily invisible and untouchable\n\
2114but is not deleted; if you save the buffer in a file, the invisible\n\
2115text is included in the file. \\[widen] makes all visible again.\n\
2116See also `save-restriction'.\n\
2117\n\
2118When calling from a program, pass two arguments; positions (integers\n\
2119or markers) bounding the text that should remain visible.")
2591ec64
EN
2120 (start, end)
2121 register Lisp_Object start, end;
35692fe0 2122{
2591ec64
EN
2123 CHECK_NUMBER_COERCE_MARKER (start, 0);
2124 CHECK_NUMBER_COERCE_MARKER (end, 1);
35692fe0 2125
2591ec64 2126 if (XINT (start) > XINT (end))
35692fe0 2127 {
b5a6948e 2128 Lisp_Object tem;
2591ec64 2129 tem = start; start = end; end = tem;
35692fe0
JB
2130 }
2131
2591ec64
EN
2132 if (!(BEG <= XINT (start) && XINT (start) <= XINT (end) && XINT (end) <= Z))
2133 args_out_of_range (start, end);
35692fe0 2134
2cad2e34
RS
2135 if (BEGV != XFASTINT (start) || ZV != XFASTINT (end))
2136 current_buffer->clip_changed = 1;
2137
ec1c14f6 2138 SET_BUF_BEGV (current_buffer, XFASTINT (start));
2591ec64 2139 SET_BUF_ZV (current_buffer, XFASTINT (end));
6ec8bbd2 2140 if (PT < XFASTINT (start))
2591ec64 2141 SET_PT (XFASTINT (start));
6ec8bbd2 2142 if (PT > XFASTINT (end))
2591ec64 2143 SET_PT (XFASTINT (end));
52b14ac0
JB
2144 /* Changing the buffer bounds invalidates any recorded current column. */
2145 invalidate_current_column ();
35692fe0
JB
2146 return Qnil;
2147}
2148
2149Lisp_Object
2150save_restriction_save ()
2151{
2152 register Lisp_Object bottom, top;
2153 /* Note: I tried using markers here, but it does not win
2154 because insertion at the end of the saved region
2155 does not advance mh and is considered "outside" the saved region. */
55561c63
KH
2156 XSETFASTINT (bottom, BEGV - BEG);
2157 XSETFASTINT (top, Z - ZV);
35692fe0
JB
2158
2159 return Fcons (Fcurrent_buffer (), Fcons (bottom, top));
2160}
2161
2162Lisp_Object
2163save_restriction_restore (data)
2164 Lisp_Object data;
2165{
2166 register struct buffer *buf;
2167 register int newhead, newtail;
2168 register Lisp_Object tem;
2cad2e34 2169 int obegv, ozv;
35692fe0
JB
2170
2171 buf = XBUFFER (XCONS (data)->car);
2172
2173 data = XCONS (data)->cdr;
2174
2175 tem = XCONS (data)->car;
2176 newhead = XINT (tem);
2177 tem = XCONS (data)->cdr;
2178 newtail = XINT (tem);
2179 if (newhead + newtail > BUF_Z (buf) - BUF_BEG (buf))
2180 {
2181 newhead = 0;
2182 newtail = 0;
2183 }
2cad2e34
RS
2184
2185 obegv = BUF_BEGV (buf);
2186 ozv = BUF_ZV (buf);
2187
ec1c14f6 2188 SET_BUF_BEGV (buf, BUF_BEG (buf) + newhead);
35692fe0 2189 SET_BUF_ZV (buf, BUF_Z (buf) - newtail);
2cad2e34
RS
2190
2191 if (obegv != BUF_BEGV (buf) || ozv != BUF_ZV (buf))
2192 current_buffer->clip_changed = 1;
35692fe0
JB
2193
2194 /* If point is outside the new visible range, move it inside. */
ec1c14f6
RS
2195 SET_BUF_PT_BOTH (buf,
2196 clip_to_bounds (BUF_BEGV (buf), BUF_PT (buf), BUF_ZV (buf)),
2197 clip_to_bounds (BUF_BEGV_BYTE (buf), BUF_PT_BYTE (buf),
2198 BUF_ZV_BYTE (buf)));
35692fe0
JB
2199
2200 return Qnil;
2201}
2202
2203DEFUN ("save-restriction", Fsave_restriction, Ssave_restriction, 0, UNEVALLED, 0,
2204 "Execute BODY, saving and restoring current buffer's restrictions.\n\
2205The buffer's restrictions make parts of the beginning and end invisible.\n\
2206\(They are set up with `narrow-to-region' and eliminated with `widen'.)\n\
2207This special form, `save-restriction', saves the current buffer's restrictions\n\
2208when it is entered, and restores them when it is exited.\n\
2209So any `narrow-to-region' within BODY lasts only until the end of the form.\n\
2210The old restrictions settings are restored\n\
2211even in case of abnormal exit (throw or error).\n\
2212\n\
2213The value returned is the value of the last form in BODY.\n\
2214\n\
2215`save-restriction' can get confused if, within the BODY, you widen\n\
2216and then make changes outside the area within the saved restrictions.\n\
2217\n\
2218Note: if you are using both `save-excursion' and `save-restriction',\n\
2219use `save-excursion' outermost:\n\
2220 (save-excursion (save-restriction ...))")
2221 (body)
2222 Lisp_Object body;
2223{
2224 register Lisp_Object val;
2225 int count = specpdl_ptr - specpdl;
2226
2227 record_unwind_protect (save_restriction_restore, save_restriction_save ());
2228 val = Fprogn (body);
2229 return unbind_to (count, val);
2230}
2231\f
671fbc4d
KH
2232/* Buffer for the most recent text displayed by Fmessage. */
2233static char *message_text;
2234
2235/* Allocated length of that buffer. */
2236static int message_length;
2237
35692fe0
JB
2238DEFUN ("message", Fmessage, Smessage, 1, MANY, 0,
2239 "Print a one-line message at the bottom of the screen.\n\
98fc5c3c
RS
2240The first argument is a format control string, and the rest are data\n\
2241to be formatted under control of the string. See `format' for details.\n\
2242\n\
ccdac5be
JB
2243If the first argument is nil, clear any existing message; let the\n\
2244minibuffer contents show.")
35692fe0
JB
2245 (nargs, args)
2246 int nargs;
2247 Lisp_Object *args;
2248{
ccdac5be 2249 if (NILP (args[0]))
f0250249
JB
2250 {
2251 message (0);
2252 return Qnil;
2253 }
ccdac5be
JB
2254 else
2255 {
2256 register Lisp_Object val;
2257 val = Fformat (nargs, args);
671fbc4d
KH
2258 /* Copy the data so that it won't move when we GC. */
2259 if (! message_text)
2260 {
2261 message_text = (char *)xmalloc (80);
2262 message_length = 80;
2263 }
dc3620af 2264 if (STRING_BYTES (XSTRING (val)) > message_length)
671fbc4d 2265 {
dc3620af 2266 message_length = STRING_BYTES (XSTRING (val));
671fbc4d
KH
2267 message_text = (char *)xrealloc (message_text, message_length);
2268 }
dc3620af
RS
2269 bcopy (XSTRING (val)->data, message_text, STRING_BYTES (XSTRING (val)));
2270 message2 (message_text, STRING_BYTES (XSTRING (val)),
1f24f4fd 2271 STRING_MULTIBYTE (val));
ccdac5be
JB
2272 return val;
2273 }
35692fe0
JB
2274}
2275
cacc3e2c
RS
2276DEFUN ("message-box", Fmessage_box, Smessage_box, 1, MANY, 0,
2277 "Display a message, in a dialog box if possible.\n\
2278If a dialog box is not available, use the echo area.\n\
f8250f01
RS
2279The first argument is a format control string, and the rest are data\n\
2280to be formatted under control of the string. See `format' for details.\n\
2281\n\
cacc3e2c
RS
2282If the first argument is nil, clear any existing message; let the\n\
2283minibuffer contents show.")
2284 (nargs, args)
2285 int nargs;
2286 Lisp_Object *args;
2287{
2288 if (NILP (args[0]))
2289 {
2290 message (0);
2291 return Qnil;
2292 }
2293 else
2294 {
2295 register Lisp_Object val;
2296 val = Fformat (nargs, args);
f8250f01 2297#ifdef HAVE_MENUS
cacc3e2c
RS
2298 {
2299 Lisp_Object pane, menu, obj;
2300 struct gcpro gcpro1;
2301 pane = Fcons (Fcons (build_string ("OK"), Qt), Qnil);
2302 GCPRO1 (pane);
2303 menu = Fcons (val, pane);
2304 obj = Fx_popup_dialog (Qt, menu);
2305 UNGCPRO;
2306 return val;
2307 }
f8250f01 2308#else /* not HAVE_MENUS */
cacc3e2c
RS
2309 /* Copy the data so that it won't move when we GC. */
2310 if (! message_text)
2311 {
2312 message_text = (char *)xmalloc (80);
2313 message_length = 80;
2314 }
dc3620af 2315 if (STRING_BYTES (XSTRING (val)) > message_length)
cacc3e2c 2316 {
dc3620af 2317 message_length = STRING_BYTES (XSTRING (val));
cacc3e2c
RS
2318 message_text = (char *)xrealloc (message_text, message_length);
2319 }
dc3620af 2320 bcopy (XSTRING (val)->data, message_text, STRING_BYTES (XSTRING (val)));
d13a8480
RS
2321 message2 (message_text, STRING_BYTES (XSTRING (val)),
2322 STRING_MULTIBYTE (val));
cacc3e2c 2323 return val;
f8250f01 2324#endif /* not HAVE_MENUS */
cacc3e2c
RS
2325 }
2326}
f8250f01 2327#ifdef HAVE_MENUS
cacc3e2c
RS
2328extern Lisp_Object last_nonmenu_event;
2329#endif
f8250f01 2330
cacc3e2c
RS
2331DEFUN ("message-or-box", Fmessage_or_box, Smessage_or_box, 1, MANY, 0,
2332 "Display a message in a dialog box or in the echo area.\n\
2333If this command was invoked with the mouse, use a dialog box.\n\
2334Otherwise, use the echo area.\n\
f8250f01
RS
2335The first argument is a format control string, and the rest are data\n\
2336to be formatted under control of the string. See `format' for details.\n\
cacc3e2c 2337\n\
cacc3e2c
RS
2338If the first argument is nil, clear any existing message; let the\n\
2339minibuffer contents show.")
2340 (nargs, args)
2341 int nargs;
2342 Lisp_Object *args;
2343{
f8250f01 2344#ifdef HAVE_MENUS
cacc3e2c 2345 if (NILP (last_nonmenu_event) || CONSP (last_nonmenu_event))
0a56ee6b 2346 return Fmessage_box (nargs, args);
cacc3e2c
RS
2347#endif
2348 return Fmessage (nargs, args);
2349}
2350
b14dda8a
RS
2351DEFUN ("current-message", Fcurrent_message, Scurrent_message, 0, 0, 0,
2352 "Return the string currently displayed in the echo area, or nil if none.")
2353 ()
2354{
2355 return (echo_area_glyphs
2356 ? make_string (echo_area_glyphs, echo_area_glyphs_length)
2357 : Qnil);
2358}
2359
1f24f4fd
RS
2360/* Number of bytes that STRING will occupy when put into the result.
2361 MULTIBYTE is nonzero if the result should be multibyte. */
2362
2363#define CONVERTED_BYTE_SIZE(MULTIBYTE, STRING) \
2364 (((MULTIBYTE) && ! STRING_MULTIBYTE (STRING)) \
8d6179dc 2365 ? count_size_as_multibyte (XSTRING (STRING)->data, \
dc3620af
RS
2366 STRING_BYTES (XSTRING (STRING))) \
2367 : STRING_BYTES (XSTRING (STRING)))
1f24f4fd 2368
35692fe0
JB
2369DEFUN ("format", Fformat, Sformat, 1, MANY, 0,
2370 "Format a string out of a control-string and arguments.\n\
2371The first argument is a control string.\n\
2372The other arguments are substituted into it to make the result, a string.\n\
2373It may contain %-sequences meaning to substitute the next argument.\n\
2374%s means print a string argument. Actually, prints any object, with `princ'.\n\
2375%d means print as number in decimal (%o octal, %x hex).\n\
9db1775a
RS
2376%e means print a number in exponential notation.\n\
2377%f means print a number in decimal-point notation.\n\
2378%g means print a number in exponential notation\n\
2379 or decimal-point notation, whichever uses fewer characters.\n\
35692fe0
JB
2380%c means print a number as a single character.\n\
2381%S means print any object as an s-expression (using prin1).\n\
9db1775a 2382 The argument used for %d, %o, %x, %e, %f, %g or %c must be a number.\n\
52b14ac0 2383Use %% to put a single % into the output.")
35692fe0
JB
2384 (nargs, args)
2385 int nargs;
2386 register Lisp_Object *args;
2387{
2388 register int n; /* The number of the next arg to substitute */
e781c49e 2389 register int total; /* An estimate of the final length */
1f24f4fd 2390 char *buf, *p;
35692fe0 2391 register unsigned char *format, *end;
1f24f4fd
RS
2392 int length, nchars;
2393 /* Nonzero if the output should be a multibyte string,
2394 which is true if any of the inputs is one. */
2395 int multibyte = 0;
8f2917e4
KH
2396 /* When we make a multibyte string, we must pay attention to the
2397 byte combining problem, i.e., a byte may be combined with a
2398 multibyte charcter of the previous string. This flag tells if we
2399 must consider such a situation or not. */
2400 int maybe_combine_byte;
1f24f4fd 2401 unsigned char *this_format;
e781c49e 2402 int longest_format;
8d6179dc 2403 Lisp_Object val;
1f24f4fd 2404
35692fe0 2405 extern char *index ();
1f24f4fd 2406
35692fe0
JB
2407 /* It should not be necessary to GCPRO ARGS, because
2408 the caller in the interpreter should take care of that. */
2409
e781c49e
RS
2410 /* Try to determine whether the result should be multibyte.
2411 This is not always right; sometimes the result needs to be multibyte
2412 because of an object that we will pass through prin1,
2413 and in that case, we won't know it here. */
1f24f4fd
RS
2414 for (n = 0; n < nargs; n++)
2415 if (STRINGP (args[n]) && STRING_MULTIBYTE (args[n]))
2416 multibyte = 1;
2417
35692fe0 2418 CHECK_STRING (args[0], 0);
e781c49e
RS
2419
2420 /* If we start out planning a unibyte result,
2421 and later find it has to be multibyte, we jump back to retry. */
2422 retry:
2423
35692fe0 2424 format = XSTRING (args[0])->data;
dc3620af 2425 end = format + STRING_BYTES (XSTRING (args[0]));
e781c49e 2426 longest_format = 0;
1f24f4fd
RS
2427
2428 /* Make room in result for all the non-%-codes in the control string. */
e781c49e 2429 total = 5 + CONVERTED_BYTE_SIZE (multibyte, args[0]);
1f24f4fd
RS
2430
2431 /* Add to TOTAL enough space to hold the converted arguments. */
35692fe0
JB
2432
2433 n = 0;
2434 while (format != end)
2435 if (*format++ == '%')
2436 {
1f24f4fd
RS
2437 int minlen, thissize = 0;
2438 unsigned char *this_format_start = format - 1;
35692fe0
JB
2439
2440 /* Process a numeric arg and skip it. */
2441 minlen = atoi (format);
537dfb13
RS
2442 if (minlen < 0)
2443 minlen = - minlen;
2444
35692fe0
JB
2445 while ((*format >= '0' && *format <= '9')
2446 || *format == '-' || *format == ' ' || *format == '.')
2447 format++;
2448
1f24f4fd
RS
2449 if (format - this_format_start + 1 > longest_format)
2450 longest_format = format - this_format_start + 1;
2451
bf6ab66c
KH
2452 if (format == end)
2453 error ("Format string ends in middle of format specifier");
35692fe0
JB
2454 if (*format == '%')
2455 format++;
2456 else if (++n >= nargs)
537dfb13 2457 error ("Not enough arguments for format string");
35692fe0
JB
2458 else if (*format == 'S')
2459 {
2460 /* For `S', prin1 the argument and then treat like a string. */
2461 register Lisp_Object tem;
2462 tem = Fprin1_to_string (args[n], Qnil);
e781c49e
RS
2463 if (STRING_MULTIBYTE (tem) && ! multibyte)
2464 {
2465 multibyte = 1;
2466 goto retry;
2467 }
35692fe0
JB
2468 args[n] = tem;
2469 goto string;
2470 }
ae683129 2471 else if (SYMBOLP (args[n]))
35692fe0 2472 {
d2fd0445 2473 XSETSTRING (args[n], XSYMBOL (args[n])->name);
7df74da6
RS
2474 if (STRING_MULTIBYTE (args[n]) && ! multibyte)
2475 {
2476 multibyte = 1;
2477 goto retry;
2478 }
35692fe0
JB
2479 goto string;
2480 }
ae683129 2481 else if (STRINGP (args[n]))
35692fe0
JB
2482 {
2483 string:
b22e7ecc 2484 if (*format != 's' && *format != 'S')
bf6ab66c 2485 error ("Format specifier doesn't match argument type");
1f24f4fd 2486 thissize = CONVERTED_BYTE_SIZE (multibyte, args[n]);
35692fe0
JB
2487 }
2488 /* Would get MPV otherwise, since Lisp_Int's `point' to low memory. */
ae683129 2489 else if (INTEGERP (args[n]) && *format != 's')
35692fe0 2490 {
4746118a 2491#ifdef LISP_FLOAT_TYPE
eb8c3be9 2492 /* The following loop assumes the Lisp type indicates
35692fe0
JB
2493 the proper way to pass the argument.
2494 So make sure we have a flonum if the argument should
2495 be a double. */
2496 if (*format == 'e' || *format == 'f' || *format == 'g')
2497 args[n] = Ffloat (args[n]);
4746118a 2498#endif
f49a2d74 2499 thissize = 30;
25c9e7fb
RS
2500 if (*format == 'c'
2501 && (! SINGLE_BYTE_CHAR_P (XINT (args[n]))
2502 || XINT (args[n]) == 0))
f49a2d74
KH
2503 {
2504 if (! multibyte)
2505 {
2506 multibyte = 1;
2507 goto retry;
2508 }
2509 args[n] = Fchar_to_string (args[n]);
dc3620af 2510 thissize = STRING_BYTES (XSTRING (args[n]));
f49a2d74 2511 }
35692fe0 2512 }
4746118a 2513#ifdef LISP_FLOAT_TYPE
ae683129 2514 else if (FLOATP (args[n]) && *format != 's')
35692fe0
JB
2515 {
2516 if (! (*format == 'e' || *format == 'f' || *format == 'g'))
247422ce 2517 args[n] = Ftruncate (args[n], Qnil);
1f24f4fd 2518 thissize = 60;
35692fe0 2519 }
4746118a 2520#endif
35692fe0
JB
2521 else
2522 {
2523 /* Anything but a string, convert to a string using princ. */
2524 register Lisp_Object tem;
2525 tem = Fprin1_to_string (args[n], Qt);
a4e91443 2526 if (STRING_MULTIBYTE (tem) & ! multibyte)
e781c49e
RS
2527 {
2528 multibyte = 1;
2529 goto retry;
2530 }
35692fe0
JB
2531 args[n] = tem;
2532 goto string;
2533 }
1f24f4fd
RS
2534
2535 if (thissize < minlen)
2536 thissize = minlen;
2537
2538 total += thissize + 4;
35692fe0
JB
2539 }
2540
e781c49e
RS
2541 /* Now we can no longer jump to retry.
2542 TOTAL and LONGEST_FORMAT are known for certain. */
2543
1f24f4fd 2544 this_format = (unsigned char *) alloca (longest_format + 1);
50aa2f90 2545
1f24f4fd
RS
2546 /* Allocate the space for the result.
2547 Note that TOTAL is an overestimate. */
2548 if (total < 1000)
3c6db9d5 2549 buf = (char *) alloca (total + 1);
1f24f4fd 2550 else
3c6db9d5 2551 buf = (char *) xmalloc (total + 1);
35692fe0 2552
1f24f4fd
RS
2553 p = buf;
2554 nchars = 0;
2555 n = 0;
35692fe0 2556
1f24f4fd
RS
2557 /* Scan the format and store result in BUF. */
2558 format = XSTRING (args[0])->data;
8f2917e4 2559 maybe_combine_byte = 0;
1f24f4fd
RS
2560 while (format != end)
2561 {
2562 if (*format == '%')
2563 {
2564 int minlen;
25c9e7fb 2565 int negative = 0;
1f24f4fd 2566 unsigned char *this_format_start = format;
35692fe0 2567
1f24f4fd 2568 format++;
fb893977 2569
1f24f4fd
RS
2570 /* Process a numeric arg and skip it. */
2571 minlen = atoi (format);
2572 if (minlen < 0)
25c9e7fb 2573 minlen = - minlen, negative = 1;
35692fe0 2574
1f24f4fd
RS
2575 while ((*format >= '0' && *format <= '9')
2576 || *format == '-' || *format == ' ' || *format == '.')
2577 format++;
35692fe0 2578
1f24f4fd
RS
2579 if (*format++ == '%')
2580 {
2581 *p++ = '%';
2582 nchars++;
2583 continue;
2584 }
2585
2586 ++n;
2587
2588 if (STRINGP (args[n]))
2589 {
25c9e7fb
RS
2590 int padding, nbytes;
2591 int width = strwidth (XSTRING (args[n])->data,
dc3620af 2592 STRING_BYTES (XSTRING (args[n])));
25c9e7fb
RS
2593
2594 /* If spec requires it, pad on right with spaces. */
2595 padding = minlen - width;
2596 if (! negative)
2597 while (padding-- > 0)
2598 {
2599 *p++ = ' ';
2600 nchars++;
2601 }
1f24f4fd 2602
8f2917e4
KH
2603 if (p > buf
2604 && multibyte
25aa5d64 2605 && !ASCII_BYTE_P (*((unsigned char *) p - 1))
8f2917e4 2606 && STRING_MULTIBYTE (args[n])
25aa5d64 2607 && !CHAR_HEAD_P (XSTRING (args[n])->data[0]))
8f2917e4 2608 maybe_combine_byte = 1;
1f24f4fd 2609 nbytes = copy_text (XSTRING (args[n])->data, p,
dc3620af 2610 STRING_BYTES (XSTRING (args[n])),
1f24f4fd
RS
2611 STRING_MULTIBYTE (args[n]), multibyte);
2612 p += nbytes;
2613 nchars += XSTRING (args[n])->size;
2614
25c9e7fb
RS
2615 if (negative)
2616 while (padding-- > 0)
2617 {
2618 *p++ = ' ';
2619 nchars++;
2620 }
1f24f4fd
RS
2621 }
2622 else if (INTEGERP (args[n]) || FLOATP (args[n]))
2623 {
2624 int this_nchars;
2625
2626 bcopy (this_format_start, this_format,
2627 format - this_format_start);
2628 this_format[format - this_format_start] = 0;
2629
d0183d38
RS
2630 if (INTEGERP (args[n]))
2631 sprintf (p, this_format, XINT (args[n]));
2632 else
2633 sprintf (p, this_format, XFLOAT (args[n])->data);
1f24f4fd 2634
8f2917e4
KH
2635 if (p > buf
2636 && multibyte
25aa5d64
KH
2637 && !ASCII_BYTE_P (*((unsigned char *) p - 1))
2638 && !CHAR_HEAD_P (*((unsigned char *) p)))
8f2917e4 2639 maybe_combine_byte = 1;
1f24f4fd
RS
2640 this_nchars = strlen (p);
2641 p += this_nchars;
2642 nchars += this_nchars;
2643 }
2644 }
7df74da6
RS
2645 else if (STRING_MULTIBYTE (args[0]))
2646 {
2647 /* Copy a whole multibyte character. */
8f2917e4
KH
2648 if (p > buf
2649 && multibyte
25aa5d64
KH
2650 && !ASCII_BYTE_P (*((unsigned char *) p - 1))
2651 && !CHAR_HEAD_P (*format))
8f2917e4 2652 maybe_combine_byte = 1;
7df74da6
RS
2653 *p++ = *format++;
2654 while (! CHAR_HEAD_P (*format)) *p++ = *format++;
2655 nchars++;
2656 }
2657 else if (multibyte)
1f24f4fd
RS
2658 {
2659 /* Convert a single-byte character to multibyte. */
2660 int len = copy_text (format, p, 1, 0, 1);
2661
2662 p += len;
2663 format++;
2664 nchars++;
2665 }
2666 else
2667 *p++ = *format++, nchars++;
2668 }
2669
8f2917e4
KH
2670 if (maybe_combine_byte)
2671 nchars = multibyte_chars_in_text (buf, p - buf);
5f75e666 2672 val = make_specified_string (buf, nchars, p - buf, multibyte);
8d6179dc 2673
1f24f4fd
RS
2674 /* If we allocated BUF with malloc, free it too. */
2675 if (total >= 1000)
2676 xfree (buf);
35692fe0 2677
8d6179dc 2678 return val;
35692fe0
JB
2679}
2680
2681/* VARARGS 1 */
2682Lisp_Object
2683#ifdef NO_ARG_ARRAY
2684format1 (string1, arg0, arg1, arg2, arg3, arg4)
679e18b1 2685 EMACS_INT arg0, arg1, arg2, arg3, arg4;
35692fe0
JB
2686#else
2687format1 (string1)
2688#endif
2689 char *string1;
2690{
2691 char buf[100];
2692#ifdef NO_ARG_ARRAY
679e18b1 2693 EMACS_INT args[5];
35692fe0
JB
2694 args[0] = arg0;
2695 args[1] = arg1;
2696 args[2] = arg2;
2697 args[3] = arg3;
2698 args[4] = arg4;
e3670faa 2699 doprnt (buf, sizeof buf, string1, (char *)0, 5, (char **) args);
35692fe0 2700#else
ea4d2909 2701 doprnt (buf, sizeof buf, string1, (char *)0, 5, &string1 + 1);
35692fe0
JB
2702#endif
2703 return build_string (buf);
2704}
2705\f
2706DEFUN ("char-equal", Fchar_equal, Schar_equal, 2, 2, 0,
2707 "Return t if two characters match, optionally ignoring case.\n\
2708Both arguments must be characters (i.e. integers).\n\
2709Case is ignored if `case-fold-search' is non-nil in the current buffer.")
2710 (c1, c2)
2711 register Lisp_Object c1, c2;
2712{
1b5d98bb 2713 int i1, i2;
35692fe0
JB
2714 CHECK_NUMBER (c1, 0);
2715 CHECK_NUMBER (c2, 1);
2716
1b5d98bb 2717 if (XINT (c1) == XINT (c2))
35692fe0 2718 return Qt;
1b5d98bb
RS
2719 if (NILP (current_buffer->case_fold_search))
2720 return Qnil;
2721
2722 /* Do these in separate statements,
2723 then compare the variables.
2724 because of the way DOWNCASE uses temp variables. */
2725 i1 = DOWNCASE (XFASTINT (c1));
2726 i2 = DOWNCASE (XFASTINT (c2));
2727 return (i1 == i2 ? Qt : Qnil);
35692fe0 2728}
b229b8d1
RS
2729\f
2730/* Transpose the markers in two regions of the current buffer, and
2731 adjust the ones between them if necessary (i.e.: if the regions
2732 differ in size).
2733
ec1c14f6
RS
2734 START1, END1 are the character positions of the first region.
2735 START1_BYTE, END1_BYTE are the byte positions.
2736 START2, END2 are the character positions of the second region.
2737 START2_BYTE, END2_BYTE are the byte positions.
2738
b229b8d1
RS
2739 Traverses the entire marker list of the buffer to do so, adding an
2740 appropriate amount to some, subtracting from some, and leaving the
2741 rest untouched. Most of this is copied from adjust_markers in insdel.c.
2742
ec1c14f6 2743 It's the caller's job to ensure that START1 <= END1 <= START2 <= END2. */
b229b8d1
RS
2744
2745void
ec1c14f6
RS
2746transpose_markers (start1, end1, start2, end2,
2747 start1_byte, end1_byte, start2_byte, end2_byte)
b229b8d1 2748 register int start1, end1, start2, end2;
ec1c14f6 2749 register int start1_byte, end1_byte, start2_byte, end2_byte;
b229b8d1 2750{
ec1c14f6 2751 register int amt1, amt1_byte, amt2, amt2_byte, diff, diff_byte, mpos;
b229b8d1 2752 register Lisp_Object marker;
b229b8d1 2753
03240d11 2754 /* Update point as if it were a marker. */
8de1d5f0
KH
2755 if (PT < start1)
2756 ;
2757 else if (PT < end1)
ec1c14f6
RS
2758 TEMP_SET_PT_BOTH (PT + (end2 - end1),
2759 PT_BYTE + (end2_byte - end1_byte));
8de1d5f0 2760 else if (PT < start2)
ec1c14f6
RS
2761 TEMP_SET_PT_BOTH (PT + (end2 - start2) - (end1 - start1),
2762 (PT_BYTE + (end2_byte - start2_byte)
2763 - (end1_byte - start1_byte)));
8de1d5f0 2764 else if (PT < end2)
ec1c14f6
RS
2765 TEMP_SET_PT_BOTH (PT - (start2 - start1),
2766 PT_BYTE - (start2_byte - start1_byte));
8de1d5f0 2767
03240d11
KH
2768 /* We used to adjust the endpoints here to account for the gap, but that
2769 isn't good enough. Even if we assume the caller has tried to move the
2770 gap out of our way, it might still be at start1 exactly, for example;
2771 and that places it `inside' the interval, for our purposes. The amount
2772 of adjustment is nontrivial if there's a `denormalized' marker whose
2773 position is between GPT and GPT + GAP_SIZE, so it's simpler to leave
2774 the dirty work to Fmarker_position, below. */
b229b8d1
RS
2775
2776 /* The difference between the region's lengths */
2777 diff = (end2 - start2) - (end1 - start1);
ec1c14f6 2778 diff_byte = (end2_byte - start2_byte) - (end1_byte - start1_byte);
b229b8d1
RS
2779
2780 /* For shifting each marker in a region by the length of the other
ec1c14f6 2781 region plus the distance between the regions. */
b229b8d1
RS
2782 amt1 = (end2 - start2) + (start2 - end1);
2783 amt2 = (end1 - start1) + (start2 - end1);
ec1c14f6
RS
2784 amt1_byte = (end2_byte - start2_byte) + (start2_byte - end1_byte);
2785 amt2_byte = (end1_byte - start1_byte) + (start2_byte - end1_byte);
b229b8d1 2786
1e158d25 2787 for (marker = BUF_MARKERS (current_buffer); !NILP (marker);
03240d11 2788 marker = XMARKER (marker)->chain)
b229b8d1 2789 {
ec1c14f6
RS
2790 mpos = marker_byte_position (marker);
2791 if (mpos >= start1_byte && mpos < end2_byte)
2792 {
2793 if (mpos < end1_byte)
2794 mpos += amt1_byte;
2795 else if (mpos < start2_byte)
2796 mpos += diff_byte;
2797 else
2798 mpos -= amt2_byte;
f3e1f752 2799 XMARKER (marker)->bytepos = mpos;
ec1c14f6
RS
2800 }
2801 mpos = XMARKER (marker)->charpos;
03240d11
KH
2802 if (mpos >= start1 && mpos < end2)
2803 {
2804 if (mpos < end1)
2805 mpos += amt1;
2806 else if (mpos < start2)
2807 mpos += diff;
2808 else
2809 mpos -= amt2;
03240d11 2810 }
ec1c14f6 2811 XMARKER (marker)->charpos = mpos;
b229b8d1
RS
2812 }
2813}
2814
2815DEFUN ("transpose-regions", Ftranspose_regions, Stranspose_regions, 4, 5, 0,
2816 "Transpose region START1 to END1 with START2 to END2.\n\
2817The regions may not be overlapping, because the size of the buffer is\n\
2818never changed in a transposition.\n\
2819\n\
ec1c14f6 2820Optional fifth arg LEAVE_MARKERS, if non-nil, means don't update\n\
b229b8d1
RS
2821any markers that happen to be located in the regions.\n\
2822\n\
2823Transposing beyond buffer boundaries is an error.")
2824 (startr1, endr1, startr2, endr2, leave_markers)
2825 Lisp_Object startr1, endr1, startr2, endr2, leave_markers;
2826{
ec1c14f6
RS
2827 register int start1, end1, start2, end2;
2828 int start1_byte, start2_byte, len1_byte, len2_byte;
2829 int gap, len1, len_mid, len2;
3c6bc7d0 2830 unsigned char *start1_addr, *start2_addr, *temp;
dc3620af
RS
2831 int combined_before_bytes_1, combined_after_bytes_1;
2832 int combined_before_bytes_2, combined_after_bytes_2;
2833 struct gcpro gcpro1, gcpro2;
b229b8d1
RS
2834
2835#ifdef USE_TEXT_PROPERTIES
2836 INTERVAL cur_intv, tmp_interval1, tmp_interval_mid, tmp_interval2;
1e158d25 2837 cur_intv = BUF_INTERVALS (current_buffer);
b229b8d1
RS
2838#endif /* USE_TEXT_PROPERTIES */
2839
2840 validate_region (&startr1, &endr1);
2841 validate_region (&startr2, &endr2);
2842
2843 start1 = XFASTINT (startr1);
2844 end1 = XFASTINT (endr1);
2845 start2 = XFASTINT (startr2);
2846 end2 = XFASTINT (endr2);
2847 gap = GPT;
2848
2849 /* Swap the regions if they're reversed. */
2850 if (start2 < end1)
2851 {
2852 register int glumph = start1;
2853 start1 = start2;
2854 start2 = glumph;
2855 glumph = end1;
2856 end1 = end2;
2857 end2 = glumph;
2858 }
2859
b229b8d1
RS
2860 len1 = end1 - start1;
2861 len2 = end2 - start2;
2862
2863 if (start2 < end1)
dc3620af 2864 error ("Transposed regions overlap");
b229b8d1 2865 else if (start1 == end1 || start2 == end2)
dc3620af 2866 error ("Transposed region has length 0");
b229b8d1
RS
2867
2868 /* The possibilities are:
2869 1. Adjacent (contiguous) regions, or separate but equal regions
2870 (no, really equal, in this case!), or
2871 2. Separate regions of unequal size.
2872
2873 The worst case is usually No. 2. It means that (aside from
2874 potential need for getting the gap out of the way), there also
2875 needs to be a shifting of the text between the two regions. So
2876 if they are spread far apart, we are that much slower... sigh. */
2877
2878 /* It must be pointed out that the really studly thing to do would
2879 be not to move the gap at all, but to leave it in place and work
2880 around it if necessary. This would be extremely efficient,
2881 especially considering that people are likely to do
2882 transpositions near where they are working interactively, which
2883 is exactly where the gap would be found. However, such code
2884 would be much harder to write and to read. So, if you are
2885 reading this comment and are feeling squirrely, by all means have
2886 a go! I just didn't feel like doing it, so I will simply move
2887 the gap the minimum distance to get it out of the way, and then
2888 deal with an unbroken array. */
3c6bc7d0
RS
2889
2890 /* Make sure the gap won't interfere, by moving it out of the text
2891 we will operate on. */
2892 if (start1 < gap && gap < end2)
2893 {
2894 if (gap - start1 < end2 - gap)
2895 move_gap (start1);
2896 else
2897 move_gap (end2);
2898 }
ec1c14f6
RS
2899
2900 start1_byte = CHAR_TO_BYTE (start1);
2901 start2_byte = CHAR_TO_BYTE (start2);
2902 len1_byte = CHAR_TO_BYTE (end1) - start1_byte;
2903 len2_byte = CHAR_TO_BYTE (end2) - start2_byte;
dc3620af
RS
2904
2905 if (end1 == start2)
2906 {
2907 combined_before_bytes_2
2908 = count_combining_before (BYTE_POS_ADDR (start2_byte),
2909 len2_byte, start1, start1_byte);
2910 combined_before_bytes_1
2911 = count_combining_before (BYTE_POS_ADDR (start1_byte),
2912 len1_byte, end2, start2_byte + len2_byte);
2913 combined_after_bytes_1
2914 = count_combining_after (BYTE_POS_ADDR (start1_byte),
2915 len1_byte, end2, start2_byte + len2_byte);
2916 combined_after_bytes_2 = 0;
2917 }
2918 else
2919 {
2920 combined_before_bytes_2
2921 = count_combining_before (BYTE_POS_ADDR (start2_byte),
2922 len2_byte, start1, start1_byte);
2923 combined_before_bytes_1
2924 = count_combining_before (BYTE_POS_ADDR (start1_byte),
2925 len1_byte, start2, start2_byte);
2926 combined_after_bytes_2
2927 = count_combining_after (BYTE_POS_ADDR (start2_byte),
2928 len2_byte, end1, start1_byte + len1_byte);
2929 combined_after_bytes_1
2930 = count_combining_after (BYTE_POS_ADDR (start1_byte),
2931 len1_byte, end2, start2_byte + len2_byte);
2932 }
2933
2934 /* If any combining is going to happen, do this the stupid way,
2935 because replace handles combining properly. */
2936 if (combined_before_bytes_1 || combined_before_bytes_2
2937 || combined_after_bytes_1 || combined_after_bytes_2)
2938 {
2939 Lisp_Object text1, text2;
2940
2941 text1 = text2 = Qnil;
2942 GCPRO2 (text1, text2);
2943
2944 text1 = make_buffer_string_both (start1, start1_byte,
2945 end1, start1_byte + len1_byte, 1);
2946 text2 = make_buffer_string_both (start2, start2_byte,
2947 end2, start2_byte + len2_byte, 1);
2948
2949 transpose_markers (start1, end1, start2, end2,
2950 start1_byte, start1_byte + len1_byte,
2951 start2_byte, start2_byte + len2_byte);
2952
c2b70590
RS
2953 replace_range (start2, end2, text1, 1, 0, 0);
2954 replace_range (start1, end1, text2, 1, 0, 0);
dc3620af
RS
2955
2956 UNGCPRO;
2957 return Qnil;
2958 }
b229b8d1
RS
2959
2960 /* Hmmm... how about checking to see if the gap is large
2961 enough to use as the temporary storage? That would avoid an
2962 allocation... interesting. Later, don't fool with it now. */
2963
2964 /* Working without memmove, for portability (sigh), so must be
2965 careful of overlapping subsections of the array... */
2966
2967 if (end1 == start2) /* adjacent regions */
2968 {
b229b8d1
RS
2969 modify_region (current_buffer, start1, end2);
2970 record_change (start1, len1 + len2);
2971
2972#ifdef USE_TEXT_PROPERTIES
2973 tmp_interval1 = copy_intervals (cur_intv, start1, len1);
2974 tmp_interval2 = copy_intervals (cur_intv, start2, len2);
09dbcf71
RS
2975 Fset_text_properties (make_number (start1), make_number (end2),
2976 Qnil, Qnil);
b229b8d1
RS
2977#endif /* USE_TEXT_PROPERTIES */
2978
2979 /* First region smaller than second. */
ec1c14f6 2980 if (len1_byte < len2_byte)
b229b8d1 2981 {
3c6bc7d0
RS
2982 /* We use alloca only if it is small,
2983 because we want to avoid stack overflow. */
ec1c14f6
RS
2984 if (len2_byte > 20000)
2985 temp = (unsigned char *) xmalloc (len2_byte);
3c6bc7d0 2986 else
ec1c14f6 2987 temp = (unsigned char *) alloca (len2_byte);
03240d11
KH
2988
2989 /* Don't precompute these addresses. We have to compute them
2990 at the last minute, because the relocating allocator might
2991 have moved the buffer around during the xmalloc. */
23017390
KH
2992 start1_addr = BYTE_POS_ADDR (start1_byte);
2993 start2_addr = BYTE_POS_ADDR (start2_byte);
03240d11 2994
ec1c14f6
RS
2995 bcopy (start2_addr, temp, len2_byte);
2996 bcopy (start1_addr, start1_addr + len2_byte, len1_byte);
2997 bcopy (temp, start1_addr, len2_byte);
2998 if (len2_byte > 20000)
3c6bc7d0 2999 free (temp);
b229b8d1
RS
3000 }
3001 else
3002 /* First region not smaller than second. */
3003 {
ec1c14f6
RS
3004 if (len1_byte > 20000)
3005 temp = (unsigned char *) xmalloc (len1_byte);
3c6bc7d0 3006 else
ec1c14f6 3007 temp = (unsigned char *) alloca (len1_byte);
23017390
KH
3008 start1_addr = BYTE_POS_ADDR (start1_byte);
3009 start2_addr = BYTE_POS_ADDR (start2_byte);
ec1c14f6
RS
3010 bcopy (start1_addr, temp, len1_byte);
3011 bcopy (start2_addr, start1_addr, len2_byte);
3012 bcopy (temp, start1_addr + len2_byte, len1_byte);
3013 if (len1_byte > 20000)
3c6bc7d0 3014 free (temp);
b229b8d1
RS
3015 }
3016#ifdef USE_TEXT_PROPERTIES
3017 graft_intervals_into_buffer (tmp_interval1, start1 + len2,
3018 len1, current_buffer, 0);
3019 graft_intervals_into_buffer (tmp_interval2, start1,
3020 len2, current_buffer, 0);
3021#endif /* USE_TEXT_PROPERTIES */
3022 }
3023 /* Non-adjacent regions, because end1 != start2, bleagh... */
3024 else
3025 {
ec1c14f6
RS
3026 len_mid = start2_byte - (start1_byte + len1_byte);
3027
3028 if (len1_byte == len2_byte)
b229b8d1
RS
3029 /* Regions are same size, though, how nice. */
3030 {
3031 modify_region (current_buffer, start1, end1);
3032 modify_region (current_buffer, start2, end2);
3033 record_change (start1, len1);
3034 record_change (start2, len2);
3035#ifdef USE_TEXT_PROPERTIES
3036 tmp_interval1 = copy_intervals (cur_intv, start1, len1);
3037 tmp_interval2 = copy_intervals (cur_intv, start2, len2);
09dbcf71
RS
3038 Fset_text_properties (make_number (start1), make_number (end1),
3039 Qnil, Qnil);
3040 Fset_text_properties (make_number (start2), make_number (end2),
3041 Qnil, Qnil);
b229b8d1
RS
3042#endif /* USE_TEXT_PROPERTIES */
3043
ec1c14f6
RS
3044 if (len1_byte > 20000)
3045 temp = (unsigned char *) xmalloc (len1_byte);
3c6bc7d0 3046 else
ec1c14f6 3047 temp = (unsigned char *) alloca (len1_byte);
23017390
KH
3048 start1_addr = BYTE_POS_ADDR (start1_byte);
3049 start2_addr = BYTE_POS_ADDR (start2_byte);
ec1c14f6
RS
3050 bcopy (start1_addr, temp, len1_byte);
3051 bcopy (start2_addr, start1_addr, len2_byte);
3052 bcopy (temp, start2_addr, len1_byte);
3053 if (len1_byte > 20000)
3c6bc7d0 3054 free (temp);
b229b8d1
RS
3055#ifdef USE_TEXT_PROPERTIES
3056 graft_intervals_into_buffer (tmp_interval1, start2,
3057 len1, current_buffer, 0);
3058 graft_intervals_into_buffer (tmp_interval2, start1,
3059 len2, current_buffer, 0);
3060#endif /* USE_TEXT_PROPERTIES */
3061 }
3062
ec1c14f6 3063 else if (len1_byte < len2_byte) /* Second region larger than first */
b229b8d1
RS
3064 /* Non-adjacent & unequal size, area between must also be shifted. */
3065 {
b229b8d1
RS
3066 modify_region (current_buffer, start1, end2);
3067 record_change (start1, (end2 - start1));
3068#ifdef USE_TEXT_PROPERTIES
3069 tmp_interval1 = copy_intervals (cur_intv, start1, len1);
3070 tmp_interval_mid = copy_intervals (cur_intv, end1, len_mid);
3071 tmp_interval2 = copy_intervals (cur_intv, start2, len2);
09dbcf71
RS
3072 Fset_text_properties (make_number (start1), make_number (end2),
3073 Qnil, Qnil);
b229b8d1
RS
3074#endif /* USE_TEXT_PROPERTIES */
3075
3c6bc7d0 3076 /* holds region 2 */
ec1c14f6
RS
3077 if (len2_byte > 20000)
3078 temp = (unsigned char *) xmalloc (len2_byte);
3c6bc7d0 3079 else
ec1c14f6 3080 temp = (unsigned char *) alloca (len2_byte);
23017390
KH
3081 start1_addr = BYTE_POS_ADDR (start1_byte);
3082 start2_addr = BYTE_POS_ADDR (start2_byte);
ec1c14f6
RS
3083 bcopy (start2_addr, temp, len2_byte);
3084 bcopy (start1_addr, start1_addr + len_mid + len2_byte, len1_byte);
3085 safe_bcopy (start1_addr + len1_byte, start1_addr + len2_byte, len_mid);
3086 bcopy (temp, start1_addr, len2_byte);
3087 if (len2_byte > 20000)
3c6bc7d0 3088 free (temp);
b229b8d1
RS
3089#ifdef USE_TEXT_PROPERTIES
3090 graft_intervals_into_buffer (tmp_interval1, end2 - len1,
3091 len1, current_buffer, 0);
3092 graft_intervals_into_buffer (tmp_interval_mid, start1 + len2,
3093 len_mid, current_buffer, 0);
3094 graft_intervals_into_buffer (tmp_interval2, start1,
3095 len2, current_buffer, 0);
3096#endif /* USE_TEXT_PROPERTIES */
3097 }
3098 else
3099 /* Second region smaller than first. */
3100 {
b229b8d1
RS
3101 record_change (start1, (end2 - start1));
3102 modify_region (current_buffer, start1, end2);
3103
3104#ifdef USE_TEXT_PROPERTIES
3105 tmp_interval1 = copy_intervals (cur_intv, start1, len1);
3106 tmp_interval_mid = copy_intervals (cur_intv, end1, len_mid);
3107 tmp_interval2 = copy_intervals (cur_intv, start2, len2);
09dbcf71
RS
3108 Fset_text_properties (make_number (start1), make_number (end2),
3109 Qnil, Qnil);
b229b8d1
RS
3110#endif /* USE_TEXT_PROPERTIES */
3111
3c6bc7d0 3112 /* holds region 1 */
ec1c14f6
RS
3113 if (len1_byte > 20000)
3114 temp = (unsigned char *) xmalloc (len1_byte);
3c6bc7d0 3115 else
ec1c14f6 3116 temp = (unsigned char *) alloca (len1_byte);
23017390
KH
3117 start1_addr = BYTE_POS_ADDR (start1_byte);
3118 start2_addr = BYTE_POS_ADDR (start2_byte);
ec1c14f6
RS
3119 bcopy (start1_addr, temp, len1_byte);
3120 bcopy (start2_addr, start1_addr, len2_byte);
3121 bcopy (start1_addr + len1_byte, start1_addr + len2_byte, len_mid);
3122 bcopy (temp, start1_addr + len2_byte + len_mid, len1_byte);
3123 if (len1_byte > 20000)
3c6bc7d0 3124 free (temp);
b229b8d1
RS
3125#ifdef USE_TEXT_PROPERTIES
3126 graft_intervals_into_buffer (tmp_interval1, end2 - len1,
3127 len1, current_buffer, 0);
3128 graft_intervals_into_buffer (tmp_interval_mid, start1 + len2,
3129 len_mid, current_buffer, 0);
3130 graft_intervals_into_buffer (tmp_interval2, start1,
3131 len2, current_buffer, 0);
3132#endif /* USE_TEXT_PROPERTIES */
3133 }
3134 }
3135
ec1c14f6
RS
3136 /* When doing multiple transpositions, it might be nice
3137 to optimize this. Perhaps the markers in any one buffer
3138 should be organized in some sorted data tree. */
b229b8d1 3139 if (NILP (leave_markers))
8de1d5f0 3140 {
ec1c14f6
RS
3141 transpose_markers (start1, end1, start2, end2,
3142 start1_byte, start1_byte + len1_byte,
3143 start2_byte, start2_byte + len2_byte);
8de1d5f0
KH
3144 fix_overlays_in_range (start1, end2);
3145 }
b229b8d1
RS
3146
3147 return Qnil;
3148}
35692fe0 3149
35692fe0
JB
3150\f
3151void
3152syms_of_editfns ()
3153{
260e2e2a
KH
3154 environbuf = 0;
3155
3156 Qbuffer_access_fontify_functions
3157 = intern ("buffer-access-fontify-functions");
3158 staticpro (&Qbuffer_access_fontify_functions);
3159
3160 DEFVAR_LISP ("buffer-access-fontify-functions",
3161 &Vbuffer_access_fontify_functions,
3162 "List of functions called by `buffer-substring' to fontify if necessary.\n\
3163Each function is called with two arguments which specify the range\n\
3164of the buffer being accessed.");
3165 Vbuffer_access_fontify_functions = Qnil;
3166
af209db8
RS
3167 {
3168 Lisp_Object obuf;
3169 extern Lisp_Object Vprin1_to_string_buffer;
3170 obuf = Fcurrent_buffer ();
3171 /* Do this here, because init_buffer_once is too early--it won't work. */
3172 Fset_buffer (Vprin1_to_string_buffer);
3173 /* Make sure buffer-access-fontify-functions is nil in this buffer. */
3174 Fset (Fmake_local_variable (intern ("buffer-access-fontify-functions")),
3175 Qnil);
3176 Fset_buffer (obuf);
3177 }
3178
0b6fd023 3179 DEFVAR_LISP ("buffer-access-fontified-property",
260e2e2a
KH
3180 &Vbuffer_access_fontified_property,
3181 "Property which (if non-nil) indicates text has been fontified.\n\
3182`buffer-substring' need not call the `buffer-access-fontify-functions'\n\
3183functions if all the text being accessed has this property.");
3184 Vbuffer_access_fontified_property = Qnil;
3185
f43754f6
KH
3186 DEFVAR_LISP ("system-name", &Vsystem_name,
3187 "The name of the machine Emacs is running on.");
3188
3189 DEFVAR_LISP ("user-full-name", &Vuser_full_name,
3190 "The full name of the user logged in.");
3191
35b34f72 3192 DEFVAR_LISP ("user-login-name", &Vuser_login_name,
f43754f6
KH
3193 "The user's name, taken from environment variables if possible.");
3194
35b34f72 3195 DEFVAR_LISP ("user-real-login-name", &Vuser_real_login_name,
f43754f6 3196 "The user's name, based upon the real uid only.");
35692fe0
JB
3197
3198 defsubr (&Schar_equal);
3199 defsubr (&Sgoto_char);
3200 defsubr (&Sstring_to_char);
3201 defsubr (&Schar_to_string);
3202 defsubr (&Sbuffer_substring);
260e2e2a 3203 defsubr (&Sbuffer_substring_no_properties);
35692fe0
JB
3204 defsubr (&Sbuffer_string);
3205
3206 defsubr (&Spoint_marker);
3207 defsubr (&Smark_marker);
3208 defsubr (&Spoint);
3209 defsubr (&Sregion_beginning);
3210 defsubr (&Sregion_end);
7df74da6
RS
3211
3212 defsubr (&Sline_beginning_position);
3213 defsubr (&Sline_end_position);
3214
35692fe0
JB
3215/* defsubr (&Smark); */
3216/* defsubr (&Sset_mark); */
3217 defsubr (&Ssave_excursion);
4bc8c7d2 3218 defsubr (&Ssave_current_buffer);
35692fe0
JB
3219
3220 defsubr (&Sbufsize);
3221 defsubr (&Spoint_max);
3222 defsubr (&Spoint_min);
3223 defsubr (&Spoint_min_marker);
3224 defsubr (&Spoint_max_marker);
c86212b9
RS
3225 defsubr (&Sgap_position);
3226 defsubr (&Sgap_size);
7df74da6 3227 defsubr (&Sposition_bytes);
3ab0732d 3228 defsubr (&Sbyte_to_position);
c9ed721d 3229
35692fe0
JB
3230 defsubr (&Sbobp);
3231 defsubr (&Seobp);
3232 defsubr (&Sbolp);
3233 defsubr (&Seolp);
850a8179
JB
3234 defsubr (&Sfollowing_char);
3235 defsubr (&Sprevious_char);
35692fe0 3236 defsubr (&Schar_after);
fb8106e8 3237 defsubr (&Schar_before);
35692fe0
JB
3238 defsubr (&Sinsert);
3239 defsubr (&Sinsert_before_markers);
be91036a
RS
3240 defsubr (&Sinsert_and_inherit);
3241 defsubr (&Sinsert_and_inherit_before_markers);
35692fe0
JB
3242 defsubr (&Sinsert_char);
3243
3244 defsubr (&Suser_login_name);
3245 defsubr (&Suser_real_login_name);
3246 defsubr (&Suser_uid);
3247 defsubr (&Suser_real_uid);
3248 defsubr (&Suser_full_name);
7fd233b3 3249 defsubr (&Semacs_pid);
d940e0e4 3250 defsubr (&Scurrent_time);
a82d387c 3251 defsubr (&Sformat_time_string);
4691c06d 3252 defsubr (&Sdecode_time);
cce7b8a0 3253 defsubr (&Sencode_time);
35692fe0 3254 defsubr (&Scurrent_time_string);
c2662aea 3255 defsubr (&Scurrent_time_zone);
143cb9a9 3256 defsubr (&Sset_time_zone_rule);
35692fe0 3257 defsubr (&Ssystem_name);
35692fe0 3258 defsubr (&Smessage);
cacc3e2c
RS
3259 defsubr (&Smessage_box);
3260 defsubr (&Smessage_or_box);
b14dda8a 3261 defsubr (&Scurrent_message);
35692fe0 3262 defsubr (&Sformat);
35692fe0
JB
3263
3264 defsubr (&Sinsert_buffer_substring);
e9cf2084 3265 defsubr (&Scompare_buffer_substrings);
35692fe0
JB
3266 defsubr (&Ssubst_char_in_region);
3267 defsubr (&Stranslate_region);
3268 defsubr (&Sdelete_region);
3269 defsubr (&Swiden);
3270 defsubr (&Snarrow_to_region);
3271 defsubr (&Ssave_restriction);
b229b8d1 3272 defsubr (&Stranspose_regions);
35692fe0 3273}