M4(1) User Commands M4(1)

m4 - پردازشگر ماکرو

m4 [OPTION]... [FILE]...

پردازش ماکروها در FILEها. اگر هیچ FILEای مشخص نشود یا FILE برابر با `-' باشد، ورودی استاندارد خوانده می‌شود.

آرگومان‌های اجباری یا اختیاری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری یا اختیاری هستند.

نمایش این راهنما و خروج
نمایش اطلاعات نسخه و خروج
یک‌بار: هشدارها به خطا تبدیل می‌شوند؛ دوبار: توقف اجرا در اولین خطا
-i, --interactive
غیرفعال کردن بافر خروجی، نادیده گرفتن وقفه‌ها
اجبار پیشوند `m4_' برای تمام دستورات توکار
فرونشاندن برخی هشدارها برای دستورات توکار
هشدار در صورت مطابقت تعریف ماکرو با REGEXP،
پیش‌فرض \$\({[^}]*}\|[0-9][0-9]+\)

تعریف NAME با مقدار VALUE، یا خالی
افزودن DIRECTORY به مسیر include
تولید خطوط `#line NUM "FILE"'
لغو تعریف NAME

لغو -G برای فعال‌سازی مجدد افزونه‌های GNU
غیرفعال‌سازی تمام افزونه‌های GNU
تنظیم اندازه جدول درهم‌سازی جستجوی نماد [65537]
تغییر محدودیت تودرتویی، 0 برای نامحدود [0]

ایجاد یک وضعیت منجمد در FILE در پایان
بارگذاری مجدد وضعیت منجمد از FILE در ابتدا

تنظیم سطح اشکال‌زدایی (نبود FLAGS به معنای `aeq' است)
هدایت خروجی اشکال‌زدایی و ردگیری به FILE (پیش‌فرض stderr، در صورت رشته خالی دور ریخته می‌شود)
-l, --arglength=NUM
محدود کردن اندازه ردگیری ماکرو
-t, --trace=NAME
ردگیری NAME هنگام تعریف شدن آن

نمایش آرگومان‌های واقعی
نمایش پیش از جمع‌آوری، پس از جمع‌آوری و پس از فراخوانی
نمایش بسط
اعلام نام فایل ورودی جاری
نمایش تغییرات در فایل‌های ورودی
اعلام شماره خط ورودی جاری
نمایش نتایج جستجوهای مسیر
نقل‌قول کردن مقادیر در صورت نیاز، با پرچم a یا e
ردیابی برای تمام فراخوانی‌های ماکرو، نه فقط موارد traceon شده
افزودن شناسه فراخوانی ماکروی یکتا، مفید همراه با پرچم c
کوته‌نوشتی برای تمامی پرچم‌های بالا

در صورت تعریف شدن، متغیر محیطی `M4PATH' فهرستی از دایرکتوری‌ها است که با دونقطه (:) جدا شده‌اند و پس از هر مورد مشخص‌شده با `-I' لحاظ می‌شوند.

وضعیت خروج برای موفقیت 0، برای شکست 1، برای عدم تطابق نسخه پرونده منجمد 63، یا هر مقداری است که به ماکروی m4exit ارسال شده است.

نوشته‌شده توسط Rene' Seindal.

گزارش اشکالات به: bug-m4@gnu.org
صفحه خانگی GNU M4: https://www.gnu.org/software/m4
راهنمای عمومی استفاده از نرم‌افزارهای گنو: https://www.gnu.org/gethelp

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

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

info m4

باید دسترسی به راهنمای کامل را برای شما فراهم کند.

March 2026 GNU M4 1.4.21