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

capitalizeWords

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

capitalizeWords(value):string

نحوه عملکرد

رشته با استفاده از یک کاراکتر فاصله جدا می‌شود. هر بخش به صورت مستقل پردازش می‌شود. برای کلمات غیرخالی، اولین کاراکتر uppercase و باقی کاراکترها lowercase می‌شوند. سپس بخش‌ها با یک فاصله به هم متصل می‌شوند.

فاصله‌ها

از آنجا که split و join هر دو از یک فاصله استفاده می‌کنند، فاصله‌های ابتدایی، انتهایی و متوالی در نتیجه حفظ می‌شوند.

قوانین حروف

هر کلمه غیرخالی با یک کاراکتر uppercase شروع می‌شود و تمام کاراکترهای باقی‌مانده آن lowercase می‌شوند.

بخش‌های خالی

وقتی چند فاصله پشت سر هم قرار داشته باشند، split رشته‌های خالی ایجاد می‌کند. این رشته‌های خالی بدون تغییر برگردانده می‌شوند و فاصله‌های اصلی حفظ می‌شوند.

پارامترها

valuestringالزامی

رشته‌ای که کلمات آن باید capitalize شوند.

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

string

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

مثال‌ها

01

استفاده پایه

تمام کلمات یک جمله را capitalize می‌کند.

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

capitalizeWords("hello world");
// "Hello World"
02

ورودی با حروف بزرگ

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

TypeScript
capitalizeWords("HELLO WORLD");
// "Hello World"
03

حروف ترکیبی

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

TypeScript
capitalizeWords("hELLo WoRLD");
// "Hello World"
04

یک کلمه

یک کلمه capitalize شده و باقی حروف آن lowercase می‌شوند.

TypeScript
capitalizeWords("hELLO");
// "Hello"
05

چند فاصله

بخش‌های خالی ایجادشده توسط فاصله‌های متوالی حفظ می‌شوند.

TypeScript
capitalizeWords("hello  world");
// "Hello  World"
06

فاصله در ابتدا و انتها

فاصله‌های ابتدایی و انتهایی حفظ می‌شوند.

TypeScript
capitalizeWords("  hello world  ");
// "  Hello World  "
07

رشته خالی

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

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