CyrefJS
CCyrefJS
EN
بازگشت به مستندات
رشته/از نسخه 1.38.0

capitalize

اولین کاراکتر یک رشته را به حروف بزرگ تبدیل می‌کند و بقیه رشته را بدون تغییر نگه می‌دارد.

capitalize(value):string

نحوه عملکرد

اگر رشته ورودی خالی باشد، همان رشته بدون تغییر برگردانده می‌شود. در غیر این صورت، اولین کاراکتر به حروف بزرگ تبدیل شده و باقی رشته بدون تغییر به آن اضافه می‌شود.

حفظ باقی رشته

تابع capitalize حروف باقی رشته را lowercase یا به شکل دیگری نرمال نمی‌کند؛ فقط اولین کاراکتر تغییر می‌کند.

رشته‌های خالی

رشته خالی مستقیماً و بدون هیچ تغییری برگردانده می‌شود.

پارامترها

valuestringالزامی

رشته‌ای که باید اولین کاراکتر آن به حروف بزرگ تبدیل شود.

مقدار بازگشتی

string

رشته‌ای که اولین کاراکتر آن به حروف بزرگ تبدیل شده است.

مثال‌ها

01

استفاده پایه

اولین کاراکتر یک رشته با حروف کوچک را بزرگ می‌کند.

TypeScript
import { capitalize } from "@cyref/js";

capitalize("hello");
// "Hello"
02

حروف ترکیبی

فقط اولین کاراکتر تغییر می‌کند و بقیه رشته بدون تغییر باقی می‌ماند.

TypeScript
capitalize("hello WORLD");
// "Hello WORLD"
03

از قبل با حرف بزرگ

اگر رشته از قبل با یک حرف بزرگ شروع شود، همان مقدار حفظ می‌شود.

TypeScript
capitalize("Hello");
// "Hello"
04

رشته خالی

رشته خالی بدون تغییر برگردانده می‌شود.

TypeScript
capitalize("");
// ""
05

باقی رشته

تمام کاراکترهای بعد از کاراکتر اول دقیقاً بدون تغییر حفظ می‌شوند.

TypeScript
capitalize("hELLO wORLD");
// "HELLO wORLD"
06

یک کاراکتر

یک کاراکتر به حروف بزرگ تبدیل می‌شود.

TypeScript
capitalize("a");
// "A"
ساخته شده با@cyref/js·مستندات رسمی