| plistutil(1) | General Commands Manual | plistutil(1) |
نام (NAME)
plistutil - تبدیل یک فایل plist بین قالب‌های باینری، XML و JSON
خلاصه دستور (SYNOPSIS)
plistutil [OPTIONS] [-i FILE] [-o FILE]
توضیحات (DESCRIPTION)
ابزار plistutil امکان تبدیل یک فایل Property List (فهرست ویژگی‌ها) را بین قالب‌های باینری، XML و JSON فراهم می‌کند.
گزینه‌ها (OPTIONS)
- -i, --infile FILE
- فایل ورودی (FILE) جهت تبدیل. اگر این آرگومان حذف شود یا - به عنوان نام فایل ارسال گردد، plistutil داده‌ها را از stdin خواهد خواند.
- -o, --outfile FILE
- فایل خروجی (FILE) برای ذخیره نتیجه تبدیل. اگر این آرگومان حذف شود یا - به عنوان نام فایل مشخص گردد، plistutil در stdout خواهد نوشت.
- -f, --format [bin|xml|json|openstep]
- اجبار قالب
خروجی،
صرف‌نظر از
نوع قالب
ورودی. این
گزینه
زمانی مفید
است که قالب
ورودی
نامشخص
باشد، اما
خروجی باید
همواره در
قالبی مشخص
(مانند xml یا json)
باشد.
در صورت عدم تعیین، داده‌های plist از نوع XML به باینری تبدیل می‌شوند و برعکس. برای تبدیل به یا از JSON یا OpenStep، قالب خروجی باید به طور صریح مشخص شود.
- -p, --print FILE
- چاپ plist در قالبی خوانا برای انسان.
- -c, --compact
- فقط برای JSON و OpenStep: چاپ خروجی به صورت فشرده. به طور پیش‌فرض، خروجی به شکل قالب‌بندی‌شده و خوانا (pretty-print) تولید می‌شود.
- -s, --sort
- مرتب‌سازی الفبایی تمام گره‌های دیکشنری بر اساس کلید، پیش از تبدیل به قالب خروجی.
- -h, --help
- چاپ اطلاعات راهنما و نحوه استفاده از دستور.
- -d, --debug
- فعال‌سازی خروجی اشکال‌زدایی (debug) گسترده.
- -v, --version
- چاپ اطلاعات نسخه.
مثال‌ها (EXAMPLES)
- plistutil -i test.plist -o out.plist
- تبدیل test.plist و نوشتن نتیجه در out.plist. اگر test.plist در قالب XML باشد، out.plist در قالب باینری خواهد بود. اگر test.plist در قالب باینری باشد، out.plist در قالب XML ذخیره می‌شود.
- plistutil -i test.plist -o out.plist -f bin
- مشابه مورد قبل، اما خروجی همواره در قالب باینری خواهد بود.
- plistutil -i test.plist -f xml
- چاپ test.plist به صورت plist از نوع XML، صرف‌نظر از قالب ورودی.
- plistutil -i test.plist -f xml -o -
- مشابه دستور قبلی.
- plistutil -i test.plist -f json
- چاپ test.plist به صورت plist از نوع JSON، صرف‌نظر از قالب ورودی.
- cat test.plist |plistutil -f xml
- دریافت داده‌های plist از ورودی استاندارد (stdin) - که از طریق دستور cat لوله‌کشی (pipe) شده - و نوشتن خروجی به صورت XML در stdout.
نویسندگان (AUTHORS)
Zach C.
Martin Szulecki
Nikias Bassen