برنامه‌نویسی
XML DOM compareBoundaryPoints() روش
تعریف و استفاده
مетод compareBoundaryPoints() دو محدوده را مقایسه می‌کند.
نحوه‌ی استفاده:howcompareBoundaryPoints(sourceRange,
)
| ) | توضیحات |
|---|---|
| how | پارامتر |
| sourceRange | محدوده‌ای که باید با محدوده‌ی فعلی مقایسه شود. اظهارنظر در مورد نحوه‌ی انجام عمل مقایسه (یعنی مقایسه‌ی کدام نقطه‌های مرزی). مقادیر مجاز آن‌ها مقدارهای تعریف شده در رابط Range است. |
مقدار بازگشتی
اگر نقطه مرزی مشخص شده‌ی محدوده‌ی فعلی در sourceRange قبل از نقطه مرزی مشخص شده، -1 بازمی‌گرداند. اگر دو نقطه مرزی مشخص شده‌ی دوگانه یکسان باشند، 0 بازمی‌گرداند. اگر نقطه‌های مرزی محدوده‌ی فعلی در sourceRange پس از نقطه مرزی مشخص شده، 1 بازمی‌گرداند.
پرتاب
اگر sourceRange به معنای مستند بیان شده توسط آن با مستند بیان شده توسط محدوده فعلی متفاوت است، این روش خطایی با کد WRONG_DOCUMENT_ERR پرتاب می‌کند. DOMException خطا.
توضیحات
این روش محدوده مرزی فعلی و محدوده مشخص شده را مقایسه می‌کند sourceRange نقطه‌های مرزی و یک مقدار برمی‌گرداند که بیان می‌کند آن‌ها در منبع مستند به صورت نسبی قرار دارند. پارامتر how محدوده‌های مقایسه دو محدوده را مشخص می‌کند. مقادیر مجاز این پارامتر و معانی آن‌ها به شرح زیر است:
- Range.START_TO_START - مقایسه نقطه شروع دو گره Range
- Range.END_TO_END - مقایسه نقطه پایان دو گره Range
- Range.START_TO_END - با استفاده از sourceRange نقطه شروع آن با نقطه پایان محدوده فعلی مقایسه شود
- Range.END_TO_START - با استفاده از sourceRange نقطه پایان آن با نقطه شروع محدوده فعلی مقایسه شود
این روش یک عدد برمی‌گرداند که بیان می‌کند محدوده فعلی در مقایسه با sourceRange موقعیت. بنابراین، ممکن است فکر کنید که ابتدا باید از پارامتر how محدوده‌های مقدار ثابت指定 نقطه‌های مرزی محدوده فعلی و سپس با استفاده از آن sourceRange نقطه‌های مرزی. اما در واقع، مقدار ثابت Range.START_TO_END مقایسه نقطه پایان محدوده فعلی با نقطه شروع sourceRange با نقطه شروع آن مقایسه شود. همچنین، مقدار ثابت Range.END_TO_START مقایسه نقطه شروع محدوده فعلی با نقطه پایان محدوده مشخص شده را مشخص می‌کند.
