curses.ascii --- ابزارهایی برای نویسه‌های ASCII

کد منبع: Lib/curses/ascii.py

---

ماژول curses.ascii ثابت‌های نام‌دار برای نویسه‌های ASCII و توابعی برای بررسی عضویت در کلاس‌های مختلف نویسه‌ای ASCII فراهم می‌کند. ثابت‌های فراهم‌شده نام‌هایی برای نویسه‌های کنترلی هستند، به شرح زیر:

نام	معنی
curses.ascii.NUL
curses.ascii.SOH	آغاز سرفصل، وقفه‌ی کنسول
curses.ascii.STX	آغاز متن
curses.ascii.ETX	پایان متن
curses.ascii.EOT	پایان انتقال
curses.ascii.ENQ	استعلام، همراه با کنترل جریان ACK
curses.ascii.ACK	Acknowledgement
curses.ascii.BEL	زنگ
curses.ascii.BS	پس‌بر (Backspace)
curses.ascii.TAB	تب
curses.ascii.HT	نام مستعار برای TAB: «تب افقی»
curses.ascii.LF	تغذیه‌ی سطر
curses.ascii.NL	نام مستعار برای LF: «خط جدید»
curses.ascii.VT	تب عمودی
curses.ascii.FF	تغذیه‌ی صفحه
curses.ascii.CR	بازگشت به ابتدای سطر
curses.ascii.SO	Shift-out، آغاز مجموعه نویسه‌ی جایگزین
curses.ascii.SI	Shift-in، از سرگیری مجموعه‌نویسه پیش‌فرض
curses.ascii.DLE	خنثی‌سازی پیوند داده (Data-link escape)
curses.ascii.DC1	XON، برای کنترل جریان
curses.ascii.DC2	کنترل دستگاه ۲، کنترل جریان حالت بلوکی
curses.ascii.DC3	XOFF، برای کنترل جریان
curses.ascii.DC4	کنترل دستگاه ۴
curses.ascii.NAK	تأیید منفی (negative acknowledgement)
curses.ascii.SYN	بی‌کاری همگام
curses.ascii.ETB	پایان بلوک انتقال
curses.ascii.CAN	لغو
curses.ascii.EM	پایان رسانه (End of medium)
curses.ascii.SUB	جایگزینی
curses.ascii.ESC	خنثی کردن
curses.ascii.FS	جداکننده‌ی پرونده
curses.ascii.GS	جداکننده‌ی گروه
curses.ascii.RS	جداکننده‌ی رکورد، پایان‌دهنده‌ی حالت بلوکی
curses.ascii.US	جداکننده‌ی واحد
curses.ascii.SP	فاصله
curses.ascii.DEL	حذف

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

این ماژول توابع زیر را فراهم می‌کند که بر اساس توابع کتابخانه استاندارد C طراحی شده‌اند:

curses.ascii.isalnum(c)

بررسی می‌کند که آیا نویسه‌ای الفبایی‌عددی ASCII است یا خیر؛ این معادل isalpha(c) or isdigit(c) است.

curses.ascii.isalpha(c)

بررسی می‌کند که آیا نویسه الفبایی ASCII است؛ این معادل isupper(c) or islower(c) است.

curses.ascii.isascii(c)

بررسی می‌کند که آیا مقدار نویسه‌ای در مجموعه‌ی ASCII ۷‌بیتی می‌گنجد یا خیر.

curses.ascii.isblank(c)

بررسی نویسه‌ی خالی ASCII؛ فاصله یا تب افقی.

curses.ascii.iscntrl(c)

بررسی وجود یک نویسه‌ی کنترلی ASCII (در بازه‌ی 0x00 تا 0x1f یا 0x7f).

curses.ascii.isdigit(c)

بررسی می‌کند که یک رقم دهدهی ASCII، '0' تا '9' باشد. این معادل c in string.digits است.

curses.ascii.isgraph(c)

بررسی هر نویسه‌ی چاپی ASCII به‌جز فاصله.

