---
product: Chilkat
product_version: 11.7.0
language: ckjava
language_label: Java
class: CkString
license: free
deprecated: false
reference_html: https://www.chilkatsoft.com/refdoc/javaCkStringRef.html
---
# Chilkat CkString — Java — v11.7.0

> Chilkat 11.7.0 · language=ckjava · class=CkString
> Other versions: replace `11.7.0` in this URL. Other languages: `https://www.chilkatsoft.com/ai-docs/v/11.7.0/<lang>/classes/CkString.md`.
> Language-wide rules (install, unlock, error model, strings/bytes): `https://www.chilkatsoft.com/ai-docs/v/11.7.0/ckjava/guide.md`.

## Purpose

The Chilkat string class.

## Object creation, unlocking and error handling

**Object Creation**

```java
CkString obj = new CkString();
```

Call `Global.UnlockBundle` once at the start of the program, before using this or any other Chilkat class. Any string unlocks a fully functional 30-day trial; a purchased unlock code is used in production. See `guide.md` for the exact code in Java.

How failure is reported depends on the method's return type and is stated in the note under each method below. In every case the diagnostic text is in the `LastErrorText` property of the object whose method was called.

## Member index

| Member | Kind | Signature |
|---|---|---|
| `NumArabic` | property, read-only | `int get_NumArabic();` |
| `NumAscii` | property, read-only | `int get_NumAscii();` |
| `NumCentralEuro` | property, read-only | `int get_NumCentralEuro();` |
| `NumChinese` | property, read-only | `int get_NumChinese();` |
| `NumCyrillic` | property, read-only | `int get_NumCyrillic();` |
| `NumGreek` | property, read-only | `int get_NumGreek();` |
| `NumHebrew` | property, read-only | `int get_NumHebrew();` |
| `NumJapanese` | property, read-only | `int get_NumJapanese();` |
| `NumKorean` | property, read-only | `int get_NumKorean();` |
| `NumLatin` | property, read-only | `int get_NumLatin();` |
| `NumThai` | property, read-only | `int get_NumThai();` |
| `append` | method | `void append(String str);` |
| `appendAnsi` | method | `void appendAnsi(String str);` |
| `appendChar` | method | `void appendChar(byte c);` |
| `appendCurrentDateRfc822` | method | `void appendCurrentDateRfc822();` |
| `appendEnc` | method | `void appendEnc(String str, String charsetEncoding);` |
| `appendInt` | method | `void appendInt(int n);` |
| `appendN` | method | `void appendN(String str, int numBytes);` |
| `appendNU` | method | `void appendNU(byte[] wideStr, int numChars);` |
| `appendRandom` | method | `void appendRandom(int numBytes, String encoding);` |
| `appendStr` | method | `void appendStr(CkString strObj);` |
| `appendU` | method | `void appendU(byte[] unicode);` |
| `appendUtf8` | method | `void appendUtf8(String str);` |
| `base64Decode` | method | `void base64Decode(String charsetEncoding);` |
| `base64Encode` | method | `void base64Encode(String charsetEncoding);` |
| `beginsWith` | method | `boolean beginsWith(String substr);` |
| `beginsWithStr` | method | `boolean beginsWithStr(CkString strObj);` |
| `charAt` | method | `byte charAt(int idx);` |
| `charAtU` | method | `char charAtU(int idx);` |
| `chopAtFirstChar` | method | `void chopAtFirstChar(byte ch);` |
| `chopAtStr` | method | `void chopAtStr(CkString subStrObj);` |
| `clear` | method | `void clear();` |
| `clone` | method | `CkString clone();` |
| `compareStr` | method | `int compareStr(CkString str);` |
| `containsSubstring` | method | `boolean containsSubstring(String substr);` |
| `containsSubstringNoCase` | method | `boolean containsSubstringNoCase(String substr);` |
| `countCharOccurances` | method | `int countCharOccurances(byte ch);` |
| `decodeXMLSpecial` | method | `void decodeXMLSpecial();` |
| `doubleValue` | method | `double doubleValue();` |
| `eliminateChar` | method | `void eliminateChar(byte ansiChar, int startIndex);` |
| `encodeXMLSpecial` | method | `void encodeXMLSpecial();` |
| `endsWith` | method | `boolean endsWith(String substr);` |
| `endsWithStr` | method | `boolean endsWithStr(CkString substrObj);` |
| `entityDecode` | method | `void entityDecode();` |
| `entityEncode` | method | `void entityEncode();` |
| `equals` | method | `boolean equals(String str);` |
| `equalsIgnoreCase` | method | `boolean equalsIgnoreCase(String str);` |
| `equalsIgnoreCaseStr` | method | `boolean equalsIgnoreCaseStr(CkString strObj);` |
| `equalsStr` | method | `boolean equalsStr(CkString strObj);` |
| `getChar` | method | `CkString getChar(int idx);` |
| `getNumChars` | method | `int getNumChars();` |
| `getSizeAnsi` | method | `int getSizeAnsi();` |
| `getSizeUnicode` | method | `int getSizeUnicode();` |
| `getSizeUtf8` | method | `int getSizeUtf8();` |
| `getUnicode` | method | `byte[] getUnicode();` |
| `hexDecode` | method | `void hexDecode(String charsetEncoding);` |
| `hexEncode` | method | `void hexEncode(String charsetEncoding);` |
| `indexOf` | method | `int indexOf(String substr);` |
| `indexOfStr` | method | `int indexOfStr(CkString substrObj);` |
| `intValue` | method | `int intValue();` |
| `isEmpty` | method | `boolean isEmpty();` |
| `lastChar` | method | `byte lastChar();` |
| `loadFile` | method | `boolean loadFile(String path, String charsetEncoding);` |
| `matches` | method | `boolean matches(String strPattern);` |
| `matchesNoCase` | method | `boolean matchesNoCase(String strPattern);` |
| `matchesStr` | method | `boolean matchesStr(CkString strPatternObj);` |
| `minimizeMemory` | method | `void minimizeMemory();` |
| `obfuscate` | method | `void obfuscate();` |
| `prepend` | method | `void prepend(String str);` |
| `punyDecode` | method | `void punyDecode();` |
| `punyEncode` | method | `void punyEncode();` |
| `qpDecode` | method | `void qpDecode(String charsetEncoding);` |
| `qpEncode` | method | `void qpEncode(String charsetEncoding);` |
| `removeAll` | method | `int removeAll(CkString substr);` |
| `removeCharOccurances` | method | `void removeCharOccurances(byte ch);` |
| `removeChunk` | method | `void removeChunk(int charStartPos, int numChars);` |
| `removeDelimited` | method | `void removeDelimited(String beginDelim, String endDelim, boolean caseSensitive);` |
| `removeFirst` | method | `boolean removeFirst(CkString substr);` |
| `replaceAll` | method | `int replaceAll(CkString findStrObj, CkString replaceStrObj);` |
| `replaceAllOccurances` | method | `int replaceAllOccurances(String findStr, String replaceStr);` |
| `replaceChar` | method | `void replaceChar(byte findCh, byte replaceCh);` |
| `replaceFirst` | method | `boolean replaceFirst(CkString findStrObj, CkString replaceStrObj);` |
| `replaceFirstOccurance` | method | `boolean replaceFirstOccurance(String findStr, String replaceStr);` |
| `saveToFile` | method | `boolean saveToFile(String path, String charsetEncoding);` |
| `setStr` | method | `void setStr(CkString s);` |
| `setString` | method | `void setString(String str);` |
| `setStringAnsi` | method | `void setStringAnsi(String s);` |
| `setStringU` | method | `void setStringU(byte[] unicode);` |
| `setStringUtf8` | method | `void setStringUtf8(String s);` |
| `shorten` | method | `void shorten(int n);` |
| `split` | method | `CkStringArray split(byte delimiterChar, boolean exceptDoubleQuoted, boolean exceptEscaped, boolean keepEmpty);` |
| `split2` | method | `CkStringArray split2(String delimiterChars, boolean exceptDoubleQuoted, boolean exceptEscaped, boolean keepEmpty);` |
| `splitAtWS` | method | `CkStringArray splitAtWS();` |
| `substring` | method | `CkString substring(int startCharIndex, int numChars);` |
| `toCRLF` | method | `void toCRLF();` |
| `tokenize` | method | `CkStringArray tokenize(String punctuation);` |
| `toLF` | method | `void toLF();` |
| `toLowerCase` | method | `void toLowerCase();` |
| `toUpperCase` | method | `void toUpperCase();` |
| `trim` | method | `void trim();` |
| `trim2` | method | `void trim2();` |
| `trimInsideSpaces` | method | `void trimInsideSpaces();` |
| `unobfuscate` | method | `void unobfuscate();` |
| `urlDecode` | method | `void urlDecode(String charsetEncoding);` |
| `urlEncode` | method | `void urlEncode(String charsetEncoding);` |

