1 /* GNU Emacs case conversion functions.
3 Copyright (C) 1985, 1994, 1997-1999, 2001-2011 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
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.
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.
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/>. */
25 #include "character.h"
28 #include "composite.h"
31 enum case_action
{CASE_UP
, CASE_DOWN
, CASE_CAPITALIZE
, CASE_CAPITALIZE_UP
};
33 Lisp_Object Qidentity
;
36 casify_object (enum case_action flag
, Lisp_Object obj
)
39 register int inword
= flag
== CASE_DOWN
;
41 /* If the case table is flagged as modified, rescan it. */
42 if (NILP (XCHAR_TABLE (BVAR (current_buffer
, downcase_table
))->extras
[1]))
43 Fset_case_table (BVAR (current_buffer
, downcase_table
));
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 (BVAR (current_buffer
, enable_multibyte_characters
));
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_CMP (XFASTINT (obj
), >, flagbits
))
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. */
66 MAKE_CHAR_MULTIBYTE (c1
);
69 XSETFASTINT (obj
, c
| flags
);
70 else if (c
== (XFASTINT (obj
) & ~flagbits
))
75 MAKE_CHAR_UNIBYTE (c
);
76 XSETFASTINT (obj
, c
| flags
);
82 wrong_type_argument (Qchar_or_string_p
, obj
);
83 else if (!STRING_MULTIBYTE (obj
))
86 EMACS_INT size
= SCHARS (obj
);
88 obj
= Fcopy_sequence (obj
);
89 for (i
= 0; i
< size
; i
++)
92 MAKE_CHAR_MULTIBYTE (c
);
94 if (inword
&& flag
!= CASE_CAPITALIZE_UP
)
96 else if (!uppercasep (c
)
97 && (!inword
|| flag
!= CASE_CAPITALIZE_UP
))
99 if ((int) flag
>= (int) CASE_CAPITALIZE
)
100 inword
= (SYNTAX (c
) == Sword
);
103 MAKE_CHAR_UNIBYTE (c
);
104 /* If the char can't be converted to a valid byte, just don't
106 if (c
>= 0 && c
< 256)
114 EMACS_INT i
, i_byte
, size
= SCHARS (obj
);
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
);
124 for (i
= i_byte
= 0; i
< size
; i
++, i_byte
+= len
)
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
);
134 c
= STRING_CHAR_AND_LENGTH (SDATA (obj
) + i_byte
, len
);
135 if (inword
&& flag
!= CASE_CAPITALIZE_UP
)
137 else if (!uppercasep (c
)
138 && (!inword
|| flag
!= CASE_CAPITALIZE_UP
))
140 if ((int) flag
>= (int) CASE_CAPITALIZE
)
141 inword
= (SYNTAX (c
) == Sword
);
142 o
+= CHAR_STRING (c
, o
);
144 eassert (o
- dst
<= o_size
);
145 obj
= make_multibyte_string ((char *) dst
, size
, o
- dst
);
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'. */)
158 return casify_object (CASE_UP
, obj
);
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. */)
167 return casify_object (CASE_DOWN
, obj
);
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. */)
178 return casify_object (CASE_CAPITALIZE
, obj
);
181 /* Like Fcapitalize but change only the initials. */
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. */)
190 return casify_object (CASE_CAPITALIZE_UP
, obj
);
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. */
197 casify_region (enum case_action flag
, Lisp_Object b
, Lisp_Object e
)
200 register int inword
= flag
== CASE_DOWN
;
201 register int multibyte
= !NILP (BVAR (current_buffer
, enable_multibyte_characters
));
202 EMACS_INT start
, end
;
203 EMACS_INT start_byte
;
205 /* Position of first and last changes. */
206 EMACS_INT first
= -1, last
IF_LINT (= 0);
208 EMACS_INT opoint
= PT
;
209 EMACS_INT opoint_byte
= PT_BYTE
;
212 /* Not modifying because nothing marked */
215 /* If the case table is flagged as modified, rescan it. */
216 if (NILP (XCHAR_TABLE (BVAR (current_buffer
, downcase_table
))->extras
[1]))
217 Fset_case_table (BVAR (current_buffer
, downcase_table
));
219 validate_region (&b
, &e
);
220 start
= XFASTINT (b
);
222 modify_region (current_buffer
, start
, end
, 0);
223 record_change (start
, end
- start
);
224 start_byte
= CHAR_TO_BYTE (start
);
226 SETUP_BUFFER_SYNTAX_TABLE (); /* For syntax_prefix_flag_p. */
234 c
= FETCH_MULTIBYTE_CHAR (start_byte
);
235 len
= CHAR_BYTES (c
);
239 c
= FETCH_BYTE (start_byte
);
240 MAKE_CHAR_MULTIBYTE (c
);
244 if (inword
&& flag
!= CASE_CAPITALIZE_UP
)
246 else if (!uppercasep (c
)
247 && (!inword
|| flag
!= CASE_CAPITALIZE_UP
))
249 if ((int) flag
>= (int) CASE_CAPITALIZE
)
250 inword
= ((SYNTAX (c
) == Sword
)
251 && (inword
|| !syntax_prefix_flag_p (c
)));
260 MAKE_CHAR_UNIBYTE (c
);
261 FETCH_BYTE (start_byte
) = c
;
263 else if (ASCII_CHAR_P (c2
) && ASCII_CHAR_P (c
))
264 FETCH_BYTE (start_byte
) = c
;
267 int tolen
= CHAR_BYTES (c
);
269 unsigned char str
[MAX_MULTIBYTE_LENGTH
];
271 CHAR_STRING (c
, str
);
274 /* Length is unchanged. */
275 for (j
= 0; j
< len
; ++j
)
276 FETCH_BYTE (start_byte
+ j
) = str
[j
];
280 /* Replace one character with the other,
281 keeping text properties the same. */
282 replace_range_2 (start
, start_byte
,
283 start
+ 1, start_byte
+ len
,
284 (char *) str
, 1, tolen
,
295 TEMP_SET_PT_BOTH (opoint
, opoint_byte
);
299 signal_after_change (first
, last
+ 1 - first
, last
+ 1 - first
);
300 update_compositions (first
, last
+ 1, CHECK_ALL
);
304 DEFUN ("upcase-region", Fupcase_region
, Supcase_region
, 2, 2, "r",
305 doc
: /* Convert the region to upper case. In programs, wants two arguments.
306 These arguments specify the starting and ending character numbers of
307 the region to operate on. When used as a command, the text between
308 point and the mark is operated on.
309 See also `capitalize-region'. */)
310 (Lisp_Object beg
, Lisp_Object end
)
312 casify_region (CASE_UP
, beg
, end
);
316 DEFUN ("downcase-region", Fdowncase_region
, Sdowncase_region
, 2, 2, "r",
317 doc
: /* Convert the region to lower case. In programs, wants two arguments.
318 These arguments specify the starting and ending character numbers of
319 the region to operate on. When used as a command, the text between
320 point and the mark is operated on. */)
321 (Lisp_Object beg
, Lisp_Object end
)
323 casify_region (CASE_DOWN
, beg
, end
);
327 DEFUN ("capitalize-region", Fcapitalize_region
, Scapitalize_region
, 2, 2, "r",
328 doc
: /* Convert the region to capitalized form.
329 Capitalized form means each word's first character is upper case
330 and the rest of it is lower case.
331 In programs, give two arguments, the starting and ending
332 character positions to operate on. */)
333 (Lisp_Object beg
, Lisp_Object end
)
335 casify_region (CASE_CAPITALIZE
, beg
, end
);
339 /* Like Fcapitalize_region but change only the initials. */
341 DEFUN ("upcase-initials-region", Fupcase_initials_region
,
342 Supcase_initials_region
, 2, 2, "r",
343 doc
: /* Upcase the initial of each word in the region.
344 Subsequent letters of each word are not changed.
345 In programs, give two arguments, the starting and ending
346 character positions to operate on. */)
347 (Lisp_Object beg
, Lisp_Object end
)
349 casify_region (CASE_CAPITALIZE_UP
, beg
, end
);
354 operate_on_word (Lisp_Object arg
, EMACS_INT
*newpoint
)
362 farend
= scan_words (PT
, iarg
);
364 farend
= iarg
> 0 ? ZV
: BEGV
;
366 *newpoint
= PT
> farend
? PT
: farend
;
367 XSETFASTINT (val
, farend
);
372 DEFUN ("upcase-word", Fupcase_word
, Supcase_word
, 1, 1, "p",
373 doc
: /* Convert following word (or ARG words) to upper case, moving over.
374 With negative argument, convert previous words but do not move.
375 See also `capitalize-word'. */)
378 Lisp_Object beg
, end
;
380 XSETFASTINT (beg
, PT
);
381 end
= operate_on_word (arg
, &newpoint
);
382 casify_region (CASE_UP
, beg
, end
);
387 DEFUN ("downcase-word", Fdowncase_word
, Sdowncase_word
, 1, 1, "p",
388 doc
: /* Convert following word (or ARG words) to lower case, moving over.
389 With negative argument, convert previous words but do not move. */)
392 Lisp_Object beg
, end
;
394 XSETFASTINT (beg
, PT
);
395 end
= operate_on_word (arg
, &newpoint
);
396 casify_region (CASE_DOWN
, beg
, end
);
401 DEFUN ("capitalize-word", Fcapitalize_word
, Scapitalize_word
, 1, 1, "p",
402 doc
: /* Capitalize the following word (or ARG words), moving over.
403 This gives the word(s) a first character in upper case
404 and the rest lower case.
405 With negative argument, capitalize previous words but do not move. */)
408 Lisp_Object beg
, end
;
410 XSETFASTINT (beg
, PT
);
411 end
= operate_on_word (arg
, &newpoint
);
412 casify_region (CASE_CAPITALIZE
, beg
, end
);
418 syms_of_casefiddle (void)
420 DEFSYM (Qidentity
, "identity");
422 defsubr (&Sdowncase
);
423 defsubr (&Scapitalize
);
424 defsubr (&Supcase_initials
);
425 defsubr (&Supcase_region
);
426 defsubr (&Sdowncase_region
);
427 defsubr (&Scapitalize_region
);
428 defsubr (&Supcase_initials_region
);
429 defsubr (&Supcase_word
);
430 defsubr (&Sdowncase_word
);
431 defsubr (&Scapitalize_word
);
435 keys_of_casefiddle (void)
437 initial_define_key (control_x_map
, Ctl ('U'), "upcase-region");
438 Fput (intern ("upcase-region"), Qdisabled
, Qt
);
439 initial_define_key (control_x_map
, Ctl ('L'), "downcase-region");
440 Fput (intern ("downcase-region"), Qdisabled
, Qt
);
442 initial_define_key (meta_map
, 'u', "upcase-word");
443 initial_define_key (meta_map
, 'l', "downcase-word");
444 initial_define_key (meta_map
, 'c', "capitalize-word");