Here you can find the source of capitalize(final String str)
Capitalizes a String changing the first letter to title case case as per Character#toUpperCase(char) .
Parameter | Description |
---|---|
str | the String to capitalize, may be null |
public static String capitalize(final String str)
//package com.java2s; //License from project: Apache License public class Main { /**/*from www .ja va 2s. com*/ * <p> * Capitalizes a String changing the first letter to title case case as per {@link Character#toUpperCase(char)}. No * other letters are changed. * </p> * <p> * A {@code null} input String returns {@code null}. * </p> * <p/> * <pre> * StringUtils.capitalize(null) = null * StringUtils.capitalize("") = "" * StringUtils.capitalize("cat") = "Cat" * StringUtils.capitalize("cAt") = "CAt" * </pre> * * @param str * the String to capitalize, may be null * @return the capitalized String, {@code null} if null String input * @see #uncapitalize(String) */ public static String capitalize(final String str) { int strLen; if (str == null || (strLen = str.length()) == 0) { return str; } final char firstChar = str.charAt(0); if (Character.isUpperCase(firstChar)) { // already capitalized return str; } return new StringBuilder(strLen).append(Character.toUpperCase(firstChar)).append(str.substring(1)) .toString(); } /** * Gets a CharSequence length or {@code 0} if the CharSequence is {@code null}. * * @param cs * a CharSequence or {@code null} * @return CharSequence length or {@code 0} if the CharSequence is {@code null}. */ public static int length(CharSequence cs) { return cs == null ? 0 : cs.length(); } /** * <p> * Converts the given value to upper case. * </p> * <p/> * <pre> * toUpperCase(null) = null * toUpperCase("") = "" * toUpperCase("aBc") = "ABC" * toUpperCase("ABC") = "ABC" * toUpperCase(" abc ") = "ABC" * </pre> * * @param value * The string value, may be null. * @return the given {@code value} converted to upper case or {@code null}. */ public static String toUpperCase(String value) { if (value == null) { return null; } return value.trim().toUpperCase(); } /** * <p> * Gets a substring from the specified String avoiding exceptions. * </p> * <p> * A negative start position can be used to start/end {@code n} characters from the end of the String. * </p> * <p> * The returned substring starts with the character in the {@code start} position and ends before the {@code end} * position. All position counting is zero-based -- i.e., to start at the beginning of the string use * {@code start = 0}. Negative start and end positions can be used to specify offsets relative to the end of the * String. * </p> * <p> * If {@code start} is not strictly to the left of {@code end}, "" is returned. * </p> * <p/> * <pre> * StringUtils.substring(null, *, *) = null * StringUtils.substring("", * , *) = ""; * StringUtils.substring("abc", 0, 2) = "ab" * StringUtils.substring("abc", 2, 0) = "" * StringUtils.substring("abc", 2, 4) = "c" * StringUtils.substring("abc", 4, 6) = "" * StringUtils.substring("abc", 2, 2) = "" * StringUtils.substring("abc", -2, -1) = "b" * StringUtils.substring("abc", -4, 2) = "ab" * </pre> * * @param str * the String to get the substring from, may be null * @param start * the position to start from, negative means count back from the end of the String by this many characters * @param end * the position to end at (exclusive), negative means count back from the end of the String by this many * characters * @return substring from start position to end position, {@code null} if null String input */ public static String substring(final String str, int start, int end) { if (str == null) { return null; } // handle negatives if (end < 0) { end = str.length() + end; // remember end is negative } if (start < 0) { start = str.length() + start; // remember start is negative } // check length next if (end > str.length()) { end = str.length(); } // if start is greater than end, return "" if (start > end) { return ""; } if (start < 0) { start = 0; } if (end < 0) { end = 0; } return str.substring(start, end); } /** * Trims the given {@code value}. * * @param value * The value to trim. * @return the given {@code value} trimmed or {@code null}. */ public static String trim(String value) { if (value == null) { return null; } return value.trim(); } }