## Properties

### CkString.NumArabic

`Chilkat 11.7.0 · ckjava · CkString · NumArabic · property · read-only · since 9.5.0.25`

```java
int get_NumArabic();
```

The number of Arabic characters contained in this string.

### CkString.NumAscii

`Chilkat 11.7.0 · ckjava · CkString · NumAscii · property · read-only · since 9.5.0.25`

```java
int get_NumAscii();
```

The number of us-ascii characters contained in this string.

### CkString.NumCentralEuro

`Chilkat 11.7.0 · ckjava · CkString · NumCentralEuro · property · read-only · since 9.5.0.25`

```java
int get_NumCentralEuro();
```

The number of Central European and Eastern European characters found in this string. These are characters specific to Polish, Czech, Slovak, Hungarian, Slovene, Croatian, Serbian (Latin script), Romanian and Albanian.

### CkString.NumChinese

`Chilkat 11.7.0 · ckjava · CkString · NumChinese · property · read-only · since 9.5.0.25`

```java
int get_NumChinese();
```

The number of Chinese characters contained in this string.

### CkString.NumCyrillic

`Chilkat 11.7.0 · ckjava · CkString · NumCyrillic · property · read-only · since 9.5.0.25`

```java
int get_NumCyrillic();
```

The number of Cyrillic characters contained in this string. The Cyrillic alphabet also called azbuka, from the old name of the first two letters) is actually a family of alphabets, subsets of which are used by certain East and South Slavic languages `” Belarusian, Bulgarian, Macedonian, Russian, Rusyn, Serbian and Ukrainian`”as well as many other languages of the former Soviet Union, Asia and Eastern Europe.

