$Lstr Index: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
(Automatically generated page update)
 
Line 2: Line 2:
<span class="pageSubtitle">Find a string inside a longstring</span>
<span class="pageSubtitle">Find a string inside a longstring</span>


<p class="warn"><b>Note: </b>Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Lstr_Index function are <var>[[PositionOf (String function)|PositionOf]]</var> and <var>[[PositionIn (String function)|PositionIn]]</var>.</p>
<p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Lstr_Index function are <var>[[PositionOf (String function)|PositionOf]]</var> and <var>[[PositionIn (String function)|PositionIn]]</var>.</p>


This function takes two longstring inputs and produces the position of one input inside the other.  
This function takes two longstring inputs and produces the position of one input inside the other.  

Latest revision as of 22:52, 20 September 2018

Find a string inside a longstring

Note: Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Lstr_Index function are PositionOf and PositionIn.

This function takes two longstring inputs and produces the position of one input inside the other.

The $Lstr_Index function accepts three arguments and returns a numeric result.

The first argument is an arbitrary longstring. This is a required argument.

The second argument is a longstring whose length, ironically, must be 255 bytes or less. This is a required argument.

The third argument is a number indicating the position within the first string that a search for a match is to being. This is an optional argument and defaults to 1 meaning the first character.

Syntax

%result = $Lstr_Index(longstring, str, start)

%result is the position in longstring of str, if there is a match after start, or it is 0 if not.

Usage notes

  • $Lstr_Index acts very much like $INDEX except:
    • It allows a start position other than 1 (argument 3).
    • It cancels the request if the string being searched for (argument 2) is longer than 255 bytes.
    • It can operate on LONGSTRING inputs.

Examples

  1. To set %X to 6:

    %X = $Lstr_Index('Beauxbatons', 'bat')

  2. To set %X to 13:

    %X = $Lstr_Index('Dudley Dursley', 'ey', 8)

Products authorizing $Lstr_Index