.\"property list tools man page .\"written by Adrian Robert (arobert@cogsci.ucsd.edu) .\"Copyright (C) 2005 Free Software Foundation, Inc. .\"Copying and distribution of this file, with or without modification, .\"are permitted in any medium without royalty provided the copyright .\"notice and this notice are preserved. .\" .\"Process this file with .\"groff -man -Tascii gdnc.1 .\" .TH PLDES 1 "August 2003" GNUstep "GNUstep System Manual" .SH "نام (NAME)" pl, pldes, plser, plmerge, plparse, pl2link \- ابزارهای مدیریت فهرست ویژگی‌ها (property list) .SH "خلاصه دستور (SYNOPSIS)" .nf .BI "pldes " "filename(s)" .nf .BI "plget " "key" [ more keys ] .nf .BI "plser [ " "-format" "fmt" " ] filename(s)" .nf .BI "plmerge [ " "destination-file" " ] [ " "input-file(s)" " ]" .nf .BI "plparse " "filename(s)" .nf .BI "pl2link " "input-file" " [ " "destination-file" " ]" .nf .BI "pl -input [ " "input-file" " ] " " -output [ " "destination-file" " ]" .nf .SH "توضیحات (DESCRIPTION)" .P فهرست‌های ویژگی (Property lists) در GNUstep، فهرست‌هایی سلسله‌مراتبی از مقادیر یا جفت‌های ویژگی\-مقدار (attribute-value) هستند. از نظر برنامه‌نویسی، آن‌ها توسط نمونه‌هایی از کلاس‌های NSString،‏ NSData،‏ NSArray یا NSDictionary (رایج‌ترین) نمایش داده می‌شوند (که خود می‌توانند شامل نمونه‌های دیگری از این کلاس‌ها باشند). این نمونه‌ها می‌توانند برای تشکیل یک نمایش ماندگار، به صورت اشیاء باینری سریالی‌سازی (serialize) شوند. علاوه بر این، دو روش متناوب انسان‌خوانا نیز برای نمایش آن‌ها وجود دارد. روش اول، که در NeXTstep و OpenStep به کار می‌رفت، از یک قالب متنی استفاده می‌کند که در آن علامت‌های مساوی بیانگر انتساب ویژگی\-مقدار و علامت‌های آکولاد بیانگر ساختار سلسله‌مراتبی هستند. روش دوم، که اغلب (به‌طور غیرتوصیفی) با عنوان قالب «plist» شناخته می‌شود، با XML بوده و در Mac OS X استفاده می‌شود. ابزارهای شرح‌داده‌شده در اینجا برنامه‌های کمکی برای کار و دستکاری بازنمایی‌های ماندگار مختلف فهرست ویژگی‌ها به عنوان فایل هستند. .IP "\fBpldes\fR \fIfilename(s)\fR" 4 یک فهرست ویژگی سریالی‌شدهٔ باینری (نمونه کلاس) را به یک نمایش متنی تبدیل می‌کند. .IP "\fBplget\fR \fIkey\fR" 4 یک نمایش متنی از یک دیکشنری در قالب فهرست ویژگی را به عنوان ورودی استاندارد می‌خواند، مقدار رشته‌ای ذخیره‌شده در آن دیکشنری با کلید مشخص‌شده را استخراج کرده و نتیجه را در خروجی استاندارد می‌نویسد. می‌توان از چندین کلید برای استخراج مقادیر از دیکشنری‌های تودرتو استفاده کرد. .IP "\fBplser\fR [ \fI-format format\fR ] \fIfilename(s)\fR" 4 یک نمایش متنی از یک فهرست ویژگی را به یک نمایش سریالی‌شدهٔ باینری یا قالب انتخابی دیگری تبدیل می‌کند. .IP "\fBplmerge\fR [ \fIdestination-file\fR ] [ \fIinput-file(s)\fR ]" 4 فهرست‌های ویژگی متنی را در یک فهرست ویژگی واحد ادغام می‌کند. .IP "\fBplparse\fR \fIfilename(s)\fR" 4 بررسی می‌کند که آیا هر فایل شامل یک نمایش متنی معتبر از یک فهرست ویژگی است یا خیر. .IP "\fBpl2link\fR \fIinput-file\fR [ \fIdestination-file\fR ]" 4 بر اساس نمایش متنی داده‌شده از یک فهرست ویژگی، یک فایل پیوند دسکتاپ برای KDE و Gnome ایجاد می‌کند. .IP "\fBpl\fR \fI-input\fR [ \fIinput-file\fR ]" 4 فایل plist سریالی‌شدهٔ مشخص‌شده توسط input-file را دریافت کرده و آن را در خروجی استاندارد می‌نویسد. .IP "\fBpl\fR \fI-output\fR [ \fIdestination-file\fR ]" 4 یک plist را از ورودی استاندارد دریافت کرده و آن را درون destination-file سریالی‌سازی می‌کند. .PP .SH "همچنین ببینید (SEE ALSO)" defaults(1) .SH "تاریخچه (HISTORY)" در سال‌های ۱۹۹۹\-۲۰۰۰ نوشته شده است. .PP این صفحه راهنما نخستین بار در gnustep-base نسخه 1.9.2 (مارس ۲۰۰۴) ظاهر شد. .P .SH "نویسندگان (AUTHORS)" .B pldes, plget, plparse, plser توسط Richard Frith-Macdonald نوشته شده‌اند. .PP .B plmerge توسط Jonathan Gapen نوشته شده است. .PP .B pl2link توسط Fred Kiefer نوشته شده است. .PP .B pl توسط Gregory Casamento نوشته شده است.