شماره خط جاری (xml_get_current_line_number)
تابع xml_get_current_line_number عدد «شماره خط (Line Number)» را می دهد. یعنی پارسر XML الان در کدام خط است. با دانستن خط، جای خطا سریع تر پیدا می شود.
تعریف و کاربرد
طبق منبع، xml_get_current_line_number(parser) شماره خط فعلیِ پارسر XML را برمی گرداند. در موفقیت یک عدد می دهد و در خطا FALSE بازمی گرداند.
سینتکس (Syntax)
xml_get_current_line_number(<parser>)
مثال از منبع
گام های عملی سریع
- پارسر XML را بساز و فایل را باز کن.
- داده را تکه تکه بخوان و پارس کن.
- در خطا، شماره خط را با پیام چاپ کن.
نکته: کنار شماره خط، شماره ستون را هم چاپ کن تا نشانی دقیق تر شود.
هشدار: پس از اتمام کار، حتماً xml_parser_free() را فراخوانی کن.
جمع بندی سریع
- شماره خط XML برای پیدا کردن خطا ضروری است.
- موفقیت: عدد؛ خطا:
FALSE. - با خط و ستون، عیب یابی دقیق تر می شود.
- پارسر را در پایان آزاد کن.
منابع و پیوندها
شماره خط XML — مرور همین موضوع در مستندات.
مرتبط: شماره ستون جاری، رشته خطای XML.
W3Schools: xml_get_current_line_number — تعریف و مثال.
W3Schools: XML Parser Reference — فهرست توابع XML.