Core Function Split - Revision history

UberFoX: 1 revision

2015-06-14T12:38:09Z

1 revision

← Older revision

Revision as of 12:38, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:40:30Z

1 revision

← Older revision

Revision as of 21:40, 11 August 2014

UberFoX: /* flag */

2013-09-12T18:15:43Z

flag

← Older revision		Revision as of 18:15, 12 September 2013
Line 35:		Line 35:
	flag = 1, entire delimiter string is needed to mark where to split the string.		flag = 1, entire delimiter string is needed to mark where to split the string.

−	flag = 2, the delimiter will be treated as an array and each string in it ~~string is needed to~~ mark where to split the string.	+	flag = 2, the delimiter will be treated as an array and each string in it can mark where to split the string.

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

UberFoX: /* Example */

2013-01-22T19:16:53Z

Example

← Older revision		Revision as of 19:16, 22 January 2013
Line 110:		Line 110:
	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
	Foreach ( Split("The<12>quick<46>brown<68>fox....", m/<\d+>/) as $elem )		Foreach ( Split("The<12>quick<46>brown<68>fox....", m/<\d+>/) as $elem )
		+	{
		+	println("Element is: " . $elem);
		+	}
		+	</syntaxhighlight>
		+
		+	Now split it using an array of strings to use as the delimiters
		+
		+	<syntaxhighlight lang="sputnik">
		+	$str = Split("The1111quick2222brown2222fox1111jumps2222omg", array("1111", "2222"), 2);
		+	Foreach ( $str as $elem )
	{		{
	println("Element is: " . $elem);		println("Element is: " . $elem);

UberFoX: /* flag */

2013-01-22T19:10:59Z

flag

← Older revision		Revision as of 19:10, 22 January 2013
Line 30:		Line 30:

	Optional; Changes how the string split works:		Optional; Changes how the string split works:
		+
	flag = 0 (default), each character in the delimiter string will mark where to split the string.		flag = 0 (default), each character in the delimiter string will mark where to split the string.
		+
	flag = 1, entire delimiter string is needed to mark where to split the string.		flag = 1, entire delimiter string is needed to mark where to split the string.
		+
		+	flag = 2, the delimiter will be treated as an array and each string in it string is needed to mark where to split the string.

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

Alexpja at 19:21, 27 November 2011

2011-11-27T19:21:40Z

← Older revision		Revision as of 19:21, 27 November 2011
Line 92:		Line 92:
	</syntaxhighlight>		</syntaxhighlight>

−	To split the string each time a "<" followed by digits followed by a ">" is ~~fonud~~ using a RegExp pattern example:	+	To split the string each time a "<" followed by digits followed by a ">" is found using a RegExp pattern example:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">

UberFoX: /* Example */

2011-11-17T23:17:53Z

Example

← Older revision		Revision as of 23:17, 17 November 2011
Line 56:		Line 56:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	$days = Split("Sun,Mon,Tue,Wed,Thu,Fri,Sat", ",")	+	$days = Split("Sun,Mon,Tue,Wed,Thu,Fri,Sat", ",");
−	~~For $day In~~ $days	+	Foreach( $days as $day )
−	println("Element is: " . $day)	+	{
−	~~Next~~	+	println("Element is: " . $day);
		+	}
	</syntaxhighlight>		</syntaxhighlight>

Line 65:		Line 66:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	$letters = Split("The quick brown FoX", "")	+	$letters = Split("The quick brown FoX", "");
−	~~For $letter In~~ $letters	+	Foreach ( $letters as $letter )
−	println("Element is: " . $letter)	+	{
−	~~Next~~	+	println("Element is: " . $letter);
		+	}
	</syntaxhighlight>		</syntaxhighlight>

Line 74:		Line 76:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	$array = Split("This moo is a string moo ok", "moo", 1)	+	$array = Split("This moo is a string moo ok", "moo", 1);
−	~~For $elem In~~ $array	+	Foreach ( $array as $elem )
−	println("Element is: " . $elem)	+	{
−	~~Next~~	+	println("Element is: " . $elem);
		+	}
	</syntaxhighlight>		</syntaxhighlight>

Line 83:		Line 86:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	~~For $elem In~~ Split("This moo is a string moo ok", "moo", 1)	+	Foreach ( Split("This moo is a string moo ok", "moo", 1) as $elem )
−	println("Element is: " . $elem)	+	{
−	~~Next~~	+	println("Element is: " . $elem);
		+	}
	</syntaxhighlight>		</syntaxhighlight>

Line 91:		Line 95:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	$str = Split("The<12>quick<46>brown<68>fox....", m/<\d+>/)	+	$str = Split("The<12>quick<46>brown<68>fox....", m/<\d+>/);
−	~~For $elem In~~ $str	+	Foreach ( $str as $elem )
−	println("Element is: " . $elem)	+	{
−	~~Next~~	+	println("Element is: " . $elem);
		+	}
	</syntaxhighlight>		</syntaxhighlight>

Line 100:		Line 105:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	~~For $elem In~~ Split("The<12>quick<46>brown<68>fox....", m/<\d+>/)	+	Foreach ( Split("The<12>quick<46>brown<68>fox....", m/<\d+>/) as $elem )
−	println("Element is: " . $elem)	+	{
−	~~Next~~	+	println("Element is: " . $elem);
		+	}
	</syntaxhighlight>		</syntaxhighlight>

UberFoX: /* delim/pattern */

2011-11-10T12:10:20Z

delim/pattern

← Older revision		Revision as of 12:10, 10 November 2011
Line 23:		Line 23:
	OR		OR

−	A RegExp match pattern.	+	A RegExp match pattern (The pattern is very similar to perl and layed out the same way).

	==== flag ====		==== flag ====

UberFoX: Created page with "

 Split( , ,  )

=== Description === Splits up a string into substrings depending on the given delimiters. OR Splits up a string in..."

2011-11-10T12:01:28Z

Created page with "<pre> Split( <expression>, <delim/pattern>, <flag> ) </pre> === Description === Splits up a string into substrings depending on the given delimiters. OR Splits up a string in..."

New page

<pre>
Split( <expression>, <delim/pattern>, <flag> )
</pre>

=== Description ===

Splits up a string into substrings depending on the given delimiters.

OR

Splits up a string into substrings depending on the given RegExp pattern.

=== Parameters ===

==== expression ====

The string to evaluate.

==== delim/pattern ====

One or more characters to use as delimiters (case sensitive).

OR

A RegExp match pattern.

==== flag ====

Warning: You can only use the flag if you are NOT using a RegExp pattern as the Delim.

Optional; Changes how the string split works:
flag = 0 (default), each character in the delimiter string will mark where to split the string.
flag = 1, entire delimiter string is needed to mark where to split the string.

=== Return Value ===

Returns an array with each elment ($array[0], $array[1], etc.) contain the delimited strings.

If no delimiters were found an empty array will be returned.

=== Remarks ===

If you use a blank string "" for the delimiters, each character will be returned as an element.

If you use a blank RegExp m// for the delim, each character will be returned as an element.

If the delimiter you wish to use is a substring instead of individual single characters, see the example below.

Split is very useful as an alternative to InStr and as a means to populate an array.

Caution if you use the macro @CRLF you are referring to a 2 character string so you will generate extra blanks lines.

=== Example ===

To split a string at each , example:

<syntaxhighlight lang="sputnik">
$days = Split("Sun,Mon,Tue,Wed,Thu,Fri,Sat", ",")
For $day In $days
println("Element is: " . $day)
Next
</syntaxhighlight>

To split a string at each letter example:

<syntaxhighlight lang="sputnik">
$letters = Split("The quick brown FoX", "")
For $letter In $letters
println("Element is: " . $letter)
Next
</syntaxhighlight>

To split a string every time it finds the word "moo" example:

<syntaxhighlight lang="sputnik">
$array = Split("This moo is a string moo ok", "moo", 1)
For $elem In $array
println("Element is: " . $elem)
Next
</syntaxhighlight>

You can place the Split directly in the For loop example:

<syntaxhighlight lang="sputnik">
For $elem In Split("This moo is a string moo ok", "moo", 1)
println("Element is: " . $elem)
Next
</syntaxhighlight>

To split the string each time a "<" followed by digits followed by a ">" is fonud using a RegExp pattern example:

<syntaxhighlight lang="sputnik">
$str = Split("The<12>quick<46>brown<68>fox....", m/<\d+>/)
For $elem In $str
println("Element is: " . $elem)
Next
</syntaxhighlight>

Of course you can place the split in the For example:

<syntaxhighlight lang="sputnik">
For $elem In Split("The<12>quick<46>brown<68>fox....", m/<\d+>/)
println("Element is: " . $elem)
Next
</syntaxhighlight>

To see what more patterns you can match go see Regex Match or RegExp functions and read the Remarks.

[[Category:Core Function]]