wordwrap
تابع «wordwrap» متن طولانی را می شکند. سپس خط های جدید می سازد. «عرض خط (Width)» یعنی حداکثر کاراکتر هر خط.
wordwrap چیست؟
wordwrap() وقتی طول متن به حدی برسد، آن را می شکند. بنابراین خروجی می تواند چند خط باشد.
سینتکس و پارامترها
wordwrap(string, width, break, cut)
string: رشته ورودی برای شکستن.
width: حداکثر طول هر خط؛ پیش فرض 75.
break: جداکننده خط؛ پیش فرض \n است.
cut: اگر TRUE باشد، کلمات خیلی بلند هم نصف می شوند.
مثال 1: شکستن با جداکننده HTML
اینجا بعد از هر 15 کاراکتر، <br>\n می گذاریم.
<?php
$str = "An example of a long word is: Supercalifragulistic";
echo wordwrap($str, 15, "<br>\n");
?>
مثال 2: استفاده از همه پارامترها
با cut=TRUE حتی کلمات بلند نصف می شوند. دقت کن.
<?php
$str = "An example of a long word is: Supercalifragulistic";
echo wordwrap($str, 15, "<br>\n", TRUE);
?>
مثال 3: خروجی ساده با \n
بدون تعیین جداکننده، پیش فرض همان \n است. مرورگر \n را نمی شکند.
<?php
$str = "An example of a long word is: Supercalifragulistic";
echo wordwrap($str, 15);
?>
چرا در HTML شکسته نشد؟
مرورگر \n را نمایش نمی دهد. بنابراین برای وب، از <br> استفاده کن.
گام های عملی
- عرض خط مناسب را انتخاب کن.
- اگر در وبی، جداکننده را <br> بگذار.
- در صورت نیاز،
cutرا TRUE کن.
نکته: ممکن است ابتدای خط فاصله بماند. سپس با trim() پاک کن.
پیوندها
- تابع wordwrap برای مرجع سریع.
- nl2br برای تبدیل \n به <br>.
جمع بندی سریع
- پیش فرض جداکننده \n است.
- برای HTML، از <br> استفاده کن.
- با cut، کلمات بلند نصف می شوند.
- عرض خط پیش فرض 75 است.