Core Function StrPos - Revision history

UberFoX at 05:33, 18 September 2015

2015-09-18T05:33:52Z

← Older revision		Revision as of 05:33, 18 September 2015
Line 1:		Line 1:
	<pre>		<pre>
−	StrPos( <haystack>, <needle>, <~~offset~~>, <~~flags~~> )	+	StrPos( <haystack>, <needle>, <flags>, <start>, <length> )
	</pre>		</pre>

Line 16:		Line 16:

	The string to search for.		The string to search for.
−
−	~~==== offset ====~~
−
−	~~Optional; Search will start this number of characters counted from the beginning of the string.~~
−
−	~~(Cannot be negative)~~
−
−	~~Default: 0~~

	==== flags ====		==== flags ====
Line 34:		Line 26:

	Default: 0 (Case sensitive)		Default: 0 (Case sensitive)
		+
		+	==== start ====
		+
		+	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
		+
		+	==== 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 50:		Line 58:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	$RET = StrPos("The quick brown FoX", "foX"~~, 0~~, 1);	+	$RET = StrPos("The quick brown FoX", "foX", 1);
−	println( $RET );	+	println( $RET ); // 16
	</syntaxhighlight>		</syntaxhighlight>

Line 58:		Line 66:
	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
	// Flag 1 for case ignore case then flag 2 for find last instead of first		// Flag 1 for case ignore case then flag 2 for find last instead of first
−	$RET = StrPos("FoX the quick brown FoX", "foX"~~, 0~~, 1 \| 2);	+	$RET = StrPos("FoX the quick brown FoX", "foX", 1 \| 2);
		+	println( $RET ); // 20
		+	</syntaxhighlight>
		+
		+	Using stat/length
		+
		+	<syntaxhighlight lang="sputnik">
		+	// make variables
		+	$str = "The quick brown foxFoX";
		+	$find = "foX";
		+	// get the last fox
		+	$RET = StrPos($str, $find, 1, -3);
		+	println( $RET );
		+	say substr($str, $RET, 3);
		+	// get the first fox
		+	$RET = StrPos($str, $find, 1);
	println( $RET );		println( $RET );
		+	say substr($str, $RET, 3);
		+	// PRINTS
		+	// 19
		+	// FoX
		+	// 16
		+	// fox
	</syntaxhighlight>		</syntaxhighlight>

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

UberFoX: 1 revision

2015-06-14T12:37:19Z

1 revision

← Older revision

Revision as of 12:37, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:40:57Z

1 revision

← Older revision

Revision as of 21:40, 11 August 2014

UberFoX at 18:15, 16 August 2013

2013-08-16T18:15:53Z

← Older revision		Revision as of 18:15, 16 August 2013
Line 5:		Line 5:
	=== Description ===		=== Description ===

−	Find the position of the first occurrence of a substring in a string	+	Find the position of the first/last occurrence of a substring in a string

	=== Parameters ===		=== Parameters ===

UberFoX at 21:00, 28 January 2013

2013-01-28T21:00:37Z

← Older revision		Revision as of 21:00, 28 January 2013
Line 28:		Line 28:

	1 = Case insensitive search		1 = Case insensitive search
		+
		+	2 = Find last match instead of first
		+
		+	(Can add flags together)

	Default: 0 (Case sensitive)		Default: 0 (Case sensitive)
Line 42:		Line 46:

	=== Example ===		=== Example ===
		+
		+	Find First:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
	$RET = StrPos("The quick brown FoX", "foX", 0, 1);		$RET = StrPos("The quick brown FoX", "foX", 0, 1);
		+	println( $RET );
		+	</syntaxhighlight>
		+
		+	Find Last:
		+
		+	<syntaxhighlight lang="sputnik">
		+	// Flag 1 for case ignore case then flag 2 for find last instead of first
		+	$RET = StrPos("FoX the quick brown FoX", "foX", 0, 1 \| 2);
	println( $RET );		println( $RET );
	</syntaxhighlight>		</syntaxhighlight>

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

UberFoX: /* flags */

2013-01-28T20:54:00Z

flags

← Older revision		Revision as of 20:54, 28 January 2013
Line 28:		Line 28:

	1 = Case insensitive search		1 = Case insensitive search
		+
		+	Default: 0 (Case sensitive)

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

UberFoX: Created page with "

 StrPos( , , ,  )

=== Description === Find the position of the first occurrence of a substring in a string === Parameters === ==..."

2013-01-28T20:50:10Z

Created page with "<pre> StrPos( <haystack>, <needle>, <offset>, <flags> ) </pre> === Description === Find the position of the first occurrence of a substring in a string === Parameters === ==..."

New page

<pre>
StrPos( <haystack>, <needle>, <offset>, <flags> )
</pre>

=== Description ===

Find the position of the first occurrence of a substring in a string

=== Parameters ===

==== haystack ====

The string to search in.

==== needle ====

The string to search for.

==== offset ====

Optional; Search will start this number of characters counted from the beginning of the string.

(Cannot be negative)

Default: 0

==== flags ====

1 = Case insensitive search

=== Return Value ===

Returns the position of where the needle exists relative to the beginning of the haystack (independent of offset). Also note that string positions start at 0, and not 1.

Return -1 on failure (such as did not find)

=== Remarks ===

None.

=== Example ===

<syntaxhighlight lang="sputnik">
$RET = StrPos("The quick brown FoX", "foX", 0, 1);
println( $RET );
</syntaxhighlight>

[[Category:Core Function]]