### CkString.NumGreek

`Chilkat 11.7.0 · ckjava · CkString · NumGreek · property · read-only · since 9.5.0.25`

```java
int get_NumGreek();
```

The number of Greek characters contained in this string.

### CkString.NumHebrew

`Chilkat 11.7.0 · ckjava · CkString · NumHebrew · property · read-only · since 9.5.0.25`

```java
int get_NumHebrew();
```

The number of Hebrew characters contained in this string.

### CkString.NumJapanese

`Chilkat 11.7.0 · ckjava · CkString · NumJapanese · property · read-only · since 9.5.0.25`

```java
int get_NumJapanese();
```

The number of Japanese characters contained in this string.

### CkString.NumKorean

`Chilkat 11.7.0 · ckjava · CkString · NumKorean · property · read-only · since 9.5.0.25`

```java
int get_NumKorean();
```

The number of Korean characters contained in this string.

### CkString.NumLatin

`Chilkat 11.7.0 · ckjava · CkString · NumLatin · property · read-only · since 9.5.0.25`

```java
int get_NumLatin();
```

The number of Latin characters contained in this string. Latin characters include all major Western European languages, such as German, Spanish, French, Italian, Nordic languages, etc.

**Note:** This is the number of chars that are Latin characters that do not fall in the us-ascii range. In other words, the 8bit Latin chars.

### CkString.NumThai

`Chilkat 11.7.0 · ckjava · CkString · NumThai · property · read-only · since 9.5.0.25`

```java
int get_NumThai();
```

The number of Thai characters contained in this string.

## Methods

### CkString.append

`Chilkat 11.7.0 · ckjava · CkString · append · method`

```java
void append(String str);
```

The `str` is appended to end of this instance.

### CkString.appendAnsi

`Chilkat 11.7.0 · ckjava · CkString · appendAnsi · method`

```java
void appendAnsi(String str);
```

Appends an ANSI string to the end of this instance. `str` should always be a null terminated ANSI string regardless of the Utf8 property setting.

### CkString.appendChar

`Chilkat 11.7.0 · ckjava · CkString · appendChar · method`

```java
void appendChar(byte c);
```

Appends a single ANSI character to the end of this instance.

### CkString.appendCurrentDateRfc822

`Chilkat 11.7.0 · ckjava · CkString · appendCurrentDateRfc822 · method`

```java
void appendCurrentDateRfc822();
```

Appends the current date/time to the end of this instance. The date/time is formatted according to the RFC822 standard, which is the typical format used in the `Date` header field of email. For example: `Fri, 27 Jul 2012 17:41:41 -0500`

### CkString.appendEnc

`Chilkat 11.7.0 · ckjava · CkString · appendEnc · method`

```java
void appendEnc(String str, String charsetEncoding);
```

**Full documentation for this method (same in every language):** [Supported Character Encodings](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/charsets_supported_by_chilkat.md)

Appends a string of any character encoding to the end of this instance. Examples of `charsetEncoding` are: Shift_JIS, windows-1255, iso-8859-2, gb2312, etc. The `str` should point to a null-terminated string that uses the charset specified by `charsetEncoding`.

### CkString.appendInt

`Chilkat 11.7.0 · ckjava · CkString · appendInt · method`

```java
void appendInt(int n);
```

Appends the decimal string representation of an integer to the end of this instance.

### CkString.appendN

`Chilkat 11.7.0 · ckjava · CkString · appendN · method`

```java
void appendN(String str, int numBytes);
```

Appends N bytes of character data to the end of this instance. If the Utf8 property is set to `true`, then `str` should point to characters in the utf-8 encoding, otherwise it should point to characters using the ANSI encoding. Note: `numBytes` is not necessarily the number of characters. It is the length, in bytes, of the string to be appended. This method exists to allow for non-null terminated strings to be appended.

### CkString.appendNU

`Chilkat 11.7.0 · ckjava · CkString · appendNU · method`

```java
void appendNU(byte[] wideStr, int numChars);
```

