org.eclipse.core.resources
Interface IEncodedStorage

All Superinterfaces:

org.eclipse.core.runtime.IAdaptable, IStorage

All Known Subinterfaces:

IFile, IFileState

All Known Implementing Classes:

File, FileState

public interface IEncodedStorage
extends IStorage

A storage that knows how its contents are encoded.

The IEncodedStorage interface extends IStorage in order to provide access to the charset to be used when decoding its contents.

Clients may implement this interface.

Since:

3.0

Method Summary

java.lang.String

getCharset() Returns the name of a charset encoding to be used when decoding this storage's contents into characters.

Methods inherited from interface org.eclipse.core.resources.IStorage

getContents, getFullPath, getName, isReadOnly

Methods inherited from interface org.eclipse.core.runtime.IAdaptable

getAdapter

Method Detail

getCharset

java.lang.String getCharset()
                            throws org.eclipse.core.runtime.CoreException

Returns the name of a charset encoding to be used when decoding this storage's contents into characters. Returns null if a proper encoding cannot be determined.

Note that this method does not check whether the result is a supported charset name. Callers should be prepared to handle UnsupportedEncodingException where this charset is used.

Returns:

the name of a charset, or null

Throws:

org.eclipse.core.runtime.CoreException - if an error happens while determining the charset. See any refinements for more information.

See Also:

IStorage.getContents()