curses.ascii.islower(c)

بررسی برای یک نویسه‌ی کوچک ASCII.

curses.ascii.isprint(c)

هر نویسه‌ی قابل‌چاپ ASCII، از جمله فاصله، بررسی می‌شود.

curses.ascii.ispunct(c)

هر نویسه‌ی چاپ‌پذیر ASCII را که فاصله یا نویسه‌ی الفبایی‌عددی نباشد، بررسی می‌کند.

curses.ascii.isspace(c)

بررسی نویسه‌های فضای سفید ASCII؛ فاصله، تغذیه‌ی سطر، بازگشت به ابتدای سطر، تغذیه‌ی صفحه، تب افقی، تب عمودی.

curses.ascii.isupper(c)

بررسی می‌کند که آیا یک نویسه بزرگ ASCII است.

curses.ascii.isxdigit(c)

بررسی می‌کند که آیا یک رقم مبنای شانزده ASCII است یا خیر. این معادل c in string.hexdigits است.

curses.ascii.isctrl(c)

بررسی می‌کند که آیا یک نویسه‌ی کنترلی ASCII است (مقادیر ترتیبی ۰ تا ۳۱). برخلاف iscntrl()، نویسه‌ی حذف (0x7f) را شامل نمی‌شود.

curses.ascii.ismeta(c)

بررسی می‌کند که آیا نویسه‌ای غیرASCII است (مقادیر ترتیبی 0x80 و بالاتر).

These functions accept an integer, a single-character string, or a curses.complexchar. A string is converted using the built-in function ord(), and a complexchar by the code of its single character; a complexchar that holds combining characters is not a single character and matches no class.

توجه داشته باشید که همه‌ی این توابع مقادیر بیتیِ ترتیبیِ برگرفته از نویسه‌ی رشته‌ای که شما به آن‌ها می‌دهید را بررسی می‌کنند؛ آن‌ها در واقع چیزی درباره‌ی کدگذاری نویسه‌های ماشین میزبان نمی‌دانند.

The following three functions take either a single-character string or an integer byte value; they return a value of the same type.

curses.ascii.ascii(c)

مقدار ASCII متناظر با ۷ بیت پایینی c را برمی‌گرداند.

curses.ascii.ctrl(c)

Return the control character corresponding to the given ASCII character (the character bit value is bitwise-anded with 0x1f). A non-ASCII character has no control character and is returned unchanged.

تغییر یافته در نسخه‌ی 3.16.0a0 (unreleased): A non-ASCII argument is now returned unchanged instead of masked to a control character.

curses.ascii.alt(c)

نویسه‌ی ۸‌بیتی متناظر با نویسه‌ی ASCII داده‌شده را برمی‌گرداند (مقدار بیتی نویسه با 0x80 OR بیتی می‌شود).

The following function takes a single-character string, an integer value, or a curses.complexchar; it returns a string.

curses.ascii.unctrl(c)

بازنمایی رشته‌ای از نویسه‌ی ASCII c را برمی‌گرداند. اگر c قابل چاپ باشد، این رشته خود نویسه است. اگر نویسه یک نویسه‌ی کنترلی (0x00--0x1f) باشد، رشته شامل یک نشانک ('^') است که پس از آن حرف بزرگ متناظر قرار می‌گیرد. اگر نویسه یک نویسه‌ی حذف ASCII (0x7f) باشد، رشته '^?' است. اگر بیت متا (0x80) نویسه فعال باشد، بیت متا حذف می‌شود، قوانین پیشین اعمال می‌شوند، و '!' به ابتدای نتیجه اضافه می‌شود.

curses.ascii.controlnames

یک آرایه‌ی ۳۳ عنصری از رشته‌ها که شامل نام‌های اختصاری ASCII برای سی‌ودو نویسه‌ی کنترلی ASCII از 0 (NUL) تا 0x1f (US)، به‌ترتیب، به‌همراه نام اختصاری SP برای نویسه‌ی فاصله است.