CHARPOS - Revision history

Admin: Created page with "= Action = Returns the position of a single character in a string.
2013-02-07T16:37:19Z

Created page with "= <span class="f_Header">Action</span> = Returns the position of a single character in a string. <span style="font-family: Arial;"> </span> <span style="font-family: A..."

New page
= <span class="f_Header">Action</span> =

Returns the position of a single character in a string.

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Syntax</span> =

pos = <span class="f_Syntax">CHARPOS</span>(string , search [,start [,SAFE]])

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Remarks</span> =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="549" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 79px; border: 1px solid rgb(0, 0, 0);" |
Pos

| valign="top" width="100%" style="width: 461px; border: 1px solid rgb(0, 0, 0);" |
Numeric variable that will be assigned with the position of the sub string in the string. Returns 0 when the sub string is not found.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 79px; border: 1px solid rgb(0, 0, 0);" |
String

| valign="top" width="100%" style="width: 461px; border: 1px solid rgb(0, 0, 0);" |
The string to search.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 79px; border: 1px solid rgb(0, 0, 0);" |
Search

| valign="top" width="100%" style="width: 461px; border: 1px solid rgb(0, 0, 0);" |
The search string. This can be a numeric variable too. For example a byte. When a string is used, only the first character will be used for the search.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 79px; border: 1px solid rgb(0, 0, 0);" |
Offset

| valign="top" width="100%" style="width: 461px; border: 1px solid rgb(0, 0, 0);" |
An optional start position where the searching must start.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 79px; border: 1px solid rgb(0, 0, 0);" |
SAFE

| valign="top" width="100%" style="width: 461px; border: 1px solid rgb(0, 0, 0);" |
If you specify an offset, Charpos will check if the offset is not located after the string. For example , when the string is "abc" and you specify an offset of 10, it will be located after the string.

The SAFE option is default. When you specify SPEED, the compiler will add the offset without checking. This will result in shorter and quicker code.

|}
</div>
<span style="font-family: Arial;"> </span>

No constant can be used for string it must be a string variable.

[[File:Notice.jpg|left|Notice.jpg]]The search is sensitive to case.

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">See also</span> =

[[SPLIT]] , [[INSTR]] , [[REPLACECHARS]] ,<span style="font-family: Arial;"> [[DELCHAR]] , [[INSERTCHAR]] , [[DELCHARS]]</span>

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Example</span> =

<br/><source lang="bascomavr">
'-------------------------------------------------------------------------------
' charpos.bas
' (c) 1995-2009 MCS Electronics
$regfile = "m88def.dat"
$crystal = 8000000
$baud = 19200
'-------------------------------------------------------------------------------
Dim S As String * 20
Dim Bpos As Byte
Dim Z As String * 1

Z = "*"
Do
Input "S:" , S
Bpos = Charpos(s , Z)
Print Bpos
Loop Until S = ""

Do
Input "S:" , S
Bpos = Charpos(s , "A") ' notice charpos is sensitive to case
Print Bpos
Loop
</source><br/>{{Languages}}

[[Category:BASCOM Language Reference]]