1.38.0capitalize
اولین کاراکتر یک رشته را به حروف بزرگ تبدیل میکند و بقیه رشته را بدون تغییر نگه میدارد.
capitalize(value):stringنحوه عملکرد
اگر رشته ورودی خالی باشد، همان رشته بدون تغییر برگردانده میشود. در غیر این صورت، اولین کاراکتر به حروف بزرگ تبدیل شده و باقی رشته بدون تغییر به آن اضافه میشود.
حفظ باقی رشته
تابع capitalize حروف باقی رشته را lowercase یا به شکل دیگری نرمال نمیکند؛ فقط اولین کاراکتر تغییر میکند.
رشتههای خالی
رشته خالی مستقیماً و بدون هیچ تغییری برگردانده میشود.
پارامترها
valuestringالزامیرشتهای که باید اولین کاراکتر آن به حروف بزرگ تبدیل شود.
مقدار بازگشتی
stringرشتهای که اولین کاراکتر آن به حروف بزرگ تبدیل شده است.
مثالها
استفاده پایه
اولین کاراکتر یک رشته با حروف کوچک را بزرگ میکند.
import { capitalize } from "@cyref/js";
capitalize("hello");
// "Hello"حروف ترکیبی
فقط اولین کاراکتر تغییر میکند و بقیه رشته بدون تغییر باقی میماند.
capitalize("hello WORLD");
// "Hello WORLD"از قبل با حرف بزرگ
اگر رشته از قبل با یک حرف بزرگ شروع شود، همان مقدار حفظ میشود.
capitalize("Hello");
// "Hello"رشته خالی
رشته خالی بدون تغییر برگردانده میشود.
capitalize("");
// ""باقی رشته
تمام کاراکترهای بعد از کاراکتر اول دقیقاً بدون تغییر حفظ میشوند.
capitalize("hELLO wORLD");
// "HELLO wORLD"یک کاراکتر
یک کاراکتر به حروف بزرگ تبدیل میشود.
capitalize("a");
// "A"