comparison src/editfns.c @ 428:3ecd8885ac67 r21-2-22

Import from CVS: tag r21-2-22
author cvs
date Mon, 13 Aug 2007 11:28:15 +0200
parents
children 9d177e8d4150
comparison
equal deleted inserted replaced
427:0a0253eac470 428:3ecd8885ac67
1 /* Lisp functions pertaining to editing.
2 Copyright (C) 1985-1987, 1989, 1992-1995 Free Software Foundation, Inc.
3 Copyright (C) 1995 Tinker Systems and INS Engineering Corp.
4 Copyright (C) 1996 Ben Wing.
5
6 This file is part of XEmacs.
7
8 XEmacs is free software; you can redistribute it and/or modify it
9 under the terms of the GNU General Public License as published by the
10 Free Software Foundation; either version 2, or (at your option) any
11 later version.
12
13 XEmacs is distributed in the hope that it will be useful, but WITHOUT
14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16 for more details.
17
18 You should have received a copy of the GNU General Public License
19 along with XEmacs; see the file COPYING. If not, write to
20 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA. */
22
23 /* Synched up with: Mule 2.0, FSF 19.30. */
24
25 /* This file has been Mule-ized. */
26
27 /* Hacked on for Mule by Ben Wing, December 1994. */
28
29 #include <config.h>
30 #include "lisp.h"
31 #ifdef HAVE_UNISTD_H
32 #include <unistd.h>
33 #endif
34
35 #include "buffer.h"
36 #include "commands.h"
37 #include "events.h" /* for EVENTP */
38 #include "extents.h"
39 #include "frame.h"
40 #include "insdel.h"
41 #include "window.h"
42 #include "chartab.h"
43 #include "line-number.h"
44
45 #include "systime.h"
46 #include "sysdep.h"
47 #include "syspwd.h"
48 #include "sysfile.h" /* for getcwd */
49
50 /* Some static data, and a function to initialize it for each run */
51
52 Lisp_Object Vsystem_name; /* #### - I don't see why this should be */
53 /* static, either... --Stig */
54 #if 0 /* XEmacs - this is now dynamic */
55 /* if at some point it's deemed desirable to
56 use lisp variables here, then they can be
57 initialized to nil and then set to their
58 real values upon the first call to the
59 functions that generate them. --stig */
60 Lisp_Object Vuser_real_login_name; /* login name of current user ID */
61 Lisp_Object Vuser_login_name; /* user name from LOGNAME or USER. */
62 #endif
63
64 /* It's useful to be able to set this as user customization, so we'll
65 keep it. */
66 Lisp_Object Vuser_full_name;
67 EXFUN (Fuser_full_name, 1);
68
69 Lisp_Object Qformat;
70
71 Lisp_Object Qpoint, Qmark, Qregion_beginning, Qregion_end;
72
73 Lisp_Object Quser_files_and_directories;
74
75 /* This holds the value of `environ' produced by the previous
76 call to Fset_time_zone_rule, or 0 if Fset_time_zone_rule
77 has never been called. */
78 static char **environbuf;
79
80 void
81 init_editfns (void)
82 {
83 /* Only used in removed code below. */
84 char *p;
85
86 environbuf = 0;
87
88 /* Set up system_name even when dumping. */
89 init_system_name ();
90
91 #ifndef CANNOT_DUMP
92 if (!initialized)
93 return;
94 #endif
95
96 if ((p = getenv ("NAME")))
97 /* I don't think it's the right thing to do the ampersand
98 modification on NAME. Not that it matters anymore... -hniksic */
99 Vuser_full_name = build_ext_string (p, FORMAT_OS);
100 else
101 Vuser_full_name = Fuser_full_name (Qnil);
102 }
103
104 DEFUN ("char-to-string", Fchar_to_string, 1, 1, 0, /*
105 Convert arg CH to a one-character string containing that character.
106 */
107 (ch))
108 {
109 Bytecount len;
110 Bufbyte str[MAX_EMCHAR_LEN];
111
112 if (EVENTP (ch))
113 {
114 Lisp_Object ch2 = Fevent_to_character (ch, Qt, Qnil, Qnil);
115 if (NILP (ch2))
116 return
117 signal_simple_continuable_error
118 ("character has no ASCII equivalent:", Fcopy_event (ch, Qnil));
119 ch = ch2;
120 }
121
122 CHECK_CHAR_COERCE_INT (ch);
123
124 len = set_charptr_emchar (str, XCHAR (ch));
125 return make_string (str, len);
126 }
127
128 DEFUN ("string-to-char", Fstring_to_char, 1, 1, 0, /*
129 Convert arg STRING to a character, the first character of that string.
130 An empty string will return the constant `nil'.
131 */
132 (str))
133 {
134 struct Lisp_String *p;
135 CHECK_STRING (str);
136
137 p = XSTRING (str);
138 if (string_length (p) != 0)
139 return make_char (string_char (p, 0));
140 else
141 /* This used to return Qzero. That is broken, broken, broken. */
142 /* It might be kinder to signal an error directly. -slb */
143 return Qnil;
144 }
145
146
147 static Lisp_Object
148 buildmark (Bufpos val, Lisp_Object buffer)
149 {
150 Lisp_Object mark = Fmake_marker ();
151 Fset_marker (mark, make_int (val), buffer);
152 return mark;
153 }
154
155 DEFUN ("point", Fpoint, 0, 1, 0, /*
156 Return value of point, as an integer.
157 Beginning of buffer is position (point-min).
158 If BUFFER is nil, the current buffer is assumed.
159 */
160 (buffer))
161 {
162 struct buffer *b = decode_buffer (buffer, 1);
163 return make_int (BUF_PT (b));
164 }
165
166 DEFUN ("point-marker", Fpoint_marker, 0, 2, 0, /*
167 Return value of point, as a marker object.
168 This marker is a copy; you may modify it with reckless abandon.
169 If optional argument DONT-COPY-P is non-nil, then it returns the real
170 point-marker; modifying the position of this marker will move point.
171 It is illegal to change the buffer of it, or make it point nowhere.
172 If BUFFER is nil, the current buffer is assumed.
173 */
174 (dont_copy_p, buffer))
175 {
176 struct buffer *b = decode_buffer (buffer, 1);
177 if (NILP (dont_copy_p))
178 return Fcopy_marker (b->point_marker, Qnil);
179 else
180 return b->point_marker;
181 }
182
183 /* The following two functions end up being identical but it's
184 cleaner to declare them separately. */
185
186 Bufpos
187 bufpos_clip_to_bounds (Bufpos lower, Bufpos num, Bufpos upper)
188 {
189 return (num < lower ? lower :
190 num > upper ? upper :
191 num);
192 }
193
194 Bytind
195 bytind_clip_to_bounds (Bytind lower, Bytind num, Bytind upper)
196 {
197 return (num < lower ? lower :
198 num > upper ? upper :
199 num);
200 }
201
202 /*
203 * Chuck says:
204 * There is no absolute way to determine if goto-char is the function
205 * being run. this-command doesn't work because it is often eval'd
206 * and this-command ends up set to eval-expression. So this flag gets
207 * added for now.
208 *
209 * Jamie thinks he's wrong, but we'll leave this in for now.
210 */
211 int atomic_extent_goto_char_p;
212
213 DEFUN ("goto-char", Fgoto_char, 1, 2, "NGoto char: ", /*
214 Set point to POSITION, a number or marker.
215 Beginning of buffer is position (point-min), end is (point-max).
216 If BUFFER is nil, the current buffer is assumed.
217 Return value of POSITION, as an integer.
218 */
219 (position, buffer))
220 {
221 struct buffer *b = decode_buffer (buffer, 1);
222 Bufpos n = get_buffer_pos_char (b, position, GB_COERCE_RANGE);
223 BUF_SET_PT (b, n);
224 atomic_extent_goto_char_p = 1;
225 return make_int (n);
226 }
227
228 static Lisp_Object
229 region_limit (int beginningp, struct buffer *b)
230 {
231 Lisp_Object m;
232
233 #if 0 /* FSFmacs */
234 if (!NILP (Vtransient_mark_mode) && NILP (Vmark_even_if_inactive)
235 && NILP (b->mark_active))
236 Fsignal (Qmark_inactive, Qnil);
237 #endif
238 m = Fmarker_position (b->mark);
239 if (NILP (m)) error ("There is no region now");
240 if (!!(BUF_PT (b) < XINT (m)) == !!beginningp)
241 return make_int (BUF_PT (b));
242 else
243 return m;
244 }
245
246 DEFUN ("region-beginning", Fregion_beginning, 0, 1, 0, /*
247 Return position of beginning of region in BUFFER, as an integer.
248 If BUFFER is nil, the current buffer is assumed.
249 */
250 (buffer))
251 {
252 return region_limit (1, decode_buffer (buffer, 1));
253 }
254
255 DEFUN ("region-end", Fregion_end, 0, 1, 0, /*
256 Return position of end of region in BUFFER, as an integer.
257 If BUFFER is nil, the current buffer is assumed.
258 */
259 (buffer))
260 {
261 return region_limit (0, decode_buffer (buffer, 1));
262 }
263
264 /* Whether to use lispm-style active-regions */
265 int zmacs_regions;
266
267 /* Whether the zmacs region is active. This is not per-buffer because
268 there can be only one active region at a time. #### Now that the
269 zmacs region are not directly tied to the X selections this may not
270 necessarily have to be true. */
271 int zmacs_region_active_p;
272
273 int zmacs_region_stays;
274
275 Lisp_Object Qzmacs_update_region, Qzmacs_deactivate_region;
276 Lisp_Object Qzmacs_region_buffer;
277
278 void
279 zmacs_update_region (void)
280 {
281 /* This function can GC */
282 if (zmacs_region_active_p)
283 call0 (Qzmacs_update_region);
284 }
285
286 void
287 zmacs_deactivate_region (void)
288 {
289 /* This function can GC */
290 if (zmacs_region_active_p)
291 call0 (Qzmacs_deactivate_region);
292 }
293
294 Lisp_Object
295 zmacs_region_buffer (void)
296 {
297 if (zmacs_region_active_p)
298 return call0 (Qzmacs_region_buffer);
299 else
300 return Qnil;
301 }
302
303 DEFUN ("mark-marker", Fmark_marker, 0, 2, 0, /*
304 Return this buffer's mark, as a marker object.
305 If `zmacs-regions' is true, then this returns nil unless the region is
306 currently in the active (highlighted) state. If optional argument FORCE
307 is t, this returns the mark (if there is one) regardless of the zmacs-region
308 state. You should *generally* not use the mark unless the region is active,
309 if the user has expressed a preference for the zmacs-region model.
310 Watch out! Moving this marker changes the mark position.
311 If you set the marker not to point anywhere, the buffer will have no mark.
312 If BUFFER is nil, the current buffer is assumed.
313 */
314 (force, buffer))
315 {
316 struct buffer *b = decode_buffer (buffer, 1);
317 if (! zmacs_regions || zmacs_region_active_p || !NILP (force))
318 return b->mark;
319 return Qnil;
320 }
321
322
323 /* The saved object is a cons:
324
325 (COPY-OF-POINT-MARKER . COPY-OF-MARK)
326
327 We used to have another cons for a VISIBLE-P element, which was t
328 if `(eq (current-buffer) (window-buffer (selected-window)))' but it
329 was unused for a long time, so I removed it. --hniksic */
330 Lisp_Object
331 save_excursion_save (void)
332 {
333 struct buffer *b;
334
335 /* #### Huh? --hniksic */
336 /*if (preparing_for_armageddon) return Qnil;*/
337
338 #ifdef ERROR_CHECK_BUFPOS
339 assert (XINT (Fpoint (Qnil)) ==
340 XINT (Fmarker_position (Fpoint_marker (Qt, Qnil))));
341 #endif
342
343 b = current_buffer;
344
345 return noseeum_cons (noseeum_copy_marker (b->point_marker, Qnil),
346 noseeum_copy_marker (b->mark, Qnil));
347 }
348
349 Lisp_Object
350 save_excursion_restore (Lisp_Object info)
351 {
352 Lisp_Object buffer = Fmarker_buffer (XCAR (info));
353
354 /* If buffer being returned to is now deleted, avoid error --
355 otherwise could get error here while unwinding to top level and
356 crash. In that case, Fmarker_buffer returns nil now. */
357 if (!NILP (buffer))
358 {
359 struct buffer *buf = XBUFFER (buffer);
360 struct gcpro gcpro1;
361 GCPRO1 (info);
362 set_buffer_internal (buf);
363 Fgoto_char (XCAR (info), buffer);
364 Fset_marker (buf->mark, XCDR (info), buffer);
365
366 #if 0 /* We used to make the current buffer visible in the selected window
367 if that was true previously. That avoids some anomalies.
368 But it creates others, and it wasn't documented, and it is simpler
369 and cleaner never to alter the window/buffer connections. */
370 /* I'm certain some code somewhere depends on this behavior. --jwz */
371 /* Even if it did, it certainly doesn't matter anymore, because
372 this has been the behavior for countless XEmacs releases
373 now. --hniksic */
374 if (visible
375 && (current_buffer != XBUFFER (XWINDOW (selected_window)->buffer)))
376 switch_to_buffer (Fcurrent_buffer (), Qnil);
377 #endif
378
379 UNGCPRO;
380 }
381
382 /* Free all the junk we allocated, so that a `save-excursion' comes
383 for free in terms of GC junk. */
384 free_marker (XMARKER (XCAR (info)));
385 free_marker (XMARKER (XCDR (info)));
386 free_cons (XCONS (info));
387 return Qnil;
388 }
389
390 DEFUN ("save-excursion", Fsave_excursion, 0, UNEVALLED, 0, /*
391 Save point, mark, and current buffer; execute BODY; restore those things.
392 Executes BODY just like `progn'.
393 The values of point, mark and the current buffer are restored
394 even in case of abnormal exit (throw or error).
395 */
396 (args))
397 {
398 /* This function can GC */
399 int speccount = specpdl_depth ();
400
401 record_unwind_protect (save_excursion_restore, save_excursion_save ());
402
403 return unbind_to (speccount, Fprogn (args));
404 }
405
406 Lisp_Object
407 save_current_buffer_restore (Lisp_Object buffer)
408 {
409 struct buffer *buf = XBUFFER (buffer);
410 /* Avoid signaling an error if the buffer is no longer alive. This
411 is for consistency with save-excursion. */
412 if (BUFFER_LIVE_P (buf))
413 set_buffer_internal (buf);
414 return Qnil;
415 }
416
417 DEFUN ("save-current-buffer", Fsave_current_buffer, 0, UNEVALLED, 0, /*
418 Save the current buffer; execute BODY; restore the current buffer.
419 Executes BODY just like `progn'.
420 */
421 (args))
422 {
423 /* This function can GC */
424 int speccount = specpdl_depth ();
425
426 record_unwind_protect (save_current_buffer_restore, Fcurrent_buffer ());
427
428 return unbind_to (speccount, Fprogn (args));
429 }
430
431 DEFUN ("buffer-size", Fbuffer_size, 0, 1, 0, /*
432 Return the number of characters in BUFFER.
433 If BUFFER is nil, the current buffer is assumed.
434 */
435 (buffer))
436 {
437 struct buffer *b = decode_buffer (buffer, 1);
438 return make_int (BUF_SIZE (b));
439 }
440
441 DEFUN ("point-min", Fpoint_min, 0, 1, 0, /*
442 Return the minimum permissible value of point in BUFFER.
443 This is 1, unless narrowing (a buffer restriction) is in effect.
444 If BUFFER is nil, the current buffer is assumed.
445 */
446 (buffer))
447 {
448 struct buffer *b = decode_buffer (buffer, 1);
449 return make_int (BUF_BEGV (b));
450 }
451
452 DEFUN ("point-min-marker", Fpoint_min_marker, 0, 1, 0, /*
453 Return a marker to the minimum permissible value of point in BUFFER.
454 This is the beginning, unless narrowing (a buffer restriction) is in effect.
455 If BUFFER is nil, the current buffer is assumed.
456 */
457 (buffer))
458 {
459 struct buffer *b = decode_buffer (buffer, 1);
460 return buildmark (BUF_BEGV (b), make_buffer (b));
461 }
462
463 DEFUN ("point-max", Fpoint_max, 0, 1, 0, /*
464 Return the maximum permissible value of point in BUFFER.
465 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)
466 is in effect, in which case it is less.
467 If BUFFER is nil, the current buffer is assumed.
468 */
469 (buffer))
470 {
471 struct buffer *b = decode_buffer (buffer, 1);
472 return make_int (BUF_ZV (b));
473 }
474
475 DEFUN ("point-max-marker", Fpoint_max_marker, 0, 1, 0, /*
476 Return a marker to the maximum permissible value of point BUFFER.
477 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)
478 is in effect, in which case it is less.
479 If BUFFER is nil, the current buffer is assumed.
480 */
481 (buffer))
482 {
483 struct buffer *b = decode_buffer (buffer, 1);
484 return buildmark (BUF_ZV (b), make_buffer (b));
485 }
486
487 DEFUN ("following-char", Ffollowing_char, 0, 1, 0, /*
488 Return the character following point.
489 At the end of the buffer or accessible region, return 0.
490 If BUFFER is nil, the current buffer is assumed.
491 */
492 (buffer))
493 {
494 struct buffer *b = decode_buffer (buffer, 1);
495 if (BUF_PT (b) >= BUF_ZV (b))
496 return Qzero; /* #### Gag me! */
497 else
498 return make_char (BUF_FETCH_CHAR (b, BUF_PT (b)));
499 }
500
501 DEFUN ("preceding-char", Fpreceding_char, 0, 1, 0, /*
502 Return the character preceding point.
503 At the beginning of the buffer or accessible region, return 0.
504 If BUFFER is nil, the current buffer is assumed.
505 */
506 (buffer))
507 {
508 struct buffer *b = decode_buffer (buffer, 1);
509 if (BUF_PT (b) <= BUF_BEGV (b))
510 return Qzero; /* #### Gag me! */
511 else
512 return make_char (BUF_FETCH_CHAR (b, BUF_PT (b) - 1));
513 }
514
515 DEFUN ("bobp", Fbobp, 0, 1, 0, /*
516 Return t if point is at the beginning of the buffer.
517 If the buffer is narrowed, this means the beginning of the narrowed part.
518 If BUFFER is nil, the current buffer is assumed.
519 */
520 (buffer))
521 {
522 struct buffer *b = decode_buffer (buffer, 1);
523 return BUF_PT (b) == BUF_BEGV (b) ? Qt : Qnil;
524 }
525
526 DEFUN ("eobp", Feobp, 0, 1, 0, /*
527 Return t if point is at the end of the buffer.
528 If the buffer is narrowed, this means the end of the narrowed part.
529 If BUFFER is nil, the current buffer is assumed.
530 */
531 (buffer))
532 {
533 struct buffer *b = decode_buffer (buffer, 1);
534 return BUF_PT (b) == BUF_ZV (b) ? Qt : Qnil;
535 }
536
537 int
538 beginning_of_line_p (struct buffer *b, Bufpos pt)
539 {
540 return pt <= BUF_BEGV (b) || BUF_FETCH_CHAR (b, pt - 1) == '\n';
541 }
542
543
544 DEFUN ("bolp", Fbolp, 0, 1, 0, /*
545 Return t if point is at the beginning of a line.
546 If BUFFER is nil, the current buffer is assumed.
547 */
548 (buffer))
549 {
550 struct buffer *b = decode_buffer (buffer, 1);
551 return beginning_of_line_p (b, BUF_PT (b)) ? Qt : Qnil;
552 }
553
554 DEFUN ("eolp", Feolp, 0, 1, 0, /*
555 Return t if point is at the end of a line.
556 `End of a line' includes point being at the end of the buffer.
557 If BUFFER is nil, the current buffer is assumed.
558 */
559 (buffer))
560 {
561 struct buffer *b = decode_buffer (buffer, 1);
562 return (BUF_PT (b) == BUF_ZV (b) || BUF_FETCH_CHAR (b, BUF_PT (b)) == '\n')
563 ? Qt : Qnil;
564 }
565
566 DEFUN ("char-after", Fchar_after, 0, 2, 0, /*
567 Return character in BUFFER at position POS.
568 POS is an integer or a buffer pointer.
569 If POS is out of range, the value is nil.
570 If BUFFER is nil, the current buffer is assumed.
571 if POS is nil, the value of point is assumed.
572 */
573 (pos, buffer))
574 {
575 struct buffer *b = decode_buffer (buffer, 1);
576 Bufpos n = (NILP (pos) ? BUF_PT (b) :
577 get_buffer_pos_char (b, pos, GB_NO_ERROR_IF_BAD));
578
579 if (n < 0 || n == BUF_ZV (b))
580 return Qnil;
581 return make_char (BUF_FETCH_CHAR (b, n));
582 }
583
584 DEFUN ("char-before", Fchar_before, 0, 2, 0, /*
585 Return character in BUFFER before position POS.
586 POS is an integer or a buffer pointer.
587 If POS is out of range, the value is nil.
588 If BUFFER is nil, the current buffer is assumed.
589 if POS is nil, the value of point is assumed.
590 */
591 (pos, buffer))
592 {
593 struct buffer *b = decode_buffer (buffer, 1);
594 Bufpos n = ((NILP (pos) ? BUF_PT (b) :
595 get_buffer_pos_char (b, pos, GB_NO_ERROR_IF_BAD)));
596
597 n--;
598
599 if (n < BUF_BEGV (b))
600 return Qnil;
601 return make_char (BUF_FETCH_CHAR (b, n));
602 }
603
604
605 DEFUN ("temp-directory", Ftemp_directory, 0, 0, 0, /*
606 Return the pathname to the directory to use for temporary files.
607 On NT/MSDOS, this is obtained from the TEMP or TMP environment variables,
608 defaulting to / if they are both undefined.
609 On Unix it is obtained from TMPDIR, with /tmp as the default
610 */
611 ())
612 {
613 char *tmpdir;
614 #if defined(WINDOWSNT) || defined(MSDOS)
615 tmpdir = getenv ("TEMP");
616 if (!tmpdir)
617 tmpdir = getenv ("TMP");
618 if (!tmpdir)
619 tmpdir = "/";
620 #else /* WINDOWSNT || MSDOS */
621 tmpdir = getenv ("TMPDIR");
622 if (!tmpdir)
623 tmpdir = "/tmp";
624 #endif
625
626 return build_ext_string (tmpdir, FORMAT_FILENAME);
627 }
628
629 DEFUN ("user-login-name", Fuser_login_name, 0, 1, 0, /*
630 Return the name under which the user logged in, as a string.
631 This is based on the effective uid, not the real uid.
632 Also, if the environment variable LOGNAME or USER is set,
633 that determines the value of this function.
634 If the optional argument UID is present, then environment variables are
635 ignored and this function returns the login name for that UID, or nil.
636 */
637 (uid))
638 {
639 char *returned_name;
640 uid_t local_uid;
641
642 if (!NILP (uid))
643 {
644 CHECK_INT (uid);
645 local_uid = XINT (uid);
646 returned_name = user_login_name (&local_uid);
647 }
648 else
649 {
650 returned_name = user_login_name (NULL);
651 }
652 /* #### - I believe this should return nil instead of "unknown" when pw==0
653 pw=0 is indicated by a null return from user_login_name
654 */
655 return returned_name ? build_string (returned_name) : Qnil;
656 }
657
658 /* This function may be called from other C routines when a
659 character string representation of the user_login_name is
660 needed but a Lisp Object is not. The UID is passed by
661 reference. If UID == NULL, then the USER name
662 for the user running XEmacs will be returned. This
663 corresponds to a nil argument to Fuser_login_name.
664 */
665 char*
666 user_login_name (uid_t *uid)
667 {
668 /* uid == NULL to return name of this user */
669 if (uid != NULL)
670 {
671 struct passwd *pw = getpwuid (*uid);
672 return pw ? pw->pw_name : NULL;
673 }
674 else
675 {
676 /* #### - when euid != uid, then LOGNAME and USER are leftovers from the
677 old environment (I site observed behavior on sunos and linux), so the
678 environment variables should be disregarded in that case. --Stig */
679 char *user_name = getenv ("LOGNAME");
680 if (!user_name)
681 user_name = getenv (
682 #ifdef WINDOWSNT
683 "USERNAME" /* it's USERNAME on NT */
684 #else
685 "USER"
686 #endif
687 );
688 if (user_name)
689 return (user_name);
690 else
691 {
692 struct passwd *pw = getpwuid (geteuid ());
693 #ifdef __CYGWIN32__
694 /* Since the Cygwin environment may not have an /etc/passwd,
695 return "unknown" instead of the null if the username
696 cannot be determined.
697 */
698 return pw ? pw->pw_name : "unknown";
699 #else
700 /* For all but Cygwin return NULL (nil) */
701 return pw ? pw->pw_name : NULL;
702 #endif
703 }
704 }
705 }
706
707 DEFUN ("user-real-login-name", Fuser_real_login_name, 0, 0, 0, /*
708 Return the name of the user's real uid, as a string.
709 This ignores the environment variables LOGNAME and USER, so it differs from
710 `user-login-name' when running under `su'.
711 */
712 ())
713 {
714 struct passwd *pw = getpwuid (getuid ());
715 /* #### - I believe this should return nil instead of "unknown" when pw==0 */
716
717 #ifdef MSDOS
718 /* We let the real user name default to "root" because that's quite
719 accurate on MSDOG and because it lets Emacs find the init file.
720 (The DVX libraries override the Djgpp libraries here.) */
721 Lisp_Object tem = build_string (pw ? pw->pw_name : "root");/* no gettext */
722 #else
723 Lisp_Object tem = build_string (pw ? pw->pw_name : "unknown");/* no gettext */
724 #endif
725 return tem;
726 }
727
728 DEFUN ("user-uid", Fuser_uid, 0, 0, 0, /*
729 Return the effective uid of Emacs, as an integer.
730 */
731 ())
732 {
733 return make_int (geteuid ());
734 }
735
736 DEFUN ("user-real-uid", Fuser_real_uid, 0, 0, 0, /*
737 Return the real uid of Emacs, as an integer.
738 */
739 ())
740 {
741 return make_int (getuid ());
742 }
743
744 DEFUN ("user-full-name", Fuser_full_name, 0, 1, 0, /*
745 Return the full name of the user logged in, as a string.
746 If the optional argument USER is given, then the full name for that
747 user is returned, or nil. USER may be either a login name or a uid.
748
749 If USER is nil, and `user-full-name' contains a string, the
750 value of `user-full-name' is returned.
751 */
752 (user))
753 {
754 Lisp_Object user_name;
755 struct passwd *pw = NULL;
756 Lisp_Object tem;
757 const char *p, *q;
758
759 if (NILP (user) && STRINGP (Vuser_full_name))
760 return Vuser_full_name;
761
762 user_name = (STRINGP (user) ? user : Fuser_login_name (user));
763 if (!NILP (user_name)) /* nil when nonexistent UID passed as arg */
764 {
765 CONST char *user_name_ext;
766
767 /* Fuck me. getpwnam() can call select() and (under IRIX at least)
768 things get wedged if a SIGIO arrives during this time. */
769 GET_C_STRING_OS_DATA_ALLOCA (user_name, user_name_ext);
770 slow_down_interrupts ();
771 pw = (struct passwd *) getpwnam (user_name_ext);
772 speed_up_interrupts ();
773 }
774
775 /* #### - Stig sez: this should return nil instead of "unknown" when pw==0 */
776 /* Ben sez: bad idea because it's likely to break something */
777 #ifndef AMPERSAND_FULL_NAME
778 p = ((pw) ? USER_FULL_NAME : "unknown"); /* don't gettext */
779 q = strchr (p, ',');
780 #else
781 p = ((pw) ? USER_FULL_NAME : "unknown"); /* don't gettext */
782 q = strchr (p, ',');
783 #endif
784 tem = ((!NILP (user) && !pw)
785 ? Qnil
786 : make_ext_string ((Extbyte *) p, (q ? q - p : strlen (p)),
787 FORMAT_OS));
788
789 #ifdef AMPERSAND_FULL_NAME
790 if (!NILP (tem))
791 {
792 p = (char *) XSTRING_DATA (tem);
793 q = strchr (p, '&');
794 /* Substitute the login name for the &, upcasing the first character. */
795 if (q)
796 {
797 char *r = (char *) alloca (strlen (p) + XSTRING_LENGTH (user_name) + 1);
798 memcpy (r, p, q - p);
799 r[q - p] = 0;
800 strcat (r, (char *) XSTRING_DATA (user_name));
801 /* #### current_buffer dependency! */
802 r[q - p] = UPCASE (current_buffer, r[q - p]);
803 strcat (r, q + 1);
804 tem = build_string (r);
805 }
806 }
807 #endif /* AMPERSAND_FULL_NAME */
808
809 return tem;
810 }
811
812 static char *cached_home_directory;
813
814 void
815 uncache_home_directory (void)
816 {
817 cached_home_directory = NULL; /* in some cases, this may cause the leaking
818 of a few bytes */
819 }
820
821 /* Returns the home directory, in external format */
822 char *
823 get_home_directory (void)
824 {
825 int output_home_warning = 0;
826
827 if (cached_home_directory == NULL)
828 {
829 if ((cached_home_directory = getenv("HOME")) == NULL)
830 {
831 #if defined(WINDOWSNT) && !defined(__CYGWIN32__)
832 char *homedrive, *homepath;
833
834 if ((homedrive = getenv("HOMEDRIVE")) != NULL &&
835 (homepath = getenv("HOMEPATH")) != NULL)
836 {
837 cached_home_directory =
838 (char *) xmalloc(strlen(homedrive) + strlen(homepath) + 1);
839 sprintf(cached_home_directory, "%s%s", homedrive, homepath);
840 }
841 else
842 {
843 # if 1
844 /*
845 * Use the current directory.
846 * This preserves the existing XEmacs behavior, but is different
847 * from NT Emacs.
848 */
849 if (initial_directory[0] != '\0')
850 {
851 cached_home_directory = initial_directory;
852 }
853 else
854 {
855 /* This will probably give the wrong value */
856 cached_home_directory = getcwd (NULL, 0);
857 }
858 # else
859 /*
860 * This is NT Emacs behavior
861 */
862 cached_home_directory = "C:\\";
863 output_home_warning = 1;
864 # endif
865 }
866 #else /* !WINDOWSNT */
867 /*
868 * Unix, typically.
869 * Using "/" isn't quite right, but what should we do?
870 * We probably should try to extract pw_dir from /etc/passwd,
871 * before falling back to this.
872 */
873 cached_home_directory = "/";
874 output_home_warning = 1;
875 #endif /* !WINDOWSNT */
876 }
877 if (initialized && output_home_warning)
878 {
879 warn_when_safe (Quser_files_and_directories, Qwarning, "\n"
880 " XEmacs was unable to determine a good value for the user's $HOME\n"
881 " directory, and will be using the value:\n"
882 " %s\n"
883 " This is probably incorrect.",
884 cached_home_directory
885 );
886 }
887 }
888 return cached_home_directory;
889 }
890
891 DEFUN ("user-home-directory", Fuser_home_directory, 0, 0, 0, /*
892 Return the user's home directory, as a string.
893 */
894 ())
895 {
896 char *path = get_home_directory ();
897
898 return path == NULL ? Qnil :
899 Fexpand_file_name (Fsubstitute_in_file_name
900 (build_ext_string (path, FORMAT_FILENAME)),
901 Qnil);
902 }
903
904 DEFUN ("system-name", Fsystem_name, 0, 0, 0, /*
905 Return the name of the machine you are running on, as a string.
906 */
907 ())
908 {
909 return Fcopy_sequence (Vsystem_name);
910 }
911
912 DEFUN ("emacs-pid", Femacs_pid, 0, 0, 0, /*
913 Return the process ID of Emacs, as an integer.
914 */
915 ())
916 {
917 return make_int (getpid ());
918 }
919
920 DEFUN ("current-time", Fcurrent_time, 0, 0, 0, /*
921 Return the current time, as the number of seconds since 1970-01-01 00:00:00.
922 The time is returned as a list of three integers. The first has the
923 most significant 16 bits of the seconds, while the second has the
924 least significant 16 bits. The third integer gives the microsecond
925 count.
926
927 The microsecond count is zero on systems that do not provide
928 resolution finer than a second.
929 */
930 ())
931 {
932 EMACS_TIME t;
933
934 EMACS_GET_TIME (t);
935 return list3 (make_int ((EMACS_SECS (t) >> 16) & 0xffff),
936 make_int ((EMACS_SECS (t) >> 0) & 0xffff),
937 make_int (EMACS_USECS (t)));
938 }
939
940 DEFUN ("current-process-time", Fcurrent_process_time, 0, 0, 0, /*
941 Return the amount of time used by this XEmacs process so far.
942 The return value is a list of three floating-point numbers, expressing
943 the user, system, and real times used by the process. The user time
944 measures the time actually spent by the CPU executing the code in this
945 process. The system time measures time spent by the CPU executing kernel
946 code on behalf of this process (e.g. I/O requests made by the process).
947
948 Note that the user and system times measure processor time, as opposed
949 to real time, and only accrue when the processor is actually doing
950 something: Time spent in an idle wait (waiting for user events to come
951 in or for I/O on a disk drive or other device to complete) does not
952 count. Thus, the user and system times will often be considerably
953 less than the real time.
954
955 Some systems do not allow the user and system times to be distinguished.
956 In this case, the user time will be the total processor time used by
957 the process, and the system time will be 0.
958
959 Some systems do not allow the real and processor times to be distinguished.
960 In this case, the user and real times will be the same and the system
961 time will be 0.
962 */
963 ())
964 {
965 double user, sys, real;
966
967 get_process_times (&user, &sys, &real);
968 return list3 (make_float (user), make_float (sys), make_float (real));
969 }
970
971
972 int lisp_to_time (Lisp_Object specified_time, time_t *result);
973 int
974 lisp_to_time (Lisp_Object specified_time, time_t *result)
975 {
976 Lisp_Object high, low;
977
978 if (NILP (specified_time))
979 return time (result) != -1;
980
981 CHECK_CONS (specified_time);
982 high = XCAR (specified_time);
983 low = XCDR (specified_time);
984 if (CONSP (low))
985 low = XCAR (low);
986 CHECK_INT (high);
987 CHECK_INT (low);
988 *result = (XINT (high) << 16) + (XINT (low) & 0xffff);
989 return *result >> 16 == XINT (high);
990 }
991
992 Lisp_Object time_to_lisp (time_t the_time);
993 Lisp_Object
994 time_to_lisp (time_t the_time)
995 {
996 unsigned int item = (unsigned int) the_time;
997 return Fcons (make_int (item >> 16), make_int (item & 0xffff));
998 }
999
1000 size_t emacs_strftime (char *string, size_t max, CONST char *format,
1001 CONST struct tm *tm);
1002 static long difftm (CONST struct tm *a, CONST struct tm *b);
1003
1004
1005 DEFUN ("format-time-string", Fformat_time_string, 1, 2, 0, /*
1006 Use FORMAT-STRING to format the time TIME.
1007 TIME is specified as (HIGH LOW . IGNORED) or (HIGH . LOW), as from
1008 `current-time' and `file-attributes'. If TIME is not specified it
1009 defaults to the current time.
1010 FORMAT-STRING may contain %-sequences to substitute parts of the time.
1011 %a is replaced by the abbreviated name of the day of week.
1012 %A is replaced by the full name of the day of week.
1013 %b is replaced by the abbreviated name of the month.
1014 %B is replaced by the full name of the month.
1015 %c is a synonym for "%x %X".
1016 %C is a locale-specific synonym, which defaults to "%A, %B %e, %Y" in the C locale.
1017 %d is replaced by the day of month, zero-padded.
1018 %D is a synonym for "%m/%d/%y".
1019 %e is replaced by the day of month, blank-padded.
1020 %h is a synonym for "%b".
1021 %H is replaced by the hour (00-23).
1022 %I is replaced by the hour (00-12).
1023 %j is replaced by the day of the year (001-366).
1024 %k is replaced by the hour (0-23), blank padded.
1025 %l is replaced by the hour (1-12), blank padded.
1026 %m is replaced by the month (01-12).
1027 %M is replaced by the minute (00-59).
1028 %n is a synonym for "\\n".
1029 %p is replaced by AM or PM, as appropriate.
1030 %r is a synonym for "%I:%M:%S %p".
1031 %R is a synonym for "%H:%M".
1032 %s is replaced by the time in seconds since 00:00:00, Jan 1, 1970 (a
1033 nonstandard extension)
1034 %S is replaced by the second (00-60).
1035 %t is a synonym for "\\t".
1036 %T is a synonym for "%H:%M:%S".
1037 %U is replaced by the week of the year (00-53), first day of week is Sunday.
1038 %w is replaced by the day of week (0-6), Sunday is day 0.
1039 %W is replaced by the week of the year (00-53), first day of week is Monday.
1040 %x is a locale-specific synonym, which defaults to "%D" in the C locale.
1041 %X is a locale-specific synonym, which defaults to "%T" in the C locale.
1042 %y is replaced by the year without century (00-99).
1043 %Y is replaced by the year with century.
1044 %Z is replaced by the time zone abbreviation.
1045
1046 The number of options reflects the `strftime' function.
1047
1048 BUG: If the charset used by the current locale is not ISO 8859-1, the
1049 characters appearing in the day and month names may be incorrect.
1050 */
1051 (format_string, time_))
1052 {
1053 time_t value;
1054 size_t size;
1055
1056 CHECK_STRING (format_string);
1057
1058 if (! lisp_to_time (time_, &value))
1059 error ("Invalid time specification");
1060
1061 /* This is probably enough. */
1062 size = XSTRING_LENGTH (format_string) * 6 + 50;
1063
1064 while (1)
1065 {
1066 char *buf = (char *) alloca (size);
1067 *buf = 1;
1068 if (emacs_strftime (buf, size,
1069 (CONST char *) XSTRING_DATA (format_string),
1070 localtime (&value))
1071 || !*buf)
1072 return build_ext_string (buf, FORMAT_BINARY);
1073 /* If buffer was too small, make it bigger. */
1074 size *= 2;
1075 }
1076 }
1077
1078 DEFUN ("decode-time", Fdecode_time, 0, 1, 0, /*
1079 Decode a time value as (SEC MINUTE HOUR DAY MONTH YEAR DOW DST ZONE).
1080 The optional SPECIFIED-TIME should be a list of (HIGH LOW . IGNORED)
1081 or (HIGH . LOW), as from `current-time' and `file-attributes', or `nil'
1082 to use the current time. The list has the following nine members:
1083 SEC is an integer between 0 and 60; SEC is 60 for a leap second, which
1084 only some operating systems support. MINUTE is an integer between 0 and 59.
1085 HOUR is an integer between 0 and 23. DAY is an integer between 1 and 31.
1086 MONTH is an integer between 1 and 12. YEAR is an integer indicating the
1087 four-digit year. DOW is the day of week, an integer between 0 and 6, where
1088 0 is Sunday. DST is t if daylight savings time is effect, otherwise nil.
1089 ZONE is an integer indicating the number of seconds east of Greenwich.
1090 \(Note that Common Lisp has different meanings for DOW and ZONE.)
1091 */
1092 (specified_time))
1093 {
1094 time_t time_spec;
1095 struct tm save_tm;
1096 struct tm *decoded_time;
1097 Lisp_Object list_args[9];
1098
1099 if (! lisp_to_time (specified_time, &time_spec))
1100 error ("Invalid time specification");
1101
1102 decoded_time = localtime (&time_spec);
1103 list_args[0] = make_int (decoded_time->tm_sec);
1104 list_args[1] = make_int (decoded_time->tm_min);
1105 list_args[2] = make_int (decoded_time->tm_hour);
1106 list_args[3] = make_int (decoded_time->tm_mday);
1107 list_args[4] = make_int (decoded_time->tm_mon + 1);
1108 list_args[5] = make_int (decoded_time->tm_year + 1900);
1109 list_args[6] = make_int (decoded_time->tm_wday);
1110 list_args[7] = (decoded_time->tm_isdst)? Qt : Qnil;
1111
1112 /* Make a copy, in case gmtime modifies the struct. */
1113 save_tm = *decoded_time;
1114 decoded_time = gmtime (&time_spec);
1115 if (decoded_time == 0)
1116 list_args[8] = Qnil;
1117 else
1118 list_args[8] = make_int (difftm (&save_tm, decoded_time));
1119 return Flist (9, list_args);
1120 }
1121
1122 static void set_time_zone_rule (char *tzstring);
1123
1124 DEFUN ("encode-time", Fencode_time, 6, MANY, 0, /*
1125 Convert SECOND, MINUTE, HOUR, DAY, MONTH, YEAR and ZONE to internal time.
1126 This is the reverse operation of `decode-time', which see.
1127 ZONE defaults to the current time zone rule. This can
1128 be a string (as from `set-time-zone-rule'), or it can be a list
1129 \(as from `current-time-zone') or an integer (as from `decode-time')
1130 applied without consideration for daylight savings time.
1131
1132 You can pass more than 7 arguments; then the first six arguments
1133 are used as SECOND through YEAR, and the *last* argument is used as ZONE.
1134 The intervening arguments are ignored.
1135 This feature lets (apply 'encode-time (decode-time ...)) work.
1136
1137 Out-of-range values for SEC, MINUTE, HOUR, DAY, or MONTH are allowed;
1138 for example, a DAY of 0 means the day preceding the given month.
1139 Year numbers less than 100 are treated just like other year numbers.
1140 If you want them to stand for years in this century, you must do that yourself.
1141 */
1142 (int nargs, Lisp_Object *args))
1143 {
1144 time_t the_time;
1145 struct tm tm;
1146 Lisp_Object zone = (nargs > 6) ? args[nargs - 1] : Qnil;
1147
1148 CHECK_INT (*args); tm.tm_sec = XINT (*args++); /* second */
1149 CHECK_INT (*args); tm.tm_min = XINT (*args++); /* minute */
1150 CHECK_INT (*args); tm.tm_hour = XINT (*args++); /* hour */
1151 CHECK_INT (*args); tm.tm_mday = XINT (*args++); /* day */
1152 CHECK_INT (*args); tm.tm_mon = XINT (*args++) - 1; /* month */
1153 CHECK_INT (*args); tm.tm_year = XINT (*args++) - 1900;/* year */
1154
1155 tm.tm_isdst = -1;
1156
1157 if (CONSP (zone))
1158 zone = XCAR (zone);
1159 if (NILP (zone))
1160 the_time = mktime (&tm);
1161 else
1162 {
1163 char tzbuf[100];
1164 char *tzstring;
1165 char **oldenv = environ, **newenv;
1166
1167 if (STRINGP (zone))
1168 tzstring = (char *) XSTRING_DATA (zone);
1169 else if (INTP (zone))
1170 {
1171 int abszone = abs (XINT (zone));
1172 sprintf (tzbuf, "XXX%s%d:%02d:%02d", "-" + (XINT (zone) < 0),
1173 abszone / (60*60), (abszone/60) % 60, abszone % 60);
1174 tzstring = tzbuf;
1175 }
1176 else
1177 error ("Invalid time zone specification");
1178
1179 /* Set TZ before calling mktime; merely adjusting mktime's returned
1180 value doesn't suffice, since that would mishandle leap seconds. */
1181 set_time_zone_rule (tzstring);
1182
1183 the_time = mktime (&tm);
1184
1185 /* Restore TZ to previous value. */
1186 newenv = environ;
1187 environ = oldenv;
1188 free (newenv);
1189 #ifdef LOCALTIME_CACHE
1190 tzset ();
1191 #endif
1192 }
1193
1194 if (the_time == (time_t) -1)
1195 error ("Specified time is not representable");
1196
1197 return wasteful_word_to_lisp (the_time);
1198 }
1199
1200 DEFUN ("current-time-string", Fcurrent_time_string, 0, 1, 0, /*
1201 Return the current time, as a human-readable string.
1202 Programs can use this function to decode a time,
1203 since the number of columns in each field is fixed.
1204 The format is `Sun Sep 16 01:03:52 1973'.
1205 If an argument is given, it specifies a time to format
1206 instead of the current time. The argument should have the form:
1207 (HIGH . LOW)
1208 or the form:
1209 (HIGH LOW . IGNORED).
1210 Thus, you can use times obtained from `current-time'
1211 and from `file-attributes'.
1212 */
1213 (specified_time))
1214 {
1215 time_t value;
1216 char buf[30];
1217 char *tem;
1218
1219 if (! lisp_to_time (specified_time, &value))
1220 value = -1;
1221 tem = (char *) ctime (&value);
1222
1223 strncpy (buf, tem, 24);
1224 buf[24] = 0;
1225
1226 return build_ext_string (buf, FORMAT_BINARY);
1227 }
1228
1229 #define TM_YEAR_ORIGIN 1900
1230
1231 /* Yield A - B, measured in seconds. */
1232 static long
1233 difftm (CONST struct tm *a, CONST struct tm *b)
1234 {
1235 int ay = a->tm_year + (TM_YEAR_ORIGIN - 1);
1236 int by = b->tm_year + (TM_YEAR_ORIGIN - 1);
1237 /* Some compilers can't handle this as a single return statement. */
1238 long days = (
1239 /* difference in day of year */
1240 a->tm_yday - b->tm_yday
1241 /* + intervening leap days */
1242 + ((ay >> 2) - (by >> 2))
1243 - (ay/100 - by/100)
1244 + ((ay/100 >> 2) - (by/100 >> 2))
1245 /* + difference in years * 365 */
1246 + (long)(ay-by) * 365
1247 );
1248 return (60*(60*(24*days + (a->tm_hour - b->tm_hour))
1249 + (a->tm_min - b->tm_min))
1250 + (a->tm_sec - b->tm_sec));
1251 }
1252
1253 DEFUN ("current-time-zone", Fcurrent_time_zone, 0, 1, 0, /*
1254 Return the offset and name for the local time zone.
1255 This returns a list of the form (OFFSET NAME).
1256 OFFSET is an integer number of seconds ahead of UTC (east of Greenwich).
1257 A negative value means west of Greenwich.
1258 NAME is a string giving the name of the time zone.
1259 If an argument is given, it specifies when the time zone offset is determined
1260 instead of using the current time. The argument should have the form:
1261 (HIGH . LOW)
1262 or the form:
1263 (HIGH LOW . IGNORED).
1264 Thus, you can use times obtained from `current-time'
1265 and from `file-attributes'.
1266
1267 Some operating systems cannot provide all this information to Emacs;
1268 in this case, `current-time-zone' returns a list containing nil for
1269 the data it can't find.
1270 */
1271 (specified_time))
1272 {
1273 time_t value;
1274 struct tm *t = NULL;
1275
1276 if (lisp_to_time (specified_time, &value)
1277 && (t = gmtime (&value)) != 0)
1278 {
1279 struct tm gmt = *t; /* Make a copy, in case localtime modifies *t. */
1280 long offset;
1281 char *s, buf[6];
1282
1283 t = localtime (&value);
1284 offset = difftm (t, &gmt);
1285 s = 0;
1286 #ifdef HAVE_TM_ZONE
1287 if (t->tm_zone)
1288 s = (char *)t->tm_zone;
1289 #else /* not HAVE_TM_ZONE */
1290 #ifdef HAVE_TZNAME
1291 if (t->tm_isdst == 0 || t->tm_isdst == 1)
1292 s = tzname[t->tm_isdst];
1293 #endif
1294 #endif /* not HAVE_TM_ZONE */
1295 if (!s)
1296 {
1297 /* No local time zone name is available; use "+-NNNN" instead. */
1298 int am = (offset < 0 ? -offset : offset) / 60;
1299 sprintf (buf, "%c%02d%02d", (offset < 0 ? '-' : '+'), am/60, am%60);
1300 s = buf;
1301 }
1302 return list2 (make_int (offset), build_string (s));
1303 }
1304 else
1305 return list2 (Qnil, Qnil);
1306 }
1307
1308 #ifdef LOCALTIME_CACHE
1309
1310 /* These two values are known to load tz files in buggy implementations,
1311 i.e. Solaris 1 executables running under either Solaris 1 or Solaris 2.
1312 Their values shouldn't matter in non-buggy implementations.
1313 We don't use string literals for these strings,
1314 since if a string in the environment is in readonly
1315 storage, it runs afoul of bugs in SVR4 and Solaris 2.3.
1316 See Sun bugs 1113095 and 1114114, ``Timezone routines
1317 improperly modify environment''. */
1318
1319 static char set_time_zone_rule_tz1[] = "TZ=GMT+0";
1320 static char set_time_zone_rule_tz2[] = "TZ=GMT+1";
1321
1322 #endif
1323
1324 /* Set the local time zone rule to TZSTRING.
1325 This allocates memory into `environ', which it is the caller's
1326 responsibility to free. */
1327 static void
1328 set_time_zone_rule (char *tzstring)
1329 {
1330 int envptrs;
1331 char **from, **to, **newenv;
1332
1333 for (from = environ; *from; from++)
1334 continue;
1335 envptrs = from - environ + 2;
1336 newenv = to = (char **) xmalloc (envptrs * sizeof (char *)
1337 + (tzstring ? strlen (tzstring) + 4 : 0));
1338 if (tzstring)
1339 {
1340 char *t = (char *) (to + envptrs);
1341 strcpy (t, "TZ=");
1342 strcat (t, tzstring);
1343 *to++ = t;
1344 }
1345
1346 for (from = environ; *from; from++)
1347 if (strncmp (*from, "TZ=", 3) != 0)
1348 *to++ = *from;
1349 *to = 0;
1350
1351 environ = newenv;
1352
1353 #ifdef LOCALTIME_CACHE
1354 {
1355 /* In SunOS 4.1.3_U1 and 4.1.4, if TZ has a value like
1356 "US/Pacific" that loads a tz file, then changes to a value like
1357 "XXX0" that does not load a tz file, and then changes back to
1358 its original value, the last change is (incorrectly) ignored.
1359 Also, if TZ changes twice in succession to values that do
1360 not load a tz file, tzset can dump core (see Sun bug#1225179).
1361 The following code works around these bugs. */
1362
1363 if (tzstring)
1364 {
1365 /* Temporarily set TZ to a value that loads a tz file
1366 and that differs from tzstring. */
1367 char *tz = *newenv;
1368 *newenv = (strcmp (tzstring, set_time_zone_rule_tz1 + 3) == 0
1369 ? set_time_zone_rule_tz2 : set_time_zone_rule_tz1);
1370 tzset ();
1371 *newenv = tz;
1372 }
1373 else
1374 {
1375 /* The implied tzstring is unknown, so temporarily set TZ to
1376 two different values that each load a tz file. */
1377 *to = set_time_zone_rule_tz1;
1378 to[1] = 0;
1379 tzset ();
1380 *to = set_time_zone_rule_tz2;
1381 tzset ();
1382 *to = 0;
1383 }
1384
1385 /* Now TZ has the desired value, and tzset can be invoked safely. */
1386 }
1387
1388 tzset ();
1389 #endif
1390 }
1391
1392 DEFUN ("set-time-zone-rule", Fset_time_zone_rule, 1, 1, 0, /*
1393 Set the local time zone using TZ, a string specifying a time zone rule.
1394 If TZ is nil, use implementation-defined default time zone information.
1395 */
1396 (tz))
1397 {
1398 char *tzstring;
1399
1400 if (NILP (tz))
1401 tzstring = 0;
1402 else
1403 {
1404 CHECK_STRING (tz);
1405 tzstring = (char *) XSTRING_DATA (tz);
1406 }
1407
1408 set_time_zone_rule (tzstring);
1409 if (environbuf)
1410 xfree (environbuf);
1411 environbuf = environ;
1412
1413 return Qnil;
1414 }
1415
1416
1417 void
1418 buffer_insert1 (struct buffer *buf, Lisp_Object arg)
1419 {
1420 /* This function can GC */
1421 struct gcpro gcpro1;
1422 GCPRO1 (arg);
1423 retry:
1424 if (CHAR_OR_CHAR_INTP (arg))
1425 {
1426 buffer_insert_emacs_char (buf, XCHAR_OR_CHAR_INT (arg));
1427 }
1428 else if (STRINGP (arg))
1429 {
1430 buffer_insert_lisp_string (buf, arg);
1431 }
1432 else
1433 {
1434 arg = wrong_type_argument (Qchar_or_string_p, arg);
1435 goto retry;
1436 }
1437 zmacs_region_stays = 0;
1438 UNGCPRO;
1439 }
1440
1441
1442 /* Callers passing one argument to Finsert need not gcpro the
1443 argument "array", since the only element of the array will
1444 not be used after calling insert_emacs_char or insert_lisp_string,
1445 so we don't care if it gets trashed. */
1446
1447 DEFUN ("insert", Finsert, 0, MANY, 0, /*
1448 Insert the arguments, either strings or characters, at point.
1449 Point moves forward so that it ends up after the inserted text.
1450 Any other markers at the point of insertion remain before the text.
1451 If a string has non-null string-extent-data, new extents will be created.
1452 */
1453 (int nargs, Lisp_Object *args))
1454 {
1455 /* This function can GC */
1456 REGISTER int argnum;
1457
1458 for (argnum = 0; argnum < nargs; argnum++)
1459 {
1460 buffer_insert1 (current_buffer, args[argnum]);
1461 }
1462
1463 return Qnil;
1464 }
1465
1466 DEFUN ("insert-before-markers", Finsert_before_markers, 0, MANY, 0, /*
1467 Insert strings or characters at point, relocating markers after the text.
1468 Point moves forward so that it ends up after the inserted text.
1469 Any other markers at the point of insertion also end up after the text.
1470 */
1471 (int nargs, Lisp_Object *args))
1472 {
1473 /* This function can GC */
1474 REGISTER int argnum;
1475 REGISTER Lisp_Object tem;
1476
1477 for (argnum = 0; argnum < nargs; argnum++)
1478 {
1479 tem = args[argnum];
1480 retry:
1481 if (CHAR_OR_CHAR_INTP (tem))
1482 {
1483 buffer_insert_emacs_char_1 (current_buffer, -1,
1484 XCHAR_OR_CHAR_INT (tem),
1485 INSDEL_BEFORE_MARKERS);
1486 }
1487 else if (STRINGP (tem))
1488 {
1489 buffer_insert_lisp_string_1 (current_buffer, -1, tem,
1490 INSDEL_BEFORE_MARKERS);
1491 }
1492 else
1493 {
1494 tem = wrong_type_argument (Qchar_or_string_p, tem);
1495 goto retry;
1496 }
1497 }
1498 zmacs_region_stays = 0;
1499 return Qnil;
1500 }
1501
1502 DEFUN ("insert-string", Finsert_string, 1, 2, 0, /*
1503 Insert STRING into BUFFER at BUFFER's point.
1504 Point moves forward so that it ends up after the inserted text.
1505 Any other markers at the point of insertion remain before the text.
1506 If a string has non-null string-extent-data, new extents will be created.
1507 BUFFER defaults to the current buffer.
1508 */
1509 (string, buffer))
1510 {
1511 struct buffer *b = decode_buffer (buffer, 1);
1512 CHECK_STRING (string);
1513 buffer_insert_lisp_string (b, string);
1514 zmacs_region_stays = 0;
1515 return Qnil;
1516 }
1517
1518 /* Third argument in FSF is INHERIT:
1519
1520 "The optional third arg INHERIT, if non-nil, says to inherit text properties
1521 from adjoining text, if those properties are sticky."
1522
1523 Jamie thinks this is bogus. */
1524
1525
1526 DEFUN ("insert-char", Finsert_char, 1, 4, 0, /*
1527 Insert COUNT (second arg) copies of CHR (first arg).
1528 Point and all markers are affected as in the function `insert'.
1529 COUNT defaults to 1 if omitted.
1530 The optional third arg IGNORED is INHERIT under FSF Emacs.
1531 This is highly bogus, however, and XEmacs always behaves as if
1532 `t' were passed to INHERIT.
1533 The optional fourth arg BUFFER specifies the buffer to insert the
1534 text into. If BUFFER is nil, the current buffer is assumed.
1535 */
1536 (chr, count, ignored, buffer))
1537 {
1538 /* This function can GC */
1539 REGISTER Bufbyte *string;
1540 REGISTER int slen;
1541 REGISTER int i, j;
1542 REGISTER Bytecount n;
1543 REGISTER Bytecount charlen;
1544 Bufbyte str[MAX_EMCHAR_LEN];
1545 struct buffer *b = decode_buffer (buffer, 1);
1546 int cou;
1547
1548 CHECK_CHAR_COERCE_INT (chr);
1549 if (NILP (count))
1550 cou = 1;
1551 else
1552 {
1553 CHECK_INT (count);
1554 cou = XINT (count);
1555 }
1556
1557 charlen = set_charptr_emchar (str, XCHAR (chr));
1558 n = cou * charlen;
1559 if (n <= 0)
1560 return Qnil;
1561 slen = min (n, 768);
1562 string = alloca_array (Bufbyte, slen);
1563 /* Write as many copies of the character into the temp string as will fit. */
1564 for (i = 0; i + charlen <= slen; i += charlen)
1565 for (j = 0; j < charlen; j++)
1566 string[i + j] = str[j];
1567 slen = i;
1568 while (n >= slen)
1569 {
1570 buffer_insert_raw_string (b, string, slen);
1571 n -= slen;
1572 }
1573 if (n > 0)
1574 #if 0 /* FSFmacs bogosity */
1575 {
1576 if (!NILP (inherit))
1577 insert_and_inherit (string, n);
1578 else
1579 insert (string, n);
1580 }
1581 #else
1582 buffer_insert_raw_string (b, string, n);
1583 #endif
1584
1585 zmacs_region_stays = 0;
1586 return Qnil;
1587 }
1588
1589
1590 /* Making strings from buffer contents. */
1591
1592 DEFUN ("buffer-substring", Fbuffer_substring, 0, 3, 0, /*
1593 Return the contents of part of BUFFER as a string.
1594 The two arguments START and END are character positions;
1595 they can be in either order. If omitted, they default to the beginning
1596 and end of BUFFER, respectively.
1597 If there are duplicable extents in the region, the string remembers
1598 them in its extent data.
1599 If BUFFER is nil, the current buffer is assumed.
1600 */
1601 (start, end, buffer))
1602 {
1603 /* This function can GC */
1604 Bufpos begv, zv;
1605 struct buffer *b = decode_buffer (buffer, 1);
1606
1607 get_buffer_range_char (b, start, end, &begv, &zv, GB_ALLOW_NIL);
1608 return make_string_from_buffer (b, begv, zv - begv);
1609 }
1610
1611 /* It might make more sense to name this
1612 `buffer-substring-no-extents', but this name is FSFmacs-compatible,
1613 and what the function does is probably good enough for what the
1614 user-code will typically want to use it for. */
1615 DEFUN ("buffer-substring-no-properties", Fbuffer_substring_no_properties, 0, 3, 0, /*
1616 Return the text from BEG to END, as a string, without copying the extents.
1617 */
1618 (start, end, buffer))
1619 {
1620 /* This function can GC */
1621 Bufpos begv, zv;
1622 struct buffer *b = decode_buffer (buffer, 1);
1623
1624 get_buffer_range_char (b, start, end, &begv, &zv, GB_ALLOW_NIL);
1625 return make_string_from_buffer_no_extents (b, begv, zv - begv);
1626 }
1627
1628 DEFUN ("insert-buffer-substring", Finsert_buffer_substring, 1, 3, 0, /*
1629 Insert before point a substring of the contents of buffer BUFFER.
1630 BUFFER may be a buffer or a buffer name.
1631 Arguments START and END are character numbers specifying the substring.
1632 They default to the beginning and the end of BUFFER.
1633 */
1634 (buffer, start, end))
1635 {
1636 /* This function can GC */
1637 Bufpos b, e;
1638 struct buffer *bp;
1639
1640 bp = XBUFFER (get_buffer (buffer, 1));
1641 get_buffer_range_char (bp, start, end, &b, &e, GB_ALLOW_NIL);
1642
1643 if (b < e)
1644 buffer_insert_from_buffer (current_buffer, bp, b, e - b);
1645
1646 return Qnil;
1647 }
1648
1649 DEFUN ("compare-buffer-substrings", Fcompare_buffer_substrings, 6, 6, 0, /*
1650 Compare two substrings of two buffers; return result as number.
1651 the value is -N if first string is less after N-1 chars,
1652 +N if first string is greater after N-1 chars, or 0 if strings match.
1653 Each substring is represented as three arguments: BUFFER, START and END.
1654 That makes six args in all, three for each substring.
1655
1656 The value of `case-fold-search' in the current buffer
1657 determines whether case is significant or ignored.
1658 */
1659 (buffer1, start1, end1, buffer2, start2, end2))
1660 {
1661 Bufpos begp1, endp1, begp2, endp2;
1662 REGISTER Charcount len1, len2, length, i;
1663 struct buffer *bp1, *bp2;
1664 Lisp_Object trt = ((!NILP (current_buffer->case_fold_search)) ?
1665 current_buffer->case_canon_table : Qnil);
1666
1667 /* Find the first buffer and its substring. */
1668
1669 bp1 = decode_buffer (buffer1, 1);
1670 get_buffer_range_char (bp1, start1, end1, &begp1, &endp1, GB_ALLOW_NIL);
1671
1672 /* Likewise for second substring. */
1673
1674 bp2 = decode_buffer (buffer2, 1);
1675 get_buffer_range_char (bp2, start2, end2, &begp2, &endp2, GB_ALLOW_NIL);
1676
1677 len1 = endp1 - begp1;
1678 len2 = endp2 - begp2;
1679 length = len1;
1680 if (len2 < length)
1681 length = len2;
1682
1683 for (i = 0; i < length; i++)
1684 {
1685 Emchar c1 = BUF_FETCH_CHAR (bp1, begp1 + i);
1686 Emchar c2 = BUF_FETCH_CHAR (bp2, begp2 + i);
1687 if (!NILP (trt))
1688 {
1689 c1 = TRT_TABLE_OF (trt, c1);
1690 c2 = TRT_TABLE_OF (trt, c2);
1691 }
1692 if (c1 < c2)
1693 return make_int (- 1 - i);
1694 if (c1 > c2)
1695 return make_int (i + 1);
1696 }
1697
1698 /* The strings match as far as they go.
1699 If one is shorter, that one is less. */
1700 if (length < len1)
1701 return make_int (length + 1);
1702 else if (length < len2)
1703 return make_int (- length - 1);
1704
1705 /* Same length too => they are equal. */
1706 return Qzero;
1707 }
1708
1709
1710 static Lisp_Object
1711 subst_char_in_region_unwind (Lisp_Object arg)
1712 {
1713 XBUFFER (XCAR (arg))->undo_list = XCDR (arg);
1714 return Qnil;
1715 }
1716
1717 static Lisp_Object
1718 subst_char_in_region_unwind_1 (Lisp_Object arg)
1719 {
1720 XBUFFER (XCAR (arg))->filename = XCDR (arg);
1721 return Qnil;
1722 }
1723
1724 DEFUN ("subst-char-in-region", Fsubst_char_in_region, 4, 5, 0, /*
1725 From START to END, replace FROMCHAR with TOCHAR each time it occurs.
1726 If optional arg NOUNDO is non-nil, don't record this change for undo
1727 and don't mark the buffer as really changed.
1728 */
1729 (start, end, fromchar, tochar, noundo))
1730 {
1731 /* This function can GC */
1732 Bufpos pos, stop;
1733 Emchar fromc, toc;
1734 int mc_count;
1735 struct buffer *buf = current_buffer;
1736 int count = specpdl_depth ();
1737
1738 get_buffer_range_char (buf, start, end, &pos, &stop, 0);
1739 CHECK_CHAR_COERCE_INT (fromchar);
1740 CHECK_CHAR_COERCE_INT (tochar);
1741
1742 fromc = XCHAR (fromchar);
1743 toc = XCHAR (tochar);
1744
1745 /* If we don't want undo, turn off putting stuff on the list.
1746 That's faster than getting rid of things,
1747 and it prevents even the entry for a first change.
1748 Also inhibit locking the file. */
1749 if (!NILP (noundo))
1750 {
1751 record_unwind_protect (subst_char_in_region_unwind,
1752 Fcons (Fcurrent_buffer (), buf->undo_list));
1753 buf->undo_list = Qt;
1754 /* Don't do file-locking. */
1755 record_unwind_protect (subst_char_in_region_unwind_1,
1756 Fcons (Fcurrent_buffer (), buf->filename));
1757 buf->filename = Qnil;
1758 }
1759
1760 mc_count = begin_multiple_change (buf, pos, stop);
1761 while (pos < stop)
1762 {
1763 if (BUF_FETCH_CHAR (buf, pos) == fromc)
1764 {
1765 /* There used to be some code here that set the buffer to
1766 unmodified if NOUNDO was specified and there was only
1767 one change to the buffer since it was last saved.
1768 This is a crock of shit, so I'm not duplicating this
1769 behavior. I think this was left over from when
1770 prepare_to_modify_buffer() actually bumped MODIFF,
1771 so that code was supposed to undo this change. --ben */
1772 buffer_replace_char (buf, pos, toc, !NILP (noundo), 0);
1773
1774 /* If noundo is not nil then we don't mark the buffer as
1775 modified. In reality that needs to happen externally
1776 only. Internally redisplay needs to know that the actual
1777 contents it should be displaying have changed. */
1778 if (!NILP (noundo))
1779 Fset_buffer_modified_p (Fbuffer_modified_p (Qnil), Qnil);
1780 }
1781 pos++;
1782 }
1783 end_multiple_change (buf, mc_count);
1784
1785 unbind_to (count, Qnil);
1786 return Qnil;
1787 }
1788
1789 /* #### Shouldn't this also accept a BUFFER argument, in the good old
1790 XEmacs tradition? */
1791 DEFUN ("translate-region", Ftranslate_region, 3, 3, 0, /*
1792 Translate characters from START to END according to TABLE.
1793
1794 If TABLE is a string, the Nth character in it is the mapping for the
1795 character with code N.
1796
1797 If TABLE is a vector, its Nth element is the mapping for character
1798 with code N. The values of elements may be characters, strings, or
1799 nil (nil meaning don't replace.)
1800
1801 If TABLE is a char-table, its elements describe the mapping between
1802 characters and their replacements. The char-table should be of type
1803 `char' or `generic'.
1804
1805 Returns the number of substitutions performed.
1806 */
1807 (start, end, table))
1808 {
1809 /* This function can GC */
1810 Bufpos pos, stop; /* Limits of the region. */
1811 int cnt = 0; /* Number of changes made. */
1812 int mc_count;
1813 struct buffer *buf = current_buffer;
1814 Emchar oc;
1815
1816 get_buffer_range_char (buf, start, end, &pos, &stop, 0);
1817 mc_count = begin_multiple_change (buf, pos, stop);
1818 if (STRINGP (table))
1819 {
1820 struct Lisp_String *stable = XSTRING (table);
1821 Charcount size = string_char_length (stable);
1822 #ifdef MULE
1823 /* Under Mule, string_char(n) is O(n), so for large tables or
1824 large regions it makes sense to create an array of Emchars. */
1825 if (size * (stop - pos) > 65536)
1826 {
1827 Emchar *etable = alloca_array (Emchar, size);
1828 convert_bufbyte_string_into_emchar_string
1829 (string_data (stable), string_length (stable), etable);
1830 for (; pos < stop && (oc = BUF_FETCH_CHAR (buf, pos), 1); pos++)
1831 {
1832 if (oc < size)
1833 {
1834 Emchar nc = etable[oc];
1835 if (nc != oc)
1836 {
1837 buffer_replace_char (buf, pos, nc, 0, 0);
1838 ++cnt;
1839 }
1840 }
1841 }
1842 }
1843 else
1844 #endif /* MULE */
1845 {
1846 for (; pos < stop && (oc = BUF_FETCH_CHAR (buf, pos), 1); pos++)
1847 {
1848 if (oc < size)
1849 {
1850 Emchar nc = string_char (stable, oc);
1851 if (nc != oc)
1852 {
1853 buffer_replace_char (buf, pos, nc, 0, 0);
1854 ++cnt;
1855 }
1856 }
1857 }
1858 }
1859 }
1860 else if (VECTORP (table))
1861 {
1862 Charcount size = XVECTOR_LENGTH (table);
1863 Lisp_Object *vtable = XVECTOR_DATA (table);
1864
1865 for (; pos < stop && (oc = BUF_FETCH_CHAR (buf, pos), 1); pos++)
1866 {
1867 if (oc < size)
1868 {
1869 Lisp_Object replacement = vtable[oc];
1870 retry:
1871 if (CHAR_OR_CHAR_INTP (replacement))
1872 {
1873 Emchar nc = XCHAR_OR_CHAR_INT (replacement);
1874 if (nc != oc)
1875 {
1876 buffer_replace_char (buf, pos, nc, 0, 0);
1877 ++cnt;
1878 }
1879 }
1880 else if (STRINGP (replacement))
1881 {
1882 Charcount incr = XSTRING_CHAR_LENGTH (replacement) - 1;
1883 buffer_delete_range (buf, pos, pos + 1, 0);
1884 buffer_insert_lisp_string_1 (buf, pos, replacement, 0);
1885 pos += incr, stop += incr;
1886 ++cnt;
1887 }
1888 else if (!NILP (replacement))
1889 {
1890 replacement = wrong_type_argument (Qchar_or_string_p, replacement);
1891 goto retry;
1892 }
1893 }
1894 }
1895 }
1896 else if (CHAR_TABLEP (table)
1897 && (XCHAR_TABLE_TYPE (table) == CHAR_TABLE_TYPE_GENERIC
1898 || XCHAR_TABLE_TYPE (table) == CHAR_TABLE_TYPE_CHAR))
1899 {
1900 struct Lisp_Char_Table *ctable = XCHAR_TABLE (table);
1901
1902 for (; pos < stop && (oc = BUF_FETCH_CHAR (buf, pos), 1); pos++)
1903 {
1904 Lisp_Object replacement = get_char_table (oc, ctable);
1905 retry2:
1906 if (CHAR_OR_CHAR_INTP (replacement))
1907 {
1908 Emchar nc = XCHAR_OR_CHAR_INT (replacement);
1909 if (nc != oc)
1910 {
1911 buffer_replace_char (buf, pos, nc, 0, 0);
1912 ++cnt;
1913 }
1914 }
1915 else if (STRINGP (replacement))
1916 {
1917 Charcount incr = XSTRING_CHAR_LENGTH (replacement) - 1;
1918 buffer_delete_range (buf, pos, pos + 1, 0);
1919 buffer_insert_lisp_string_1 (buf, pos, replacement, 0);
1920 pos += incr, stop += incr;
1921 ++cnt;
1922 }
1923 else if (!NILP (replacement))
1924 {
1925 replacement = wrong_type_argument (Qchar_or_string_p, replacement);
1926 goto retry2;
1927 }
1928 }
1929 }
1930 else
1931 dead_wrong_type_argument (Qstringp, table);
1932 end_multiple_change (buf, mc_count);
1933
1934 return make_int (cnt);
1935 }
1936
1937 DEFUN ("delete-region", Fdelete_region, 2, 3, "r", /*
1938 Delete the text between point and mark.
1939 When called from a program, expects two arguments,
1940 positions (integers or markers) specifying the stretch to be deleted.
1941 If BUFFER is nil, the current buffer is assumed.
1942 */
1943 (b, e, buffer))
1944 {
1945 /* This function can GC */
1946 Bufpos start, end;
1947 struct buffer *buf = decode_buffer (buffer, 1);
1948
1949 get_buffer_range_char (buf, b, e, &start, &end, 0);
1950 buffer_delete_range (buf, start, end, 0);
1951 zmacs_region_stays = 0;
1952 return Qnil;
1953 }
1954
1955 void
1956 widen_buffer (struct buffer *b, int no_clip)
1957 {
1958 if (BUF_BEGV (b) != BUF_BEG (b))
1959 {
1960 clip_changed = 1;
1961 SET_BOTH_BUF_BEGV (b, BUF_BEG (b), BI_BUF_BEG (b));
1962 }
1963 if (BUF_ZV (b) != BUF_Z (b))
1964 {
1965 clip_changed = 1;
1966 SET_BOTH_BUF_ZV (b, BUF_Z (b), BI_BUF_Z (b));
1967 }
1968 if (clip_changed)
1969 {
1970 if (!no_clip)
1971 MARK_CLIP_CHANGED;
1972 /* Changing the buffer bounds invalidates any recorded current
1973 column. */
1974 invalidate_current_column ();
1975 narrow_line_number_cache (b);
1976 }
1977 }
1978
1979 DEFUN ("widen", Fwiden, 0, 1, "", /*
1980 Remove restrictions (narrowing) from BUFFER.
1981 This allows the buffer's full text to be seen and edited.
1982 If BUFFER is nil, the current buffer is assumed.
1983 */
1984 (buffer))
1985 {
1986 struct buffer *b = decode_buffer (buffer, 1);
1987 widen_buffer (b, 0);
1988 zmacs_region_stays = 0;
1989 return Qnil;
1990 }
1991
1992 DEFUN ("narrow-to-region", Fnarrow_to_region, 2, 3, "r", /*
1993 Restrict editing in BUFFER to the current region.
1994 The rest of the text becomes temporarily invisible and untouchable
1995 but is not deleted; if you save the buffer in a file, the invisible
1996 text is included in the file. \\[widen] makes all visible again.
1997 If BUFFER is nil, the current buffer is assumed.
1998 See also `save-restriction'.
1999
2000 When calling from a program, pass two arguments; positions (integers
2001 or markers) bounding the text that should remain visible.
2002 */
2003 (b, e, buffer))
2004 {
2005 Bufpos start, end;
2006 struct buffer *buf = decode_buffer (buffer, 1);
2007 Bytind bi_start, bi_end;
2008
2009 get_buffer_range_char (buf, b, e, &start, &end, GB_ALLOW_PAST_ACCESSIBLE);
2010 bi_start = bufpos_to_bytind (buf, start);
2011 bi_end = bufpos_to_bytind (buf, end);
2012
2013 SET_BOTH_BUF_BEGV (buf, start, bi_start);
2014 SET_BOTH_BUF_ZV (buf, end, bi_end);
2015 if (BUF_PT (buf) < start)
2016 BUF_SET_PT (buf, start);
2017 if (BUF_PT (buf) > end)
2018 BUF_SET_PT (buf, end);
2019 MARK_CLIP_CHANGED;
2020 /* Changing the buffer bounds invalidates any recorded current column. */
2021 invalidate_current_column ();
2022 narrow_line_number_cache (buf);
2023 zmacs_region_stays = 0;
2024 return Qnil;
2025 }
2026
2027 Lisp_Object
2028 save_restriction_save (void)
2029 {
2030 Lisp_Object bottom, top;
2031 /* Note: I tried using markers here, but it does not win
2032 because insertion at the end of the saved region
2033 does not advance mh and is considered "outside" the saved region. */
2034 bottom = make_int (BUF_BEGV (current_buffer) - BUF_BEG (current_buffer));
2035 top = make_int (BUF_Z (current_buffer) - BUF_ZV (current_buffer));
2036
2037 return noseeum_cons (Fcurrent_buffer (), noseeum_cons (bottom, top));
2038 }
2039
2040 Lisp_Object
2041 save_restriction_restore (Lisp_Object data)
2042 {
2043 struct buffer *buf;
2044 Charcount newhead, newtail;
2045 Lisp_Object tem;
2046 int local_clip_changed = 0;
2047
2048 buf = XBUFFER (XCAR (data));
2049 if (!BUFFER_LIVE_P (buf))
2050 {
2051 /* someone could have killed the buffer in the meantime ... */
2052 free_cons (XCONS (XCDR (data)));
2053 free_cons (XCONS (data));
2054 return Qnil;
2055 }
2056 tem = XCDR (data);
2057 newhead = XINT (XCAR (tem));
2058 newtail = XINT (XCDR (tem));
2059
2060 free_cons (XCONS (XCDR (data)));
2061 free_cons (XCONS (data));
2062
2063 if (newhead + newtail > BUF_Z (buf) - BUF_BEG (buf))
2064 {
2065 newhead = 0;
2066 newtail = 0;
2067 }
2068
2069 {
2070 Bufpos start, end;
2071 Bytind bi_start, bi_end;
2072
2073 start = BUF_BEG (buf) + newhead;
2074 end = BUF_Z (buf) - newtail;
2075
2076 bi_start = bufpos_to_bytind (buf, start);
2077 bi_end = bufpos_to_bytind (buf, end);
2078
2079 if (BUF_BEGV (buf) != start)
2080 {
2081 local_clip_changed = 1;
2082 SET_BOTH_BUF_BEGV (buf, start, bi_start);
2083 narrow_line_number_cache (buf);
2084 }
2085 if (BUF_ZV (buf) != end)
2086 {
2087 local_clip_changed = 1;
2088 SET_BOTH_BUF_ZV (buf, end, bi_end);
2089 }
2090 }
2091 if (local_clip_changed)
2092 MARK_CLIP_CHANGED;
2093
2094 /* If point is outside the new visible range, move it inside. */
2095 BUF_SET_PT (buf,
2096 bufpos_clip_to_bounds (BUF_BEGV (buf),
2097 BUF_PT (buf),
2098 BUF_ZV (buf)));
2099
2100 return Qnil;
2101 }
2102
2103 DEFUN ("save-restriction", Fsave_restriction, 0, UNEVALLED, 0, /*
2104 Execute BODY, saving and restoring current buffer's restrictions.
2105 The buffer's restrictions make parts of the beginning and end invisible.
2106 \(They are set up with `narrow-to-region' and eliminated with `widen'.)
2107 This special form, `save-restriction', saves the current buffer's restrictions
2108 when it is entered, and restores them when it is exited.
2109 So any `narrow-to-region' within BODY lasts only until the end of the form.
2110 The old restrictions settings are restored
2111 even in case of abnormal exit (throw or error).
2112
2113 The value returned is the value of the last form in BODY.
2114
2115 `save-restriction' can get confused if, within the BODY, you widen
2116 and then make changes outside the area within the saved restrictions.
2117
2118 Note: if you are using both `save-excursion' and `save-restriction',
2119 use `save-excursion' outermost:
2120 (save-excursion (save-restriction ...))
2121 */
2122 (body))
2123 {
2124 /* This function can GC */
2125 int speccount = specpdl_depth ();
2126
2127 record_unwind_protect (save_restriction_restore, save_restriction_save ());
2128
2129 return unbind_to (speccount, Fprogn (body));
2130 }
2131
2132
2133 DEFUN ("format", Fformat, 1, MANY, 0, /*
2134 Format a string out of a control-string and arguments.
2135 The first argument is a control string.
2136 The other arguments are substituted into it to make the result, a string.
2137 It may contain %-sequences meaning to substitute the next argument.
2138 %s means print all objects as-is, using `princ'.
2139 %S means print all objects as s-expressions, using `prin1'.
2140 %d or %i means print as an integer in decimal (%o octal, %x lowercase hex,
2141 %X uppercase hex).
2142 %c means print as a single character.
2143 %f means print as a floating-point number in fixed notation (e.g. 785.200).
2144 %e or %E means print as a floating-point number in scientific notation
2145 (e.g. 7.85200e+03).
2146 %g or %G means print as a floating-point number in "pretty format";
2147 depending on the number, either %f or %e/%E format will be used, and
2148 trailing zeroes are removed from the fractional part.
2149 The argument used for all but %s and %S must be a number. It will be
2150 converted to an integer or a floating-point number as necessary.
2151
2152 %$ means reposition to read a specific numbered argument; for example,
2153 %3$s would apply the `%s' to the third argument after the control string,
2154 and the next format directive would use the fourth argument, the
2155 following one the fifth argument, etc. (There must be a positive integer
2156 between the % and the $).
2157 Zero or more of the flag characters `-', `+', ` ', `0', and `#' may be
2158 specified between the optional repositioning spec and the conversion
2159 character; see below.
2160 An optional minimum field width may be specified after any flag characters
2161 and before the conversion character; it specifies the minimum number of
2162 characters that the converted argument will take up. Padding will be
2163 added on the left (or on the right, if the `-' flag is specified), as
2164 necessary. Padding is done with spaces, or with zeroes if the `0' flag
2165 is specified.
2166 If the field width is specified as `*', the field width is assumed to have
2167 been specified as an argument. Any repositioning specification that
2168 would normally specify the argument to be converted will now specify
2169 where to find this field width argument, not where to find the argument
2170 to be converted. If there is no repositioning specification, the normal
2171 next argument is used. The argument to be converted will be the next
2172 argument after the field width argument unless the precision is also
2173 specified as `*' (see below).
2174
2175 An optional period character and precision may be specified after any
2176 minimum field width. It specifies the minimum number of digits to
2177 appear in %d, %i, %o, %x, and %X conversions (the number is padded
2178 on the left with zeroes as necessary); the number of digits printed
2179 after the decimal point for %f, %e, and %E conversions; the number
2180 of significant digits printed in %g and %G conversions; and the
2181 maximum number of non-padding characters printed in %s and %S
2182 conversions. The default precision for floating-point conversions
2183 is six.
2184 If the precision is specified as `*', the precision is assumed to have been
2185 specified as an argument. The argument used will be the next argument
2186 after the field width argument, if any. If the field width was not
2187 specified as an argument, any repositioning specification that would
2188 normally specify the argument to be converted will now specify where to
2189 find the precision argument. If there is no repositioning specification,
2190 the normal next argument is used.
2191
2192 The ` ' and `+' flags mean prefix non-negative numbers with a space or
2193 plus sign, respectively.
2194 The `#' flag means print numbers in an alternate, more verbose format:
2195 octal numbers begin with zero; hex numbers begin with a 0x or 0X;
2196 a decimal point is printed in %f, %e, and %E conversions even if no
2197 numbers are printed after it; and trailing zeroes are not omitted in
2198 %g and %G conversions.
2199
2200 Use %% to put a single % into the output.
2201 */
2202 (int nargs, Lisp_Object *args))
2203 {
2204 /* It should not be necessary to GCPRO ARGS, because
2205 the caller in the interpreter should take care of that. */
2206
2207 CHECK_STRING (args[0]);
2208 return emacs_doprnt_string_lisp (0, args[0], 0, nargs - 1, args + 1);
2209 }
2210
2211
2212 DEFUN ("char-equal", Fchar_equal, 2, 3, 0, /*
2213 Return t if two characters match, optionally ignoring case.
2214 Both arguments must be characters (i.e. NOT integers).
2215 Case is ignored if `case-fold-search' is non-nil in BUFFER.
2216 If BUFFER is nil, the current buffer is assumed.
2217 */
2218 (c1, c2, buffer))
2219 {
2220 Emchar x1, x2;
2221 struct buffer *b = decode_buffer (buffer, 1);
2222
2223 CHECK_CHAR_COERCE_INT (c1);
2224 CHECK_CHAR_COERCE_INT (c2);
2225 x1 = XCHAR (c1);
2226 x2 = XCHAR (c2);
2227
2228 return (!NILP (b->case_fold_search)
2229 ? DOWNCASE (b, x1) == DOWNCASE (b, x2)
2230 : x1 == x2)
2231 ? Qt : Qnil;
2232 }
2233
2234 DEFUN ("char=", Fchar_Equal, 2, 3, 0, /*
2235 Return t if two characters match, case is significant.
2236 Both arguments must be characters (i.e. NOT integers).
2237 The optional buffer argument is for symmetry and is ignored.
2238 */
2239 (c1, c2, buffer))
2240 {
2241 CHECK_CHAR_COERCE_INT (c1);
2242 CHECK_CHAR_COERCE_INT (c2);
2243
2244 return XCHAR(c1) == XCHAR(c2) ? Qt : Qnil;
2245 }
2246
2247 #if 0 /* Undebugged FSFmacs code */
2248 /* Transpose the markers in two regions of the current buffer, and
2249 adjust the ones between them if necessary (i.e.: if the regions
2250 differ in size).
2251
2252 Traverses the entire marker list of the buffer to do so, adding an
2253 appropriate amount to some, subtracting from some, and leaving the
2254 rest untouched. Most of this is copied from adjust_markers in insdel.c.
2255
2256 It's the caller's job to see that (start1 <= end1 <= start2 <= end2). */
2257
2258 void
2259 transpose_markers (Bufpos start1, Bufpos end1, Bufpos start2, Bufpos end2)
2260 {
2261 Charcount amt1, amt2, diff;
2262 Lisp_Object marker;
2263 struct buffer *buf = current_buffer;
2264
2265 /* Update point as if it were a marker. */
2266 if (BUF_PT (buf) < start1)
2267 ;
2268 else if (BUF_PT (buf) < end1)
2269 BUF_SET_PT (buf, BUF_PT (buf) + (end2 - end1));
2270 else if (BUF_PT (buf) < start2)
2271 BUF_SET_PT (buf, BUF_PT (buf) + (end2 - start2) - (end1 - start1));
2272 else if (BUF_PT (buf) < end2)
2273 BUF_SET_PT (buf, BUF_PT (buf) - (start2 - start1));
2274
2275 /* We used to adjust the endpoints here to account for the gap, but that
2276 isn't good enough. Even if we assume the caller has tried to move the
2277 gap out of our way, it might still be at start1 exactly, for example;
2278 and that places it `inside' the interval, for our purposes. The amount
2279 of adjustment is nontrivial if there's a `denormalized' marker whose
2280 position is between GPT and GPT + GAP_SIZE, so it's simpler to leave
2281 the dirty work to Fmarker_position, below. */
2282
2283 /* The difference between the region's lengths */
2284 diff = (end2 - start2) - (end1 - start1);
2285
2286 /* For shifting each marker in a region by the length of the other
2287 * region plus the distance between the regions.
2288 */
2289 amt1 = (end2 - start2) + (start2 - end1);
2290 amt2 = (end1 - start1) + (start2 - end1);
2291
2292 for (marker = BUF_MARKERS (buf); !NILP (marker);
2293 marker = XMARKER (marker)->chain)
2294 {
2295 Bufpos mpos = marker_position (marker);
2296 if (mpos >= start1 && mpos < end2)
2297 {
2298 if (mpos < end1)
2299 mpos += amt1;
2300 else if (mpos < start2)
2301 mpos += diff;
2302 else
2303 mpos -= amt2;
2304 set_marker_position (marker, mpos);
2305 }
2306 }
2307 }
2308
2309 #endif /* 0 */
2310
2311 DEFUN ("transpose-regions", Ftranspose_regions, 4, 5, 0, /*
2312 Transpose region START1 to END1 with START2 to END2.
2313 The regions may not be overlapping, because the size of the buffer is
2314 never changed in a transposition.
2315
2316 Optional fifth arg LEAVE_MARKERS, if non-nil, means don't transpose
2317 any markers that happen to be located in the regions. (#### BUG: currently
2318 this function always acts as if LEAVE_MARKERS is non-nil.)
2319
2320 Transposing beyond buffer boundaries is an error.
2321 */
2322 (startr1, endr1, startr2, endr2, leave_markers))
2323 {
2324 Bufpos start1, end1, start2, end2;
2325 Charcount len1, len2;
2326 Lisp_Object string1, string2;
2327 struct buffer *buf = current_buffer;
2328
2329 get_buffer_range_char (buf, startr1, endr1, &start1, &end1, 0);
2330 get_buffer_range_char (buf, startr2, endr2, &start2, &end2, 0);
2331
2332 len1 = end1 - start1;
2333 len2 = end2 - start2;
2334
2335 if (start2 < end1)
2336 error ("transposed regions not properly ordered");
2337 else if (start1 == end1 || start2 == end2)
2338 error ("transposed region may not be of length 0");
2339
2340 string1 = make_string_from_buffer (buf, start1, len1);
2341 string2 = make_string_from_buffer (buf, start2, len2);
2342 buffer_delete_range (buf, start2, end2, 0);
2343 buffer_insert_lisp_string_1 (buf, start2, string1, 0);
2344 buffer_delete_range (buf, start1, end1, 0);
2345 buffer_insert_lisp_string_1 (buf, start1, string2, 0);
2346
2347 /* In FSFmacs there is a whole bunch of really ugly code here
2348 to attempt to transpose the regions without using up any
2349 extra memory. Although the intent may be good, the result
2350 was highly bogus. */
2351
2352 return Qnil;
2353 }
2354
2355
2356 /************************************************************************/
2357 /* initialization */
2358 /************************************************************************/
2359
2360 void
2361 syms_of_editfns (void)
2362 {
2363 defsymbol (&Qpoint, "point");
2364 defsymbol (&Qmark, "mark");
2365 defsymbol (&Qregion_beginning, "region-beginning");
2366 defsymbol (&Qregion_end, "region-end");
2367 defsymbol (&Qformat, "format");
2368 defsymbol (&Quser_files_and_directories, "user-files-and-directories");
2369
2370 DEFSUBR (Fchar_equal);
2371 DEFSUBR (Fchar_Equal);
2372 DEFSUBR (Fgoto_char);
2373 DEFSUBR (Fstring_to_char);
2374 DEFSUBR (Fchar_to_string);
2375 DEFSUBR (Fbuffer_substring);
2376 DEFSUBR (Fbuffer_substring_no_properties);
2377
2378 DEFSUBR (Fpoint_marker);
2379 DEFSUBR (Fmark_marker);
2380 DEFSUBR (Fpoint);
2381 DEFSUBR (Fregion_beginning);
2382 DEFSUBR (Fregion_end);
2383 DEFSUBR (Fsave_excursion);
2384 DEFSUBR (Fsave_current_buffer);
2385
2386 DEFSUBR (Fbuffer_size);
2387 DEFSUBR (Fpoint_max);
2388 DEFSUBR (Fpoint_min);
2389 DEFSUBR (Fpoint_min_marker);
2390 DEFSUBR (Fpoint_max_marker);
2391
2392 DEFSUBR (Fbobp);
2393 DEFSUBR (Feobp);
2394 DEFSUBR (Fbolp);
2395 DEFSUBR (Feolp);
2396 DEFSUBR (Ffollowing_char);
2397 DEFSUBR (Fpreceding_char);
2398 DEFSUBR (Fchar_after);
2399 DEFSUBR (Fchar_before);
2400 DEFSUBR (Finsert);
2401 DEFSUBR (Finsert_string);
2402 DEFSUBR (Finsert_before_markers);
2403 DEFSUBR (Finsert_char);
2404
2405 DEFSUBR (Ftemp_directory);
2406 DEFSUBR (Fuser_login_name);
2407 DEFSUBR (Fuser_real_login_name);
2408 DEFSUBR (Fuser_uid);
2409 DEFSUBR (Fuser_real_uid);
2410 DEFSUBR (Fuser_full_name);
2411 DEFSUBR (Fuser_home_directory);
2412 DEFSUBR (Femacs_pid);
2413 DEFSUBR (Fcurrent_time);
2414 DEFSUBR (Fcurrent_process_time);
2415 DEFSUBR (Fformat_time_string);
2416 DEFSUBR (Fdecode_time);
2417 DEFSUBR (Fencode_time);
2418 DEFSUBR (Fcurrent_time_string);
2419 DEFSUBR (Fcurrent_time_zone);
2420 DEFSUBR (Fset_time_zone_rule);
2421 DEFSUBR (Fsystem_name);
2422 DEFSUBR (Fformat);
2423
2424 DEFSUBR (Finsert_buffer_substring);
2425 DEFSUBR (Fcompare_buffer_substrings);
2426 DEFSUBR (Fsubst_char_in_region);
2427 DEFSUBR (Ftranslate_region);
2428 DEFSUBR (Fdelete_region);
2429 DEFSUBR (Fwiden);
2430 DEFSUBR (Fnarrow_to_region);
2431 DEFSUBR (Fsave_restriction);
2432 DEFSUBR (Ftranspose_regions);
2433
2434 defsymbol (&Qzmacs_update_region, "zmacs-update-region");
2435 defsymbol (&Qzmacs_deactivate_region, "zmacs-deactivate-region");
2436 defsymbol (&Qzmacs_region_buffer, "zmacs-region-buffer");
2437 }
2438
2439 void
2440 vars_of_editfns (void)
2441 {
2442 staticpro (&Vsystem_name);
2443 #if 0
2444 staticpro (&Vuser_name);
2445 staticpro (&Vuser_real_name);
2446 #endif
2447 DEFVAR_BOOL ("zmacs-regions", &zmacs_regions /*
2448 *Whether LISPM-style active regions should be used.
2449 This means that commands which operate on the region (the area between the
2450 point and the mark) will only work while the region is in the ``active''
2451 state, which is indicated by highlighting. Executing most commands causes
2452 the region to not be in the active state, so (for example) \\[kill-region] will only
2453 work immediately after activating the region.
2454
2455 More specifically:
2456
2457 - Commands which operate on the region only work if the region is active.
2458 - Only a very small set of commands cause the region to become active:
2459 Those commands whose semantics are to mark an area, like mark-defun.
2460 - The region is deactivated after each command that is executed, except that:
2461 - "Motion" commands do not change whether the region is active or not.
2462
2463 set-mark-command (C-SPC) pushes a mark and activates the region. Moving the
2464 cursor with normal motion commands (C-n, C-p, etc) will cause the region
2465 between point and the recently-pushed mark to be highlighted. It will
2466 remain highlighted until some non-motion command is executed.
2467
2468 exchange-point-and-mark (\\[exchange-point-and-mark]) activates the region. So if you mark a
2469 region and execute a command that operates on it, you can reactivate the
2470 same region with \\[exchange-point-and-mark] (or perhaps \\[exchange-point-and-mark] \\[exchange-point-and-mark]) to operate on it
2471 again.
2472
2473 Generally, commands which push marks as a means of navigation (like
2474 beginning-of-buffer and end-of-buffer (M-< and M->)) do not activate the
2475 region. But commands which push marks as a means of marking an area of
2476 text (like mark-defun (\\[mark-defun]), mark-word (\\[mark-word]) or mark-whole-buffer (\\[mark-whole-buffer]))
2477 do activate the region.
2478
2479 The way the command loop actually works with regard to deactivating the
2480 region is as follows:
2481
2482 - If the variable `zmacs-region-stays' has been set to t during the command
2483 just executed, the region is left alone (this is how the motion commands
2484 make the region stay around; see the `_' flag in the `interactive'
2485 specification). `zmacs-region-stays' is reset to nil before each command
2486 is executed.
2487 - If the function `zmacs-activate-region' has been called during the command
2488 just executed, the region is left alone. Very few functions should
2489 actually call this function.
2490 - Otherwise, if the region is active, the region is deactivated and
2491 the `zmacs-deactivate-region-hook' is called.
2492 */ );
2493 /* Zmacs style active regions are now ON by default */
2494 zmacs_regions = 1;
2495
2496 DEFVAR_BOOL ("zmacs-region-active-p", &zmacs_region_active_p /*
2497 Do not alter this. It is for internal use only.
2498 */ );
2499 zmacs_region_active_p = 0;
2500
2501 DEFVAR_BOOL ("zmacs-region-stays", &zmacs_region_stays /*
2502 Whether the current command will deactivate the region.
2503 Commands which do not wish to affect whether the region is currently
2504 highlighted should set this to t. Normally, the region is turned off after
2505 executing each command that did not explicitly turn it on with the function
2506 zmacs-activate-region. Setting this to true lets a command be non-intrusive.
2507 See the variable `zmacs-regions'.
2508
2509 The same effect can be achieved using the `_' interactive specification.
2510 */ );
2511 zmacs_region_stays = 0;
2512
2513 DEFVAR_BOOL ("atomic-extent-goto-char-p", &atomic_extent_goto_char_p /*
2514 Do not use this -- it will be going away soon.
2515 Indicates if `goto-char' has just been run. This information is allegedly
2516 needed to get the desired behavior for atomic extents and unfortunately
2517 is not available by any other means.
2518 */ );
2519 atomic_extent_goto_char_p = 0;
2520 #ifdef AMPERSAND_FULL_NAME
2521 Fprovide(intern("ampersand-full-name"));
2522 #endif
2523
2524 DEFVAR_LISP ("user-full-name", &Vuser_full_name /*
2525 *The name of the user.
2526 The function `user-full-name', which will return the value of this
2527 variable, when called without arguments.
2528 This is initialized to the value of the NAME environment variable.
2529 */ );
2530 /* Initialized at run-time. */
2531 Vuser_full_name = Qnil;
2532 }