Programmer Guide/Command Reference/SUBSTR - Revision history

Jw at 09:19, 4 March 2016

2016-03-04T09:19:54Z

← Older revision		Revision as of 11:19, 4 March 2016
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
			{{PG_StringCommands}}
	<var>var</var> := SUBSTR <var>string</var> [ <var>skip_count</var> [ <var>length</var> ]]		<var>var</var> := SUBSTR <var>string</var> [ <var>skip_count</var> [ <var>length</var> ]]

Christian at 20:37, 29 April 2014

2014-04-29T20:37:17Z

← Older revision		Revision as of 22:37, 29 April 2014
Line 14:		Line 14:

	# skip 1 character, returning 'bcd'		# skip 1 character, returning 'bcd'
	#str := substr 'abcd' 1		<var>#str</var> := substr 'abcd' 1

	# skip 2 characters, returning 'cd'		# skip 2 characters, returning 'cd'
	#str := substr 'abcd' 2		<var>#str</var> := substr 'abcd' 2

	# skip 1 character, request 2 characters - returning 'bc'		# skip 1 character, request 2 characters - returning 'bc'
	#str := substr 'abcd' 1 2		<var>#str</var> := substr 'abcd' 1 2

	# skip 2 character from the end, request 1 character, returning 'b'		# skip 2 character from the end, request 1 character, returning 'b'
	#str := substr 'abcd' 2 -2		<var>#str</var> := substr 'abcd' 2 -1

Christian at 20:35, 29 April 2014

2014-04-29T20:35:31Z

← Older revision		Revision as of 22:35, 29 April 2014
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	==SUBSTR==		<var>var</var> := SUBSTR <var>string</var> [ <var>skip_count</var> [ <var>length</var> ]]

	~~var := SUBSTR~~ <~~var~~>~~string~~</~~var~~> [ <var>~~skip_count~~</var> [ <var>~~length~~</var> ]]		The {{STX}} <code>SUBSTR</code> command extracts a substring from its first argument, <var>string</var>. The start of the substring to extract is denoted by the second parameter <var>skip_count</var>, denoting the number of characters ''to skip''.

	The <code>SUBSTR</code> command extracts a substring from its first argument, <var>string</var>. The start of the substring to extract is denoted by the second parameter <var>skip_count</var>, denoting the number of characters to skip.		The length of the substring to extract is denoted by the third parameter, <var>length</var>. If you supply a negative number for <var>length</var>, its absolute value will be used, ''and'' <var>skip_count</var> will start at the ''end'' of the string. Isn't {{STx}} a splendid beast!

	The length of the substring to extract is denoted by the third parameter, <var>length</var>. If you supply a negative number for <var>length</var>, its absolute value will be used, ''and'' <var>skip_count</var> will start at the ''end'' of the string.

	;<var>string</var>		;<var>string</var>

Christian at 14:58, 3 July 2013

2013-07-03T14:58:51Z

← Older revision		Revision as of 16:58, 3 July 2013
Line 23:		Line 23:
	# skip 1 character, request 2 characters - returning 'bc'		# skip 1 character, request 2 characters - returning 'bc'
	#str := substr 'abcd' 1 2		#str := substr 'abcd' 1 2

	# skip 1 character from the end, request ~~2 characters~~, returning 'ab'		# skip 2 character from the end, request 1 character, returning 'b'
	#str := substr 'abcd' 1 -2		#str := substr 'abcd' 2 -2

Christian at 14:57, 3 July 2013

2013-07-03T14:57:52Z

← Older revision		Revision as of 16:57, 3 July 2013
Line 4:		Line 4:
	var := SUBSTR <var>string</var> [ <var>skip_count</var> [ <var>length</var> ]]		var := SUBSTR <var>string</var> [ <var>skip_count</var> [ <var>length</var> ]]

	The <code>SUBSTR</code> command extracts a substring from its first argument, <var>string</var>. The start of the substring to extract is denoted by the second parameter <var>skip_count</~~code~~>, denoting the number of characters to skip.		The <code>SUBSTR</code> command extracts a substring from its first argument, <var>string</var>. The start of the substring to extract is denoted by the second parameter <var>skip_count</var>, denoting the number of characters to skip.

	The length of the substring to extract is denoted by the third parameter, <var>length</var>. If you supply a negative number for <var>length</var>, its absolute value will be used, ''and'' <var>skip_count</var> will start at the ''end'' of the string.		The length of the substring to extract is denoted by the third parameter, <var>length</var>. If you supply a negative number for <var>length</var>, its absolute value will be used, ''and'' <var>skip_count</var> will start at the ''end'' of the string.

