Overview | Package | Class | Tree | Deprecated | Index | Help

3.00.12
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## interbase.interclient
Class CharacterEncodings

    java.lang.Object
      |
      +--interbase.interclient.CharacterEncodings

public final class CharacterEncodings
extends Object

An enumeration of IANA character encodings supported by InterClient.

A complete list of IANA encodings may be found at ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets. The InterBase name for the IANA character encoding may be obtained by calling `getInterBaseCharacterSetName()`.

Any of the following character encodings may be specified on connection using the `charSet` connection property. It is recommended to use one of the static final encoding variables below rather than using hardwired encoding names in your application. The actual encoding names represented by these variables could change from one release to the next.

See DataSource Properties for a description of the `charSet` connection property.

Since:
  Extension, since InterClient 1.50

Field Summary
`static String` | `_8859_1` ISO Latin-1.
`static String` | `Big5` Big 5 Chinese for Taiwan Multi-byte set.
`static String` | `Cp1250` Windows Eastern Europe/Latin-2.
`static String` | `Cp1251` Windows Cyrillic.
`static String` | `Cp1252` Windows Western Europe/Latin-1.
`static String` | `Cp1253` Windows Greek.
`static String` | `Cp1254` Windows Turkish.
`static String` | `Cp437` PC Original.
`static String` | `Cp850` PC Latin-1.
`static String` | `Cp852` PC Latin-2.
`static String` | `Cp857` PC Turkish.
`static String` | `Cp860` PC Portuguese.
`static String` | `Cp861` PC Icelandic.
`static String` | `Cp863` PC Canadian French.
`static String` | `Cp865` PC Nordic.
`static String` | `EUCJIS` Japanese Extended Unix Code (EUC).
`static String` | `GB2312` Simplified Chinese for People's Republic of China.
`static String` | `GBK`
`static String` | `KSC5601` Korean.
`static String` | `MS932`
`static String` | `MS949`
`static String` | `MS950`
`static String` | `NONE` The default encoding is no encoding at all.
`static String` | `SJIS` PC and Windows Japanese.
`static String` | `UTF8` Standard UTF-8.

Method Summary
`static String` | `getInterBaseCharacterSetName(String encoding)` Return the InterBase character set name for a supported Java encoding name.
`static String[]` | `getSupportedEncodings()` Return an array of all Java encodings supported by the driver.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

### NONE

    public static final String NONE

  The default encoding is no encoding at all. Represents the value "NONE".

  If an encoding is not specified using the `charSet` connection property, an attachment will use the InterBase default `NONE` character set. The `NONE` character set attachment specifies that data is processed as is with no conversions. The default encoding for your locale is not used. Because conversions are not performed and no particular encoding is enforced, all SQL and SQL data is interpreted byte-wise as the low order byte of a Java Unicode 2-byte character. Therefore, all SQL and character data should be restricted to ASCII when connecting to an InterBase server using the default `NONE` character set.

  Since:
    Extension, since InterClient 1.50

### _8859_1

    public static final String _8859_1

  ISO Latin-1. Represents the IANA name and preferred MIME name `ISO-8859-1`. The InterBase character set name is `ISO8859_1`. The Java encoding name is `8859_1`.

  An 8-bit encoding that supports many latin languages, including Afrikaans, Albanian, Basque, Catalan, Danish, Dutch, English, Faroese, Finnish, French, Galician, German, Icelandic, Irish, Italian, Norwegian, Portuguese, Scottish, Spanish, and Swedish.

  Since:
    Extension, since InterClient 1.50

### Big5

    public static final String Big5

  Big 5 Chinese for Taiwan Multi-byte set. Represents the IANA name and preferred MIME name `Big5`. The InterBase character set name is `BIG_5`. The Java encoding name is `Big5`. Also known as `csBig5`.
  Since:
    Extension, since InterClient 1.50

### MS950

    public static final String MS950

### Cp1250

    public static final String Cp1250

  Windows Eastern Europe/Latin-2. Represents the IANA name `windows-1250`. The InterBase character set name is `WIN1250`. The Java encoding name is `Cp1250`;
  Since:
    Extension, since InterClient 1.50

### Cp1251

    public static final String Cp1251

  Windows Cyrillic. Represents the IANA name `windows-1251`. The InterBase character set name is `WIN1251`. The Java encoding name is `Cp1251`.
  Since:
    Extension, since InterClient 1.50

### Cp1252

    public static final String Cp1252

  Windows Western Europe/Latin-1. Represents the IANA name `windows-1252`. The InterBase character set name is `WIN1252`. The Java encoding name is `Cp1252`.
  Since:
    Extension, since InterClient 1.50

### Cp1253

    public static final String Cp1253

  Windows Greek. Represents the IANA name `windows-1253`. The InterBase character set name is `WIN1253`. The Java encoding name is `Cp1253`.
  Since:
    Extension, since InterClient 1.50

