XML DOM substringData() روش

تعریف و استفاده

substringData() روشی است که از Text یا Comment از یک گره استخراج کند.}

نحوه استفاده:

CharacterData.substringData(start,length)
پارامتر توضیح
start ضروری. موقعیت اولین کاراکتر در زنجیره بازگردانده شده.
length ضروری. تعداد کاراکترهای زنجیره‌ای که باید بازگردانده شود.

برگشت‌دهی

یک رشته‌ای بازمی‌گرداند که شامل موضوع Text یا Comment داده‌ها از start شروع شده length کاراکتر.

پرتاب

این روش می‌تواند خطاهای کد زیر را پرتاب کند DOMException خطا:

INDEX_SIZE_ERR - پارامتر start یا length منفی است یا length بزرگتر از طول موضوع Text یا Comment است.

DOMSTRING_SIZE_ERR - دامنه متن مشخص شده بیش از حد طولانی است و نمی‌تواند در پیاده‌سازی JavaScript مرورگر به یک رشته جایگزین شود.

توضیح

این روش از موضوع Text یا Comment داده‌ها را از start شروع شده length کاراکتر. فقط زمانی که تعداد کاراکترهای متن شامل در یک گره بیشتر از حداکثر تعداد کاراکترهای زنجیره‌ای که می‌تواند در پیاده‌سازی JavaScript مرورگر جایگزین شود، باشد، این روش مفید است. در این حالت، برنامه JavaScript نمی‌تواند مستقیماً از ویژگی data موضوع Text یا Comment استفاده کند و باید از قطعه کوتاه‌تری از متن گره استفاده کند. در عمل، این موضوع ممکن است به ندرت رخ دهد.

صفحات مرتبط

دستورالعمل XML DOM:Text.replaceData()

دستورالعمل XML DOM:Comment.replaceData()