---
product: Chilkat
product_version: 11.7.0
language: objc
language_label: Objective-C
class: StringTable
class_name: CkoStringTable
license: free
deprecated: false
reference_html: https://www.chilkatsoft.com/refdoc/objcCkoStringTableRef.html
---
# Chilkat StringTable — Objective-C — v11.7.0

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

## Purpose

**Store, load, search, sort, split, retrieve, and save ordered lists of strings.**

`Chilkat.StringTable` is a simple ordered collection of strings. It can append strings directly, load one string per line from files or `StringBuilder`, search for substrings or wildcard matches, sort the collection, split strings into entries, retrieve strings by index, export the table as line-delimited text, and save the result to a file.

**Ordered string collection**

Store a list of strings in insertion order and retrieve individual entries by zero-based index.

**Append and import**

Add strings directly, append strings from a file, or load line-delimited text from a `StringBuilder`.

**Search strings**

Find entries containing a substring or matching a wildcard pattern when filtering or locating text values.

**Sort entries**

Sort the string collection when deterministic ordering or user-facing display order is needed.

**Split into entries**

Split delimited text into separate string-table entries for easier indexing, searching, sorting, or saving.

**Export and save**

Convert the table back to line-delimited text, copy it to a `StringBuilder`, or save the collection to a file.

**Common pattern:** Use `StringTable` when application code needs a lightweight ordered list of text values. Append or load the strings, search or sort as needed, retrieve entries by index with `StringAt` or `StringAtSb`, then export the final list as line-delimited text or save it to a file.

