{{htmlmetatags>metatag-robots=()
metatag-title=(INSTR | ugBASIC User Manual)
metatag-keywords=(ugBASIC,Commodore 64,Commodore PLUS/4,ZX Spectrum)
metatag-description=(Manual page for INSTR)
metatag-media-og:image=(:ugbasic:logo-ugbasic-fb.png)
metatag-og:title=(INSTR | ugBASIC User Manual) 
metatag-og:description=(Manual page for INSTR)
}}

====== ugBASIC User Manual ======

===== INSTR ✓ =====

===== SYNTAX =====
     = INSTR( text, searched [, start] )

==== PURPOSE ====


This function can be called to search through strings for individual characters or sub-strings:
it allows you to search for all instances of one string inside another. The string is searched 
for the first occurrence of the second strings. If it is found, its location will be reported 
in the form of the number of characters from the left-hand side of the searched string. 
If the search is unsuccessful, a result of zero will be given.

Normally, the search will begin from the first character at the extreme left-hand side of the 
host string, but you can specify an (optional) number of characters from the beginning of the 
searched string. The optional start-of-search position can range from one to the maximum 
number of characters in the searched string to be searched.



==== EXAMPLE ====
    x = INSTR( "ugBASIC", "A" )
    x = INSTR( "ugBASIC", "A", 2 )


See also the following example files:
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/strings_instr_01.bas|strings_instr_01.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/strings_instr_02.bas|strings_instr_02.bas]]''


==== ABBREVIATION ====
   Ist


==== AVAILABLE ON ====


==== ALIAS FOR ====
[[PLACE]] 

==== ANY PROBLEM? ====
If you have encountered a problem using this command, if you think there is a bug or the explanation is unclear, please [[https://github.com/spotlessmind1975/ugbasic/issues/new?title=ISSUE ON INSTR|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

[[:ugbasic:user:index|{{ :ugbasic:user:logo-ugbasic.png?nolink&600 |}}]]