### Cp1254

    public static final String Cp1254

  Windows Turkish. Represents the IANA name `windows-1254`. The InterBase character set name is `WIN1254`. The Java encoding name is `Cp1254`.
  Since:
    Extension, since InterClient 1.50

### Cp437

    public static final String Cp437

  PC Original. Represents the IANA name `IBM437`. The InterBase character set name is `DOS437`. The Java encoding name is `Cp437`.
  Since:
    Extension, since InterClient 1.50

### Cp850

    public static final String Cp850

  PC Latin-1. Represents the IANA name `IBM850`. The InterBase character set name is `DOS850`. The Java encoding name is `Cp850`.
  Since:
    Extension, since InterClient 1.50

### Cp852

    public static final String Cp852

  PC Latin-2. Represents the IANA name `IBM852`. The InterBase character set name is `DOS852`. The Java encoding name is `Cp852`.
  Since:
    Extension, since InterClient 1.50

### Cp857

    public static final String Cp857

  PC Turkish. Represents the IANA name `IBM857`. The InterBase character set name is `DOS857`. The Java encoding name is `Cp857`.
  Since:
    Extension, since InterClient 1.50

### Cp860

    public static final String Cp860

  PC Portuguese. Represents the IANA name `IBM860`. The InterBase character set name is `DOS860`. The Java encoding name is `Cp860`.
  Since:
    Extension, since InterClient 1.50

### Cp861

    public static final String Cp861

  PC Icelandic. Represents the IANA name `IBM861`. The InterBase character set name is `DOS861`. The Java encoding name is `Cp861`.
  Since:
    Extension, since InterClient 1.50

### Cp863

    public static final String Cp863

  PC Canadian French. Represents the IANA name `IBM863`. The InterBase character set name is `DOS863`. The Java encoding name is `Cp863`
  Since:
    Extension, since InterClient 1.50

### Cp865

    public static final String Cp865

  PC Nordic. Represents the IANA name `IBM865`. The InterBase character set name is `DOS865`. The Java encoding name is `Cp865`.
  Since:
    Extension, since InterClient 1.50

### EUCJIS

    public static final String EUCJIS

  Japanese Extended Unix Code (EUC). Represents the IANA name `Extended_UNIX_Code_Packed_Format_for_Japanese`, and preferred MIME name `EUC-JP`. The InterBase character set name is `EUCJ_0208`. The Java encoding name is `EUCJIS`.

  A double 7-bit byte set, restricted to A0-FF in both bytes

  Since:
    Extension, since InterClient 1.50

### GB2312

    public static final String GB2312

  Simplified Chinese for People's Republic of China. Represents the IANA name and preferred MIME name `GB2312`. The InterBase character set name is `GB_2312`. The Java encoding name is `GB2312`.

  A mixed one byte, two byte set:

       20-7E = one byte ASCII
       A1-FE = two byte PRC Kanji

  Since:
    Extension, since InterClient 1.50

### GBK

    public static final String GBK

### KSC5601

    public static final String KSC5601

  Korean. Represents the IANA name `KS_C_5601-1987`. The InterBase character set name is also `KSC_5601`. The Java encoding name is `KSC5601`.
  Since:
    Extension, since InterClient 1.50

### MS949

    public static final String MS949

### SJIS

    public static final String SJIS

  PC and Windows Japanese. Represents the IANA name and preferred MIME name `Shift_JIS`. The InterBase character set name is `SJIS_0208`. The Java encoding name is `SJIS`. Also known as `MS_Kanji`.

  A Microsoft code that extends `csHalfWidthKatakana` to include kanji by adding a second byte when the value of the first byte is in the ranges 81-9F or E0-EF.

  Since:
    Extension, since InterClient 1.50

### MS932

    public static final String MS932

### UTF8

    public static final String UTF8

  Standard UTF-8. Represents the IANA name `UTF-8`. The InterBase character set name is `UNICODE_FSS`. The Java encoding name is `UTF8`.

  UTF-8 is a 1 to 3 byte universal encoding of 2-byte Unicode in which ASCII has a one byte representation. That is, unlike 2-byte Unicode, ASCII is a subset of UTF-8. This makes UTF-8 a File-Safe encoding, and is therefore known as File System Safe Unicode, or Unicode FSS.

  Since:
    Extension, since InterClient 1.50

Method Detail

### getInterBaseCharacterSetName

    public static String getInterBaseCharacterSetName(String encoding)
                                               throws SQLException

  Return the InterBase character set name for a supported Java encoding name.
  Throws:
    `SQLException` - if the IANA encoding is not supported.
  Since:
    Extension, since InterClient 1.50

### getSupportedEncodings

    public static String[] getSupportedEncodings()

  Return an array of all Java encodings supported by the driver. Driver support for an encoding does not necessarily imply database support for the encoding. Database support for particular encodings will depend on the version of InterBase being used.
  Since:
    Extension, since InterClient 1.50

Overview | Package | Class | Tree | Deprecated | Index | Help

3.00.12
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Send comments or suggestions to interclient@borland.com