Programmer Guide/Command Reference/STRCHR: Difference between revisions

From STX Wiki
Jump to navigationJump to search
(initial import)
 
No edit summary
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
==STRCHR==
{{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]]] /Variable [[Programmer_Guide/Command_Reference_Options/-|/-]] <var>needle</var> <var>haystackvariable</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>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><var>var</var> := STRCHR [ /R ] [ /S ] /V /- <var>characters</var> <var>variable</var></code>
;<code>/Reverse</code>
: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>
:If option <code>[[Programmer_Guide/Command_Reference_Options/Silent|/Silent]]</code> is set, warnings instead of errors will be generated on failure
;<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.
;<code>[[Programmer_Guide/Command_Reference_Options/-|/-]]</code>
: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>
:A string of characters, or a single character, to search for.
;<var>haystackvariable</var>
:Find the first semi-colon in the string stored in the variable <var>haystackvariable</var>.


-> var = the index of the first occurrence or -1
#v := set 'You must be joking ;-)'
 
#i := strchr /Variable [[Programmer_Guide/Command_Reference_Options/-|/-]] ';' '#v'
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.
// #i == 19
 
;<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>

Latest revision as of 10:19, 4 March 2016

var := STRCHR [ /Reverse ] [ /Silent ] /- needle haystackstring
var := STRCHR [ /Reverse ] [ /Silent] /Variable /- needle haystackvariable

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

/Reverse
If option /Reverse is supplied, the haystack will be searched from right to left; otherwise, it will be searched from left to right.
/Silent
If option /Silent is set, warnings instead of errors will be generated on failure
/Variable
This option tells STx that the haystack argument is the name of a variable whose contents are to be searched. When omitting /Variable, the haystack argument will be considered a string literal to search.
/-
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.
needle
A string of characters, or a single character, to search for.
haystackvariable
Find the first semi-colon in the string stored in the variable haystackvariable.
#v := set 'You must be joking ;-)'
#i := strchr /Variable /- ';' '#v'
// #i == 19
Retrieved from "https://mediawiki.kfs.oeaw.ac.at/stx/docs/wiki/index.php?title=Programmer_Guide/Command_Reference/STRCHR&oldid=8946"

Navigation menu

Personal tools