Eclipse Platform
Release 3.3

org.eclipse.search.core.text
Class TextSearchMatchAccess

java.lang.Object
  extended byorg.eclipse.search.core.text.TextSearchMatchAccess

public abstract class TextSearchMatchAccess
extends Object

A TextSearchMatchAccess gives access to a pattern match found by the TextSearchEngine.

Please note that TextSearchMatchAccess objects do not have value semantic. The state of the object might change over time especially since objects are reused for different call backs. Clients shall not keep a reference to a TextSearchMatchAccess element.

This class should only be implemented by implementors of a TextSearchEngine.

Since:
3.2

Constructor Summary
TextSearchMatchAccess()
           
 
Method Summary
abstract  IFile getFile()
          Returns the file the match was found in.
abstract  String getFileContent(int offset, int length)
          Returns the file's content at the given offsets.
abstract  char getFileContentChar(int offset)
          Returns a character of the file's content at the given offset
abstract  int getFileContentLength()
          Returns the length of this file's content.
abstract  int getMatchLength()
          Returns the length of this search match.
abstract  int getMatchOffset()
          Returns the offset of this search match.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

TextSearchMatchAccess

public TextSearchMatchAccess()
Method Detail

getFile

public abstract IFile getFile()
Returns the file the match was found in.

Returns:
the file the match was found.

getMatchOffset

public abstract int getMatchOffset()
Returns the offset of this search match.

Returns:
the offset of this search match

getMatchLength

public abstract int getMatchLength()
Returns the length of this search match.

Returns:
the length of this search match

getFileContentLength

public abstract int getFileContentLength()
Returns the length of this file's content.

Returns:
the length of this file's content.

getFileContentChar

public abstract char getFileContentChar(int offset)
Returns a character of the file's content at the given offset

Returns:
the character at the given offset
Throws:
IndexOutOfBoundsException - an IndexOutOfBoundsException is thrown when the offset is negative or not less than the file content's length.

getFileContent

public abstract String getFileContent(int offset,
                                      int length)
Returns the file's content at the given offsets.

Parameters:
offset - the offset of the requested content
length - the of the requested content
Returns:
the substring of the file's content
Throws:
IndexOutOfBoundsException - an IndexOutOfBoundsException is thrown when the offset or the length are negative or when offset + length is not less than the file content's length.

Eclipse Platform
Release 3.3

Guidelines for using Eclipse APIs.

Copyright (c) IBM Corp. and others 2000, 2007. All rights reserved.