Package org.eclipse.cdt.core
Interface IPositionTrackerManager
public interface IPositionTrackerManager
An interface to manage the position tracking. It allows for mapping character
offsets from a file previously stored on disk to the offset in the current document
for the file.
- Since:
- 4.0
- Restriction:
- This interface is not intended to be implemented by clients.
- Restriction:
- This interface is not intended to be extended by clients.
-
Method Summary
Modifier and TypeMethodDescriptionfindPositionConverter
(URI externalLocation, long timestamp) Returns the position tracker suitable for mapping character offsets of the given external file/timestamp to the current version of it.findPositionConverter
(ITranslationUnit tu, long timestamp) Returns the position converter suitable for mapping character offsets of the given translation unit to the current version of it.findPositionConverter
(org.eclipse.core.resources.IFile file, long timestamp) Returns the position converter suitable for mapping character offsets of the given file/timestamp to the current version of it.findPositionConverter
(org.eclipse.core.runtime.IPath fullPathOrExternalLocation, long timestamp) Returns the position tracker suitable for mapping character offsets of the given external file/timestamp to the current version of it.
-
Method Details
-
findPositionConverter
Returns the position converter suitable for mapping character offsets of the given translation unit to the current version of it.- Parameters:
tu
- a translation unit for which the position adapter is requested.timestamp
- identifies the version of the file stored on disk.- Returns:
- the requested position converter or
null
.
-
findPositionConverter
Returns the position converter suitable for mapping character offsets of the given file/timestamp to the current version of it.- Parameters:
file
- a file for which the position adapter is requested.timestamp
- identifies the version of the file stored on disk.- Returns:
- the requested position converter or
null
.
-
findPositionConverter
IPositionConverter findPositionConverter(org.eclipse.core.runtime.IPath fullPathOrExternalLocation, long timestamp) Returns the position tracker suitable for mapping character offsets of the given external file/timestamp to the current version of it.The method can be used for resources by supplying the full path. However, it does not work if you supply the location of a resource.
- Parameters:
fullPathOrExternalLocation
- an external location for which the position adapter is requested.timestamp
- identifies the version of the file stored on disk.- Returns:
- the requested position converter or
null
.
-
findPositionConverter
Returns the position tracker suitable for mapping character offsets of the given external file/timestamp to the current version of it.The method cannot be used for resources that are part of the workspace.
- Parameters:
externalLocation
- an external location for which the position adapter is requested.timestamp
- identifies the version of the file stored on disk.- Returns:
- the requested position converter or
null
. - Since:
- 5.1
-