Next revision
|
Previous revision
|
en:instr [2016/01/01 22:41] 127.0.0.1 external edit |
en:instr [2020/02/28 10:46] (current) |
===== Instr (Function) ===== | ===== Instr (Function) ===== |
==== Format ==== | ==== Format ==== |
**instr** ( //haystack_expr// , //needle_expr// )\\ | **instr** ( [[stringexpressions|haystack_string_expression]] , [[stringexpressions|needle_string_expression]] )\\ |
**instr** ( //haystack_expr// , //needle_expr// , //start_expr// )\\ | **instr** ( [[stringexpressions|haystack_string_expression]] , [[stringexpressions|needle_string_expression]] , [[integerexpressions|start_expression]] )\\ |
**instr** ( //haystack_expr// , //needle_expr// , //start_expr// , //boolean_expr//)\\ | **instr** ( [[stringexpressions|haystack_string_expression]] , [[stringexpressions|needle_string_expression]] , [[integerexpressions|start_expression]] , [[booleanexpressions|boolean_expression]])\\ |
| |
returns //positive_integer_value// | returns [[integerexpressions|integer_expression]] |
| |
==== Description ==== | ==== Description ==== |
Check to see if the string //needle_expr// is contained in the string //haystack_expr//. If it is, then this function will return the index of starting character of the first place where //needle_expr// occurs. Otherwise, this function will return 0. You may also specify an optional starting location for the search to begin //start_expr// and a //boolean_expr// to specify that the search will treat upper and lower case letters the same. | Check to see if the string [[stringexpressions|needle_string_expression]] is contained in the string [[stringexpressions|haystack_string_expression]]. If it is, then this function will return the index of starting character of the first place where [[stringexpressions|needle_string_expression]] occurs. Otherwise, this function will return 0. |
| |
| You may optionally specify a starting location for the search to begin [[integerexpressions|start_expression]]. If the start is 1 or greater the search will begin from the specified character from the start. If the start is < 0 then the search will begin from the nth character from the end. The search will ALWAYS look forward. |
| |
| An optional [[booleanexpressions|boolean_expression]] may be used to specify that the search will treat upper and lower case letters the same. |
==== Note ==== | ==== Note ==== |
String indices begin at 1. | String indices begin at 1. |
| |
==== Example ==== | ==== Example ==== |
<code> | <code> |
==== History ==== | ==== History ==== |
|0.9.6.55|New to Version| | |0.9.6.55|New to Version| |
| |1.99.99.53|Added start position < 0| |
| |
| |