Append N Unicode characters to the end of this instance. The `wideStr` points to the 2-byte per char Unicode string. The `numChars` is the number of Unicode characters to be appended (not the number of bytes).

### CkString.appendRandom

`Chilkat 11.7.0 · ckjava · CkString · appendRandom · method`

```java
void appendRandom(int numBytes, String encoding);
```

Appends `numBytes` random bytes to the end of this instance. Because arbitrary byte values in the range 0 to 255 do not necessarily represent valid characters, the bytes must be encoded to a string friendly representation such as hex, base64, etc. The `encoding` specifies the encoding to be used. Possible values are `hex`, `base64`, `quoted-printable`, `asc`, or `url`.

### CkString.appendStr

`Chilkat 11.7.0 · ckjava · CkString · appendStr · method`

```java
void appendStr(CkString strObj);
```

Appends the contents of `strObj` to the end of this instance.

### CkString.appendU

`Chilkat 11.7.0 · ckjava · CkString · appendU · method`

```java
void appendU(byte[] unicode);
```

Append a Unicode string to the CkString object.

### CkString.appendUtf8

`Chilkat 11.7.0 · ckjava · CkString · appendUtf8 · method`

```java
void appendUtf8(String str);
```

Appends a utf-8 string to the existing contents of this instance. `str` should always be a null terminated utf-8 string regardless of the Utf8 property setting.

### CkString.base64Decode

`Chilkat 11.7.0 · ckjava · CkString · base64Decode · method`

```java
void base64Decode(String charsetEncoding);
```

**Full documentation for this method (same in every language):** [Supported Character Encodings](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/charsets_supported_by_chilkat.md)

In-place base64 decodes the string and inteprets the results according to the character encoding specified.

### CkString.base64Encode

`Chilkat 11.7.0 · ckjava · CkString · base64Encode · method`

```java
void base64Encode(String charsetEncoding);
```

**Full documentation for this method (same in every language):** [Supported Character Encodings](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/charsets_supported_by_chilkat.md)

In-place base64 encodes the string. Internally, the string is first converted to the character encoding specified and then base-64 encoded. Typical `charsetEncoding` values are `utf-8`, `ANSI`, `iso-8859-1`, etc.

### CkString.beginsWith

`Chilkat 11.7.0 · ckjava · CkString · beginsWith · method`

```java
boolean beginsWith(String substr);
```

Return `true` if this string begins with `substr` (case sensitive), otherwise returns `false`.

### CkString.beginsWithStr

`Chilkat 11.7.0 · ckjava · CkString · beginsWithStr · method`

```java
boolean beginsWithStr(CkString strObj);
```

Returns `true` if the string begins with the contents of `strObj`. Otherwise returns `false`. This method is case sensitive.

### CkString.charAt

`Chilkat 11.7.0 · ckjava · CkString · charAt · method`

```java
byte charAt(int idx);
```

Returns the ANSI character at a specified index.The first character is at index 0.

### CkString.charAtU

`Chilkat 11.7.0 · ckjava · CkString · charAtU · method`

```java
char charAtU(int idx);
```

Return the Nth character as a Unicode character.

### CkString.chopAtFirstChar

`Chilkat 11.7.0 · ckjava · CkString · chopAtFirstChar · method`

```java
void chopAtFirstChar(byte ch);
```

Finds the first occurrence of `ch` and discards the characters at and following `ch`.

### CkString.chopAtStr

`Chilkat 11.7.0 · ckjava · CkString · chopAtStr · method`

```java
void chopAtStr(CkString subStrObj);
```

Finds the first occurrence of a substring and chops it at that point. The result is that the substring and all subsequent characters are removed from the string.

### CkString.clear

`Chilkat 11.7.0 · ckjava · CkString · clear · method`

```java
void clear();
```

Clears the string. The string contains 0 characters after calling this method.

### CkString.clone

`Chilkat 11.7.0 · ckjava · CkString · clone · method`

```java
CkString clone();
```

Creates a copy of the string. As with any newly created Chilkat object instance returned by a Chilkat method, the returned CkString object must be deleted by the calling application.

Returns `nil` on failure

### CkString.compareStr

`Chilkat 11.7.0 · ckjava · CkString · compareStr · method`

```java
int compareStr(CkString str);
```

Compare two strings. A return value = 0 means they are equal. Return value = 1 indicates that calling object is lexicographically less than argument. Return value = -1 indicates that calling object is lexicographically greater than argument.

### CkString.containsSubstring

`Chilkat 11.7.0 · ckjava · CkString · containsSubstring · method`

```java
boolean containsSubstring(String substr);
```

Returns `true` if the string contains the specified substring, otherwise returns `false`. The string comparison is case-sensitive.

### CkString.containsSubstringNoCase

`Chilkat 11.7.0 · ckjava · CkString · containsSubstringNoCase · method`

```java
boolean containsSubstringNoCase(String substr);
```

Same as containsSubstring except the matching is case insensitive.

