FIELD
Warning
SingleStore 9.0 gives you the opportunity to preview, evaluate, and provide feedback on new and upcoming features prior to their general availability. In the interim, SingleStore 8.9 is recommended for production workloads, which can later be upgraded to SingleStore 9.0.
On this page
Returns the first index of the str
argument in the str1
, str2
, … list, or 0 if it doesn’t exist.
Syntax
FIELD (str, str1, str2, ...)
Remarks
If all arguments are strings, then all arguments are compared as strings.
If str
is NULL, the return value is 0 because NULL fails equality comparison with any value.
Arguments
-
str
: any string or binary object -
str1
,str2
, … : list of strings or binary objects
Return Type
Integer
Example
SELECT FIELD('abra', 'cadabra', 'abra', 'abracadabra');
+-------------------------------------------------+
| FIELD('abra', 'cadabra', 'abra', 'abracadabra') |
+-------------------------------------------------+
| 2 |
+-------------------------------------------------+
Caution
Implicit Collation
When character_
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.utf8mb4
character set.
For more information, refer to Implicit Collation in Special Cases.
Last modified: February 27, 2023