indexOf() : Find Substring Position

Find the first occurrence position of a substring within a string.

Signature

indexOf(str, search)

Parameters

Returns

Type: Integer

The zero-based index of the first occurrence, or -1 if not found.

Examples

Check if Found

{{#if indexOf(model.text, '@') >= 0}}
  <p>Email format detected</p>
{{else}}
  <p>Not an email</p>
{{/if}}

Data:

doc.Params["model"] = new {
    text = "user@example.com"
};

Output:

<p>Email format detected</p>

Extract After Position

<p>Domain: {{substring(model.email, indexOf(model.email, '@') + 1)}}</p>

Data:

doc.Params["model"] = new {
    email = "john@company.com"
};

Output:

<p>Domain: company.com</p>

Split on First Occurrence

<p>First part: {{substring(model.text, 0, indexOf(model.text, ','))}}</p>
<p>Second part: {{substring(model.text, indexOf(model.text, ',') + 2)}}</p>

Data:

doc.Params["model"] = new {
    text = "apple, orange, banana"
};

Output:

<p>First part: apple</p>
<p>Second part: orange, banana</p>

Conditional Based on Position

{{#each model.items}}
  {{#if indexOf(this.code, '-') > 0}}
    <p>Code with separator: {{this.code}}</p>
  {{else}}
    <p>Simple code: {{this.code}}</p>
  {{/if}}
{{/each}}

Data:

doc.Params["model"] = new {
    items = new[] {
        new { code = "ABC-123" },
        new { code = "XYZ789" }
    }
};

Output:

<p>Code with separator: ABC-123</p>
<p>Simple code: XYZ789</p>

Notes

• Returns zero-based index (0 = first character)
• Returns -1 if substring not found
• Case-sensitive search
• Returns index of first occurrence only
• For case-insensitive search, use with toLower()
• Commonly used with substring() for text extraction
• For existence check only, use contains()

See Also

• contains Function
• substring Function
• split Function
• Greater Than or Equal Operator