char-uppercase-p: New predicate

Return non-nil if its argument is an uppercase character.

Suggested in Bug#54804.

* lisp/subr.el (char-uppercase-p): New defun.
* etc/NEWS (Lisp Changes in Emacs 29.1): Announce it
* doc/lispref/display.texi (Size of Displayed Text): Document it.
* test/lisp/subr-tests.el (test-char-uppercase-p): Add a test.

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 0ab683d234da3984f6e7a26176c3698ef4811620..f428fb858b0ee3503d7be17d9904f06cd9d49da2 100644 (file)
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2010,6 +2010,11 @@ Tables}).  The width of a tab character is usually @code{tab-width}
 (@pxref{Usual Display}).
 @end defun
 
+@defun char-uppercase-p char
+Return non-@code{nil} if @var{char} is an uppercase character
+according to Unicode.
+@end defun
+
 @defun string-width string &optional from to
 This function returns the width in columns of the string @var{string},
 if it were displayed in the current buffer and the selected window.

diff --git a/etc/NEWS b/etc/NEWS
index 991088a067f78a6b170bc5280726b3804ad32b9b..ddb83ce410d1b0b61e07d5664f8539374e25cd05 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1781,6 +1781,10 @@ functions.
 \f
 * Lisp Changes in Emacs 29.1
 
++++
+** New predicate 'char-uppercase-p'.
+This returns non-nil if its argument its an uppercase character.
+
 ** Byte compilation
 
 ---
@@ -1793,7 +1797,6 @@ I.e., double-quoting the 'bar', which is almost never the correct
 value.  The byte compiler will now issue a warning if it encounters
 these forms.
 
-
 +++
 *** 'restore-buffer-modified-p' can now alter buffer auto-save state.
 With a FLAG value of 'autosaved', it will mark the buffer as having

diff --git a/lisp/simple.el b/lisp/simple.el
index 89fb0ea97ecb5710ce160f7478dec14cf52d4ed1..3812f6d8c6a4d813761142153bd286b2c14c8b93 100644 (file)
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -6054,6 +6054,14 @@ and KILLP is t if a prefix arg was specified."
     ;; Avoid warning about delete-backward-char
     (with-no-warnings (delete-backward-char n killp))))
 
+(defun char-uppercase-p (char)
+  "Return non-nil if CHAR is an upper-case character.
+If the Unicode tables are not yet available, e.g. during bootstrap,
+then gives correct answers only for ASCII characters."
+  (cond ((unicode-property-table-internal 'lowercase)
+         (characterp (get-char-code-property char 'lowercase)))
+        ((and (>= char ?A) (<= char ?Z)))))
+
 (defun zap-to-char (arg char)
   "Kill up to and including ARGth occurrence of CHAR.
 Case is ignored if `case-fold-search' is non-nil in the current buffer.

diff --git a/test/lisp/subr-tests.el b/test/lisp/subr-tests.el
index 89803e5ce2e6215b6945e65b418aaab6b0d3a198..a25eb363b0162470f36912d26698c98808b4ab72 100644 (file)
--- a/test/lisp/subr-tests.el
+++ b/test/lisp/subr-tests.el
@@ -1074,5 +1074,12 @@ final or penultimate step during initialization."))
       (should (= subr-test--local 2))
       (should-not (boundp 'subr-test--unexist)))))
 
+(ert-deftest test-char-uppercase-p ()
+  "Tests for `char-uppercase-p'."
+  (dolist (c (list ?R ?S ?Ω ?Ψ))
+    (should (char-uppercase-p c)))
+  (dolist (c (list ?a ?b ?α ?β))
+    (should-not (char-uppercase-p c))))
+
 (provide 'subr-tests)
 ;;; subr-tests.el ends here