/**
 * @file 字符串-cases.js
 * @module 轉小寫
 */

/**
 * 將字符串的第一個字母小寫。
 *
 * @param {string} 字符串
 * 需要小寫的字符串
 *
 * @return {字符串}
 * 首字母小寫的字符串
 */
導出常量 toLowerCase = 函數（字符串）{
  如果（字符串類型！=='字符串'）{
    返回字符串；
  }

  返回 string.replace(/./, (w) => w.toLowerCase());
};

/**
 * 大寫字符串的第一個字母。
 *
 * @param {string} 字符串
 * 需要大寫的字符串
 *
 * @return {字符串}
 * 首字母大寫的字符串
 */
導出常量 toTitleCase = 函數（字符串）{
  如果（字符串類型！=='字符串'）{
    返回字符串；
  }

  返回 string.replace(/./, (w) => w.toUpperCase());
};

/**
 * 比較兩個字符串的 TitleCase 版本是否相等。
 *
 * @param {字符串} str1
 * 第一個要比較的字符串
 *
 * @param {字符串} str2
 * 第二個要比較的字符串
 *
 * @return {布爾值}
 * 字符串的 TitleCase 版本是否相等
 */
export const titleCaseEquals = function(str1, str2) {
  返回 TitleCase(str1) === toTitleCase(str2);
};