Bài tập 5 (B9_C#) Xây dựng lớp StringHelper

using System;
using System.Linq;  // Cần cho Enumerable.Repeat trong TaoMatKhau

/*
 * ============================================================
 * LỚP STRINGHELPER - TIỆN ÍCH XỬ LÝ CHUỖI
 * ============================================================
 * 
 * ĐẶC ĐIỂM:
 * - Lớp STATIC: Không cần khởi tạo đối tượng, gọi trực tiếp qua tên lớp
 * - Chứa các phương thức tiện ích (utility methods) để xử lý chuỗi
 * - Đặt trong namespace Bai5_StringHelper.Helpers
 */
namespace Bai5_StringHelper.Helpers
{
    public static class StringHelper
    {
        // ============================================================
        // 1. VIẾT HOA CHỮ CÁI ĐẦU MỖI TỪ
        // ============================================================
        // MỤC ĐÍCH: Chuyển đổi chuỗi thành dạng Title Case
        // Ví dụ: "ngUYỄN vĂN a" → "Nguyễn Văn A"
        public static string VietHoaChuCaiDau(string s)
        {
            // Kiểm tra chuỗi rỗng hoặc null để tránh lỗi
            if (string.IsNullOrEmpty(s)) return s;
            
            // Loại bỏ khoảng trắng đầu và cuối chuỗi
            s = s.Trim();
            
            // Tách chuỗi thành mảng các từ dựa trên khoảng trắng
            string[] words = s.Split(' ');
            
            // Duyệt từng từ trong mảng
            for (int i = 0; i < words.Length; i++)
            {
                // Bỏ qua từ rỗng (trường hợp nhiều khoảng trắng)
                if (!string.IsNullOrEmpty(words[i]))
                {
                    // Viết hoa chữ cái đầu + viết thường phần còn lại
                    // words[i][0]: lấy ký tự đầu tiên
                    // words[i].Substring(1): lấy phần còn lại từ vị trí 1
                    words[i] = char.ToUpper(words[i][0]) + words[i].Substring(1).ToLower();
                }
            }
            
            // Ghép các từ lại với nhau bằng khoảng trắng
            return string.Join(" ", words);
        }

        // ============================================================
        // 2. CHUẨN HÓA TÊN
        // ============================================================
        // MỤC ĐÍCH: Xóa khoảng trắng thừa + Viết hoa chuẩn tên
        // Ví dụ: "  Nguyễn   Văn   A  " → "Nguyễn Văn A"
        public static string ChuanHoaTen(string ten)
        {
            // Kiểm tra chuỗi rỗng hoặc null
            if (string.IsNullOrEmpty(ten)) return ten;
            
            // Bước 1: Xóa khoảng trắng đầu và cuối
            ten = ten.Trim();
            
            // Bước 2: Xóa khoảng trắng thừa giữa các từ
            // Lặp đến khi không còn 2 khoảng trắng liên tiếp
            while (ten.Contains("  "))
                ten = ten.Replace("  ", " ");  // Thay 2 spaces → 1 space
            
            // Bước 3: Gọi hàm viết hoa chữ cái đầu
            return VietHoaChuCaiDau(ten);
        }

        // ============================================================
        // 3. TẠO MẬT KHẨU NGẪU NHIÊN
        // ============================================================
        // MỤC ĐÍCH: Tạo chuỗi mật khẩu ngẫu nhiên với độ dài chỉ định
        // Ví dụ: TaoMatKhau(10) → "aB3@xY9#mN"
        public static string TaoMatKhau(int doDai = 8)  // Tham số mặc định = 8
        {
            // Chuỗi chứa tất cả ký tự cho phép trong mật khẩu
            // Gồm: Chữ hoa, chữ thường, số, và ký tự đặc biệt
            const string chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*";
            
            // Tạo đối tượng Random để sinh số ngẫu nhiên
            Random rand = new Random();
            
            /* 
             * Cơ chế tạo mật khẩu:
             * 1. Enumerable.Repeat(chars, doDai) 
             *    → Lặp lại chuỗi chars doDai lần
             * 2. .Select(s => s[rand.Next(s.Length)]) 
             *    → Mỗi lần chọn ngẫu nhiên 1 ký tự từ chuỗi chars
             * 3. .ToArray() 
             *    → Chuyển thành mảng ký tự
             * 4. new string(...) 
             *    → Tạo chuỗi từ mảng ký tự
             */
            return new string(Enumerable.Repeat(chars, doDai)
                .Select(s => s[rand.Next(s.Length)])
                .ToArray());
        }

        // ============================================================
        // 4. CẮT CHUỖI (THÊM "...")
        // ============================================================
        // MỤC ĐÍCH: Rút gọn chuỗi dài, thêm "..." vào cuối
        // Ví dụ: CatChuoi("Xin chào thế giới", 10) → "Xin chào..."
        public static string CatChuoi(string s, int maxLen)
        {
            // Kiểm tra chuỗi rỗng/null
            if (string.IsNullOrEmpty(s)) return s;
            
            // Nếu chuỗi đã ngắn hơn maxLen → giữ nguyên
            if (s.Length <= maxLen) return s;
            
            // Cắt chuỗi: lấy maxLen - 3 ký tự đầu + "..."
            // Trừ 3 để chừa chỗ cho dấu "..."
            return s.Substring(0, maxLen - 3) + "...";
        }

        // ============================================================
        // 5. ĐẾM SỐ TỪ TRONG CHUỖI
        // ============================================================
        // MỤC ĐÍCH: Đếm số lượng từ trong một câu
        // Ví dụ: DemSoTu("Hôm nay trời đẹp") → 4
        public static int DemSoTu(string s)
        {
            // Kiểm tra chuỗi rỗng, null hoặc chỉ có khoảng trắng
            if (string.IsNullOrWhiteSpace(s)) return 0;
            
            // Xóa khoảng trắng đầu/cuối
            s = s.Trim();
            
            /* 
             * Tách chuỗi thành mảng từ:
             * - Dùng ký tự phân cách là khoảng trắng ' '
             * - RemoveEmptyEntries: bỏ qua các phần tử rỗng
             * - Lấy độ dài mảng = số từ
             */
            return s.Split(new char[] { ' ' }, StringSplitOptions.RemoveEmptyEntries).Length;
        }

        // ============================================================
        // 6. ĐẢO NGƯỢC CHUỖI
        // ============================================================
        // MỤC ĐÍCH: Đảo ngược thứ tự các ký tự trong chuỗi
        // Ví dụ: DaoNguoc("Hello") → "olleH"
        public static string DaoNguoc(string s)
        {
            // Kiểm tra chuỗi rỗng/null
            if (string.IsNullOrEmpty(s)) return s;
            
            // Bước 1: Chuyển chuỗi thành mảng ký tự
            char[] chars = s.ToCharArray();
            
            // Bước 2: Đảo ngược mảng (thư viện .NET)
            Array.Reverse(chars);
            
            // Bước 3: Tạo chuỗi mới từ mảng đã đảo
            return new string(chars);
        }
    }
}