SQL Eval Function String_IndexOfOrdinal

String_IndexOfOrdinal returns the zero-based index of the first occurrence of a searchValue Unicode character or string within the source string using ordinal (binary) sort rules.

String_IndexOfOrdinal (
	@source NVARCHAR (MAX), 
	@searchValue NVARCHAR (MAX)
	)
RETURNS INT

Parameters

  • source: The source string.
  • searchValue: The string to search within the source string.

Returns

The zero-based index position of the searchValue parameter from the start of the source string if that string is found, or -1 if it is not. If searchValue is Empty, the return value is 0.

Example

SELECT SQLNET::String_IndexOfOrdinal('This is a string.', 'string')
SELECT SQLNET::String_IndexOfOrdinal('Archæology', 'Æ')

String_IndexOfOrdinal4k

It is equivalent to String_IndexOfOrdinal except no NVARCHAR(MAX) parameters; it can be used when input data will never be over 4000 characters as this function offers better performance.

String_IndexOfOrdinal4k (
	@source NVARCHAR (4000), 
	@searchValue NVARCHAR (4000)
	)
RETURNS INT

Example

SELECT SQLNET::String_IndexOfOrdinal4k('This is a string.', 'string')
SELECT SQLNET::String_IndexOfOrdinal4k('Archæology', 'Æ')


Contents