'\" t
.\"     Title: column
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: أوامر المستخدم
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "COLUMN" "1" "2026-05-18" "util\-linux 2.42.1" "أوامر المستخدم"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "الاسم"
column \- جدولة القوائم في أعمدة
.SH "موجز"
.sp
\fBcolumn\fP [الخيارات] [\fIملف\fP .\|.\|.]
.SH "الوصف"
.sp
تنسق أداة \fBcolumn\fP دخلها في أعمدة متعددة. وهي تدعم ثلاثة أنماط:
.sp
\fBملء الأعمدة قبل الصفوف\fP
.RS 4
هذا هو النمط المبدئي (مطلوب للتوافقية مع الإصدارات السابقة).
.RE
.sp
\fBملء الصفوف قبل الأعمدة\fP
.RS 4
يُفعل هذا النمط باستخدام خيار \fB\-x, \-\-fillrows\fP.
.RE
.sp
\fBcreate a table\fP
.RS 4
تحديد عدد الأعمدة التي يحتوي عليها الدخل وإنشاء جدول. يُفعل هذا النمط بخيار \fB\-t\fP/\fB\-\-table\fP. يُحاذى الخرج وفقاً لعرض الطرفية في النمط التفاعلي، وإلى 80 عموداً في النمط غير التفاعلي (راجع \fB\-\-output\-width\fP لمزيد من التفاصيل). يمكن تطبيق تنسيق مخصص باستخدام خيارات \fB\-\-table\-\fP* المتنوعة.
.RE
.sp
يُؤخذ الدخل من \fIملف\fP، أو من الدخل القياسي خلاف ذلك. تُتجاهل الأسطر الفارغة وتُرمّز كافة التسلسلات متعددة البايت غير الصالحة باستخدام اصطلاح x<hex>.
.SH "الخيارات"
.sp
المعامل \fIأعمدة\fP لخيارات \fB\-\-table\-\fP* أدناه هو قائمة مفصولة بفاصلة من الأسماء التي يوفرها المستخدم والمعرفة بـ \fB\-\-table\-columns \fIname1\fP,\fIname2\fP,.\|.\|.\fP، أو فهارس الأعمدة كما تظهر في الدخل بدءاً من 1، أو أسماء معرفة بواسطة سمة \fB\-\-table\-column\fP. من الممكن خلط الأسماء والفهارس. يمكن استخدام العنصر النائب الخاص \*(Aq0\*(Aq (مثلاً \-R0) لتحديد كافة الأعمدة و \*(Aq\-1\*(Aq (مثلاً \-R \-1) لتحديد آخر عمود مرئي. من الممكن استخدام نطاقات مثل \*(Aq1\-5\*(Aq عند الإشارة إلى الأعمدة بالفهارس.
.sp
\fB\-J, \-\-json\fP
.RS 4
استخدام تنسيق مخرجات JSON لطباعة الجدول. الخيار \fB\-\-table\-columns\fP مطلوب، ويُنصح بالخيار \fB\-\-table\-name\fP.
.RE
.sp
\fB\-c, \-\-output\-width\fP \fIwidth\fP
.RS 4
تُنسق المخرجات بعرض محدد كعدد من المحارف. لاحظ أن المدخلات الأطول من \fIعرض\fP لا تُقلم مبدئياً. القيمة المبدئية هي عرض الطرفية في الوضع التفاعلي، و80 عموداً في الوضع غير التفاعلي. لا تُقلم ترويسات الأعمدة أبداً.
.sp
يمكن استخدام العنصر النائب \fBunlimited\fP (أو \fB0\fP) لمنع تقييد عرض المخرجات. يُنصح بهذا عند إعادة توجيه المخرجات إلى ملف.
.sp
(الاسم الطويل الأصلي لهذا الخيار كان \fB\-\-columns\fP؛ وهذا الاسم مهجور منذ الإصدار v2.30.)
.RE
.sp
\fB\-d, \-\-table\-noheadings\fP
.RS 4
حذف طباعة الترويسة. يسمح هذا الخيار بوجود أسماء أعمدة يوفرها المستخدم في سطر الأوامر، ولكنه يبقي الترويسة مخفية عند طباعة الجدول.
.RE
.sp
\fB\-o, \-\-output\-separator\fP \fIسلسلة_محارف\fP
.RS 4
محدد الأعمدة لمخرجات الجدول (المبدئي هو مسافتان).
.RE
.sp
\fB\-s, \-\-input\-separator, \-\-separator\fP \fIالفواصل\fP
.RS 4
محددات عناصر المدخلات الممكنة (المبدئي هو مسافة بيضاء).
.RE
.sp
\fB\-S, \-\-use\-spaces\fP \fIرقم\fP
.RS 4
عند عدم استخدام وضع الجدول، تُستخدم المسافات بدلاً من علامات الجدولة لمحاذاة الأعمدة. يحدد هذا الخيار الحد الأدنى لعدد المسافات التي تفصل بين عمودين.
.RE
.sp
\fB\-t, \-\-table\fP
.RS 4
يُحدد عدد الأعمدة التي تحتوي عليها المدخلات ويُنشأ جدول. تُفصل الأعمدة مبدئياً بمسافة بيضاء، أو بالمحارف المعطاة باستخدام خيار \fB\-\-output\-separator\fP. مخرجات الجدول مفيدة للتنسيق الجمالي.
.RE
.sp
\fB\-\-table\-colorscheme\fP \fIالاسم\fP
.RS 4
تحديد نظام الألوان. الاسم المبدئي هو "column". لمزيد من التفاصيل راجع قسم \fBالألوان\fP.
.RE
.sp
\fB\-C, \-\-table\-column\fP \fIattributes\fP
.RS 4
تعريف عمود بقائمة من السمات مفصولة بفاصلة. يمكن استخدام هذا الخيار أكثر من مرة، فكل استخدام يعرف عموداً واحداً. تحل السمات محل بعض خيارات \fB\-\-table\-\fP: على سبيل المثال، \fB\-\-table\-column name=FOO,right\fP يعرف عموداً يُحاذى النص فيه إلى اليمين. هذا الخيار يتعارض مع خيار \fB\-N\fP/\fB\-\-table\-columns\fP.
.sp
السمات المتاحة هي:
.sp
\fBname=\fP\fIسلسلة\-محارف\fP
.RS 4
اسم العمود.
.RE
.sp
\fBtrunc\fP
.RS 4
تقليم نص العمود عند الضرورة. مماثل لخيار \fB\-\-table\-truncate\fP. لاحظ أن ترويسة العمود لا تُقلم أبداً، وهي تمثل الحد الأدنى لعرض العمود.
.RE
.sp
\fBtree\fP
.RS 4
استخدام هذا العمود للمخرجات الشبيهة بالشجرة. راجع \fB\-\-tree\fP لمزيد من التفاصيل.
.RE
.sp
\fBright\fP
.RS 4
يُحاذى النص لليمين. مماثل لخيار \fB\-\-table\-right\fP.
.RE
.sp
\fBwidth=\fP\fIرقم\fP
.RS 4
عرض العمود. يُستخدم كملمح فقط. لفرضه، حدد سمة \fBstrictwidth\fP أيضاً. الحد الأدنى الفعلي للعرض هو عرض ترويسة العمود.
.RE
.sp
\fBstrictwidth\fP
.RS 4
اتباع \fBwidth=\fP بصرامة لضبط الحد الأدنى لحجم العمود. يمكن أن يكون العمود أكبر إذا وفر عرض المخرجات مساحة كافية.
.RE
.sp
\fBnoextremes\fP
.RS 4
تجاهل عرض المحتوى الطويل بشكل غير معتاد. راجع \fB\-\-table\-noextreme\fP لمزيد من التفاصيل.
.RE
.sp
\fBhidden\fP
.RS 4
لا يُطبع العمود. راجع \fB\-\-table\-hide\fP لمزيد من التفاصيل.
.RE
.sp
\fBwrap\fP
.RS 4
السماح باستخدام خلية متعددة الأسطر للنصوص الطويلة إذا لزم الأمر. لاحظ أن ترويسة العمود لا تُلف أبداً وتحدد الحد الأدنى لعرض العمود. راجع \fB\-\-table\-wrap\fP لمزيد من التفاصيل.
.RE
.sp
\fBwrapnl\fP
.RS 4
اللف عند محارف السطر الجديد؛ تُعامل الأسطر الجديدة في بيانات الخلية كفواصل أسطر.
.RE
.sp
\fBwrapzero\fP
.RS 4
اللف عند محارف الصفر (NUL) في بيانات الخلية.
.RE
.sp
\fBjson=\fP\fIالنوع\fP
.RS 4
تعريف نوع العمود لمخرجات JSON. الأنواع المتاحة هي \fBstring\fP و \fBnumber\fP و \fBfloat\fP و \fBarray\-string\fP و \fBarray\-number\fP و \fBboolean\fP.
.RE
.sp
\fBcolor=\fP\fIالاسم\fP
.RS 4
تعريف لون العمود للمخرجات على الطرفية. \fIالاسم\fP هو اسم لون (black، blink، blue، bold، brown، cyan، darkgray، gray، green، halfbright، lightblue، lightcyan، lightgray، lightgreen، lightmagenta، lightred، magenta، red، reset، reverse، و yellow) أو أرقام تسلسل ألوان ANSI مفصولة بفاصلة منقوطة، ولكن بدون بادئة \*(AqESC[\*(Aq ولا لاحقة \*(Aqm\*(Aq. على سبيل المثال، "37;41" يعرف تسلسلات لخلفية حمراء ونص أمامي أبيض. لمزيد من التفاصيل راجع قسم \fBالألوان\fP.
.RE
.sp
\fBcolorkey=\fP\fIالاسم\fP
.RS 4
يشير إلى اللون كما هو معرف في نظام الألوان. راجع \fB\-\-table\-colorscheme\fP.
.RE
.sp
\fBheadercolor=\fP\fIالاسم\fP
.RS 4
مثل \fBcolor=\fP، ولكن يعرف اللون لترويسة العمود فقط.
.RE
.sp
\fBheadercolorkey=\fP\fIالاسم\fP
.RS 4
يشير إلى لون الترويسة كما هو معرف في نظام الألوان. راجع \fB\-\-table\-colorscheme\fP.
.RE
.RE
.sp
\fB\-N, \-\-table\-columns\fP \fInames\fP
.RS 4
تحديد أسماء الأعمدة بقائمة مفصولة بفاصلة. تُستخدم الأسماء لترويسة الجدول ولعنونة الأعمدة في وسائط الخيارات. راجع أيضاً \fB\-\-table\-column\fP.
.RE
.sp
\fB\-l, \-\-table\-columns\-limit\fP \fIرقم\fP
.RS 4
تحديد الحد الأقصى لعدد أعمدة المدخلات. سيحتوي العمود الأخير على كافة بيانات السطر المتبقية إذا كان الحد أصغر من عدد الأعمدة في بيانات المدخلات.
.RE
.sp
\fB\-R, \-\-table\-right\fP \fIأعمدة\fP
.RS 4
محاذاة النص لليمين في الأعمدة المحددة.
.RE
.sp
\fB\-T, \-\-table\-truncate\fP \fIأعمدة\fP
.RS 4
تحديد الأعمدة التي يمكن تقليم النص فيها عند الضرورة، وإلا فقد تُطبع مدخلات الجدول الطويلة جداً على أسطر متعددة.
.RE
.sp
\fB\-E, \-\-table\-noextreme\fP \fIأعمدة\fP
.RS 4
تحديد الأعمدة التي ينبغي فيها تجاهل المحتوى الأطول من المتوسط عند حساب عرض العمود. يؤثر الخيار على حساب العرض وتنسيق الجدول، لكن النص المطبوع لا يتأثر.
.sp
هذا الخيار نشط مبدئياً لآخر عمود مرئي.
.RE
.sp
\fB\-e, \-\-table\-header\-repeat\fP
.RS 4
يُطبع سطر الترويسة لكل صفحة.
.RE
.sp
\fB\-K\fP, \fB\-\-table\-header\-as\-columns\fP
.RS 4
استخدام أول سطر مدخل كترويسة للجدول. هذا الخيار يتعارض مع \fB\-\-table\-columns\fP و \fB\-\-table\-column\fP.
.RE
.sp
\fB\-W, \-\-table\-wrap\fP \fIأعمدة\fP
.RS 4
تحديد الأعمدة حيث يمكن استخدام خلايا متعددة الأسطر للنصوص الطويلة. مبدئياً، يُلف النص وفقاً لعرض العمود. استخدم \fB\-\-wrap\-separator\fP ليلف عند محارف فصل مخصصة بدلاً من ذلك. لاحظ أن ترويسة العمود لا تُلف أبداً وتحدد الحد الأدنى لعرض العمود.
.RE
.sp
\fB\-\-wrap\-separator\fP \fIسلسلة\-محارف\fP
.RS 4
استخدام \fIسلسلة_محارف\fP كفاصل لِلف النص داخل الأعمدة التي فُعل فيها اللف. يُستبدل الفاصل بأسطر جديدة عند عرض النص. يتطلب هذا الخيار وضع الجدول وأعمدة مفعل فيها اللف (راجع \fB\-\-table\-wrap\fP). على سبيل المثال، استخدم \f(CR|\fP للسماح باللف عند محارف الأنبوب (pipe) داخل بيانات العمود.
.RE
.sp
\fB\-H, \-\-table\-hide\fP \fIأعمدة\fP
.RS 4
لا تطبع الأعمدة المحددة. يمكن استخدام العنصر النائب الخاص \*(Aq\fB\-\fP\*(Aq لإخفاء كافة الأعمدة غير المسماة (راجع \fB\-\-table\-columns\fP).
.RE
.sp
\fB\-O, \-\-table\-order\fP \fIأعمدة\fP
.RS 4
يُحدد ترتيب أعمدة المخرجات.
.RE
.sp
\fB\-n, \-\-table\-name\fP \fIاسم\fP
.RS 4
يُحدد اسم الجدول المستخدم لمخرجات JSON. المبدئي هو "table".
.RE
.sp
\fB\-m, \-\-table\-maxout\fP
.RS 4
تُملأ كافة المساحة المتاحة في المخرجات.
.RE
.sp
\fB\-L, \-\-keep\-empty\-lines\fP
.RS 4
الحفاظ على الأسطر التي تحتوي على مسافات بيضاء فقط في الدخل. المبدئي هو تجاهل جميع الأسطر الفارغة. كان الاسم الأصلي لهذا الخيار هو \fB\-\-table\-empty\-lines\fP، ولكنه أُهمل منذ ذلك الحين لأنه يعطي انطباعاً خاطئاً بأن الخيار ينطبق فقط على نمط الجدول.
.RE
.sp
\fB\-r, \-\-tree\fP \fIعمود\fP
.RS 4
يُحدد العمود المراد استخدامه لمخرجات تشبه الشجرة. تُتجاهل الاعتمادات الدائرية والظواهر الشاذة الأخرى في علاقة الابن والأصل بصمت.
.RE
.sp
\fB\-i, \-\-tree\-id\fP \fIعمود\fP
.RS 4
تحديد العمود الذي يحتوي على معرف الابن الفريد لكل سطر لعلاقة الابن بالأب.
.RE
.sp
\fB\-p, \-\-tree\-parent\fP \fIعمود\fP
.RS 4
تحديد العمود الذي يحتوي على معرف الأب لكل سطر لعلاقة الابن بالأب.
.RE
.sp
\fB\-x, \-\-fillrows\fP
.RS 4
تُملأ الصفوف قبل ملء الأعمدة.
.RE
.sp
\fB\-\-color\fP[\fB=\fP\fIمتى\fP]
.RS 4
لون المخرجات. المعامل الاختياري \fIمتى\fP يمكن أن يكون \fBauto\fP أو \fBnever\fP أو \fBalways\fP. إذا حُذف معامل \fIمتى\fP، فإنه يعود إلى \fBauto\fP آليًا. يمكن تعطيل الألوان؛ للاطلاع على الوضع المبدئي المدمج الحالي راجع مخرجات \fB\-\-help\fP. انظر أيضًا قسم \fBالألوان\fP.
.RE
.sp
\fB\-h\fP، \fB\-\-help\fP
.RS 4
اعرض نص المساعدة ثم اخرج.
.RE
.sp
\fB\-V\fP، \fB\-\-version\fP
.RS 4
اعرض الإصدار واخرج.
.RE
.SH "الألوان"
.sp
نُفذ تلوين المخرجات بواسطة وظيفة \fBterminal\-colors.d\fP(5). يمكن تعطيل التلوين الضمني بملف فارغ
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/column.disable\fP
.br
.RE
.ll
.sp
للأمر \fBcolumn\fP أو لجميع الأدوات بواسطة
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/disable\fP
.br
.RE
.ll
.sp
منذ الإصدار 2.41، دُعم متغير البيئة $NO_COLOR أيضاً لتعطيل تلوين المخرجات ما لم يُمكن صراحةً بخيار من سطر الأوامر.
.sp
يتخطى \fI$XDG_CONFIG_HOME/terminal\-colors.d\fP أو \fI$HOME/.config/terminal\-colors.d\fP الخاص بالمستخدم الإعداد العام.
.sp
لاحظ أن تلوين المخرجات قد يُمكن مبدئياً، وفي هذه الحالة ليس من الضروري وجود أدلة \fIterminal\-colors.d\fP بعد.
.sp
اسم نظام الألوان المبدئي هو "column"، ويمكن تخطيه بواسطة
.RS 3
.ll -.6i
.sp
\fB\-\-table\-colorscheme name\fP
.br
.RE
.ll
.sp
بعد ذلك يمكن استخدام ملف \fIالاسم\fP[.disable|enable|scheme] في \fI/etc/terminal\-colors.d/\fP، أو \fI$XDG_CONFIG_HOME/terminal\-colors.d\fP، أو \fI$HOME/.config/terminal\-colors.d/\fP.
.sp
يمكن الإشارة إلى اسم اللون المنطقي (المفتاح) في نظام الألوان عبر خصائص العمود \fBcolorkey=\fP و \fBheadercolorkey=\fP. على سبيل المثال
.sp
.if n .RS 4
.nf
.fam C
echo \*(Aqimportant red\*(Aq\&           > ~/.config/terminal\-colors.d/cooltable.scheme
echo \*(Aqimportant\-header 37;41\*(Aq >> ~/.config/terminal\-colors.d/cooltable.scheme
echo \-e "a b c\(rsnaa bb cc\(rsnaaa bbb ccc" | column \-t \(rs
        \-\-table\-colorscheme=cooltable \(rs
        \-C name=AAA,colorkey=important,headercolorkey=important\-header \(rs
        \-C name=BBB,color=magenta,headercolor=cyan \(rs
        \-C name=CCC,color=green
.fam
.fi
.if n .RE
.sp
سيؤدي هذا إلى إنشاء نظام ألوان باسم "cooltable" وتلوين ترويسة وبيانات العمود الأول وفقاً للمفاتيح من النظام. سيُلون العمودان الآخران بأسماء الألوان المباشرة.
.SH "البيئة"
.sp
\fBCOLUMNS\fP
.RS 4
يُستخدم لتحديد حجم الشاشة إذا لم تتوفر أي معلومات أخرى.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
يُفعّل مخرجات تصحيح أخطاء libsmartcols.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
يستخدم محارف حشو مرئية.
.RE
.SH "تاريخ"
.sp
ظهر أمر \fBcolumn\fP في 4.3BSD\-Reno.
.SH "العلل"
.sp
غيّر الإصدار 2.23 الخيار ‎\fB\-s\fP ليكون غير شرِه، على سبيل المثال:
.sp
.if n .RS 4
.nf
.fam C
printf "a:b:c\(rsn1::3\(rsn" | column \-t \-s \*(Aq:\*(Aq
.fam
.fi
.if n .RE
.sp
المخرجات القديمة:
.sp
.if n .RS 4
.nf
.fam C
a\&  b\&  c
1\&  3
.fam
.fi
.if n .RE
.sp
المخرجات الجديدة (منذ util\-linux 2.23):
.sp
.if n .RS 4
.nf
.fam C
a\&  b\&  c
1\&     3
.fam
.fi
.if n .RE
.sp
أشارت الإصدارات التاريخية لهذه الأداة إلى أن "الصفوف تُملأ قبل الأعمدة" بشكل مبدئي، وأن الخيار \fB\-x\fP يعكس ذلك. لم يعكس هذا الصياغ السلوك الفعلي، وقد صُحّح منذ ذلك الحين (انظر أعلاه). قد تستمر تطبيقات أخرى للأمر \fBcolumn\fP في استخدام الوثائق القديمة، ولكن يجب أن يكون السلوك متطابقاً في أي حال.
.SH "أمثلة"
.sp
اطبع fstab مع سطر ترويسة ومحاذاة الأرقام لليمين:
.sp
.if n .RS 4
.nf
.fam C
sed \*(Aqs/#.*//\*(Aq /etc/fstab | column \-\-table \-\-table\-columns SOURCE,TARGET,TYPE,OPTIONS,FREQ,PASS \-\-table\-right FREQ,PASS
.fam
.fi
.if n .RE
.sp
اطبع fstab وأخفِ الأعمدة غير المسماة:
.sp
.if n .RS 4
.nf
.fam C
sed \*(Aqs/#.*//\*(Aq /etc/fstab | column \-\-table \-\-table\-columns SOURCE,TARGET,TYPE \-\-table\-hide \-
.fam
.fi
.if n .RE
.sp
اطبع شجرة:
.sp
.if n .RS 4
.nf
.fam C
echo \-e \*(Aq1 0 A\(rsn2 1 AA\(rsn3 1 AB\(rsn4 2 AAA\(rsn5 2 AAB\*(Aq | column \-\-tree\-id 1 \-\-tree\-parent 2 \-\-tree 3
1\&  0\&  A
2\&  1\&  |\-AA
4\&  2\&  | |\-AAA
5\&  2\&  | `\-AAB
3\&  1\&  `\-AB
.fam
.fi
.if n .RE
.sp
طباعة الجدول بفاصل لف مخصص:
.sp
.if n .RS 4
.nf
.fam C
echo \-e \*(AqName:Description\(rsnJohn:A|software|developer\(rsnJane:A|data|scientist\*(Aq | column \-\-table \-\-separator \*(Aq:\*(Aq \-\-table\-wrap 2 \-\-wrap\-separator \*(Aq|\*(Aq
Name\&  Description
John\&  A
      software
      developer
Jane\&  A
      data
      scientist
.fam
.fi
.if n .RE
.SH "انظر أيضاً"
.sp
\fBcolrm\fP(1)، \fBls\fP(1)، \fBpaste\fP(1)، \fBsort\fP(1)
.SH "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
الأمر \fBcolumn\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."