cueprint(1) General Commands Manual cueprint(1)

cueprint - گزارش اطلاعات دیسک و قطعه‌ها از یک فایل CUE یا TOC

cueprint [ { -i format | --input-format=format } { -n number | --track-number=number } { -d template | --disc-template=template } { -t template | --track-template=template } ] [ file ... ]
cueprint -h | --help
cueprint -V | --version

دستور cueprint اطلاعات دیسک و قطعه‌ها را از فایل‌های CUE و TOC که معمولاً توسط نرم‌افزارهای استخراج دیسک فشرده (سی‌دی) ایجاد می‌شوند، گزارش می‌دهد.

به‌طور پیش‌فرض، cueprint مجموعه‌ای پیش‌فرض از اطلاعات دیسک و مجموعه‌ای پیش‌فرض از اطلاعات را برای هر قطعه روی دیسک گزارش می‌کند. با استفاده از گزینه‌ها، می‌توان گزارش را به یک قطعه خاص محدود کرد و نحوه ارائه اطلاعات دیسک و قطعه را می‌توان با استفاده از رشته‌های قالب‌بندی به سبک printf(3) (که در اینجا برای جلوگیری از سردرگمی با مفهوم قالب فایل، «الگو» یا ‘templates’ نامیده می‌شوند) به طور گسترده سفارشی‌سازی کرد. تمام نویسه‌ها در یک الگو بدون تغییر در خروجی بازتولید می‌شوند، به جز تبدیل‌ها (که با ‘%’ آغاز می‌شوند) و گریزها (که با ‘\’ آغاز می‌شوند).

اگر هیچ نام فایلی مشخص نشده باشد، cueprint از ورودی استاندارد می‌خواند و گزینه قالب ورودی حتماً باید مشخص شود. اگر یک یا چند نام فایل ارائه شده باشد، اما گزینه قالب ورودی مشخص نشده باشد، قالب ورودی بر اساس پسوند هر فایل (مثلاً .cue یا .toc) حدس زده خواهد شد. این روش تشخیص به بزرگی و کوچکی حروف حساس نیست.

یک تبدیل دارای ساختاری به صورت ‘%[flags][width][.precision]type’ است.

مقدارهای flags می‌تواند صفر یا چند مورد از موارد زیر باشد:

نویسه معنی
- چپ‌چین کردن بسط
+ قرار دادن علامت قبل از اعداد
‘ ’ (space) قرار دادن یک فاصله خالی قبل از اعداد مثبت
0 پر کردن اعداد با صفر

مقدار width حداقل عرض فیلد است. precision حداکثر عرض برای رشته‌ها است. type یک تک‌نویسه است که نوع تبدیل را مشخص می‌کند — به جز %، این تنها بخش اجباری تبدیل است.

انواع تبدیل موجود در جدول زیر آورده شده‌اند؛ انواع تبدیل دیسک در نیمه سمت چپ جدول، و انواع تبدیل قطعه در نیمه سمت راست ارائه شده‌اند. نویسه‌های بسط الگوی دیسک، هم برای الگوهای دیسک و هم برای الگوهای قطعه معتبر هستند.

نویسه تبدیل نویسه تبدیل
A تنظیم‌کننده آلبوم a تنظیم‌کننده قطعه
C آهنگساز آلبوم c آهنگساز قطعه
G سبک آلبوم g سبک قطعه
i کد ISRC قطعه
M پیام آلبوم m پیام قطعه
N تعداد قطعه‌ها n شماره قطعه
P اجراکننده آلبوم p اجراکننده قطعه
S ترانه‌سرای آلبوم
T عنوان آلبوم t عنوان قطعه
U کد UPC/EAN آلبوم u کد ISRC قطعه (CD-TEXT)

هر نویسه دیگری که به عنوان نوع تبدیل استفاده شود، به خود بسط می‌یابد. به این ترتیب است که می‌توان علامت درصد واقعی را در الگو قرار داد؛ یعنی ‘%%’ به ‘%’ بسط می‌یابد.

نویسه‌های گریز شناخته‌شده همگی تک‌نویسه هستند و در جدول زیر فهرست شده‌اند.

توالی گریز بسط
\a هشدار (bell)
\b پس‌بر (backspace)
\f تغذیه صفحه (formfeed)
\n خط جدید (newline)
\r بازگشت به ابتدای سطر (carriage return)
\t تب افقی (horizontal tab)
\v تب عمودی (vertical tab)
\0 تهی (null)

هر نویسه دیگری که پس از ‘\’ در یک توالی گریز استفاده شود به خود بسط می‌یابد. به این ترتیب است که می‌توان نویسه گریز (بک‌اسلش) واقعی را در الگو قرار داد؛ یعنی ‘\\’ به ‘\’ بسط می‌یابد.

الگوی دیسک را تعیین می‌کند (بخش تبدیل‌ها (Conversions) را ببینید).
پیام راهنمای استفاده را نمایش می‌دهد و خارج می‌شود.
قالب مورد انتظار فایل(های) ورودی را روی format تنظیم می‌کند، که باید یا cue یا toc باشد.
تنها اطلاعات مربوط به یک قطعه را چاپ می‌کند. حالت پیش‌فرض چاپ اطلاعات همه قطعه‌ها است.
الگوی قطعه را تعیین می‌کند (بخش تبدیل‌ها (Conversions) را ببینید).
اطلاعات نسخه را نمایش می‌دهد و خارج می‌شود.

دستور cueprint اگر اطلاعات را با موفقیت از هر فایل ورودی گزارش کند با وضعیت خروج صفر، و در صورت بروز مشکل با وضعیتی غیرصفر خارج می‌شود.

برای نمایش اطلاعات دیسک و قطعه‌ها (با استفاده از الگوی پیش‌فرض برای هر دو):

% cueprint album.cue

برای چاپ تعداد قطعه‌ها در یک فایل CUE:

% cueprint -d '%N\n' album.cue

مجموعه Cuetools توسط Svend Sorensen نوشته شده است. Branden Robinson در اصلاحات و بهبودهای ابزارها و مستندات مشارکت داشته است.

cuebreakpoints(1), cueconvert(1), printf(3)