.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.3. .TH DECORATE "1" "April 2025" "decorate 1.9" "دستورهای کاربری" .SH "نام (NAME)" decorate \- تبدیل فیلدهایی با قالب‌های گوناگون .SH "خلاصه دستور (SYNOPSIS)" .B decorate [\fI\,گزینه\/\fR]... [\fI\,ورودی\/\fR] .br .B decorate \fI\,--decorate \/\fR[\fI\,گزینه\/\fR]... [\fI\,ورودی\/\fR] .br .B decorate \fI\,--undecorate N \/\fR[\fI\,گزینه\/\fR]... [\fI\,ورودی\/\fR] .SH "توضیحات (DESCRIPTION)" تبدیل (و در صورت تمایل، مرتب‌سازی) فیلدهایی با قالب‌های گوناگون .PP با .BR \-\-decorate : فیلدهای تبدیل‌شده را به ابتدای هر خط افزوده و آن را در خروجی استاندارد (STDOUT) چاپ می‌کند؛ مرتب‌سازی انجام نمی‌دهد. .PP با .BR \-\-undecorate : تعداد N فیلد نخست را از ورودی حذف می‌کند؛ به عنوان گام پس‌پردازش پس از .BR sort (1) به کار می‌رود. .PP بدون .B \-\-decorate و .BR \-\-undecorate : ورودی را به طور خودکار آرایش (decorate) کرده، .BR sort (1) را اجرا می‌کند و فیلدهای اضافی را از خروجی حذف (undecorate) می‌نماید؛ این ساده‌ترین شیوه استفاده است. برنامه .B decorate امکان مرتب‌سازی ورودی را بر اساس ترتیبات گوناگون مانند نشانی‌های IP، اعداد رومی و غیره فراهم می‌سازد. این برنامه در هماهنگی با .BR sort (1) برای انجام مرتب‌سازی واقعی کار می‌کند. .PP این ایده توسط .UR https://lists.gnu.org/r/bug-coreutils/2015-06/msg00076.html Pádraig Brady .UE پیشنهاد شده بود: .PP ۱. آرایش (Decorate): تبدیل ورودی به یک قالب قابل مرتب‌سازی به عنوان فیلدهای اضافی .br ۲. مرتب‌سازی بر اساس فیلدهای اضافه‌شده .br ۳. بازگردانی (Undecorate): حذف فیلدهای اضافه‌شده .SH "گزینه‌ها (OPTIONS)" .SS "گزینه‌های عمومی:" .TP \fB\-\-decorate\fR فیلدهای مشخص‌شده را تبدیل/آرایش کرده و خروجی را در STDOUT چاپ می‌کند. به طور خودکار .BR sort (1) را اجرا نمی‌کند یا فیلدهای اضافی خروجی را حذف نمی‌نماید. .TP \fB\-\-header\fR=\fI\,N\/\fR تعداد N خط نخست را آرایش یا مرتب نمی‌کند. .TP \fB\-H\fR همانند \fB\-\-header\fR=\fI\,N\/\fR است. .TP \fB\-k\fR, \fB\-\-key\fR=\fI\,KEYDEF\/\fR کلید/فیلد جهت مرتب‌سازی؛ ساختاری مشابه .BR sort (1) دارد که در صورت تمایل پس از آن \':method\' برای تبدیل فیلد به یک مقدار قابل مرتب‌سازی می‌آید؛ مثال‌ها و تبدیل‌های موجود را در ادامه ببینید. .TP \fB\-t\fR, \fB\-\-field\-separator\fR=\fI\,SEP\/\fR استفاده از SEP به جای تغییر حالت از نویسه غیرفاصله به فاصله. .TP \fB\-\-print\-sort\-args\fR چاپ آرگومان‌های تنظیم‌شده برای .BR sort (1) ؛ هنگام استفاده از .B \-\-decorate و سپس اجرای دستی .BR sort (1) کاربرد دارد. .TP \fB\-\-undecorate\fR=\fI\,N\/\fR حذف N فیلد نخست. .TP \fB\-z\fR, \fB\-\-zero\-terminated\fR جداکننده خطوط نویسه تهی (NUL) است، نه خط جدید. .TP \fB\-\-sort\-cmd=\fR/path/to/sort دستور جایگزین .BR sort (1) برای استفاده. .TP \fB\-h\fR, \fB\-\-help\fR نمایش این راهنما و خروج .TP \fB\-V\fR, \fB\-\-version\fR نمایش اطلاعات نسخه و خروج .PP گزینه‌های زیر عیناً به sort ارسال می‌شوند (بیشتر آن‌ها به GNU sort وابسته هستند): .HP \fB\-c\fR, \fB\-\-check\fR .HP \fB\-\-compress\-program\fR .HP \fB\-\-random\-source\fR .HP \fB\-s\fR, \fB\-\-stable\fR .HP \fB\-\-batch\-size\fR .HP \fB\-S\fR, \fB\-\-buffer\-size\fR .HP \fB\-T\fR, \fB\-\-temporary\-directory\fR .HP \fB\-u\fR, \fB\-\-unique\fR .HP \fB\-\-parallel\fR .PP روش‌های تبدیل موجود (جهت استفاده با \fB\-k\fR): .TP as\-is رونویسی بدون تغییر .TP roman اعداد رومی .TP strlen طول (به بایت) فیلد مشخص‌شده .TP ipv4 نشانی‌های IPv4 ده‌دهی نقطه‌دار .TP ipv6 نشانی‌های IPv6 .TP ipv4inet نشانی‌های عددی و نقطه‌ای IPv4 (شامل مقادیر هشت‌هشتی و هگزادسیمال) .TP ipv6v4map نشانی‌های IPv6 و IPv4 (به صورت IPv4 نگاشت‌شده در IPv6) .TP ipv6v4comp نشانی‌های IPv6 و IPv4 (به صورت IPv4 سازگار با IPv6) .SH "مثال‌ها (EXAMPLES)" نمونه‌ای از آماده‌سازی برای مرتب‌سازی بر اساس اعداد رومی: .PP .nf .RS $ printf "%s\\n" C V III IX XI | \fBdecorate\fR \-k1,1:roman \-\-decorate 0000100 C 0000005 V 0000003 III 0000009 IX 0000011 XI .RE .fi .PP اکنون می‌توان خروجی را به .BR sort (1) ارسال کرده و سپس فیلد نخست را حذف (=undecorate) کرد: .PP .nf .RS $ printf "%s\\n" C V III IX XI \\ | \fBdecorate\fR \-k1,1:roman \-\-decorate \\ | sort \-k1,1 \\ | \fBdecorate\fR \-\-undecorate 1 III V IX XI C .RE .fi .PP برنامه .B decorate می‌تواند مراحل decorate-sort-undecorate را به طور خودکار ترکیب کند (هنگامی که بدون .B \-\-decorate یا .B \-\-undecorate اجرا شود): .PP .nf .RS $ printf "%s\\n" C V III IX XI | \fBdecorate\fR \-k1,1:roman III V IX XI C .RE .fi .PP .SH "اطلاعات تکمیلی (ADDITIONAL INFORMATION)" ببینید: .UR https://www.gnu.org/software/datamash وب‌سایت GNU Datamash .UE .SH "نویسندگان (AUTHORS)" نوشته شده توسط Assaf Gordon، Timothy Rice، Shawn Wagner و Erik Auerswald. .SH "حق نشر (COPYRIGHT)" حق نشر \(co 2025 Assaf Gordon و Timothy Rice .br مجوز GPLv3+: مجوز عمومی گنو نسخه ۳ یا بالاتر . .br این نرم‌افزار آزاد است: شما می‌توانید آن را تغییر دهید یا دوباره توزیع کنید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد. .SH "همچنین ببینید (SEE ALSO)" مستندات کامل برای .B decorate به صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های .B info و .B decorate به درستی روی سیستم شما نصب شده باشند، دستور .IP .B info decorate .PP باید دسترسی شما را به راهنمای کامل فراهم کند.