Package com.intellij.openapi.editor.impl

Class BulkChangesMerger

java.lang.Object

com.intellij.openapi.editor.impl.BulkChangesMerger

public class BulkChangesMerger
extends java.lang.Object

Encapsulates logic of merging set of changes into particular text.

Thread-safe.

Field Summary

Fields

Modifier and Type	Field and Description
static BulkChangesMerger	INSTANCE

Constructor Summary

Constructors

Constructor and Description
BulkChangesMerger()

Method Summary

Modifier and Type	Method and Description
void	mergeInPlace(char [] data, int length, java.util.List<? extends TextChangeImpl> changes) Allows to perform 'in-place' merge of the given changes to the given array.
char []	mergeToCharArray(char [] text, int textLength, java.util.List<? extends TextChange> changes) Merges given changes within the given text and returns result as a new char array.
java.lang.CharSequence	mergeToCharSequence(char [] text, int textLength, java.util.List<? extends TextChange> changes) Merges given changes within the given text and returns result as a new char sequence.
int	updateOffset(int originalOffset, java.util.List<? extends TextChange> changes) Given an offset of some location in the document, returns offset of this location after application of given changes.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

INSTANCE

public static final BulkChangesMerger INSTANCE

Constructor Detail

BulkChangesMerger

public BulkChangesMerger()

Method Detail

mergeToCharSequence

public java.lang.CharSequence mergeToCharSequence(char [] text,
                                                  int textLength,
                                                  java.util.List<? extends TextChange> changes)

Merges given changes within the given text and returns result as a new char sequence.

Parameters:

text - text to apply given changes for

textLength - interested number of symbols from the given text to use

changes - changes to apply to the given text. It's assumed that there are no intersections between them and that they are sorted by offsets in ascending order

Returns:

merge result

mergeToCharArray

public char [] mergeToCharArray(char [] text,
                                int textLength,
                                java.util.List<? extends TextChange> changes)

Merges given changes within the given text and returns result as a new char array.

Parameters:

text - text to apply given changes for

textLength - interested number of symbols from the given text to use

changes - changes to apply to the given text. It's assumed that there are no intersections between them and that they are sorted by offsets in ascending order

Returns:

merge result

mergeInPlace

public void mergeInPlace(char [] data,
                         int length,
                         java.util.List<? extends TextChangeImpl> changes)
                  throws java.lang.IllegalArgumentException

Allows to perform 'in-place' merge of the given changes to the given array.

I.e. it's considered that given array contains particular text at [0; length) region and given changes define offsets against it. It's also assumed that given array length is enough to contain resulting text after applying the changes.

Example: consider that initial text is '12345' and given changes are 'remove text at [1; 3) interval' and 'replace text at [4; 5) interval with 'abcde''. Resulting text is '14abcde' then and given array length should be not less than 7.

Parameters:

data - data array

length - initial text length (without changes)

changes - change to apply to the target text

Throws:

java.lang.IllegalArgumentException - if given array is not big enough to contain the resulting text

updateOffset

public int updateOffset(int originalOffset,
                        java.util.List<? extends TextChange> changes)

Given an offset of some location in the document, returns offset of this location after application of given changes. List of changes is supposed to satisfy the same constraints as required by mergeToCharSequence(char[], int, List) method.