1 /* GNU Emacs case conversion functions.
2 Copyright (C) 1985, 1994, 1997 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 Boston, MA 02111-1307, USA. */
29 enum case_action
{CASE_UP
, CASE_DOWN
, CASE_CAPITALIZE
, CASE_CAPITALIZE_UP
};
31 Lisp_Object Qidentity
;
34 casify_object (flag
, obj
)
35 enum case_action flag
;
38 register int i
, c
, len
;
39 register int inword
= flag
== CASE_DOWN
;
42 /* If the case table is flagged as modified, rescan it. */
43 if (NILP (XCHAR_TABLE (current_buffer
->downcase_table
)->extras
[1]))
44 Fset_case_table (current_buffer
->downcase_table
);
50 int flagbits
= (CHAR_ALT
| CHAR_SUPER
| CHAR_HYPER
51 | CHAR_SHIFT
| CHAR_CTL
| CHAR_META
);
52 int flags
= XINT (obj
) & flagbits
;
54 c
= DOWNCASE (XFASTINT (obj
) & ~flagbits
);
56 XSETFASTINT (obj
, c
| flags
);
57 else if (c
== (XFASTINT (obj
) & ~flagbits
))
59 c
= UPCASE1 ((XFASTINT (obj
) & ~flagbits
));
60 XSETFASTINT (obj
, c
| flags
);
67 int multibyte
= STRING_MULTIBYTE (obj
);
69 obj
= Fcopy_sequence (obj
);
70 len
= STRING_BYTES (XSTRING (obj
));
72 /* Scan all single-byte characters from start of string. */
75 c
= XSTRING (obj
)->data
[i
];
77 if (multibyte
&& c
>= 0x80)
78 /* A multibyte character can't be handled in this
81 if (inword
&& flag
!= CASE_CAPITALIZE_UP
)
83 else if (!UPPERCASEP (c
)
84 && (!inword
|| flag
!= CASE_CAPITALIZE_UP
))
86 /* If this char won't fit in a single-byte string.
87 fall out to the multibyte case. */
88 if (multibyte
? ! ASCII_BYTE_P (c
)
89 : ! SINGLE_BYTE_CHAR_P (c
))
92 XSTRING (obj
)->data
[i
] = c
;
93 if ((int) flag
>= (int) CASE_CAPITALIZE
)
94 inword
= SYNTAX (c
) == Sword
;
98 /* If we didn't do the whole string as single-byte,
99 scan the rest in a more complex way. */
102 /* The work is not yet finished because of a multibyte
103 character just encountered. */
104 int fromlen
, tolen
, j
= i
, j_byte
= i
;
106 = (char *) alloca ((len
- i
) * MAX_LENGTH_OF_MULTI_BYTE_FORM
108 unsigned char *str
, workbuf
[4];
110 /* Copy data already handled. */
111 bcopy (XSTRING (obj
)->data
, buf
, i
);
113 /* From now on, I counts bytes. */
116 c
= STRING_CHAR_AND_LENGTH (XSTRING (obj
)->data
+ i
,
118 if (inword
&& flag
!= CASE_CAPITALIZE_UP
)
120 else if (!UPPERCASEP (c
)
121 && (!inword
|| flag
!= CASE_CAPITALIZE_UP
))
123 tolen
= CHAR_STRING (c
, workbuf
, str
);
124 bcopy (str
, buf
+ j_byte
, tolen
);
128 if ((int) flag
>= (int) CASE_CAPITALIZE
)
129 inword
= SYNTAX (c
) == Sword
;
131 obj
= make_specified_string (buf
, j
, j_byte
,
132 STRING_MULTIBYTE (obj
));
136 obj
= wrong_type_argument (Qchar_or_string_p
, obj
);
140 DEFUN ("upcase", Fupcase
, Supcase
, 1, 1, 0,
141 "Convert argument to upper case and return that.\n\
142 The argument may be a character or string. The result has the same type.\n\
143 The argument object is not altered--the value is a copy.\n\
144 See also `capitalize', `downcase' and `upcase-initials'.")
148 return casify_object (CASE_UP
, obj
);
151 DEFUN ("downcase", Fdowncase
, Sdowncase
, 1, 1, 0,
152 "Convert argument to lower case and return that.\n\
153 The argument may be a character or string. The result has the same type.\n\
154 The argument object is not altered--the value is a copy.")
158 return casify_object (CASE_DOWN
, obj
);
161 DEFUN ("capitalize", Fcapitalize
, Scapitalize
, 1, 1, 0,
162 "Convert argument to capitalized form and return that.\n\
163 This means that each word's first character is upper case\n\
164 and the rest is lower case.\n\
165 The argument may be a character or string. The result has the same type.\n\
166 The argument object is not altered--the value is a copy.")
170 return casify_object (CASE_CAPITALIZE
, obj
);
173 /* Like Fcapitalize but change only the initials. */
175 DEFUN ("upcase-initials", Fupcase_initials
, Supcase_initials
, 1, 1, 0,
176 "Convert the initial of each word in the argument to upper case.\n\
177 Do not change the other letters of each word.\n\
178 The argument may be a character or string. The result has the same type.\n\
179 The argument object is not altered--the value is a copy.")
183 return casify_object (CASE_CAPITALIZE_UP
, obj
);
186 /* flag is CASE_UP, CASE_DOWN or CASE_CAPITALIZE or CASE_CAPITALIZE_UP.
187 b and e specify range of buffer to operate on. */
190 casify_region (flag
, b
, e
)
191 enum case_action flag
;
196 register int inword
= flag
== CASE_DOWN
;
197 register int multibyte
= !NILP (current_buffer
->enable_multibyte_characters
);
199 int start_byte
, end_byte
;
200 Lisp_Object ch
, downch
, val
;
203 /* Not modifying because nothing marked */
206 /* If the case table is flagged as modified, rescan it. */
207 if (NILP (XCHAR_TABLE (current_buffer
->downcase_table
)->extras
[1]))
208 Fset_case_table (current_buffer
->downcase_table
);
210 validate_region (&b
, &e
);
211 start
= XFASTINT (b
);
213 modify_region (current_buffer
, start
, end
);
214 record_change (start
, end
- start
);
215 start_byte
= CHAR_TO_BYTE (start
);
216 end_byte
= CHAR_TO_BYTE (end
);
218 for (i
= start_byte
; i
< end_byte
; i
++)
221 if (multibyte
&& c
>= 0x80)
222 /* A multibyte character can't be handled in this simple loop. */
224 if (inword
&& flag
!= CASE_CAPITALIZE_UP
)
226 else if (!UPPERCASEP (c
)
227 && (!inword
|| flag
!= CASE_CAPITALIZE_UP
))
230 if ((int) flag
>= (int) CASE_CAPITALIZE
)
231 inword
= SYNTAX (c
) == Sword
;
235 /* The work is not yet finished because of a multibyte character
238 int opoint_byte
= PT_BYTE
;
243 if ((c
= FETCH_BYTE (i
)) >= 0x80)
244 c
= FETCH_MULTIBYTE_CHAR (i
);
246 if (inword
&& flag
!= CASE_CAPITALIZE_UP
)
248 else if (!UPPERCASEP (c
)
249 && (!inword
|| flag
!= CASE_CAPITALIZE_UP
))
253 int fromlen
, tolen
, j
;
254 unsigned char workbuf
[4], *str
;
256 /* Handle the most likely case */
257 if (c
< 0400 && c2
< 0400)
259 else if (fromlen
= CHAR_STRING (c
, workbuf
, str
),
260 tolen
= CHAR_STRING (c2
, workbuf
, str
),
263 for (j
= 0; j
< tolen
; ++j
)
264 FETCH_BYTE (i
+ j
) = str
[j
];
268 error ("Can't casify letters that change length");
269 #if 0 /* This is approximately what we'd like to be able to do here */
271 del_range_1 (i
+ tolen
, i
+ fromlen
, 0);
272 else if (tolen
> fromlen
)
274 TEMP_SET_PT (i
+ fromlen
);
275 insert_1 (str
+ fromlen
, tolen
- fromlen
, 1, 0, 0);
280 if ((int) flag
>= (int) CASE_CAPITALIZE
)
281 inword
= SYNTAX (c2
) == Sword
;
284 TEMP_SET_PT_BOTH (opoint
, opoint_byte
);
287 signal_after_change (start
, end
- start
, end
- start
);
290 DEFUN ("upcase-region", Fupcase_region
, Supcase_region
, 2, 2, "r",
291 "Convert the region to upper case. In programs, wants two arguments.\n\
292 These arguments specify the starting and ending character numbers of\n\
293 the region to operate on. When used as a command, the text between\n\
294 point and the mark is operated on.\n\
295 See also `capitalize-region'.")
297 Lisp_Object beg
, end
;
299 casify_region (CASE_UP
, beg
, end
);
303 DEFUN ("downcase-region", Fdowncase_region
, Sdowncase_region
, 2, 2, "r",
304 "Convert the region to lower case. In programs, wants two arguments.\n\
305 These arguments specify the starting and ending character numbers of\n\
306 the region to operate on. When used as a command, the text between\n\
307 point and the mark is operated on.")
309 Lisp_Object beg
, end
;
311 casify_region (CASE_DOWN
, beg
, end
);
315 DEFUN ("capitalize-region", Fcapitalize_region
, Scapitalize_region
, 2, 2, "r",
316 "Convert the region to capitalized form.\n\
317 Capitalized form means each word's first character is upper case\n\
318 and the rest of it is lower case.\n\
319 In programs, give two arguments, the starting and ending\n\
320 character positions to operate on.")
322 Lisp_Object beg
, end
;
324 casify_region (CASE_CAPITALIZE
, beg
, end
);
328 /* Like Fcapitalize_region but change only the initials. */
330 DEFUN ("upcase-initials-region", Fupcase_initials_region
,
331 Supcase_initials_region
, 2, 2, "r",
332 "Upcase the initial of each word in the region.\n\
333 Subsequent letters of each word are not changed.\n\
334 In programs, give two arguments, the starting and ending\n\
335 character positions to operate on.")
337 Lisp_Object beg
, end
;
339 casify_region (CASE_CAPITALIZE_UP
, beg
, end
);
344 operate_on_word (arg
, newpoint
)
352 CHECK_NUMBER (arg
, 0);
354 farend
= scan_words (PT
, iarg
);
356 farend
= iarg
> 0 ? ZV
: BEGV
;
358 *newpoint
= PT
> farend
? PT
: farend
;
359 XSETFASTINT (val
, farend
);
364 DEFUN ("upcase-word", Fupcase_word
, Supcase_word
, 1, 1, "p",
365 "Convert following word (or ARG words) to upper case, moving over.\n\
366 With negative argument, convert previous words but do not move.\n\
367 See also `capitalize-word'.")
371 Lisp_Object beg
, end
;
373 XSETFASTINT (beg
, PT
);
374 end
= operate_on_word (arg
, &newpoint
);
375 casify_region (CASE_UP
, beg
, end
);
380 DEFUN ("downcase-word", Fdowncase_word
, Sdowncase_word
, 1, 1, "p",
381 "Convert following word (or ARG words) to lower case, moving over.\n\
382 With negative argument, convert previous words but do not move.")
386 Lisp_Object beg
, end
;
388 XSETFASTINT (beg
, PT
);
389 end
= operate_on_word (arg
, &newpoint
);
390 casify_region (CASE_DOWN
, beg
, end
);
395 DEFUN ("capitalize-word", Fcapitalize_word
, Scapitalize_word
, 1, 1, "p",
396 "Capitalize the following word (or ARG words), moving over.\n\
397 This gives the word(s) a first character in upper case\n\
398 and the rest lower case.\n\
399 With negative argument, capitalize previous words but do not move.")
403 Lisp_Object beg
, end
;
405 XSETFASTINT (beg
, PT
);
406 end
= operate_on_word (arg
, &newpoint
);
407 casify_region (CASE_CAPITALIZE
, beg
, end
);
413 syms_of_casefiddle ()
415 Qidentity
= intern ("identity");
416 staticpro (&Qidentity
);
418 defsubr (&Sdowncase
);
419 defsubr (&Scapitalize
);
420 defsubr (&Supcase_initials
);
421 defsubr (&Supcase_region
);
422 defsubr (&Sdowncase_region
);
423 defsubr (&Scapitalize_region
);
424 defsubr (&Supcase_initials_region
);
425 defsubr (&Supcase_word
);
426 defsubr (&Sdowncase_word
);
427 defsubr (&Scapitalize_word
);
431 keys_of_casefiddle ()
433 initial_define_key (control_x_map
, Ctl('U'), "upcase-region");
434 Fput (intern ("upcase-region"), Qdisabled
, Qt
);
435 initial_define_key (control_x_map
, Ctl('L'), "downcase-region");
436 Fput (intern ("downcase-region"), Qdisabled
, Qt
);
438 initial_define_key (meta_map
, 'u', "upcase-word");
439 initial_define_key (meta_map
, 'l', "downcase-word");
440 initial_define_key (meta_map
, 'c', "capitalize-word");