Sandman: /* Notes */

Sandman — Sat, 23 Feb 2008 00:07:35 GMT

Notes

←Older revision		Revision as of 00:07, 23 February 2008
Line 20:		Line 20:

	== Notes ==		== Notes ==
-	Before [[Fenix]] [[0.92]], if the number of characters is specified as 0, it is interpreted the same as if the number of characters were not specified. Because of this, code like implementation of backspace functionality should be done a little different:	+	Before [[Fenix]] [[0.92]], if the number of characters is specified as 0, it is interpreted the same as if the number of characters were not specified, meaning the returned string will be all characters from '' startposition''. Because of this, code like implementation of backspace functionality should be done a little different:
	<pre>		<pre>
	if(len(str)>1)		if(len(str)>1)

Sandman: /* Example */

Sandman — Mon, 26 Nov 2007 00:43:55 GMT

Example

←Older revision		Revision as of 00:43, 26 November 2007
Line 62:		Line 62:
	</pre>		</pre>
	Used in example: [[say]](), [[key]]()		Used in example: [[say]](), [[key]]()
		+
		+	{{Funcbox
		+	\| category = Strings
		+	}}

Sandman: New page: Category:functions Category:strings ==Definition== '''INT''' substr ( <'''STRING''' str> , <'''INT''' startposition> , [<'''INT''' characters>] ) Returns a subsection of a certai...

Sandman — Fri, 31 Aug 2007 18:14:54 GMT

New page: Category:functions Category:strings ==Definition== '''INT''' substr ( <'''STRING''' str> , <'''INT''' startposition> , [<'''INT''' characters>] ) Returns a subsection of a certai...

New page

[[Category:functions]]
[[Category:strings]]

==Definition==
'''INT''' substr ( <'''STRING''' str> , <'''INT''' startposition> , [<'''INT''' characters>] )

Returns a subsection of a certain string.

== Parameters ==
{|
| '''STRING''' str || - The string of which a subsection will be returned.
|-
| '''INT''' startposition || - The position of the first character to be in the subsection.
|-
| ['''INT''' characters] || - The number of characters the subsection will hold. Negative values are special; see [[#Notes|Notes]].
|}

== Returns ==
'''STRING''' : The subsection.

== Notes ==
Before [[Fenix]] [[0.92]], if the number of characters is specified as 0, it is interpreted the same as if the number of characters were not specified. Because of this, code like implementation of backspace functionality should be done a little different:
<pre>
if(len(str)>1)
str = substr(str,0,len(str)-1);
else
str = "";
end
</pre>
Used in code: [[len]]()

If the number of characters is a negative value, the following applies: the start of the subsection will be ''startposition''; the end of the subsection will be the length of the string minus the absolute value of ''characters''.

== Example ==
<pre>
Private
String str = "This is my string.";
Begin

// No specified number of characters
say( substr(str,2) + "<" ); // "is is my string."
say( substr(str,-7) + "<" ); // "string."

// Specified number of characters
say( substr(str,5,2) + "<" ); // "is"

// Number of characters greater than length of string
say( substr(str,2,50) + "<" ); // "is my string."
say( substr(str,-7,50) + "<" ); // "is"

// Negative number of characters
say( substr(str,5,-5) + "<" ); // "is my st"

// Special case
say( substr(str,0,0) + "<" ); // "", but pre 0.92: "This is my string."

Repeat
frame;
Until(key(_ESC))

End
</pre>
Used in example: [[say]](), [[key]]()

Substr - Revision history

Sandman: /* Notes */

Sandman: /* Example */

Sandman: New page: Category:functions Category:strings ==Definition== '''INT''' substr ( <'''STRING''' str> , <'''INT''' startposition> , [<'''INT''' characters>] ) Returns a subsection of a certai...