---
product: Chilkat
product_version: 11.7.0
language: delphidll
language_label: Delphi DLL
class: StringTable
license: free
deprecated: false
reference_html: https://www.chilkatsoft.com/refdoc/dd_CkStringTableRef.html
---
# Chilkat StringTable — Delphi DLL — v11.7.0

> Chilkat 11.7.0 · language=delphidll · class=StringTable
> 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/delphidll/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

**Create/Dispose**

```pascal
var
myObject: HCkStringTable;

begin
myObject := CkStringTable_Create();

// ...

CkStringTable_Dispose(myObject);
end;
```

`function CkStringTable_Create: HCkStringTable; stdcall;`

Creates an instance of the HCkStringTable object and returns a handle (i.e. a Pointer). The handle is passed in the 1st argument for the functions listed on this page.

`procedure CkStringTable_Dispose(handle: HCkStringTable); stdcall;`

Objects created by calling CkStringTable_Create must be freed by calling this method. A memory leak occurs if a handle is not disposed by calling this function.

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 Delphi DLL.

## 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` | `procedure CkStringTable_getDebugLogFilePath(objHandle: HCkStringTable; outPropVal: HCkString); stdcall; procedure CkStringTable_putDebugLogFilePath(objHandle: HCkStringTable; newPropVal: PWideChar); stdcall; function CkStringTable__debugLogFilePath(objHandle: HCkStringTable): PWideChar; stdcall;` | 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` | `procedure CkStringTable_getLastErrorHtml(objHandle: HCkStringTable; outPropVal: HCkString); stdcall; function CkStringTable__lastErrorHtml(objHandle: HCkStringTable): PWideChar; stdcall;` | read-only | Provides HTML-formatted information about the last called method or property. |
| `LastErrorText` | `procedure CkStringTable_getLastErrorText(objHandle: HCkStringTable; outPropVal: HCkString); stdcall; function CkStringTable__lastErrorText(objHandle: HCkStringTable): PWideChar; stdcall;` | read-only | Provides plain text information about the last called method or property. |
| `LastErrorXml` | `procedure CkStringTable_getLastErrorXml(objHandle: HCkStringTable; outPropVal: HCkString); stdcall; function CkStringTable__lastErrorXml(objHandle: HCkStringTable): PWideChar; stdcall;` | read-only | Provides XML-formatted information about the last called method or property. |
| `LastMethodSuccess` | `function CkStringTable_getLastMethodSuccess(objHandle: HCkStringTable): wordbool; stdcall; procedure CkStringTable_putLastMethodSuccess(objHandle: HCkStringTable; newPropVal: wordbool); stdcall;` | read/write | Indicates the success or failure of the most recent method call: `True` means success, `False` means failure. |
| `VerboseLogging` | `function CkStringTable_getVerboseLogging(objHandle: HCkStringTable): wordbool; stdcall; procedure CkStringTable_putVerboseLogging(objHandle: HCkStringTable; newPropVal: wordbool); stdcall;` | read/write | If set to `True`, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may contain more verbose information. |
| `Version` | `procedure CkStringTable_getVersion(objHandle: HCkStringTable; outPropVal: HCkString); stdcall; function CkStringTable__version(objHandle: HCkStringTable): PWideChar; stdcall;` | read-only | Version of the component/library, such as "10.1.0" |

## Member index

| Member | Kind | Signature |
|---|---|---|
| `Count` | property, read-only | `function CkStringTable_getCount(objHandle: HCkStringTable): Integer; stdcall;` |
| `Append` | method | `function CkStringTable_Append(objHandle: HCkStringTable;     value: PWideChar): wordbool; stdcall;` |
| `AppendFromFile` | method | `function CkStringTable_AppendFromFile(objHandle: HCkStringTable;     maxLineLen: Integer;     charset: PWideChar;     path: PWideChar): wordbool; stdcall;` |
| `AppendFromSb` | method | `function CkStringTable_AppendFromSb(objHandle: HCkStringTable;     sb: HCkStringBuilder): wordbool; stdcall;` |
| `Clear` | method | `procedure CkStringTable_Clear(objHandle: HCkStringTable) stdcall;` |
| `FindMatch` | method | `function CkStringTable_FindMatch(objHandle: HCkStringTable;     sb: HCkStringBuilder;     caseSensitive: wordbool): Integer; stdcall;` |
| `FindSubstring` | method | `function CkStringTable_FindSubstring(objHandle: HCkStringTable;     startIndex: Integer;     substr: PWideChar;     caseSensitive: wordbool): Integer; stdcall;` |
| `GetStrings` | method | `function CkStringTable_GetStrings(objHandle: HCkStringTable;     startIdx: Integer;     count: Integer;     crlf: wordbool;     outStr: HCkString): wordbool; stdcall; function CkStringTable__getStrings(objHandle: HCkStringTable;     startIdx: Integer;     count: Integer;     crlf: wordbool): PWideChar; stdcall;` |
| `IntAt` | method | `function CkStringTable_IntAt(objHandle: HCkStringTable;     index: Integer): Integer; stdcall;` |
| `SaveToFile` | method | `function CkStringTable_SaveToFile(objHandle: HCkStringTable;     charset: PWideChar;     bCrlf: wordbool;     path: PWideChar): wordbool; stdcall;` |
| `Sort` | method | `function CkStringTable_Sort(objHandle: HCkStringTable;     ascending: wordbool;     caseSensitive: wordbool): wordbool; stdcall;` |
| `SplitAndAppend` | method | `function CkStringTable_SplitAndAppend(objHandle: HCkStringTable;     inStr: PWideChar;     delimiterChar: PWideChar;     exceptDoubleQuoted: wordbool;     exceptEscaped: wordbool): wordbool; stdcall;` |
| `StringAt` | method | `function CkStringTable_StringAt(objHandle: HCkStringTable;     index: Integer;     outStr: HCkString): wordbool; stdcall; function CkStringTable__stringAt(objHandle: HCkStringTable;     index: Integer): PWideChar; stdcall;` |
| `StringAtSb` | method | `function CkStringTable_StringAtSb(objHandle: HCkStringTable;     index: Integer;     sb: HCkStringBuilder): wordbool; stdcall;` |
| `ToSb` | method | `function CkStringTable_ToSb(objHandle: HCkStringTable;     sb: HCkStringBuilder): wordbool; stdcall;` |
| `WordFollowing` | method | `function CkStringTable_WordFollowing(objHandle: HCkStringTable;     sb: HCkStringBuilder;     captureEmailAddr: wordbool;     sbWord: HCkStringBuilder): Integer; stdcall;` |

