Enhanced Version Of `titleCase`

[abdelhakim-sahifa]

Here's an enhanced version of the titleCase function with additional features:

1. Excludes short words from capitalization: Words like "and", "or", "the" won't be capitalized unless they're the first or last word.
2. Handles acronyms: Words in all caps will remain in all caps.
3. Deals with hyphenated words: Both parts of hyphenated words will be capitalized.

String titleCase(String text) {
  final List<String> excludeWords = ['and', 'or', 'the', 'to', 'of', 'for', 'in', 'on', 'at', 'by', 'with', 'as'];
  final List<String> words = text.trim().split(RegExp(r'\s+'));

  String capitalize(String word) {
    if (word.length <= 2 || word.toUpperCase() == word) return word;
    return word[0].toUpperCase() + word.substring(1).toLowerCase();
  }

  for (int i = 0; i < words.length; i++) {
    if (words[i].contains('-')) {
      words[i] = words[i]
          .split('-')
          .map((part) => capitalize(part))
          .join('-');
    } else if (i == 0 || i == words.length - 1 || !excludeWords.contains(words[i].toLowerCase())) {
      words[i] = capitalize(words[i]);
    } else {
      words[i] = words[i].toLowerCase();
    }
  }

  return words.join(' ');
}

This enhanced version of titleCase takes care of more specific capitalization rules, making the output more refined and accurate for a variety of text inputs.

[abdelhakim-sahifa]

Function Definition

String titleCase(String text) {

• The function titleCase takes a String parameter called text and returns a String.
• The purpose of this function is to convert a given string into title case, where the first letter of each word is capitalized, except for certain small words unless they appear at the beginning or end of the string.

List of Words to Exclude

  final List<String> excludeWords = ['and', 'or', 'the', 'to', 'of', 'for', 'in', 'on', 'at', 'by', 'with', 'as'];

• excludeWords is a list of small words that should not be capitalized unless they are the first or last word in the input string.

Splitting the Text into Words

  final List<String> words = text.trim().split(RegExp(r'\s+'));

• The text string is trimmed to remove any leading or trailing whitespace.
• The split method is used with a regular expression RegExp(r'\s+') to divide the string into a list of words based on one or more whitespace characters.

Capitalize Function

  String capitalize(String word) {
    if (word.length <= 2 || word.toUpperCase() == word) return word;
    return word[0].toUpperCase() + word.substring(1).toLowerCase();
  }

• The capitalize function takes a String parameter called word.
• If the word length is 2 or less, or if the word is already in uppercase, it returns the word as it is.
• Otherwise, it capitalizes the first letter and makes the rest of the word lowercase.

Loop Through Words and Capitalize as Needed

  for (int i = 0; i < words.length; i++) {
    if (words[i].contains('-')) {
      words[i] = words[i]
          .split('-')
          .map((part) => capitalize(part))
          .join('-');
    } else if (i == 0 || i == words.length - 1 || !excludeWords.contains(words[i].toLowerCase())) {
      words[i] = capitalize(words[i]);
    } else {
      words[i] = words[i].toLowerCase();
    }
  }

• A for loop iterates over each word in the words list.
• If a word contains a hyphen (-), it splits the word into parts, capitalizes each part, and then joins them back with hyphens.
• If the word is the first or last word in the list, or if it is not in the excludeWords list, it is capitalized.
• If the word is in the excludeWords list, it is converted to lowercase.

Joining Words Back into a String

  return words.join(' ');
}

• The words are joined back into a single string with a space separating each word, and this string is returned as the result of the function.

Summary

This function converts a given string into title case while handling special cases such as hyphenated words and small words that should not be capitalized unless they are the first or last word in the string.