### CkString.countCharOccurances

`Chilkat 11.7.0 · ckjava · CkString · countCharOccurances · method`

```java
int countCharOccurances(byte ch);
```

Returns the number of occurrences of the specified ANSI char.

### CkString.decodeXMLSpecial

`Chilkat 11.7.0 · ckjava · CkString · decodeXMLSpecial · method`

```java
void decodeXMLSpecial();
```

Decodes XML special characters. For example, < is converted to '<'

### CkString.doubleValue

`Chilkat 11.7.0 · ckjava · CkString · doubleValue · method`

```java
double doubleValue();
```

Converts the string to a double and returns the value.

### CkString.eliminateChar

`Chilkat 11.7.0 · ckjava · CkString · eliminateChar · method`

```java
void eliminateChar(byte ansiChar, int startIndex);
```

Eliminate all occurrences of a particular ANSI character.

### CkString.encodeXMLSpecial

`Chilkat 11.7.0 · ckjava · CkString · encodeXMLSpecial · method`

```java
void encodeXMLSpecial();
```

Encodes XML special characters. For example, '<' is converted to <

### CkString.endsWith

`Chilkat 11.7.0 · ckjava · CkString · endsWith · method`

```java
boolean endsWith(String substr);
```

Returns `true` if the string ends with `substr` (case-sensitive). Otherwise returns `false`.

### CkString.endsWithStr

`Chilkat 11.7.0 · ckjava · CkString · endsWithStr · method`

```java
boolean endsWithStr(CkString substrObj);
```

Returns `true` if the string ends with the specified substring, otherwise returns `false`.

### CkString.entityDecode

`Chilkat 11.7.0 · ckjava · CkString · entityDecode · method`

```java
void entityDecode();
```

Decodes any HTML entities found within the string, replacing them with the characters represented.

### CkString.entityEncode

`Chilkat 11.7.0 · ckjava · CkString · entityEncode · method`

```java
void entityEncode();
```

HTML encodes any characters that are special to HTML or cannot be represented by 7-bit us-ascii.

### CkString.equals

`Chilkat 11.7.0 · ckjava · CkString · equals · method`

```java
boolean equals(String str);
```

Returns `true` if the strings are equal, otherwise returns `false`. (case-sensitive)

### CkString.equalsIgnoreCase

`Chilkat 11.7.0 · ckjava · CkString · equalsIgnoreCase · method`

```java
boolean equalsIgnoreCase(String str);
```

Returns `true` if the strings are equal, otherwise returns `false`. (case-insensitive)

### CkString.equalsIgnoreCaseStr

`Chilkat 11.7.0 · ckjava · CkString · equalsIgnoreCaseStr · method`

```java
boolean equalsIgnoreCaseStr(CkString strObj);
```

Returns `true` if the strings are equal, otherwise returns `false` (case-insensitive)

### CkString.equalsStr

`Chilkat 11.7.0 · ckjava · CkString · equalsStr · method`

```java
boolean equalsStr(CkString strObj);
```

Returns `true` if the strings are equal, otherwise returns `false`. (case-sensitive)

### CkString.getChar

`Chilkat 11.7.0 · ckjava · CkString · getChar · method`

```java
CkString getChar(int idx);
```

Returns a new CkString object containing the Nth character. (Note, it does not contain the Nth byte, but the Nth character.) For languages such as Chinese, Japanese, etc. individual characters are represented by multiple or varying number of bytes.

Returns `nil` on failure

### CkString.getNumChars

`Chilkat 11.7.0 · ckjava · CkString · getNumChars · method`

```java
int getNumChars();
```

Returns the number of characters in the string.

### CkString.getSizeAnsi

`Chilkat 11.7.0 · ckjava · CkString · getSizeAnsi · method`

```java
int getSizeAnsi();
```

Returns the size, in bytes, of the ANSI encoding of the string.

### CkString.getSizeUnicode

`Chilkat 11.7.0 · ckjava · CkString · getSizeUnicode · method`

```java
int getSizeUnicode();
```

Returns the size, in bytes, of the Unicode encoding of the string.

### CkString.getSizeUtf8

`Chilkat 11.7.0 · ckjava · CkString · getSizeUtf8 · method`

```java
int getSizeUtf8();
```

Returns the size, in bytes, of the utf-8 encoding of the string.

### CkString.getUnicode

`Chilkat 11.7.0 · ckjava · CkString · getUnicode · method`

```java
byte[] getUnicode();
```

Return a pointer to memory containing the string in Unicode.

### CkString.hexDecode

`Chilkat 11.7.0 · ckjava · CkString · hexDecode · method`

```java
void hexDecode(String charsetEncoding);
```

**Full documentation for this method (same in every language):** [Supported Character Encodings](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/charsets_supported_by_chilkat.md)

Hex decodes a string and inteprets the bytes according to the character encoding specified.

### CkString.hexEncode

