تنظیم گزینه parser (xml_parser_set_option)
تابع xml_parser_set_option برای تنظیم گزینه پارسر است. «گزینه (Option)» یعنی تنظیمات داخلی؛ مثل کم وزیاد کردن صدا در بازی.
تعریف و کاربرد تنظیم گزینه parser
طبق منبع، این تابع یک گزینه را در پارسر XML تنظیم می کند و در صورت موفقیت TRUE می دهد.
سینتکس (Syntax)
xml_parser_set_option(<parser>, <option>, <value>)
گزینه های پشتیبانی شده
- XML_OPTION_CASE_FOLDING: حروف تگ ها را بزرگ کند یا نه. 1 یا 0.
- XML_OPTION_SKIP_TAGSTART: چند نویسه آغاز نام تگ رد شود.
- XML_OPTION_SKIP_WHITE: مقدارهای فقط فاصله سفید رد شوند. 1 یا 0.
- XML_OPTION_TARGET_ENCODING: کدگذاری خروجی؛ مثل UTF-8.
مثال: تنظیم گزینه parser
<?php
// ساخت یک پارسر XML
$parser = xml_parser_create();
// تنظیم: حروف بزرگ سازی تگ ها غیرفعال شود
$ok = xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
if ($ok === true) {
echo "Option set successfully.";
} else {
echo "Failed to set option.";
}
// آزادسازی پارسر
xml_parser_free($parser);
?>
گام های عملی تنظیم گزینه parser
- با xml_parser_create پارسر بساز.
- گزینه مدنظرت را انتخاب کن و مقدار بده.
- در صورت نیاز مقدار را با xml_parser_get_option بررسی کن.
- در پایان، با xml_parser_free آزاد کن.
نکته: تنظیم گزینه parser روی نحوه خواندن XML اثر می گذارد؛ مثل فیلتر کلاس روی تکالیف.
هشدار: مقدار نامعتبر بدهی، تابع FALSE برمی گرداند و تغییری اعمال نمی شود.
جمع بندی سریع
- xml_parser_set_option یک گزینه را تنظیم می کند.
- گزینه ها شامل CASE، ENCODING و SKIPها هستند.
- موفقیت با TRUE برمی گردد.
- فراموش نکن پارسر را آزاد کنی.