Programmer Guide/Command Reference/STRCHR - Revision history

Jw at 09:19, 4 March 2016

2016-03-04T09:19:39Z

← Older revision		Revision as of 11:19, 4 March 2016
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
			{{PG_StringCommands}}
	<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]] ] [[Programmer_Guide/Command_Reference_Options/-\|/-]] <var>needle</var> <var>haystackstring</var>		<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]] ] [[Programmer_Guide/Command_Reference_Options/-\|/-]] <var>needle</var> <var>haystackstring</var>
	<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]] /Variable [[Programmer_Guide/Command_Reference_Options/-\|/-]] <var>needle</var> <var>haystackvariable</var>		<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]] /Variable [[Programmer_Guide/Command_Reference_Options/-\|/-]] <var>needle</var> <var>haystackvariable</var>

Christian at 16:57, 29 April 2014

2014-04-29T16:57:21Z

← Older revision		Revision as of 18:57, 29 April 2014
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]] ] [[~~XXX~~\|/-]] <var>needle</var> <var>haystackstring</var>		<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]] ] [[Programmer_Guide/Command_Reference_Options/-\|/-]] <var>needle</var> <var>haystackstring</var>
	<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]] /Variable [[~~XXX~~\|/-]] <var>needle</var> <var>haystackvariable</var>		<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]] /Variable [[Programmer_Guide/Command_Reference_Options/-\|/-]] <var>needle</var> <var>haystackvariable</var>

	Locates the first occurrence of the character <var>character</var>, or one of the characters in <var>characters</var> in the string <var>haystackstring</var> or, if <code>/Variable</code> is supplied, in the variable <var>haystackvariable</var>. and returns the index of the first occurrence, or -1, if no occurrence is found.		Locates the first occurrence of the character <var>character</var>, or one of the characters in <var>characters</var> in the string <var>haystackstring</var> or, if <code>/Variable</code> is supplied, in the variable <var>haystackvariable</var>. and returns the index of the first occurrence, or -1, if no occurrence is found.
Line 11:		Line 11:
	;<code>/Variable</code>		;<code>/Variable</code>
	:This option tells {{STX}} that the haystack argument is the name of a variable whose contents are to be searched. When omitting <code>/Variable</code>, the haystack argument will be considered a string literal to search.		:This option tells {{STX}} that the haystack argument is the name of a variable whose contents are to be searched. When omitting <code>/Variable</code>, the haystack argument will be considered a string literal to search.
	;<code>[[~~XXX~~\|/-]]</code>		;<code>[[Programmer_Guide/Command_Reference_Options/-\|/-]]</code>
	:The "end of options" option tells {{STx}} that any further arguments are plain arguments, even should they start with a slash. You should always use this option in order to prevent - unless, of course, if you can be entirely sure that none of your arguments will start with a slash.		:The [[Programmer_Guide/Command_Reference_Options/-\|"end of options" option]] tells {{STx}} that any further arguments are plain arguments, even should they start with a slash. You should always use this option in order to prevent - unless, of course, if you can be entirely sure that none of your arguments will start with a slash.
	;<var>needle</var>		;<var>needle</var>
	:A string of characters, or a single character, to search for.		:A string of characters, or a single character, to search for.
Line 19:		Line 19:

	#v := set 'You must be joking ;-)'		#v := set 'You must be joking ;-)'
	#i := strchr /Variable [[~~XXX~~\|/-]] ';' '#v'		#i := strchr /Variable [[Programmer_Guide/Command_Reference_Options/-\|/-]] ';' '#v'
	// #i == 19		// #i == 19

Christian at 16:55, 29 April 2014

2014-04-29T16:55:22Z

← Older revision		Revision as of 18:55, 29 April 2014
Line 19:		Line 19:

	#v := set 'You must be joking ;-)'		#v := set 'You must be joking ;-)'
	#i := strchr /v [[XXX\|/-]] ';' '#v'		#i := strchr /Variable [[XXX\|/-]] ';' '#v'
	// #i == 19		// #i == 19

Christian at 16:54, 29 April 2014

2014-04-29T16:54:09Z

