'\" t
.\"     Title: timew-get
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2025-08-16
.\"    Manual: User Manuals
.\"    Source: timew 1.9.1
.\"  Language: Persian
.\"
.TH "TIMEW\-GET" "1" "2025-08-16" "timew 1.9.1" "User Manuals"
.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 "نام (NAME)"
timew-get \- نمایش مقادیر DOM
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBtimew get\fP \fI<DOM>\fP\fB...\fP
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
مرجع DOM را اعتبارسنجی می‌کند، سپس مقدار آن را به‌دست آورده و نمایش می‌دهد.
.sp
در صورت نامعتبر بودن مرجع، یک پیام خطا در stderr نمایش داده می‌شود و وضعیت خروج ۱ خواهد بود.
.sp
تمام مراجع DOM با \f(CRdom\fP آغاز می‌شوند؛ ۴ زیرمرجع وجود دارد که می‌توان به آن‌ها دسترسی داشت:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRdom.tracked\fP، تمام بازه‌ها
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRdom.active\fP، ردیابی زمان فعال
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRdom.tags\fP، تمام برچسب‌ها
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRdom.rc\fP، تنظیمات پیکربندی
.RE
.sp
برای جزئیات بیشتر درباره این موارد، \fBtimew\-config\fP(7) را ببینید.
ارجاع به بازه یا برچسبی که وجود ندارد، یک خطا محسوب می‌شود.
.sp
اگر بیش از یک مرجع معتبر DOM داده شود، نتایج با یک فاصله به یکدیگر متصل می‌شوند.
.SH "مثال‌ها (EXAMPLES)"
.sp
پرس‌وجوی وضعیت ردیابی زمان جاری
.RS 4
$ timew get dom.active
1
.sp
این پرس‌وجو در صورتی که ردیابی زمان فعال باشد \f(CR1\fP، و در غیر این صورت \f(CR0\fP را برمی‌گرداند.
.RE
.sp
نمایش سومین بازه از یک پرس‌وجو به صورت JSON
.RS 4
برای مرجع \f(CRdom.tracked\fP می‌توان فیلترسازی بر اساس محدوده و برچسب‌ها را اعمال کرد:
.sp
.if n .RS 4
.nf
.fam C
$ timew get dom.tracked.3.json :month FOO
{"id":42,"start":"20250802T101224Z","end":"20250802T101224Z","tags":["FOO","BAR"]}
.fam
.fi
.if n .RE
.sp
توجه داشته باشید که عدد \f(CR3\fP در مرجع به سومین بازه در نتیجه پرس‌وجو اشاره دارد، نه بازه‌ای با شناسه \f(CR3\fP!
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBtimew\-dom\fP(7)