Christian: /* SUBSTR */

2013-07-03T14:57:31Z

SUBSTR

← Older revision		Revision as of 16:57, 3 July 2013
Line 2:		Line 2:
	==SUBSTR==		==SUBSTR==

	~~<code>~~var := SUBSTR <var>string</var> [ <var>~~start~~</var> [ <var>length</var> ]]~~</code>~~		var := SUBSTR <var>string</var> [ <var>skip_count</var> [ <var>length</var> ]]

	-> var ~~= '~~string[start .~~. start+length-1]'~~		The <code>SUBSTR</code> command extracts a substring from its first argument, <var>string</var>. The start of the substring to extract is denoted by the second parameter <var>skip_count</code>, denoting the number of characters to skip.

	~~Get a~~ substring of the ~~string~~ <var>~~string~~</var>. If no length ~~is specified all characters from~~ <var>~~start~~</var> to the end of the string ~~are copied to <code>var</code>~~. ~~If neither~~		The length of the substring to extract is denoted by the third parameter, <var>length</var>. If you supply a negative number for <var>length</var>, its absolute value will be used, ''and'' <var>skip_count</var> will start at the ''end'' of the string.

	;<var>string</var>		;<var>string</var>

	:The string from which to retrieve the substring.		:The string from which to retrieve the substring.
			;<var>skip_count</var>
	;<var>~~start~~</var>		:by denoting the number of characters to skip from the beginning (<var>length</var>≥0) or from the end of the string (<var>length</var><0), <var>skip_count</var> indicates where to start extracting the substring. The default value is <code>0</code>.

	:~~The zero-based index~~ of the ~~first character~~ of the substring. The default value is <code>0</code>.

	;<var>length</var>		;<var>length</var>
			:Its absolute value determines the length of the substring to extract. If <var>length</var> is less than zero, <var>skip_count</var> characters will be skipped from the ''end'' of the string; otherwise, they will be skipped from the ''beginning'' of the string. If omitted, the "remaining" part of the string will be extracted.

	:~~The length of the substring. If length is not specified then the length of the string minus <var>start</var> is used.~~		# skip 1 character, returning 'bcd'
			#str := substr 'abcd' 1
	~~Remove the first~~ character ~~of a string.~~
			# skip 2 characters, returning 'cd'
			#str := substr 'abcd' 2

			# skip 1 character, request 2 characters - returning 'bc'
			#str := substr 'abcd' 1 2

	~~<pre>~~		# skip 1 character from the end, request 2 characters, returning 'ab'
	#str := substr '~~$#str~~' 1		#str := substr 'abcd' 1 -2
	~~</pre>~~

Admin: 1 revision: Initial import

2010-11-18T16:31:34Z

1 revision: Initial import

← Older revision	Revision as of 18:31, 18 November 2010
(No difference)

193.171.195.8: initial import

2010-05-17T13:05:27Z

initial import

New page

{{DISPLAYTITLE:{{SUBPAGENAME}}}}
==SUBSTR==

<code>var := SUBSTR <var>string</var> [ <var>start</var> [ <var>length</var> ]]</code>

-> var = 'string[start .. start+length-1]'

Get a substring of the string <var>string</var>. If no length is specified all characters from <var>start</var> to the end of the string are copied to <code>var</code>. If neither

;<var>string</var>

:The string from which to retrieve the substring.

;<var>start</var>

:The zero-based index of the first character of the substring. The default value is <code>0</code>.

;<var>length</var>

:The length of the substring. If length is not specified then the length of the string minus <var>start</var> is used.

Remove the first character of a string.

<pre>
#str := substr '$#str' 1
</pre>