key
تابع key() روی SimpleXMLIterator کار می کند و «کلید عنصر XML» را می دهد. منظور از کلید، نام برچسب جاری است. مثل وقتی در دفتر حضور و غیاب، اسمِ ردیفِ فعلی را می خوانی.
تعریف کوتاه و کاربرد کلید عنصر XML
key() نام تگِ عنصرِ جاری را برمی گرداند. اگر روی تگ <to> باشی، خروجی "to" است. اگر جای درستی نباشی، شکست می خوری.
سینتکس
SimpleXMLIterator::key() ورودی ندارد و یک رشته یا FALSE برمی گرداند.
مثال ساده
<?php
$note = <<<XML
<note>
<to>Tove</to>
<from>Jani</from>
<heading>Reminder</heading>
<body>Do not forget me this weekend!</body>
</note>
XML;
$xml = new SimpleXMLIterator($note);
$xml->rewind();
var_dump($xml->key());
?>
گام های عملی
- XML را در
SimpleXMLIteratorبساز. - با rewind() برو ابتدای لیست.
- با key() نام تگِ عنصر جاری را بگیر.
- برای حرکت بعدی از next() استفاده کن.
نکته های کاربردی کلید عنصر XML
نکته: اگر FALSE گرفتی، موقعیت را با valid() چک کن.
نکته: برای محتوای عنصر از current() استفاده کن؛ key() فقط نام تگ است.
جمع بندی سریع
- key() نام تگِ عنصر جاری را می دهد.
- قبلش معمولاً
rewind()لازم است. - برای داده داخل تگ،
current()بهتر است. - برای پیمایش،
next()را فراموش نکن.