رشته خطای XML (xml_error_string)
تابع xml_error_string متنِ خطا را از «کُد خطا» می سازد. «کُد خطا (Error Code)» یک عدد است؛ «رشته خطا» همان توضیح خواناست. این تابع فقط متن خطا را برمی گرداند.
تعریف و کاربرد
طبق منبع، xml_error_string(code) توضیح خطای پارسر XML را برمی گرداند. اگر موفق باشد، متن خطا می آید؛ در شکست، FALSE می شود.
سینتکس (Syntax)
xml_error_string(code)؛ ورودی باید عدد برگشتی از xml_get_error_code() باشد.
مثال از منبع
<?php
// Invalid xml file
$xmlfile = 'test.xml';
$xmlparser = xml_parser_create();
$fp = fopen($xmlfile, 'r');
while ($xmldata = fread($fp, 4096)) {
// parse the data chunk
if (!xml_parse($xmlparser, $xmldata, feof($fp))) {
die(
print "ERROR: "
. xml_error_string(xml_get_error_code($xmlparser))
. "<br>Line: "
. xml_get_current_line_number($xmlparser)
. "<br>Column: "
. xml_get_current_column_number($xmlparser)
. "<br>"
);
}
}
xml_parser_free($xmlparser);
?>
گام های عملی سریع
- XML را با پارسر بخوان.
- اگر خطا شد، کُد خطا را بگیر.
- با
xml_error_stringمتن خطا را نمایش بده.
نکته: برای خط مکان، از xml_get_current_line_number() و xml_get_current_column_number() کمک بگیر.
هشدار: قبل از خروج از برنامه، حتماً xml_parser_free() را صدا بزن.
جمع بندی سریع
- رشته خطای XML را از کُد می سازد.
- در موفقیت، متن خوانا می دهد.
- در خطا، مقدار
FALSEبرمی گردد. - شماره خط و ستون را جداگانه بگیر.
منابع و ادامه مطالعه
W3Schools: xml_error_string — توضیح رسمی و مثال.
W3Schools: XML Parser Reference — فهرست توابع مرتبط.
برای آشنایی بیشتر، صفحه utf8_encode و utf8_decode را ببین. همچنین لینک داخلی با کلیدواژه رشته خطای XML را برای ناوبری سریع گذاشتیم.