===== InStr (Funcție) =====
> **Engleză:** //**IN STR**ing = în șir de caractere//
==== Format ====
**instr** ( [[stringexpressions|textul_în_care_se_caută]] , [[stringexpressions|text_de_căutat]] )\\
**instr** ( [[stringexpressions|textul_în_care_se_caută]] , [[stringexpressions|text_de_căutat]] , [[integerexpressions|valoare_start]] )\\
**instr** ( [[stringexpressions|textul_în_care_se_caută]] , [[stringexpressions|text_de_căutat]] , [[integerexpressions|valoare_start]] , [[booleanexpressions|expresie_booleană]])

Întoarce un [[integerexpressions|număr_întreg]].
==== Descriere ====
Verifică dacă șirul de caractere [[stringexpressions|text_de_căutat]] este conținut în [[stringexpressions|textul_în_care_se_caută]]. Dacă este găsit, funcția întoarce poziția (indexul) unde s-a găsit șirul [[stringexpressions|text_de_căutat]]. În cazul în care nu este găsit, funcția întoarce valoarea 0.

În mod opțional se poate specifica o valoare pentru [[integerexpressions|valoare_start]], acesta reprezentând poziția de unde se dorește începerea căutării, unde 1 este primul caracter din [[stringexpressions|textul_în_care_se_caută]], 2 este al doilea caracter ș.a.m.d. În cazul în care poziția furnizată este negativă, atunci căutarea va începe de la caracterul specificat numărând de la sfârșitul textului, unde -1 este ultimul caracter, -2 este penultimul caracter, -3 este al treilea caracter din coadă ș.a.m.d.\\
Indiferent poziția furnizată, căutarea se va face întotdeauna de la ce mai mică poziție către cea mai mare, adică dinspre începutul textului spre sfârșitul lui.

De asemenea, se poate specifica și o a patra valoare opțională, o [[booleanexpressions|expresie_booleană]] pentru a indica dacă se vor trata la fel literele mari și literele mici în cadrul căutării. În mod implicit funcția va trata în mod diferit literele mari și literele mici, făcând distincție între ele.
==== Note ====
Șirurile de caractere încep de la poziția 1.
==== Exemplu ====
<code>
print instr("Unu sau unsprezece", "un")
print instr("UNU sau unsprezece", "un", 1, true)
print instr("unu, unit, punte", "un")
print instr("unu, unit, punte", "un", -5)
</code>
va afișa
<code>
9
1
1
13
</code>
==== Vezi și ====
{{page>ro:start#Șiruri de caractere&noheader}}
==== Istoric ==== 
|0.9.6.55|Adăugată în acestă versiune|
|1.99.99.53|S-a adăugat posibilitatea specificării unei poziții negative|