Core Function InStr - Revision history

UberFoX at 07:51, 17 September 2015

2015-09-17T07:51:20Z

← Older revision		Revision as of 07:51, 17 September 2015
Line 1:		Line 1:
	<pre>		<pre>
−	InStr( <string>, <substirng>, <casesense>, <occurrence>, <start>	+	InStr( <string>, <substirng>, <casesense>, <occurrence>, <start>, <length> )
	</pre>		</pre>

Line 36:		Line 36:

	Optional; The starting position of the search.		Optional; The starting position of the search.
		+
		+	OR
		+
		+	If the start is a negative value the character position will work backwards from the length of the string.

	Default: 0		Default: 0
		+
		+	==== length ====
		+
		+	Optional; The number of characters to search. By default the entire remainder of the string.
		+
		+	If length is given and is negative, then that many characters will be omitted from the end of string (after the start position has been calculated when a start is negative). If start denotes the position of this truncation or beyond, -1 will be returned.

	=== Return Value ===		=== Return Value ===
Line 43:		Line 53:
	Success: Returns the position of the substring.		Success: Returns the position of the substring.

−	Failure: Returns ~~0 if substring not found or~~ -1 ~~if Invalid "occurance" parameter given~~.	+	Failure: Returns -1.

	=== Remarks ===		=== Remarks ===

−	The first character position is 1.	+	The first character position is 0.

	=== Example ===		=== Example ===
Line 57:		Line 67:
	$result = InStr("I am a String", "RING");		$result = InStr("I am a String", "RING");
	Println("Search result:" , $result);		Println("Search result:" , $result);
		+	// PRINTS
		+	// Search result:43
		+	// Search result:9
		+	</syntaxhighlight>
		+
		+	Using negative start and then using a length
		+
		+	<syntaxhighlight lang="sputnik">
		+	$result = InStr("I am a String", "RING", true, 1, -4, 4);
		+	Println("Search result:" , $result);
		+	if ($result != -1)
		+	say "Found: " . SubStr("I am a String", $result, 4);
		+	else
		+	say "NOT Found";
		+	$result = InStr("I am a StrIng catchRing", "RING", true, 2, -16);
		+	Println("Search result:" , $result);
		+	if ($result != -1)
		+	say "Found: " . SubStr("I am a StrIng catchRing", $result, 4);
		+	else
		+	say "NOT Found";
		+	// PRINTS
		+	// Search result:9
		+	// Found: ring
		+	// Search result:19
		+	// Found: Ring
	</syntaxhighlight>		</syntaxhighlight>

	[[Category:Core Function]]		[[Category:Core Function]]

UberFoX: /* ignoreCase */

2015-09-17T07:09:46Z

ignoreCase

← Older revision		Revision as of 07:09, 17 September 2015
Line 25:		Line 25:
	false = case sensitive		false = case sensitive

−	Default: ~~false~~	+	Default: true

	==== occurrence ====		==== occurrence ====

UberFoX: /* casesense */

2015-09-17T06:59:56Z

casesense

← Older revision		Revision as of 06:59, 17 September 2015
Line 17:		Line 17:
	The substring to search for.		The substring to search for.

−	==== ~~casesense~~ ====	+	==== ignoreCase ====

−	Optional; Flag to indicate if the operations should be case ~~sensitive~~.	+	Optional; Flag to indicate if the operations should be case insensitive.

−	0 = not case sensitive~~, using the user's locale (default)~~	+	true = not case sensitive

−	1 = case sensitive	+	false = case sensitive

−	~~2 = not case sensitive, using a basic/faster comparison~~	+	Default: false
−		+
−	Default: 0	+

	==== occurrence ====		==== occurrence ====

UberFoX: 1 revision

2015-06-14T12:38:08Z

1 revision

← Older revision

Revision as of 12:38, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:40:29Z

1 revision

← Older revision

Revision as of 21:40, 11 August 2014

UberFoX at 21:40, 23 August 2013

2013-08-23T21:40:49Z

← Older revision		Revision as of 21:40, 23 August 2013
Line 1:		Line 1:
	<pre>		<pre>
−	InStr( <string>, <substirng>, <casesense>, <occurrence>, <start~~>, <count~~>	+	InStr( <string>, <substirng>, <casesense>, <occurrence>, <start>
	</pre>		</pre>

Line 40:		Line 40:

	Default: 0		Default: 0
−
−	~~==== count ====~~
−
−	~~Optional; The number of comparisons to make.~~

	=== Return Value ===		=== Return Value ===

UberFoX at 19:05, 23 August 2013

2013-08-23T19:05:37Z

← Older revision		Revision as of 19:05, 23 August 2013
Line 26:		Line 26:

	2 = not case sensitive, using a basic/faster comparison		2 = not case sensitive, using a basic/faster comparison
		+
		+	Default: 0

	==== occurrence ====		==== occurrence ====
Line 36:		Line 38:

	Optional; The starting position of the search.		Optional; The starting position of the search.
		+
		+	Default: 0

	==== count ====		==== count ====

UberFoX: /* casesense */

2013-08-23T15:51:38Z

casesense

← Older revision		Revision as of 15:51, 23 August 2013
Line 20:		Line 20:

	Optional; Flag to indicate if the operations should be case sensitive.		Optional; Flag to indicate if the operations should be case sensitive.
		+
	0 = not case sensitive, using the user's locale (default)		0 = not case sensitive, using the user's locale (default)
		+
	1 = case sensitive		1 = case sensitive
		+
	2 = not case sensitive, using a basic/faster comparison		2 = not case sensitive, using a basic/faster comparison

UberFoX: /* Example */

2011-11-18T20:45:32Z

Example

← Older revision		Revision as of 20:45, 18 November 2011
Line 51:		Line 51:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	$location = InStr("How much wood could a woodchuck chuck is a woodchuck could chuck wood?", "wood", 0, 3)	+	$location = InStr("How much wood could a woodchuck chuck is a woodchuck could chuck wood?", "wood", 0, 3);
−	Println("Search result:" , $location) ; Find the 3rd occurance of "wood"	+	Println("Search result:" , $location); // Find the 3rd occurance of "wood"
−		+
−	$result = InStr("I am a String", "RING")	+	$result = InStr("I am a String", "RING");
−	Println("Search result:" , $result)	+	Println("Search result:" , $result);
	</syntaxhighlight>		</syntaxhighlight>

	[[Category:Core Function]]		[[Category:Core Function]]

UberFoX: /* occurrence */

2011-11-09T16:43:55Z

occurrence

← Older revision		Revision as of 16:43, 9 November 2011
Line 26:		Line 26:
	==== occurrence ====		==== occurrence ====

−	Optional; Which occurrence of the substring to find in the string. Use a negative occurrence to search from the right side. The default value is 1 (finds first occurrence).	+	Optional; Which occurrence of the substring to find in the string. Use a negative occurrence to search from the right side.
		+
		+	The default value is 1 (finds first occurrence).

	==== start ====		==== start ====