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.

مصادر

صفحة التوثيق الرسمي للمكتبة linecache