Rename isupper, islower, ucfirst and lcfirst

Spell "uppercase" and "lowercase" in full for consistency with uppercase and lowercase functions.

Author: nalimilan

NEWS.md

@@ -1099,6 +1099,9 @@ Deprecated or removed
     `show(IOContext(io, :compact => true), x...)` ([#26080]).
     Use `sprint(show, x..., context=:compact => true)` instead of `sprint(showcompact, x...)`.
 
+  * `isupper`, `islower`, `ucfirst` and `lcfirst` have been deprecated in favor of `isuppercase`,
+    `islowercase`, `uppercasefirst` and `lowercasefirst`, respectively ([#26442]).
+
 Command-line option changes
 ---------------------------
 
@@ -1396,4 +1399,5 @@ Command-line option changes
 [#26009]: https://github.com/JuliaLang/julia/issues/26009
 [#26071]: https://github.com/JuliaLang/julia/issues/26071
 [#26080]: https://github.com/JuliaLang/julia/issues/26080
-[#26149]: https://github.com/JuliaLang/julia/issues/26149
+[#26149]: https://github.com/JuliaLang/julia/issues/26149
+[#26442]: https://github.com/JuliaLang/julia/issues/26442

base/deprecated.jl

@@ -1518,6 +1518,11 @@ end
 @deprecate showcompact(io, x) show(IOContext(io, :compact => true), x)
 @deprecate sprint(::typeof(showcompact), args...) sprint(show, args...; context=:compact => true)
 
+@deprecate isupper isuppercase
+@deprecate islower islowercase
+@deprecate ucfirst uppercasefirst
+@deprecate lcfirst lowercasefirst
+
 # END 0.7 deprecations
 
 # BEGIN 1.0 deprecations

base/exports.jl

@@ -574,15 +574,15 @@ export
     isascii,
     iscntrl,
     isdigit,
-    islower,
+    islowercase,
     isnumeric,
     isprint,
     ispunct,
     isspace,
-    isupper,
+    isuppercase,
     isxdigit,
-    lcfirst,
     lowercase,
+    lowercasefirst,
     isvalid,
     join,
     lpad,
@@ -606,9 +606,9 @@ export
     thisind,
     titlecase,
     transcode,
-    ucfirst,
     unescape_string,
     uppercase,
+    uppercasefirst,
 
 # text output
     IOContext,

base/printf.jl

@@ -413,7 +413,7 @@ function gen_e(flags::String, width::Int, precision::Int, c::Char, inside_g::Boo
     blk = ifblk.args[2]
     push!(blk.args, :((len, pt, neg) = args))
     push!(blk.args, :(exp = pt-1))
-    expmark = isupper(c) ? "E" : "e"
+    expmark = isuppercase(c) ? "E" : "e"
     if precision==0 && '#' in flags
         expmark = string(".",expmark)
     end

base/strings/strings.jl

@@ -4,8 +4,8 @@ include("strings/substring.jl")
 include("strings/search.jl")
 include("strings/unicode.jl")
 
-import .Unicode: textwidth, islower, isupper, isalpha, isdigit, isnumeric, iscntrl, ispunct,
-    isspace, isprint, isxdigit, lowercase, uppercase, titlecase, lcfirst, ucfirst
+import .Unicode: textwidth, islowercase, isuppercase, isalpha, isdigit, isnumeric, iscntrl, ispunct,
+    isspace, isprint, isxdigit, lowercase, uppercase, titlecase, lowercasefirst, uppercasefirst
 
 include("strings/util.jl")
 include("strings/io.jl")

base/strings/unicode.jl

@@ -268,48 +268,48 @@ isassigned(c) = UTF8PROC_CATEGORY_CN < category_code(c) <= UTF8PROC_CATEGORY_CO
 ## libc character class predicates ##
 
 """
-    islower(c::AbstractChar) -> Bool
+    islowercase(c::AbstractChar) -> Bool
 
 Tests whether a character is a lowercase letter.
 A character is classified as lowercase if it belongs to Unicode category Ll,
 Letter: Lowercase.
 
 # Examples
 ```jldoctest
-julia> islower('α')
+julia> islowercase('α')
 true
 
-julia> islower('Γ')
+julia> islowercase('Γ')
 false
 
-julia> islower('❤')
+julia> islowercase('❤')
 false
 ```
 """
-islower(c::AbstractChar) = category_code(c) == UTF8PROC_CATEGORY_LL
+islowercase(c::AbstractChar) = category_code(c) == UTF8PROC_CATEGORY_LL
 
 # true for Unicode upper and mixed case
 
 """
-    isupper(c::AbstractChar) -> Bool
+    isuppercase(c::AbstractChar) -> Bool
 
 Tests whether a character is an uppercase letter.
 A character is classified as uppercase if it belongs to Unicode category Lu,
 Letter: Uppercase, or Lt, Letter: Titlecase.
 
 # Examples
 ```jldoctest
-julia> isupper('γ')
+julia> isuppercase('γ')
 false
 
-julia> isupper('Γ')
+julia> isuppercase('Γ')
 true
 
-julia> isupper('❤')
+julia> isuppercase('❤')
 false
 ```
 """
-function isupper(c::AbstractChar)
+function isuppercase(c::AbstractChar)
     cat = category_code(c)
     cat == UTF8PROC_CATEGORY_LU || cat == UTF8PROC_CATEGORY_LT
 end
@@ -533,7 +533,7 @@ converted to lowercase, otherwise they are left unchanged.
 By default, all non-letters are considered as word separators;
 a predicate can be passed as the `wordsep` keyword to determine
 which characters should be considered as word separators.
-See also [`ucfirst`](@ref) to capitalize only the first
+See also [`uppercasefirst`](@ref) to capitalize only the first
 character in `s`.
 
 # Examples
@@ -564,22 +564,22 @@ function titlecase(s::AbstractString; wordsep::Function = !iscased, strict::Bool
 end
 
 """
-    ucfirst(s::AbstractString) -> String
+    uppercasefirst(s::AbstractString) -> String
 
 Return `s` with the first character converted to uppercase (technically "title
 case" for Unicode). See also [`titlecase`](@ref) to capitalize the first
 character of every word in `s`.
 
-See also: [`lcfirst`](@ref), [`uppercase`](@ref), [`lowercase`](@ref),
+See also: [`lowercasefirst`](@ref), [`uppercase`](@ref), [`lowercase`](@ref),
 [`titlecase`](@ref)
 
 # Examples
 ```jldoctest
-julia> ucfirst("python")
+julia> uppercasefirst("python")
 "Python"
 ```
 """
-function ucfirst(s::AbstractString)
+function uppercasefirst(s::AbstractString)
     isempty(s) && return ""
     c = s[1]
     c′ = titlecase(c)
@@ -588,20 +588,20 @@ function ucfirst(s::AbstractString)
 end
 
 """
-    lcfirst(s::AbstractString)
+    lowercasefirst(s::AbstractString)
 
 Return `s` with the first character converted to lowercase.
 
-See also: [`ucfirst`](@ref), [`uppercase`](@ref), [`lowercase`](@ref),
+See also: [`uppercasefirst`](@ref), [`uppercase`](@ref), [`lowercase`](@ref),
 [`titlecase`](@ref)
 
 # Examples
 ```jldoctest
-julia> lcfirst("Julia")
+julia> lowercasefirst("Julia")
 "julia"
 ```
 """
-function lcfirst(s::AbstractString)
+function lowercasefirst(s::AbstractString)
     isempty(s) && return ""
     c = s[1]
     c′ = lowercase(c)

doc/src/base/strings.md

@@ -53,8 +53,8 @@ Base.last(::AbstractString, ::Integer)
 Base.uppercase
 Base.lowercase
 Base.titlecase
-Base.ucfirst
-Base.lcfirst
+Base.uppercasefirst
+Base.lowercasefirst
 Base.join
 Base.chop
 Base.chomp
@@ -66,12 +66,12 @@ Base.isalpha
 Base.isascii
 Base.iscntrl
 Base.isdigit
-Base.islower
+Base.islowercase
 Base.isnumeric
 Base.isprint
 Base.ispunct
 Base.isspace
-Base.isupper
+Base.isuppercase
 Base.isxdigit
 Core.Symbol
 Base.escape_string

stdlib/Markdown/src/Common/block.jl

@@ -214,7 +214,7 @@ function admonition(stream::IO, block::MD)
                 if contains(line, untitled)
                     m = match(untitled, line)
                     # When no title is provided we use CATEGORY_NAME, capitalising it.
-                    m.captures[1], ucfirst(m.captures[1])
+                    m.captures[1], uppercasefirst(m.captures[1])
                 elseif contains(line, titled)
                     m = match(titled, line)
                     # To have a blank TITLE provide an explicit empty string as TITLE.

stdlib/Markdown/src/render/plain.jl

@@ -72,7 +72,7 @@ end
 
 function plain(io::IO, md::Admonition)
     s = sprint(plain, md.content)
-    title = md.title == ucfirst(md.category) ? "" : " \"$(md.title)\""
+    title = md.title == uppercasefirst(md.category) ? "" : " \"$(md.title)\""
     println(io, "!!! ", md.category, title)
     for line in split(rstrip(s), "\n")
         println(io, isempty(line) ? "" : "    ", line)

stdlib/Markdown/src/render/rst.jl

@@ -76,7 +76,7 @@ end
 
 function rst(io::IO, md::Admonition)
     s = sprint(rst, md.content)
-    title = md.title == ucfirst(md.category) ? "" : md.title
+    title = md.title == uppercasefirst(md.category) ? "" : md.title
     println(io, ".. ", md.category, "::", isempty(title) ? "" : " $title")
     for line in split(rstrip(s), "\n")
         println(io, isempty(line) ? "" : "   ", line)