For an extended overview, see [StringTable Class Overview](https://www.chilkatsoft.com/stringtable_class_overview.asp).

## Object creation, unlocking and error handling

**Object Creation**

```objectivec
CkoStringTable *obj = [[CkoStringTable alloc] init];
```

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 Objective-C.

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.

## Members common to every Chilkat class

Documented once per language in `common-members.md`; listed here so this page is self-contained.

| Property | Signature | Access | Meaning |
|---|---|---|---|
| `DebugLogFilePath` | `@property (nonatomic, copy) NSString *DebugLogFilePath;` | read/write | If set to a file path, this property logs the LastErrorText of each Chilkat method or property call to the specified file. |
| `LastErrorHtml` | `@property (nonatomic, readonly, copy) NSString *LastErrorHtml;` | read-only | Provides HTML-formatted information about the last called method or property. |
| `LastErrorText` | `@property (nonatomic, readonly, copy) NSString *LastErrorText;` | read-only | Provides plain text information about the last called method or property. |
| `LastErrorXml` | `@property (nonatomic, readonly, copy) NSString *LastErrorXml;` | read-only | Provides XML-formatted information about the last called method or property. |
| `LastMethodSuccess` | `@property (nonatomic) BOOL LastMethodSuccess;` | read/write | Indicates the success or failure of the most recent method call: `YES` means success, `NO` means failure. |
| `VerboseLogging` | `@property (nonatomic) BOOL VerboseLogging;` | read/write | If set to `YES`, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may contain more verbose information. |
| `Version` | `@property (nonatomic, readonly, copy) NSString *Version;` | read-only | Version of the component/library, such as "10.1.0" |

## Member index

| Member | Kind | Signature |
|---|---|---|
| `Count` | property, read-only | `@property (nonatomic, readonly, copy) NSNumber *Count;` |
| `Append` | method | `- (BOOL)Append:(NSString *)value;` |
| `AppendFromFile` | method | `- (BOOL)AppendFromFile:(NSNumber *)maxLineLen     charset:(NSString *)charset     path:(NSString *)path;` |
| `AppendFromSb` | method | `- (BOOL)AppendFromSb:(CkoStringBuilder *)sb;` |
| `Clear` | method | `- (void)Clear;` |
| `FindMatch` | method | `- (NSNumber *)FindMatch:(CkoStringBuilder *)sb     caseSensitive:(BOOL)caseSensitive;` |
| `FindSubstring` | method | `- (NSNumber *)FindSubstring:(NSNumber *)startIndex     substr:(NSString *)substr     caseSensitive:(BOOL)caseSensitive;` |
| `GetStrings` | method | `- (NSString *)GetStrings:(NSNumber *)startIdx     count:(NSNumber *)count     crlf:(BOOL)crlf;` |
| `IntAt` | method | `- (NSNumber *)IntAt:(NSNumber *)index;` |
| `SaveToFile` | method | `- (BOOL)SaveToFile:(NSString *)charset     bCrlf:(BOOL)bCrlf     path:(NSString *)path;` |
| `Sort` | method | `- (BOOL)Sort:(BOOL)ascending     caseSensitive:(BOOL)caseSensitive;` |
| `SplitAndAppend` | method | `- (BOOL)SplitAndAppend:(NSString *)inStr     delimiterChar:(NSString *)delimiterChar     exceptDoubleQuoted:(BOOL)exceptDoubleQuoted     exceptEscaped:(BOOL)exceptEscaped;` |
| `StringAt` | method | `- (NSString *)StringAt:(NSNumber *)index;` |
| `StringAtSb` | method | `- (BOOL)StringAtSb:(NSNumber *)index     sb:(CkoStringBuilder *)sb;` |
| `ToSb` | method | `- (BOOL)ToSb:(CkoStringBuilder *)sb;` |
| `WordFollowing` | method | `- (NSNumber *)WordFollowing:(CkoStringBuilder *)sb     captureEmailAddr:(BOOL)captureEmailAddr     sbWord:(CkoStringBuilder *)sbWord;` |

## Properties

### StringTable.Count

`Chilkat 11.7.0 · objc · StringTable · Count · property · read-only · since 9.5.0.62`

```objectivec
@property (nonatomic, readonly, copy) NSNumber *Count;
```

The number of strings in the table.

## Methods

### StringTable.Append

`Chilkat 11.7.0 · objc · StringTable · Append · method · since 9.5.0.62`

```objectivec
- (BOOL)Append:(NSString *)value;
```

Appends a string to the table.

Returns YES for success, NO for failure.

### StringTable.AppendFromFile

`Chilkat 11.7.0 · objc · StringTable · AppendFromFile · method · since 9.5.0.62`

```objectivec
- (BOOL)AppendFromFile:(NSNumber *)maxLineLen 
    charset:(NSString *)charset 
    path:(NSString *)path;
```

Appends strings, one per line, from a file. Each line in the `path` should be no longer than the length specified in `maxLineLen`. The `charset` indicates the character encoding of the contents of the file, such as `utf-8`, `iso-8859-1`, `Shift_JIS`, etc.

Returns YES for success, NO for failure.

### StringTable.AppendFromSb

`Chilkat 11.7.0 · objc · StringTable · AppendFromSb · method · since 9.5.0.62`

```objectivec
- (BOOL)AppendFromSb:(CkoStringBuilder *)sb;
```

Appends strings, one per line, from the contents of a StringBuilder object.

Returns YES for success, NO for failure.

### StringTable.Clear

`Chilkat 11.7.0 · objc · StringTable · Clear · method · since 9.5.0.62`

```objectivec
- (void)Clear;
```

Removes all the strings from the table.

### StringTable.FindMatch

`Chilkat 11.7.0 · objc · StringTable · FindMatch · method · since 11.1.0`

```objectivec
- (NSNumber *)FindMatch:(CkoStringBuilder *)sb 
    caseSensitive:(BOOL)caseSensitive;
```

This string table object holds strings with wildcards. The method returns the index of the wildcarded string that matches the text in `sb`, or -1 if no match is found. `caseSensitive` specifies whether the matching should be case-sensitive.

### StringTable.FindSubstring

`Chilkat 11.7.0 · objc · StringTable · FindSubstring · method · since 9.5.0.77`

```objectivec
- (NSNumber *)FindSubstring:(NSNumber *)startIndex 
    substr:(NSString *)substr 
    caseSensitive:(BOOL)caseSensitive;
```

Return the index of the first string in the table containing `substr`. Begins searching strings starting at `startIndex`. If `caseSensitive` is `YES`, then the search is case sensitive. If `caseSensitive` is `NO` then the search is case insensitive. Returns -1 if the `substr` is not found.

### StringTable.GetStrings

`Chilkat 11.7.0 · objc · StringTable · GetStrings · method · since 9.5.0.87`

```objectivec
- (NSString *)GetStrings:(NSNumber *)startIdx 
    count:(NSNumber *)count 
    crlf:(BOOL)crlf;
```

Return the number of strings specified by `count`, one per line, starting at `startIdx`. To return the entire table, pass 0 values for both `startIdx` and `count`. Set `crlf` equal to `YES` to emit with CRLF line endings, or `NO` to emit LF-only line endings. The last string is emitted includes the line ending.

Returns `nil` on failure

### StringTable.IntAt

`Chilkat 11.7.0 · objc · StringTable · IntAt · method · since 9.5.0.63`

```objectivec
- (NSNumber *)IntAt:(NSNumber *)index;
```

Returns the Nth string in the table, converted to an integer value. The `index` is 0-based. (The first string is at index 0.) Returns -1 if no string is found at the specified index. Returns 0 if the string at the specified index exist, but is not an integer.

### StringTable.SaveToFile

`Chilkat 11.7.0 · objc · StringTable · SaveToFile · method · since 9.5.0.62`

```objectivec
- (BOOL)SaveToFile:(NSString *)charset 
    bCrlf:(BOOL)bCrlf 
    path:(NSString *)path;
```

Saves the string table to a file. The `charset` is the character encoding to use, such as `utf-8`, `iso-8859-1`, `windows-1252`, `Shift_JIS`, `gb2312`, etc. If `bCrlf` is `YES`, then CRLF line endings are used, otherwise LF-only line endings are used.

Returns YES for success, NO for failure.

### StringTable.Sort

`Chilkat 11.7.0 · objc · StringTable · Sort · method · since 9.5.0.87`

```objectivec
- (BOOL)Sort:(BOOL)ascending 
    caseSensitive:(BOOL)caseSensitive;
```

Sorts the strings in the collection in ascending or descending order. To sort in ascending order, set `ascending` to `YES`, otherwise set `ascending` equal to `NO`.

Returns YES for success, NO for failure.

### StringTable.SplitAndAppend

`Chilkat 11.7.0 · objc · StringTable · SplitAndAppend · method · since 9.5.0.62`

```objectivec
- (BOOL)SplitAndAppend:(NSString *)inStr 
    delimiterChar:(NSString *)delimiterChar 
    exceptDoubleQuoted:(BOOL)exceptDoubleQuoted 
    exceptEscaped:(BOOL)exceptEscaped;
```

Splits a string into parts based on a single character `delimiterChar`. If `exceptDoubleQuoted` is `YES`, then the delimiter char found between double quotes is not treated as a delimiter. If `exceptEscaped` is `YES`, then an escaped (with a backslash) delimiter char is not treated as a delimiter.

Returns YES for success, NO for failure.

### StringTable.StringAt

`Chilkat 11.7.0 · objc · StringTable · StringAt · method · since 9.5.0.62`

```objectivec
- (NSString *)StringAt:(NSNumber *)index;
```

Returns the Nth string in the table. The `index` is 0-based. (The first string is at index 0.)

Returns `nil` on failure

### StringTable.StringAtSb

`Chilkat 11.7.0 · objc · StringTable · StringAtSb · method · since 11.2.0`

```objectivec
- (BOOL)StringAtSb:(NSNumber *)index 
    sb:(CkoStringBuilder *)sb;
```

Appends the Nth string in the table to `sb`. The `index` is 0-based. (The first string is at index 0.)

Returns YES for success, NO for failure.

### StringTable.ToSb

`Chilkat 11.7.0 · objc · StringTable · ToSb · method · since 11.3.0`

```objectivec
- (BOOL)ToSb:(CkoStringBuilder *)sb;
```

Appends the entire string table to `sb` using CRLF line endings.

Returns YES for success, NO for failure.

### StringTable.WordFollowing

`Chilkat 11.7.0 · objc · StringTable · WordFollowing · method · since 11.1.0`

```objectivec
- (NSNumber *)WordFollowing:(CkoStringBuilder *)sb 
    captureEmailAddr:(BOOL)captureEmailAddr 
    sbWord:(CkoStringBuilder *)sbWord;
```

The method performs a case-insensitive search to return the index of a table entry matching `sb`, or -1 if there is no match. Set `captureEmailAddr` to `YES` if the target word is expected to be an email address, otherwise set `captureEmailAddr` to `NO`. `sbWord` will receive the word (email address) following the matched text. This method helps replace the outdated Chilkat Bounce class, which was used for identifying and categorizing bounced email types.

## Related classes

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

