Important

The SingleStore 9.1 release candidate (RC) is available now. It will be promoted to general availability (GA) soon and at that time it will be renamed to SingleStore 10.

In the interim, SingleStore 9.1 RC can be used to preview, evaluate, and provide feedback on the new and upcoming features in SingleStore 10, while SingleStore 9.0 is recommended for production workloads.

INSTR

Syntax

SQL

INSTR (str, searchstr)

Arguments

str: any string or binary object
searchstr: string to search for

Note

This function is identical to LOCATE but with the arguments reversed.

Return Type

Integer position, one-indexed. 0 if not found.

Examples

SQL

SELECT INSTR('ohai', 'i');

+--------------------+
| INSTR('ohai', 'i') |
+--------------------+
|                  4 |
+--------------------+

SQL

SELECT INSTR('ohai', 'z');

+--------------------+
| INSTR('ohai', 'z') |
+--------------------+
|                  0 |
+--------------------+

Warning

Implicit Collation

When character_set_server is set to utf8, string literals with characters using 4-byte encoding are implicitly assigned binary collation and processed as a sequence of bytes rather than characters. This implicit conversion to binary collation causes string functions to return unexpected results. To avoid using implicit binary collation, either use explicit type casting or use database columns defined with the utf8mb4 character set.

For more information, refer to Implicit Collation in Special Cases.