Programowanie
Metoda compareBoundaryPoints() w XML DOM
Definicja i zastosowanie
Metoda compareBoundaryPoints() porównuje pozycje dwóch zakresów.
Gramatyka:howcompareBoundaryPoints(sourceRange,
)
| ) | opis |
|---|---|
| how | parametr |
| sourceRange | z którym należy porównać bieżący zakres. Określa, jak należy wykonać operację porównania (tj. które punkty graniczne mają być porównywane). Dopuszczalne wartości to stałe zdefiniowane w interfejsie Range. |
wartość zwracana
Jeśli bieżący punkt graniczny zakresu znajduje się sourceRange określony punkt graniczny, zwraca -1. Jeśli określone dwa punkty graniczne są takie same, zwraca 0. Jeśli bieżące granice zakresu znajdują się sourceRange określony punkt graniczny, zwraca 1.
wyrzuca
Jeśli sourceRange oznacza, że dokument reprezentowany przez ten obiekt różni się od dokumentu reprezentowanego przez bieżący zakres, metoda wywoła wyjątek o kodzie WRONG_DOCUMENT_ERR. Wyjątek DOMException.
opis
metoda porównuje punkty graniczne bieżącego zakresu i sourceRange punkty graniczne i zwraca wartość, która określa ich względne położenie w dokumencie źródłowym. Parametr how określa, który punkt graniczny zakresów należy porównać. Legalne wartości tego parametru i ich znaczenie są następujące:
- Range.START_TO_START - porównanie punktów startowych dwóch węzłów Range
- Range.END_TO_END - porównanie punktów końcowych dwóch węzłów Range
- Range.START_TO_END - używając sourceRange porównać punkt startowy z punktem końcowym bieżącego zakresu
- Range.END_TO_START - używając sourceRange porównać punkt końcowy z punktem startowym bieżącego zakresu
zwróconej wartości jest liczbą, która określa pozycję bieżącego zakresu względem sourceRange pozycji. Dlatego możesz myśleć, że najpierw należy użyć parametru how stałe zakresy określają punkty graniczne bieżącego zakresu, a następnie używają go do sourceRange punkty graniczne. Ale w rzeczywistości, stała Range.START_TO_END określa punkty graniczne bieżącego zakresu i sourceRange porównać z punktem startowym. Podobnie, stała Range.END_TO_START określa porównanie punktu startowego bieżącego zakresu z punktem końcowym określonego zakresu.
