PRINTF_GETTEXT(1) دستورهای کاربری PRINTF_GETTEXT(1)

printf_gettext - قالببندی و ترجمه پیامهای متنی

printf_gettext [گزینه] قالب [آرگومان]...

برنامه printf_gettext یک رشته قالب را با جستجو در کاتالوگ پیام، به زبان کاربر ترجمه می‌کند و رشته قالب ترجمه‌شده را بر روی آرگومان‌های مشخص‌شده اعمال می‌نماید.

تولید خروجی قالب‌بندی‌شده، با اعمال ترجمه زبان بومی قالب بر روی آرگومان‌ها.

مشخص کردن زمینه (context) برای قالب.
قالب
رشته قالب.
آرگومان
آرگومان متنی یا عددی.

نمایش این راهنما و خروج.
نمایش اطلاعات نسخه برنامه و خروج.

رشته قالب شامل موارد زیر است:

- متن ساده،
- دستورالعمل‌ها (directives) که با '%' آغاز می‌شوند،
- توالی‌های اسکیپ (escape sequences) که با یک بک‌اسلش آغاز می‌شوند.

یک دستورالعمل که یک آرگومان را مصرف می‌کند:

- با '%' یا '%m$' شروع می‌شود که در آن m یک عدد صحیح مثبت است،
- می‌تواند به صورت اختیاری با هر یک از نویسه‌های '#'، '0'، '-'، ' '، '+' دنبال شود،
که هر کدام به عنوان یک پرچم (flag) عمل می‌کنند،
- می‌تواند به صورت اختیاری با تعیین عرض فیلد (یک عدد صحیح غیرمنفی) دنبال شود،
- می‌تواند به صورت اختیاری با '.' و تعیین دقت (یک عدد صحیح
غیرمنفی اختیاری) دنبال شود،
- با یک مشخص‌کننده نوع پایان می‌یابد:
- 'c' که یک نویسه را چاپ می‌کند،
- 's' که یک رشته را چاپ می‌کند،
- 'i'، 'd' که یک عدد صحیح را چاپ می‌کنند،
- 'u'، 'o'، 'x'، 'X' که یک عدد صحیح بدون علامت (غیرمنفی) را چاپ می‌کنند،
- 'e'، 'E' که یک عدد ممیز شناور را با نماد علمی چاپ می‌کنند،
- 'f'، 'F' که یک عدد ممیز شناور را بدون توان چاپ می‌کنند،
- 'g'، 'G' که یک عدد ممیز شناور را با نماد کلی چاپ می‌کنند،
- 'a'، 'A' که یک عدد ممیز شناور را با نماد شانزده‌شانزدهی (هگزادسیمال) چاپ می‌کنند.

علاوه بر این، دستورالعمل '%%' نیز وجود دارد که یک نویسه '%' تنها را چاپ می‌کند.

اگر یک دستورالعمل، آرگومان را با شماره آن مشخص کند (نمادگذاری '%m$')، تمامی دستورالعمل‌هایی که یک آرگومان را مصرف می‌کنند نیز باید همین کار را انجام دهند.

توالی‌های اسکیپ عبارتند از:

\\
بک‌اسلش (backslash)
هشدار یا زنگ (BEL)
پس‌بر یا پس‌رو (BS)
برگه‌خور (FF)
خط جدید (LF)
بازگشت به ابتدای سطر (CR)
تب افقی (HT)
تب عمودی (VT)
عدد هشت‌هشتی (اکتال) با ۱ تا ۳ رقم

متغیرهای محیطی:

ترجمه رشته قالب در دامنه ترجمه مشخص‌شده توسط متغیر محیطی TEXTDOMAIN جستجو می‌شود. این ترجمه در دایرکتوری کاتالوگ‌های مشخص‌شده توسط متغیر محیطی TEXTDOMAINDIR یا در صورت عدم وجود، در دایرکتوری پیش‌فرض کاتالوگ‌ها جستجو می‌گردد. این فایل اجرایی به گونه‌ای پیکربندی شده است که از دایرکتوری پیش‌فرض کاتالوگ‌ها استفاده کند: /usr/share/locale

نوشته شده توسط Bruno Haible.

گزارش اشکالات در سامانه ردیابی باگ به نشانی: https://savannah.gnu.org/projects/gettext یا از طریق رایانامه به: <bug-gettext@gnu.org>.

حق نشر © 2025-2026 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.).
مجوز GPLv3+: مجوز عمومی همگانی گنو نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html.
این یک نرم‌افزار آزاد است: شما در تغییر و توزیع مجدد آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.

مستندات کامل برای printf_gettext به عنوان یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های info و printf_gettext به درستی در سیستم شما نصب شده باشند، با اجرای دستور

info printf_gettext

می‌توانید به کتابچه کامل دسترسی داشته باشید.

ژانویه ۲۰۲۶ GNU gettext-runtime 1.0