## Properties

### StringTable.Count

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

```pascal
function CkStringTable_getCount(objHandle: HCkStringTable): Integer; stdcall;
```

The number of strings in the table.

## Methods

### StringTable.Append

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

```pascal
function CkStringTable_Append(objHandle: HCkStringTable;
    value: PWideChar): wordbool; stdcall;
```

Appends a string to the table.

Returns True for success, False for failure.

### StringTable.AppendFromFile

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

```pascal
function CkStringTable_AppendFromFile(objHandle: HCkStringTable;
    maxLineLen: Integer;
    charset: PWideChar;
    path: PWideChar): wordbool; stdcall;
```

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 True for success, False for failure.

### StringTable.AppendFromSb

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

```pascal
function CkStringTable_AppendFromSb(objHandle: HCkStringTable;
    sb: HCkStringBuilder): wordbool; stdcall;
```

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

Returns True for success, False for failure.

### StringTable.Clear

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

```pascal
procedure CkStringTable_Clear(objHandle: HCkStringTable) stdcall;
```

Removes all the strings from the table.

### StringTable.FindMatch

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

```pascal
function CkStringTable_FindMatch(objHandle: HCkStringTable;
    sb: HCkStringBuilder;
    caseSensitive: wordbool): Integer; stdcall;
```

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 · delphidll · StringTable · FindSubstring · method · since 9.5.0.77`

```pascal
function CkStringTable_FindSubstring(objHandle: HCkStringTable;
    startIndex: Integer;
    substr: PWideChar;
    caseSensitive: wordbool): Integer; stdcall;
```

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

### StringTable.GetStrings

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

```pascal
function CkStringTable_GetStrings(objHandle: HCkStringTable;
    startIdx: Integer;
    count: Integer;
    crlf: wordbool;
    outStr: HCkString): wordbool; stdcall;
function CkStringTable__getStrings(objHandle: HCkStringTable;
    startIdx: Integer;
    count: Integer;
    crlf: wordbool): PWideChar; stdcall;
```

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 `True` to emit with CRLF line endings, or `False` to emit LF-only line endings. The last string is emitted includes the line ending.

Returns True for success, False for failure.

See the notes about [PWideChar memory ownership and validity](https://www.chilkatsoft.com/delphi_pwidechar.asp).

### StringTable.IntAt

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

```pascal
function CkStringTable_IntAt(objHandle: HCkStringTable;
    index: Integer): Integer; stdcall;
```

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 · delphidll · StringTable · SaveToFile · method · since 9.5.0.62`

```pascal
function CkStringTable_SaveToFile(objHandle: HCkStringTable;
    charset: PWideChar;
    bCrlf: wordbool;
    path: PWideChar): wordbool; stdcall;
```

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 `True`, then CRLF line endings are used, otherwise LF-only line endings are used.

Returns True for success, False for failure.

### StringTable.Sort

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

```pascal
function CkStringTable_Sort(objHandle: HCkStringTable;
    ascending: wordbool;
    caseSensitive: wordbool): wordbool; stdcall;
```

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

Returns True for success, False for failure.

### StringTable.SplitAndAppend

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

```pascal
function CkStringTable_SplitAndAppend(objHandle: HCkStringTable;
    inStr: PWideChar;
    delimiterChar: PWideChar;
    exceptDoubleQuoted: wordbool;
    exceptEscaped: wordbool): wordbool; stdcall;
```

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

Returns True for success, False for failure.

### StringTable.StringAt

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

```pascal
function CkStringTable_StringAt(objHandle: HCkStringTable;
    index: Integer;
    outStr: HCkString): wordbool; stdcall;
function CkStringTable__stringAt(objHandle: HCkStringTable;
    index: Integer): PWideChar; stdcall;
```

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

Returns True for success, False for failure.

See the notes about [PWideChar memory ownership and validity](https://www.chilkatsoft.com/delphi_pwidechar.asp).

### StringTable.StringAtSb

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

```pascal
function CkStringTable_StringAtSb(objHandle: HCkStringTable;
    index: Integer;
    sb: HCkStringBuilder): wordbool; stdcall;
```

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

Returns True for success, False for failure.

### StringTable.ToSb

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

```pascal
function CkStringTable_ToSb(objHandle: HCkStringTable;
    sb: HCkStringBuilder): wordbool; stdcall;
```

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

Returns True for success, False for failure.

### StringTable.WordFollowing

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

```pascal
function CkStringTable_WordFollowing(objHandle: HCkStringTable;
    sb: HCkStringBuilder;
    captureEmailAddr: wordbool;
    sbWord: HCkStringBuilder): Integer; stdcall;
```

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 `True` if the target word is expected to be an email address, otherwise set `captureEmailAddr` to `False`. `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/delphidll/classes/StringBuilder.md)