`Chilkat 11.7.0 · ckjava · CkString · hexEncode · method`

```java
void hexEncode(String charsetEncoding);
```

**Full documentation for this method (same in every language):** [Supported Character Encodings](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/charsets_supported_by_chilkat.md)

Converts the string to the character encoding specified and replaces the string contents with the hex encoding of the character data.

### CkString.indexOf

`Chilkat 11.7.0 · ckjava · CkString · indexOf · method`

```java
int indexOf(String substr);
```

Returns the index of the first occurrence of a substring. Returns -1 if not found.

### CkString.indexOfStr

`Chilkat 11.7.0 · ckjava · CkString · indexOfStr · method`

```java
int indexOfStr(CkString substrObj);
```

Returns the index of the first occurrence of a substring. Returns -1 if not found.

### CkString.intValue

`Chilkat 11.7.0 · ckjava · CkString · intValue · method`

```java
int intValue();
```

Converts the string to an integer and returns the integer value.

### CkString.isEmpty

`Chilkat 11.7.0 · ckjava · CkString · isEmpty · method`

```java
boolean isEmpty();
```

Returns `true` if the string object is empty, otherwise returns `false`.

### CkString.lastChar

`Chilkat 11.7.0 · ckjava · CkString · lastChar · method`

```java
byte lastChar();
```

Returns the last ANSI character in the string.

### CkString.loadFile

`Chilkat 11.7.0 · ckjava · CkString · loadFile · method`

```java
boolean loadFile(String path, String charsetEncoding);
```

**Full documentation for this method (same in every language):** [Supported Character Encodings](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/charsets_supported_by_chilkat.md)

Load the contents of a text file into the CkString object. The string is cleared before loading. The character encoding of the text file is specified by `charsetEncoding`. This method allows for text files in any charset to be loaded: utf-8, Unicode, Shift_JIS, iso-8859-1, etc.

Returns true for success, false for failure.

### CkString.matches

`Chilkat 11.7.0 · ckjava · CkString · matches · method`

```java
boolean matches(String strPattern);
```

Returns `true` if the string matches the `strPattern`, which may contain one or more asterisk wildcard characters. Returns `false` if the string does not match. This method is case-sensitive.

### CkString.matchesNoCase

`Chilkat 11.7.0 · ckjava · CkString · matchesNoCase · method`

```java
boolean matchesNoCase(String strPattern);
```

Returns `true` if the string matches the `strPattern`, which may contain one or more asterisk wildcard characters. Returns `false` if the string does not match. This method is case-insensitive.

### CkString.matchesStr

`Chilkat 11.7.0 · ckjava · CkString · matchesStr · method`

```java
boolean matchesStr(CkString strPatternObj);
```

Returns `true` if the string matches a pattern, otherwise returns `false`. The pattern may contain any number of wildcard '\*' characters which represent 0 or more occurrences of any character. This method is case-sensitive.

### CkString.minimizeMemory

`Chilkat 11.7.0 · ckjava · CkString · minimizeMemory · method`

```java
void minimizeMemory();
```

Minimizes the amount of memory consumed by this object. For example, consider the following: A CkString object is loaded with the contents of a text file. The `replaceAllOccurances` method is called, replacing longer substrings with shorter replacements. The actual string length will become shorter than the internal buffer space that is allocated. The minimizeMemory method will, if necessary, allocate a new internal buffer that is exactly the size needed to hold the current contents of the string, copy the string to the new internal buffer, and deallocate the old buffer.

### CkString.obfuscate

`Chilkat 11.7.0 · ckjava · CkString · obfuscate · method`

```java
void obfuscate();
```

Obfuscates the string. (The unobfuscate method can be called to reverse the obfuscation to restore the original string.)

The Chilkat string obfuscation algorithm works by taking the utf-8 bytes of the string, base64 encoding it, and then scrambling the letters of the base64 encoded string. It is deterministic in that the same string will always obfuscate to the same result. It is not a secure way of encrypting a string. It is only meant to be a simple means of transforming a string into something unintelligible.

### CkString.prepend

`Chilkat 11.7.0 · ckjava · CkString · prepend · method`

```java
void prepend(String str);
```

Prepends `str` to this instance.

### CkString.punyDecode

`Chilkat 11.7.0 · ckjava · CkString · punyDecode · method · since 9.5.0.52`

```java
void punyDecode();
```

In-place decodes the string from punycode.

### CkString.punyEncode

`Chilkat 11.7.0 · ckjava · CkString · punyEncode · method · since 9.5.0.52`

```java
void punyEncode();
```

In-place encodes the string to punycode.

### CkString.qpDecode

`Chilkat 11.7.0 · ckjava · CkString · qpDecode · method`

```java
void qpDecode(String charsetEncoding);
```

**Full documentation for this method (same in every language):** [Supported Character Encodings](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/charsets_supported_by_chilkat.md)