← Older revision		Revision as of 18:54, 29 April 2014
Line 15:		Line 15:
	;<var>needle</var>		;<var>needle</var>
	:A string of characters, or a single character, to search for.		:A string of characters, or a single character, to search for.
	;<var>~~variable~~</var>		;<var>haystackvariable</var>
	:Find the first semi-colon in the string stored in the variable <var>~~variable~~</var>.		:Find the first semi-colon in the string stored in the variable <var>haystackvariable</var>.

	#v := set 'You must be joking ;-)'		#v := set 'You must be joking ;-)'
	#i := strchr /v [[XXX\|/-]] ';' '#v'		#i := strchr /v [[XXX\|/-]] ';' '#v'
	// #i == 19		// #i == 19

Christian at 16:53, 29 April 2014

2014-04-29T16:53:38Z

← Older revision		Revision as of 18:53, 29 April 2014
Line 11:		Line 11:
	;<code>/Variable</code>		;<code>/Variable</code>
	:This option tells {{STX}} that the haystack argument is the name of a variable whose contents are to be searched. When omitting <code>/Variable</code>, the haystack argument will be considered a string literal to search.		:This option tells {{STX}} that the haystack argument is the name of a variable whose contents are to be searched. When omitting <code>/Variable</code>, the haystack argument will be considered a string literal to search.
			;<code>[[XXX\|/-]]</code>
			:The "end of options" option tells {{STx}} that any further arguments are plain arguments, even should they start with a slash. You should always use this option in order to prevent - unless, of course, if you can be entirely sure that none of your arguments will start with a slash.
	;<var>needle</var>		;<var>needle</var>
	:A string of characters, or a single character, to search for.		:A string of characters, or a single character, to search for.

Christian at 16:50, 29 April 2014

2014-04-29T16:50:59Z

← Older revision		Revision as of 18:50, 29 April 2014
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]] ] /- <var>needle</var> <var>haystackstring</var>		<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]] ] [[XXX\|/-]] <var>needle</var> <var>haystackstring</var>
	<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]] /Variable /- <var>needle</var> <var>haystackvariable</var>		<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]] /Variable [[XXX\|/-]] <var>needle</var> <var>haystackvariable</var>

	Locates the first occurrence of the character <var>character</var>, or one of the characters in <var>characters</var> in the string <var>haystackstring</var> or, if <code>/Variable</code> is supplied, in the variable <var>haystackvariable</var>. and returns the index of the first occurrence, or -1, if no occurrence is found.		Locates the first occurrence of the character <var>character</var>, or one of the characters in <var>characters</var> in the string <var>haystackstring</var> or, if <code>/Variable</code> is supplied, in the variable <var>haystackvariable</var>. and returns the index of the first occurrence, or -1, if no occurrence is found.
Line 17:		Line 17:

	#v := set 'You must be joking ;-)'		#v := set 'You must be joking ;-)'
	#i := strchr /v /- ';' '#v'		#i := strchr /v [[XXX\|/-]] ';' '#v'
	// #i == 19		// #i == 19

Christian at 16:46, 29 April 2014

2014-04-29T16:46:56Z

