Python/linecache/getline
التابع linecache.getline
يعيد السطر المُحدد رقمُه بالمعامل lineno الممرة كسلسلة نصية، ويعيد سلسلة نصية فارغة إن حدث أي خطأ.
يكون المحرف الدال على نهاية السطر متضَمّنًا ضمن السلسة النصية المعادة.
إن لم يكن الملف ذو الاسم filename موجودًا، يقوم التابع بالبحث عنه ضمن مسار البحث عن الوحدات، sys.path، وذلك بعد أن يتم البحث أولًا عن تابع __loader__ المعرف ضمن التحسين PEP-302 ضمن الوسيط module_globals وذلك في حال كانت الوحدة مستوردةً من ملف مضغوط أو من مصدر ليس من نظام الملفات.
البنية العامة
linecache.getline(filename, lineno, module_globals=None)
المعاملات
الوسيط filename
سلسلة نصية تُمثل اسم الملف المطلوب جلب السطر منه.
الوسيط lineno
رقم السطر المطلوب.
الوسيط module_globals
قاموس dict يحتوي توابع خاصة، وله القيمة الافتراضية None
القيمة المعادة
سلسة محرفية تُمثل السطر المطلوب جلبه، وقد تكون السلسلة النصية الخالية '' في حال حدوث أي خطأ.
وتحوي هذه السلسلة النصية على محرف نهاية السطر ، الذي قد يكون 'n\' في نهايتها.
أمثلة
يبين المثال التالي طريقة استخدام التابع:
>>> import linecache
>>> f=open('D:\\file.txt','w')
>>> print('Hello\nWorld!\How\nAre\nYou!',file=f)
>>> f.close()
>>> linecache.getline('D:\\file.txt',1)
'Hello\n'
>>> linecache.getline('D:\\file.txt',2)
'World!\\How\n'
>>> linecache.getline('D:\\file.txt',55)
''
>>> linecache.getline('D:\\file.txt',-1)
''
>>> linecache.getline('D:\\file33.txt',-1)
''
>>> linecache.getline('D:\\file33.txt',1)
''
انظر أيضًا
التابع المضمن open.
مصادر