Quoted-printable decodes the string and interprets the resulting character data according to the specified character encoding. The result is that the quoted-printable string is in-place decoded.

### CkString.qpEncode

`Chilkat 11.7.0 · ckjava · CkString · qpEncode · method`

```java
void qpEncode(String charsetEncoding);
```

**Full documentation for this method (same in every language):** [Supported Character Encodings](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/charsets_supported_by_chilkat.md)

Quoted-printable encodes the string. The string is first converted to the charset specified, and those bytes are QP-encoded. The contents of the string are replaced with the QP-encoded result.

### CkString.removeAll

`Chilkat 11.7.0 · ckjava · CkString · removeAll · method`

```java
int removeAll(CkString substr);
```

Removes all occurrences of `substr`.

### CkString.removeCharOccurances

`Chilkat 11.7.0 · ckjava · CkString · removeCharOccurances · method`

```java
void removeCharOccurances(byte ch);
```

Removes all occurrences of a specific ANSI character from the string.

### CkString.removeChunk

`Chilkat 11.7.0 · ckjava · CkString · removeChunk · method`

```java
void removeChunk(int charStartPos, int numChars);
```

Removes a chunk of characters specified by starting index and length.

### CkString.removeDelimited

`Chilkat 11.7.0 · ckjava · CkString · removeDelimited · method · since 9.5.0.52`

```java
void removeDelimited(String beginDelim, String endDelim, boolean caseSensitive);
```

Remove all occurrences of strings delimited by `beginDelim` and `endDelim`. Also removes the delimiters.

### CkString.removeFirst

`Chilkat 11.7.0 · ckjava · CkString · removeFirst · method`

```java
boolean removeFirst(CkString substr);
```

Removes the first occurrence of a substring.

### CkString.replaceAll

`Chilkat 11.7.0 · ckjava · CkString · replaceAll · method`

```java
int replaceAll(CkString findStrObj, CkString replaceStrObj);
```

Replaces all occurrences of a substring with another. The replacement string is allowed to be empty or different in length.

### CkString.replaceAllOccurances

`Chilkat 11.7.0 · ckjava · CkString · replaceAllOccurances · method`

```java
int replaceAllOccurances(String findStr, String replaceStr);
```

Replaces all occurrences of a substring with another substring. The replacement string is allowed to be empty or different in length.

### CkString.replaceChar

`Chilkat 11.7.0 · ckjava · CkString · replaceChar · method`

```java
void replaceChar(byte findCh, byte replaceCh);
```

Replaces all occurrences of a specified ANSI character with another.

### CkString.replaceFirst

`Chilkat 11.7.0 · ckjava · CkString · replaceFirst · method`

```java
boolean replaceFirst(CkString findStrObj, CkString replaceStrObj);
```

Replaces the first occurrence of a substring with another. The replacement string is allowed to be empty or different in length.

### CkString.replaceFirstOccurance

`Chilkat 11.7.0 · ckjava · CkString · replaceFirstOccurance · method`

```java
boolean replaceFirstOccurance(String findStr, String replaceStr);
```

Replaces the first occurrence of a substring with another. The replacement string is allowed to be empty or different in length. (Chilkat is aware of the misspelling of the word `occurrence`, but unfortunately it is too late to change..)

### CkString.saveToFile

`Chilkat 11.7.0 · ckjava · CkString · saveToFile · method`

```java
boolean saveToFile(String path, String charsetEncoding);
```

**Full documentation for this method (same in every language):** [Supported Character Encodings](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/charsets_supported_by_chilkat.md)

Saves the string to a file using the character encoding specified by `charsetEncoding`. If a file of the same name exists, it is overwritten. For charsets such as `utf-8`, `utf-16`, or others that have a possible BOM/preamble, the preamble is output by default. To exclude the BOM/preamble, prepend `no-bom-` to the charset name. For example `no-bom-utf-8`.

Returns true for success, false for failure.

### CkString.setStr

`Chilkat 11.7.0 · ckjava · CkString · setStr · method`

```java
void setStr(CkString s);
```

Replaces the contents of the string with another.

### CkString.setString

`Chilkat 11.7.0 · ckjava · CkString · setString · method`

```java
void setString(String str);
```

Clears the contents of this instance and appends `str`.

### CkString.setStringAnsi

`Chilkat 11.7.0 · ckjava · CkString · setStringAnsi · method`

```java
void setStringAnsi(String s);
```

Set the CkString object from an ANSI string.

### CkString.setStringU

`Chilkat 11.7.0 · ckjava · CkString · setStringU · method`

```java
void setStringU(byte[] unicode);
```

Set the CkString object from a Unicode string.

### CkString.setStringUtf8

`Chilkat 11.7.0 · ckjava · CkString · setStringUtf8 · method`

```java
void setStringUtf8(String s);
```

Set the string object from a utf-8 string.

### CkString.shorten

