Copyright (c) 2000, 2008 IBM Corporation and others.
This program and the accompanying materials
are made available under the terms of the Eclipse Public License 2.0
which accompanies this distribution, and is available at
https://www.eclipse.org/legal/epl-2.0/
SPDX-License-Identifier: EPL-2.0
Contributors:
    IBM Corporation - initial API and implementation
/*******************************************************************************
 * Copyright (c) 2000, 2008 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.text.edits;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

import org.eclipse.core.runtime.Assert;

import org.eclipse.jface.text.IRegion;


A text edit group combines a list of TextEdits and a name into a single object. The name must be a human readable string use to present the text edit group in the user interface. 

Clients may extend this class to add extra information to
a text edit group.

Since:
3.0/**
 * A text edit group combines a list of {@link TextEdit}s
 * and a name into a single object. The name must be a human
 * readable string use to present the text edit group in the
 * user interface.
 * <p>
 * Clients may extend this class to add extra information to
 * a text edit group.
 * </p>
 *
 * @since 3.0
 */
public class TextEditGroup {

	private String fDescription;
	private List<TextEdit> fEdits;

	
Creates a new text edit group with the given name.
Params:
name – the name of the text edit group. Must be
 a human readable string/**
	 * Creates a new text edit group with the given name.
	 *
	 * @param name the name of the text edit group. Must be
	 *  a human readable string
	 */
	public TextEditGroup(String name) {
		super();
		Assert.isNotNull(name);
		fDescription= name;
		fEdits= new ArrayList<>(3);
	}

	
Creates a new text edit group with a name and a single TextEdit. 
Params:
name – the name of the text edit group. Must be
 a human readable string
edit – the edit to manage/**
	 * Creates a new text edit group with a name and a single
	 * {@link TextEdit}.
	 *
	 * @param name the name of the text edit group. Must be
	 *  a human readable string
	 * @param edit the edit to manage
	 */
	public TextEditGroup(String name, TextEdit edit) {
		Assert.isNotNull(name);
		Assert.isNotNull(edit);
		fDescription= name;
		fEdits= new ArrayList<>(1);
		fEdits.add(edit);
	}

	
Creates a new text edit group with the given name and
array of edits.
Params:
name – the name of the text edit group. Must be
 a human readable string
edits – the array of edits/**
	 * Creates a new text edit group with the given name and
	 * array of edits.
	 *
	 * @param name the name of the text edit group. Must be
	 *  a human readable string
	 * @param edits the array of edits
	 */
	public TextEditGroup(String name, TextEdit[] edits) {
		super();
		Assert.isNotNull(name);
		Assert.isNotNull(edits);
		fDescription= name;
		fEdits= new ArrayList<>(Arrays.asList(edits));
	}

	
Returns the edit group's name.
Returns:
the edit group's name/**
	 * Returns the edit group's name.
	 *
	 * @return the edit group's name
	 */
	public String getName() {
		return fDescription;
	}

	
Adds the given TextEdit to this group. 
Params:
edit – the edit to add/**
	 * Adds the given {@link TextEdit} to this group.
	 *
	 * @param edit the edit to add
	 */
	public void addTextEdit(TextEdit edit) {
		fEdits.add(edit);
	}

	
Removes the given TextEdit from this group. 
Params:
edit – the edit to remove
Returns:
true if this group contained the specified edit.
Since:
3.3/**
	 * Removes the given {@link TextEdit} from this group.
	 *
	 * @param edit the edit to remove
	 * @return <code>true</code> if this group contained the specified edit.
	 * @since 3.3
	 */
	public boolean removeTextEdit(TextEdit edit) {
		return fEdits.remove(edit);
	}

	
Removes all text edits from this group.
Since:
3.3/**
	 * Removes all text edits from this group.
	 *
	 * @since 3.3
	 */
	public void clearTextEdits() {
		fEdits.clear();
	}



	
Returns true if the list of managed TextEdits is empty; otherwise false
 is returned.
Returns:
whether the list of managed text edits is
 empty or not/**
	 * Returns <code>true</code> if the list of managed
	 * {@link TextEdit}s is empty; otherwise <code>false
	 * </code> is returned.
	 *
	 * @return whether the list of managed text edits is
	 *  empty or not
	 */
	public boolean isEmpty() {
		return fEdits.isEmpty();
	}

	
Returns an array of TextEdits containing the edits managed by this group. 
Returns:
the managed text edits/**
	 * Returns an array of {@link TextEdit}s containing
	 * the edits managed by this group.
	 *
	 * @return the managed text edits
	 */
	public TextEdit[] getTextEdits() {
		return fEdits.toArray(new TextEdit[fEdits.size()]);
	}

	
Returns the text region covered by the edits managed via this
edit group. If the group doesn't manage any edits null
 is returned.
Returns:
the text region covered by this edit group or 
 null if no edits are managed/**
	 * Returns the text region covered by the edits managed via this
	 * edit group. If the group doesn't manage any edits <code>null
	 * </code> is returned.
	 *
	 * @return the text region covered by this edit group or <code>
	 *  null</code> if no edits are managed
	 */
	public IRegion getRegion() {
		int size= fEdits.size();
		if (size == 0) {
			return null;
		} else if (size == 1) {
			return fEdits.get(0).getRegion();
		} else {
			return TextEdit.getCoverage(fEdits.toArray(new TextEdit[fEdits.size()]));
		}
	}
}