← Older revision		Revision as of 18:46, 29 April 2014
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]] ~~] [ /V~~ ] /- <var>~~characters~~</var> <var>~~string~~</var>		<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]] ] /- <var>needle</var> <var>haystackstring</var>
	<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]] /V /- <var>~~characters~~</var> <var>~~variable~~</var>		<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]] /Variable /- <var>needle</var> <var>haystackvariable</var>

	Locates the first occurrence of the character <var>character</var>, or one of the characters in <var>characters</var> in the string <var>~~string~~</var> or the variable <var>~~variable~~</var>. and returns the index of the first occurrence, or -1, if no occurrence is found.		Locates the first occurrence of the character <var>character</var>, or one of the characters in <var>characters</var> in the string <var>haystackstring</var> or, if <code>/Variable</code> is supplied, in the variable <var>haystackvariable</var>. and returns the index of the first occurrence, or -1, if no occurrence is found.

	;<code>/Reverse</code>		;<code>/Reverse</code>
	:If option <code>/Reverse</code> is supplied, the ~~string~~ will be searched from right to left; otherwise, it will be searched from left to right.		:If option <code>/Reverse</code> is supplied, the haystack will be searched from right to left; otherwise, it will be searched from left to right.
	;<code>[[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]</code>		;<code>[[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]</code>
	:If option <code>[[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]</code> is set, warnings instead of errors will be generated on failure		:If option <code>[[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]</code> is set, warnings instead of errors will be generated on failure
	;<~~var~~>~~string~~</~~var~~>		;<code>/Variable</code>
	:A string ~~of characters~~ to search ~~for~~.		:This option tells {{STX}} that the haystack argument is the name of a variable whose contents are to be searched. When omitting <code>/Variable</code>, the haystack argument will be considered a string literal to search.
	;<var>~~character~~</var>		;<var>needle</var>
	:A single character to search for.		:A string of characters, or a single character, to search for.
	;<var>variable</var>		;<var>variable</var>
	:Find the first semi-colon in the string stored in the variable <var>variable</var>.		:Find the first semi-colon in the string stored in the variable <var>variable</var>.

Christian at 16:42, 29 April 2014

2014-04-29T16:42:24Z

← Older revision		Revision as of 18:42, 29 April 2014
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	==STRCHR==		<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]] ] [ /V ] /- <var>characters</var> <var>string</var>
			<var>var</var> := STRCHR [ /Reverse ] [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]] /V /- <var>characters</var> <var>variable</var>

	~~<code><var>var</var> := STRCHR [ /R ] [ /S ] [ /V ] /- <var>characters</var> <var>string</var></code>~~		Locates the first occurrence of the character <var>character</var>, or one of the characters in <var>characters</var> in the string <var>string</var> or the variable <var>variable</var>. and returns the index of the first occurrence, or -1, if no occurrence is found.

	~~<code><var>var</var> := STRCHR [ /R ] [ /S ] /V /- <var>characters</var> <var>variable</var></code>~~

	~~-> var = the index of the first occurrence or -1~~

	Locates the first occurrence of the character <var>character</var>, or one of the characters in <var>~~character~~</var> in the string <var>string</var> or the variable <var>variable</var>. and returns the index of the first occurrence, or -1, if no occurrence is found.

	~~;<var>/R</var>~~

	~~:If option /R is supplied, the string will be searched from right to left; otherwise, it will be searched from left to right.~~

	~~;<var>/S</var>~~

	~~:If option /S is set, warnings instead of errors will be generated on failure~~

			;<code>/Reverse</code>
			:If option <code>/Reverse</code> is supplied, the string will be searched from right to left; otherwise, it will be searched from left to right.
			;<code>[[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]</code>
			:If option <code>[[Programmer_Guide/Command_Reference_Options/Silent\|/Silent]]</code> is set, warnings instead of errors will be generated on failure
	;<var>string</var>		;<var>string</var>

	:A string of characters to search for.		:A string of characters to search for.

	;<var>character</var>		;<var>character</var>

	:A single character to search for.		:A single character to search for.

	;<var>variable</var>		;<var>variable</var>
			:Find the first semi-colon in the string stored in the variable <var>variable</var>.

	~~Find the first semi-colon in the string stored in the variable #v.~~		#v := set 'You must be joking ;-)'
			#i := strchr /v /- ';' '#v'
	~~<pre>~~		// #i == 19
	#v := set 'You must be joking ;-)'
	#i := strchr /v /- ';' '#v'
	// #i == 19
	~~</pre>~~

Admin: 1 revision: Initial import

2010-11-18T16:31:36Z

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}}}}
==STRCHR==

<code><var>var</var> := STRCHR [ /R ] [ /S ] [ /V ] /- <var>characters</var> <var>string</var></code>

<code><var>var</var> := STRCHR [ /R ] [ /S ] /V /- <var>characters</var> <var>variable</var></code>

-> var = the index of the first occurrence or -1

Locates the first occurrence of the character <var>character</var>, or one of the characters in <var>character</var> in the string <var>string</var> or the variable <var>variable</var>. and returns the index of the first occurrence, or -1, if no occurrence is found.

;<var>/R</var>

:If option /R is supplied, the string will be searched from right to left; otherwise, it will be searched from left to right.

;<var>/S</var>

:If option /S is set, warnings instead of errors will be generated on failure

;<var>string</var>

:A string of characters to search for.

;<var>character</var>

:A single character to search for.

;<var>variable</var>

Find the first semi-colon in the string stored in the variable #v.

<pre>
#v := set 'You must be joking ;-)'
#i := strchr /v /- ';' '#v'
// #i == 19
</pre>