com.perforce.p4java.server
Class PerforceCharsets

java.lang.Object
  com.perforce.p4java.server.PerforceCharsets

public class PerforceCharsets
extends Object

Encapsulates Perforce-wide charset information for servers.

Unfortunately, support for Unicode and associated charsets is somewhat server- and installation-dependent, and not easy to divine unless you're already talking to a Perforce server -- by which time it's too late. This class is an attempt to make it easier to cut that Gordian knot...

Note that the names below are not actually the standard name for the charset in some cases: e.g. UTF-8 should be "utf-8" not "utf8", but we follow the Perforce server's rules here.

PerforceCharsets

public PerforceCharsets()

getKnownCharsets

public static String[] getKnownCharsets()

Get known P4 charsets

Returns:

- array of p4 charset names

getP4CharsetName

public static String getP4CharsetName(String javaCharsetName)

Get the first matching Perforce equivalent charset name for a given Java charset name. Multiple Perforce charsets can be mapped to a Java charset (i.e. Perforce "utf8-bom" and "utf8unchecked" are mapped to Java "UTF-8")

Parameters:

javaCharsetName -

Returns:

- Perforce charset name

getJavaCharsetName

public static String getJavaCharsetName(String p4CharsetName)

Get Java equivalent charset name for a p4 charset name

Parameters:

p4CharsetName -

Returns:

- Java charset name

getJavaCharsetName

public static String getJavaCharsetName(int p4CharsetIndex)

Get Java equivalent charset name for a p4 charset index (knownCharsets)

Parameters:

p4CharsetIndex -

Returns:

- Java charset name

getJavaCharset

public static Charset getJavaCharset(int p4CharsetIndex)

Get Java equivalent charset for a p4 charset index (knownCharsets)

Parameters:

p4CharsetIndex -

Returns:

- Java charset

isSupported

public static boolean isSupported(String p4CharsetName)

Is the P4 charset name specified supported?

Parameters:

p4CharsetName -

Returns:

- true if supported, false otherwise