]> code.delx.au - gnu-emacs/blob - src/casefiddle.c
Merge from trunk
[gnu-emacs] / src / casefiddle.c
1 /* GNU Emacs case conversion functions.
2 Copyright (C) 1985, 1994, 1997, 1998, 1999, 2001, 2002, 2003, 2004,
3 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
4
5 This file is part of GNU Emacs.
6
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
11
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
19
20
21 #include <config.h>
22 #include <setjmp.h>
23 #include "lisp.h"
24 #include "buffer.h"
25 #include "character.h"
26 #include "commands.h"
27 #include "syntax.h"
28 #include "composite.h"
29 #include "keymap.h"
30
31 enum case_action {CASE_UP, CASE_DOWN, CASE_CAPITALIZE, CASE_CAPITALIZE_UP};
32
33 Lisp_Object Qidentity;
34 \f
35 Lisp_Object
36 casify_object (enum case_action flag, Lisp_Object obj)
37 {
38 register int c, c1;
39 register int inword = flag == CASE_DOWN;
40
41 /* If the case table is flagged as modified, rescan it. */
42 if (NILP (XCHAR_TABLE (current_buffer->downcase_table)->extras[1]))
43 Fset_case_table (current_buffer->downcase_table);
44
45 if (INTEGERP (obj))
46 {
47 int flagbits = (CHAR_ALT | CHAR_SUPER | CHAR_HYPER
48 | CHAR_SHIFT | CHAR_CTL | CHAR_META);
49 int flags = XINT (obj) & flagbits;
50 int multibyte = ! NILP (current_buffer->enable_multibyte_characters);
51
52 /* If the character has higher bits set
53 above the flags, return it unchanged.
54 It is not a real character. */
55 if ((unsigned) XFASTINT (obj) > (unsigned) flagbits)
56 return obj;
57
58 c1 = XFASTINT (obj) & ~flagbits;
59 /* FIXME: Even if enable-multibyte-characters is nil, we may
60 manipulate multibyte chars. This means we have a bug for latin-1
61 chars since when we receive an int 128-255 we can't tell whether
62 it's an eight-bit byte or a latin-1 char. */
63 if (c1 >= 256)
64 multibyte = 1;
65 if (! multibyte)
66 MAKE_CHAR_MULTIBYTE (c1);
67 c = DOWNCASE (c1);
68 if (inword)
69 XSETFASTINT (obj, c | flags);
70 else if (c == (XFASTINT (obj) & ~flagbits))
71 {
72 if (! inword)
73 c = UPCASE1 (c1);
74 if (! multibyte)
75 MAKE_CHAR_UNIBYTE (c);
76 XSETFASTINT (obj, c | flags);
77 }
78 return obj;
79 }
80
81 if (!STRINGP (obj))
82 wrong_type_argument (Qchar_or_string_p, obj);
83 else if (!STRING_MULTIBYTE (obj))
84 {
85 EMACS_INT i;
86 EMACS_INT size = SCHARS (obj);
87
88 obj = Fcopy_sequence (obj);
89 for (i = 0; i < size; i++)
90 {
91 c = SREF (obj, i);
92 MAKE_CHAR_MULTIBYTE (c);
93 c1 = c;
94 if (inword && flag != CASE_CAPITALIZE_UP)
95 c = DOWNCASE (c);
96 else if (!UPPERCASEP (c)
97 && (!inword || flag != CASE_CAPITALIZE_UP))
98 c = UPCASE1 (c1);
99 if ((int) flag >= (int) CASE_CAPITALIZE)
100 inword = (SYNTAX (c) == Sword);
101 if (c != c1)
102 {
103 MAKE_CHAR_UNIBYTE (c);
104 /* If the char can't be converted to a valid byte, just don't
105 change it. */
106 if (c >= 0 && c < 256)
107 SSET (obj, i, c);
108 }
109 }
110 return obj;
111 }
112 else
113 {
114 EMACS_INT i, i_byte, size = SCHARS (obj);
115 int len;
116 USE_SAFE_ALLOCA;
117 unsigned char *dst, *o;
118 /* Over-allocate by 12%: this is a minor overhead, but should be
119 sufficient in 99.999% of the cases to avoid a reallocation. */
120 EMACS_INT o_size = SBYTES (obj) + SBYTES (obj) / 8 + MAX_MULTIBYTE_LENGTH;
121 SAFE_ALLOCA (dst, void *, o_size);
122 o = dst;
123
124 for (i = i_byte = 0; i < size; i++, i_byte += len)
125 {
126 if ((o - dst) + MAX_MULTIBYTE_LENGTH > o_size)
127 { /* Not enough space for the next char: grow the destination. */
128 unsigned char *old_dst = dst;
129 o_size += o_size; /* Probably overkill, but extremely rare. */
130 SAFE_ALLOCA (dst, void *, o_size);
131 memcpy (dst, old_dst, o - old_dst);
132 o = dst + (o - old_dst);
133 }
134 c = STRING_CHAR_AND_LENGTH (SDATA (obj) + i_byte, len);
135 if (inword && flag != CASE_CAPITALIZE_UP)
136 c = DOWNCASE (c);
137 else if (!UPPERCASEP (c)
138 && (!inword || flag != CASE_CAPITALIZE_UP))
139 c = UPCASE1 (c);
140 if ((int) flag >= (int) CASE_CAPITALIZE)
141 inword = (SYNTAX (c) == Sword);
142 o += CHAR_STRING (c, o);
143 }
144 eassert (o - dst <= o_size);
145 obj = make_multibyte_string (dst, size, o - dst);
146 SAFE_FREE ();
147 return obj;
148 }
149 }
150
151 DEFUN ("upcase", Fupcase, Supcase, 1, 1, 0,
152 doc: /* Convert argument to upper case and return that.
153 The argument may be a character or string. The result has the same type.
154 The argument object is not altered--the value is a copy.
155 See also `capitalize', `downcase' and `upcase-initials'. */)
156 (Lisp_Object obj)
157 {
158 return casify_object (CASE_UP, obj);
159 }
160
161 DEFUN ("downcase", Fdowncase, Sdowncase, 1, 1, 0,
162 doc: /* Convert argument to lower case and return that.
163 The argument may be a character or string. The result has the same type.
164 The argument object is not altered--the value is a copy. */)
165 (Lisp_Object obj)
166 {
167 return casify_object (CASE_DOWN, obj);
168 }
169
170 DEFUN ("capitalize", Fcapitalize, Scapitalize, 1, 1, 0,
171 doc: /* Convert argument to capitalized form and return that.
172 This means that each word's first character is upper case
173 and the rest is lower case.
174 The argument may be a character or string. The result has the same type.
175 The argument object is not altered--the value is a copy. */)
176 (Lisp_Object obj)
177 {
178 return casify_object (CASE_CAPITALIZE, obj);
179 }
180
181 /* Like Fcapitalize but change only the initials. */
182
183 DEFUN ("upcase-initials", Fupcase_initials, Supcase_initials, 1, 1, 0,
184 doc: /* Convert the initial of each word in the argument to upper case.
185 Do not change the other letters of each word.
186 The argument may be a character or string. The result has the same type.
187 The argument object is not altered--the value is a copy. */)
188 (Lisp_Object obj)
189 {
190 return casify_object (CASE_CAPITALIZE_UP, obj);
191 }
192 \f
193 /* flag is CASE_UP, CASE_DOWN or CASE_CAPITALIZE or CASE_CAPITALIZE_UP.
194 b and e specify range of buffer to operate on. */
195
196 void
197 casify_region (enum case_action flag, Lisp_Object b, Lisp_Object e)
198 {
199 register int c;
200 register int inword = flag == CASE_DOWN;
201 register int multibyte = !NILP (current_buffer->enable_multibyte_characters);
202 EMACS_INT start, end;
203 EMACS_INT start_byte, end_byte;
204 EMACS_INT first = -1, last; /* Position of first and last changes. */
205 EMACS_INT opoint = PT;
206 EMACS_INT opoint_byte = PT_BYTE;
207
208 if (EQ (b, e))
209 /* Not modifying because nothing marked */
210 return;
211
212 /* If the case table is flagged as modified, rescan it. */
213 if (NILP (XCHAR_TABLE (current_buffer->downcase_table)->extras[1]))
214 Fset_case_table (current_buffer->downcase_table);
215
216 validate_region (&b, &e);
217 start = XFASTINT (b);
218 end = XFASTINT (e);
219 modify_region (current_buffer, start, end, 0);
220 record_change (start, end - start);
221 start_byte = CHAR_TO_BYTE (start);
222 end_byte = CHAR_TO_BYTE (end);
223
224 while (start < end)
225 {
226 int c2, len;
227
228 if (multibyte)
229 {
230 c = FETCH_MULTIBYTE_CHAR (start_byte);
231 len = CHAR_BYTES (c);
232 }
233 else
234 {
235 c = FETCH_BYTE (start_byte);
236 MAKE_CHAR_MULTIBYTE (c);
237 len = 1;
238 }
239 c2 = c;
240 if (inword && flag != CASE_CAPITALIZE_UP)
241 c = DOWNCASE (c);
242 else if (!UPPERCASEP (c)
243 && (!inword || flag != CASE_CAPITALIZE_UP))
244 c = UPCASE1 (c);
245 if ((int) flag >= (int) CASE_CAPITALIZE)
246 inword = ((SYNTAX (c) == Sword) && (inword || !SYNTAX_PREFIX (c)));
247 if (c != c2)
248 {
249 last = start;
250 if (first < 0)
251 first = start;
252
253 if (! multibyte)
254 {
255 MAKE_CHAR_UNIBYTE (c);
256 FETCH_BYTE (start_byte) = c;
257 }
258 else if (ASCII_CHAR_P (c2) && ASCII_CHAR_P (c))
259 FETCH_BYTE (start_byte) = c;
260 else
261 {
262 int tolen = CHAR_BYTES (c);
263 int j;
264 unsigned char str[MAX_MULTIBYTE_LENGTH];
265
266 CHAR_STRING (c, str);
267 if (len == tolen)
268 {
269 /* Length is unchanged. */
270 for (j = 0; j < len; ++j)
271 FETCH_BYTE (start_byte + j) = str[j];
272 }
273 else
274 {
275 /* Replace one character with the other,
276 keeping text properties the same. */
277 replace_range_2 (start, start_byte,
278 start + 1, start_byte + len,
279 str, 1, tolen,
280 0);
281 len = tolen;
282 }
283 }
284 }
285 start++;
286 start_byte += len;
287 }
288
289 if (PT != opoint)
290 TEMP_SET_PT_BOTH (opoint, opoint_byte);
291
292 if (first >= 0)
293 {
294 signal_after_change (first, last + 1 - first, last + 1 - first);
295 update_compositions (first, last + 1, CHECK_ALL);
296 }
297 }
298
299 DEFUN ("upcase-region", Fupcase_region, Supcase_region, 2, 2, "r",
300 doc: /* Convert the region to upper case. In programs, wants two arguments.
301 These arguments specify the starting and ending character numbers of
302 the region to operate on. When used as a command, the text between
303 point and the mark is operated on.
304 See also `capitalize-region'. */)
305 (Lisp_Object beg, Lisp_Object end)
306 {
307 casify_region (CASE_UP, beg, end);
308 return Qnil;
309 }
310
311 DEFUN ("downcase-region", Fdowncase_region, Sdowncase_region, 2, 2, "r",
312 doc: /* Convert the region to lower case. In programs, wants two arguments.
313 These arguments specify the starting and ending character numbers of
314 the region to operate on. When used as a command, the text between
315 point and the mark is operated on. */)
316 (Lisp_Object beg, Lisp_Object end)
317 {
318 casify_region (CASE_DOWN, beg, end);
319 return Qnil;
320 }
321
322 DEFUN ("capitalize-region", Fcapitalize_region, Scapitalize_region, 2, 2, "r",
323 doc: /* Convert the region to capitalized form.
324 Capitalized form means each word's first character is upper case
325 and the rest of it is lower case.
326 In programs, give two arguments, the starting and ending
327 character positions to operate on. */)
328 (Lisp_Object beg, Lisp_Object end)
329 {
330 casify_region (CASE_CAPITALIZE, beg, end);
331 return Qnil;
332 }
333
334 /* Like Fcapitalize_region but change only the initials. */
335
336 DEFUN ("upcase-initials-region", Fupcase_initials_region,
337 Supcase_initials_region, 2, 2, "r",
338 doc: /* Upcase the initial of each word in the region.
339 Subsequent letters of each word are not changed.
340 In programs, give two arguments, the starting and ending
341 character positions to operate on. */)
342 (Lisp_Object beg, Lisp_Object end)
343 {
344 casify_region (CASE_CAPITALIZE_UP, beg, end);
345 return Qnil;
346 }
347 \f
348 static Lisp_Object
349 operate_on_word (Lisp_Object arg, EMACS_INT *newpoint)
350 {
351 Lisp_Object val;
352 int farend;
353 int iarg;
354
355 CHECK_NUMBER (arg);
356 iarg = XINT (arg);
357 farend = scan_words (PT, iarg);
358 if (!farend)
359 farend = iarg > 0 ? ZV : BEGV;
360
361 *newpoint = PT > farend ? PT : farend;
362 XSETFASTINT (val, farend);
363
364 return val;
365 }
366
367 DEFUN ("upcase-word", Fupcase_word, Supcase_word, 1, 1, "p",
368 doc: /* Convert following word (or ARG words) to upper case, moving over.
369 With negative argument, convert previous words but do not move.
370 See also `capitalize-word'. */)
371 (Lisp_Object arg)
372 {
373 Lisp_Object beg, end;
374 EMACS_INT newpoint;
375 XSETFASTINT (beg, PT);
376 end = operate_on_word (arg, &newpoint);
377 casify_region (CASE_UP, beg, end);
378 SET_PT (newpoint);
379 return Qnil;
380 }
381
382 DEFUN ("downcase-word", Fdowncase_word, Sdowncase_word, 1, 1, "p",
383 doc: /* Convert following word (or ARG words) to lower case, moving over.
384 With negative argument, convert previous words but do not move. */)
385 (Lisp_Object arg)
386 {
387 Lisp_Object beg, end;
388 EMACS_INT newpoint;
389 XSETFASTINT (beg, PT);
390 end = operate_on_word (arg, &newpoint);
391 casify_region (CASE_DOWN, beg, end);
392 SET_PT (newpoint);
393 return Qnil;
394 }
395
396 DEFUN ("capitalize-word", Fcapitalize_word, Scapitalize_word, 1, 1, "p",
397 doc: /* Capitalize the following word (or ARG words), moving over.
398 This gives the word(s) a first character in upper case
399 and the rest lower case.
400 With negative argument, capitalize previous words but do not move. */)
401 (Lisp_Object arg)
402 {
403 Lisp_Object beg, end;
404 EMACS_INT newpoint;
405 XSETFASTINT (beg, PT);
406 end = operate_on_word (arg, &newpoint);
407 casify_region (CASE_CAPITALIZE, beg, end);
408 SET_PT (newpoint);
409 return Qnil;
410 }
411 \f
412 void
413 syms_of_casefiddle (void)
414 {
415 Qidentity = intern_c_string ("identity");
416 staticpro (&Qidentity);
417 defsubr (&Supcase);
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);
428 }
429
430 void
431 keys_of_casefiddle (void)
432 {
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);
437
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");
441 }
442
443 /* arch-tag: 60a73c66-5489-47e7-a81f-cead4057c526
444 (do not change this comment) */