`Chilkat 11.7.0 · ckjava · CkString · shorten · method`

```java
void shorten(int n);
```

Discards the last N characters.

### CkString.split

`Chilkat 11.7.0 · ckjava · CkString · split · method`

```java
CkStringArray split(byte delimiterChar, boolean exceptDoubleQuoted, boolean exceptEscaped, boolean keepEmpty);
```

Splits a string into a collection of strings using a delimiter character. If `exceptEscaped` is `true`, then delimiter chars escaped with a backslash are ignored. If `exceptDoubleQuoted` is `true`, then delimiter chars inside quotes are ignored. If `keepEmpty` is `false`, then empty strings are excluded from being added to the returned CkStringArray object.

Returns `nil` on failure

### CkString.split2

`Chilkat 11.7.0 · ckjava · CkString · split2 · method`

```java
CkStringArray split2(String delimiterChars, boolean exceptDoubleQuoted, boolean exceptEscaped, boolean keepEmpty);
```

Same as `split`, except a set of characters can be used for delimiters.

Returns `nil` on failure

### CkString.splitAtWS

`Chilkat 11.7.0 · ckjava · CkString · splitAtWS · method`

```java
CkStringArray splitAtWS();
```

Equivalent to split2(`\t\r\n`,true,true,false)

Returns `nil` on failure

### CkString.substring

`Chilkat 11.7.0 · ckjava · CkString · substring · method`

```java
CkString substring(int startCharIndex, int numChars);
```

Returns a substring specified by starting character position and number of characters. (The 1st char is at index 0.)

Returns `nil` on failure

### CkString.toCRLF

`Chilkat 11.7.0 · ckjava · CkString · toCRLF · method`

```java
void toCRLF();
```

Converts all line endings to CRLF.

### CkString.tokenize

`Chilkat 11.7.0 · ckjava · CkString · tokenize · method`

```java
CkStringArray tokenize(String punctuation);
```

Tokenizes a string. The string is split at whitespace characters, and any single punctuation character is returned as a separate token. For example, this string:  
CkStringArray \*CkString::tokenize(char \*punctuation) const  

is tokenized to  

CkStringArray  
\*  
CkString  
:  
:  
tokenize  
(  
\*  
punctuation  
)  
const

Returns `nil` on failure

### CkString.toLF

`Chilkat 11.7.0 · ckjava · CkString · toLF · method`

```java
void toLF();
```

Converts all line endings to bare-LF (Unix/Linux style line endings).

### CkString.toLowerCase

`Chilkat 11.7.0 · ckjava · CkString · toLowerCase · method`

```java
void toLowerCase();
```

Converts the string to lowercase.

### CkString.toUpperCase

`Chilkat 11.7.0 · ckjava · CkString · toUpperCase · method`

```java
void toUpperCase();
```

Converts the string to uppercase.

### CkString.trim

`Chilkat 11.7.0 · ckjava · CkString · trim · method`

```java
void trim();
```

Trim SPACE and Tab characters from both ends of the string.

### CkString.trim2

`Chilkat 11.7.0 · ckjava · CkString · trim2 · method`

```java
void trim2();
```

Trim SPACE, Tab, CR, and LF characters from both ends of the string.

### CkString.trimInsideSpaces

`Chilkat 11.7.0 · ckjava · CkString · trimInsideSpaces · method`

```java
void trimInsideSpaces();
```

Replaces all tabs, CR's, and LF's, with SPACE chars, and removes extra SPACE's so there are no occurrences of more than one SPACE char in a row.

### CkString.unobfuscate

`Chilkat 11.7.0 · ckjava · CkString · unobfuscate · method`

```java
void unobfuscate();
```

Unobfuscates the string.

The Chilkat string obfuscation algorithm works by taking the utf-8 bytes of the string, base64 encoding it, and then scrambling the letters of the base64 encoded string. It is deterministic in that the same string will always obfuscate to the same result. It is not a secure way of encrypting a string. It is only meant to be a simple means of transforming a string into something unintelligible.

### CkString.urlDecode

`Chilkat 11.7.0 · ckjava · CkString · urlDecode · method`

```java
void urlDecode(String charsetEncoding);
```

**Full documentation for this method (same in every language):** [Supported Character Encodings](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/charsets_supported_by_chilkat.md)

URL decodes the string and interprets the resulting byte data in the specified charset encoding.

### CkString.urlEncode

`Chilkat 11.7.0 · ckjava · CkString · urlEncode · method`

```java
void urlEncode(String charsetEncoding);
```

**Full documentation for this method (same in every language):** [Supported Character Encodings](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/charsets_supported_by_chilkat.md)

URL encodes the string. The string is first converted to the specified charset encoding, and those bytes are URL-encoded. The contents of the string are replaced with the URL-encoded result.

## Related classes

[`StringArray`](https://www.chilkatsoft.com/ai-docs/v/11.7.0/ckjava/classes/StringArray.md)

