/*
 * Copyright (C) 2009, Christian Halstrick <christian.halstrick@sap.com>
 * Copyright (C) 2010, Google Inc. and others
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Distribution License v. 1.0 which is available at
 * https://www.eclipse.org/org/documents/edl-v10.php.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */

package org.eclipse.jgit.merge;

One chunk from a merge result. Each chunk contains a range from a
single sequence. In case of conflicts multiple chunks are reported for one
conflict. The conflictState tells when conflicts start and end.
/**
 * One chunk from a merge result. Each chunk contains a range from a
 * single sequence. In case of conflicts multiple chunks are reported for one
 * conflict. The conflictState tells when conflicts start and end.
 */
public class MergeChunk {
	
A state telling whether a MergeChunk belongs to a conflict or not. The
first chunk of a conflict is reported with a special state to be able to
distinguish the border between two consecutive conflicts
/**
	 * A state telling whether a MergeChunk belongs to a conflict or not. The
	 * first chunk of a conflict is reported with a special state to be able to
	 * distinguish the border between two consecutive conflicts
	 */
	public enum ConflictState {
		
This chunk does not belong to a conflict
/**
		 * This chunk does not belong to a conflict
		 */
		NO_CONFLICT,

		
This chunk does belong to a conflict and is the first one of the
conflicting chunks
/**
		 * This chunk does belong to a conflict and is the first one of the
		 * conflicting chunks
		 */
		FIRST_CONFLICTING_RANGE,

		
This chunk does belong to a conflict but is not the first one of the
conflicting chunks. It's a subsequent one.
/**
		 * This chunk does belong to a conflict but is not the first one of the
		 * conflicting chunks. It's a subsequent one.
		 */
		NEXT_CONFLICTING_RANGE
	}

	private final int sequenceIndex;

	private final int begin;

	private final int end;

	private final ConflictState conflictState;

	
Creates a new empty MergeChunk
Params:
sequenceIndex –  determines to which sequence this chunks belongs to. Same as in MergeResult.add
begin – 
           the first element from the specified sequence which should be
           included in the merge result. Indexes start with 0.
end – 
           specifies the end of the range to be added. The element this
           index points to is the first element which not added to the
           merge result. All elements between begin (including begin) and
           this element are added.
conflictState –  the state of this chunk. See ConflictState/**
	 * Creates a new empty MergeChunk
	 *
	 * @param sequenceIndex
	 *            determines to which sequence this chunks belongs to. Same as
	 *            in {@link org.eclipse.jgit.merge.MergeResult#add}
	 * @param begin
	 *            the first element from the specified sequence which should be
	 *            included in the merge result. Indexes start with 0.
	 * @param end
	 *            specifies the end of the range to be added. The element this
	 *            index points to is the first element which not added to the
	 *            merge result. All elements between begin (including begin) and
	 *            this element are added.
	 * @param conflictState
	 *            the state of this chunk. See
	 *            {@link org.eclipse.jgit.merge.MergeChunk.ConflictState}
	 */
	protected MergeChunk(int sequenceIndex, int begin, int end,
			ConflictState conflictState) {
		this.sequenceIndex = sequenceIndex;
		this.begin = begin;
		this.end = end;
		this.conflictState = conflictState;
	}

	
Get the index of the sequence to which this sequence chunks belongs to.
Returns:
the index of the sequence to which this sequence chunks belongs to. Same as in MergeResult.add/**
	 * Get the index of the sequence to which this sequence chunks belongs to.
	 *
	 * @return the index of the sequence to which this sequence chunks belongs
	 *         to. Same as in {@link org.eclipse.jgit.merge.MergeResult#add}
	 */
	public int getSequenceIndex() {
		return sequenceIndex;
	}

	
Get the first element from the specified sequence which should be
included in the merge result.
Returns:
the first element from the specified sequence which should be
        included in the merge result. Indexes start with 0./**
	 * Get the first element from the specified sequence which should be
	 * included in the merge result.
	 *
	 * @return the first element from the specified sequence which should be
	 *         included in the merge result. Indexes start with 0.
	 */
	public int getBegin() {
		return begin;
	}

	
Get the end of the range of this chunk.
Returns:
the end of the range of this chunk. The element this index points
        to is the first element which not added to the merge result. All
        elements between begin (including begin) and this element are
        added./**
	 * Get the end of the range of this chunk.
	 *
	 * @return the end of the range of this chunk. The element this index points
	 *         to is the first element which not added to the merge result. All
	 *         elements between begin (including begin) and this element are
	 *         added.
	 */
	public int getEnd() {
		return end;
	}

	
Get the state of this chunk.
Returns:
the state of this chunk. See ConflictState/**
	 * Get the state of this chunk.
	 *
	 * @return the state of this chunk. See
	 *         {@link org.eclipse.jgit.merge.MergeChunk.ConflictState}
	 */
	public ConflictState getConflictState() {
		return conflictState;
	}
}