Wstęp AutoIt wyposażony jest w bogaty zestaw funkcji służących do manipulacji łańcuchami znakowymi (stringami). W niniejszym rozdziale zostaną opisane sposoby tworzenia, edycji, testowania i zapisu stringów.

Co to jest string? String to nazwa typu danych służącego do przechowywania napisów (zmiennych łańcuchowych).

Stringi w AutoIt mogą zawierać wszystkie znaki ASCII o kodach od 0 do 255, a także znaki UNICODE o kodach od 0 do 65535 .

Maksymalna wielkość stringu to 2147483647 znaków.

Tworzenie stringów String można utworzyć ujmując jego elementy w cudzysłów lub apostrofy.

$a="to jest string" $b='to też jest string'

Jeżeli chcemy żeby tworzony string zawierał cudzysłów lub apostrof należy go utworzyć tak: $a="to jest 'cytat'" ;lub $b='to jest "cytat"'

String można utworzyć łącząc dowolną ilość innych stringów za pomocą operatora &: $a="To jest string" $b="to też jest string" $c=$a&" i "&$b&"!" ;wynik "To jest string i to też jest string!"

Na string można zmienić dowolne wyrażenie za pomocą funkcji String(): String(wyrażenie) $str=String(7+8) ;wynik string "15" $str=String(2=3) ;wynik string "False" $str=String(True) ;wynik string "True"

Można także wczytać z dysku plik tekstowy np.: $str=FileRead("Test.txt") Dokładny opis w rozdziale: AutoIt/Czytanie i pisanie do plików.

Jednoznakowy string można uzyskać zamieniając na znak kod ASCII lub UNICODE: Chr(ASCIIcode) ;zakres 0-255 ChrW(UNICODEcode) ;zakres 0-65535 MsgBox(0,"",Chr(66)&ChrW(666)) Tym sposobem możemy utworzyć string ze znaków, których nie da się wpisać z klawiatury.

Przy okazji wspomnijmy o funkcjach odwrotnych, tzn. takich, które zmieniają znaki na odpowiadające im kody: Asc ( "znak" ) ;kod ASCII AscW ( "znak" ) ;kod UNICODE MsgBox(0, "ASCII Ś:", Asc("Ś")) MsgBox(0, "Unicode Ś:", AscW("Ś"))

Testowanie stringów W AutoIt istnieje zestaw funkcji umożliwiające uzyskanie pewnych informacji o stringach bez ingerencji w ich zawartość.

Określenie długości stringu StringLen StringLen("string") Funkcja zwraca długość stringu (ilość znaków z których składa się string). $a="QWERTY" $d=StringLen($a) ;wynik 6

Sprawdzenie czy string jest zapisem liczby całkowitej StringIsInt StringIsInt("string") Funkcja zwraca 1 gdy tak lub 0 gdy nie. $a=StringIsInt("+42") ;wynik 1 $b=StringIsInt("-00") ;wynik 1 $c=StringIsInt("1.0") ;wynik 0, zapis z kropką dziesiętną - liczba zmiennoprzecinkowa $d=StringIsInt(1.0) ;wynik 1, liczba 1.0 użyta jako string - niejawnie konwersja do stringu "1" $e=StringIsInt("1+2") ;wynik 0, to nie zapis liczby lecz wyrażenia

Sprawdzenie czy string jest zapisem liczby zmiennoprzecinkowej StringIsFloat StringIsFloat("string") Funkcja zwraca 1 gdy tak lub 0 gdy nie. $b=StringIsFloat("7.") ;wynik 1 zero po kropce domyślne $c=StringIsFloat("-.0") ;wynik 1 $d=StringIsFloat("3/4") ;wynik 0 to jest wyrażenie $e=StringIsFloat("2") ;wynik 0 to jest liczba całkowita $f=StringIsFloat(1.5) ;wynik 1, liczba 1.5 użyta jako string - niejawnie konwersja do stringu "1.5" $g=StringIsFloat(1.0) ;wynik 0, liczba 1.0 użyta jako string - niejawnie konwersja do stringu "1"

Sprawdzenie czy string zawiera tylko znaki alfanumeryczne StringIsAlNum StringIsAlNum("string") Funkcja zwraca 1 gdy tak lub 0 gdy nie. $a=StringIsAlNum("a1B2") ;wynik 1 $a=StringIsAlNum(" a1B2") ;wynik 0, string zawiera także spacje

Sprawdzenie czy string zawiera tylko litery StringIsAlpha StringIsAlpha("string") Funkcja zwraca 1 gdy tak lub 0 gdy nie. $a=StringIsAlpha("Alpha") ;wynik 1 $a=StringIsAlpha("@lpha") ;wynik 0, string zawiera także znak @

Sprawdzenie czy string zawiera tylko małe litery StringIsLower StringIsLower("string") Funkcja zwraca 1 gdy tak lub 0 gdy nie. $a=StringIsLower("łąka") ;wynik 1

Sprawdzenie czy string zawiera tylko duże litery StringIsUpper StringIsUpper("string") Funkcja zwraca 1 gdy tak lub 0 gdy nie. $a=StringIsUpper("ŁĄKA") ;wynik 1

Sprawdzenie czy string zawiera tylko cyfry od 0 do 9 StringIsDigit StringIsDigit("string") Funkcja zwraca 1 gdy tak lub 0 gdy nie. $a=StringIsDigit("12333") ;wynik 1 $b=StringIsDigit("1.5") ;wynik 0, string zawiera kropkę $c=StringIsDigit("1 2 3") ;wynik 0, string zawiera także spacje $d=StringIsDigit("") ;wynik 0, string pusty

Sprawdzenie czy string zawiera tylko cyfry szesnastkowe 0-9 i A-F StringIsXDigit StringIsXDigit("string") Funkcja zwraca 1 gdy tak lub 0 gdy nie. $a=StringIsXDigit("00FC") ;wynik 1 $b=StringIsXDigit("2570") ;wynik 1 $c=StringIsXDigit("a cafe") ;wynik 0, zawiera także spację $d=StringIsXDigit(1 + 2.0) ;wynik 1, wyrażenie użyta jako string - niejawnie konwersja do stringu "3"

Sprawdzenie czy string zawiera tylko znaki o kodzie ASCII z zakresu 0-127 StringIsASCII StringIsASCII ( "string" ) Funkcja zwraca 1 gdy tak lub 0 gdy nie. $a=StringIsASCII("To jest jakis tekst") ;wynik 1 $b=StringIsASCII("To jest jakiś tekst") ;wynik 0, polska litera ś ma kod ASCII większy niż 127

Sprawdzenie czy string zawiera tylko "białe" znaki StringIsSpace StringIsSpace("string") Funkcja zwraca 1 gdy tak lub 0 gdy nie. $x =StringIsSpace(" " & @LF & Chr(11) & @TAB & " " & @CRLF) ;wynik 1

Porównywanie stringów z użyciem operatorów porównań

Sprawdzenie czy stringi są jednakowe (= lub ==): $str1="To jest string" $str2="to jest string" $test=($str1=$str2) ;wartość True, operator = nie rozróżnia wielkości liter $test=($str1==$str2) ;wartość False, operator == odróżnia wielkie litery od małych

Pozostałe operatory nie odróżniają dużych liter od małych.

Są to >, =, .

Ocena wartości stringu odbywa się wg kodów znaków poczynając od lewej strony do prawej (z uwzględnieniem tego że wielkość liter jest nierozróżnialna). $str1="Alfa" $str2="bb" ;string 2 ma większą wartość ponieważ kod litery b jest większy od A, stąd $test=($str1>$str2) ;wartość False $test=($str1<$str2) ;wartość True $str1="Alfa" $str2="Alfa1" $test=($str1<$str2) ;wartość True

Porównywanie i przeszukiwanie stringów (funkcje AutoIt'a)

Porównanie dwóch stringów StringCompare StringCompare ( "string1", "string2" [, flag] ) Funkcja ta działa bardzo podobnie do operatorów porównań.

Można jednak za pomocą parametru flag (opcjonalnego) ustalić sposób wartościowania stringów.

flag - określa czy mają być odróżniane duże litery od małych

0 - nierozróżniane z uwzględnieniem ustawień lokalnych np. Ó i ó nie są rozróżniane (domyślne)

1 - rozróżnianie wielkości liter

2 - nierozróżniane bez uwzględnienia ustawień lokalnych np. Ó i ó są rozróżniane

Funkcja zwraca:

0 - gdy stringi są jednakowej co do wartości

>0 - gdy pierwszy string ma większą wartość od drugiego

<0 - gdy pierwszy string ma mniejszą wartość od drugiego

Przykład: $r=StringCompare("Żaba", "żaba") ;wynik 0 $r=StringCompare("Żaba", "żaba",1) ;wynik -1 $r=StringCompare("żaba", "Żaba",1) ;wynik 1

Poszukiwanie wewnątrz stringu mniejszego substringu StringInStr StringInStr ( "string", "substring" [, flag1 [, flag2 [, start [, koniec]]]] ) Znaczenie parametrów funkcji:

"string" - przeszukiwany string

"substring" - poszukiwany podstring

Pozostałe opcjonalnie:

flag1 - określa czy mają być odróżniane duże litery od małych

0 - nierozróżniane z uwzględnieniem ustawień lokalnych np. Ó i ó nie są rozróżniane (domyślne)

1 - rozróżnianie wielkości liter

2 - nierozróżniane bez uwzględnienia ustawień lokalnych np. Ó i ó są rozróżniane

flag2 - określa które wystąpienie podstringu uwzględnić, jeżeli użyjemy liczb ujemnych to string będzie przeszukiwany od końca (domyślnie 1)

start i koniec - określają od którego elementu ma się rozpocząć przeszukiwanie i na którym ma się skończyć (domyślnie cały string)

Funkcja zwraca pozycję podstringu, lub 0 gdy podstring nie został znaleziony.

Przykład: $a="String w którym szukamy podstringu" $b="stri" $w=StringInStr($a,$b) ;wynik 1 $w=StringInStr($a,$b,0,2) ;wynik 28 $w=StringInStr($a,$b,1) ;wynik 28 $w=StringInStr($a,"m") ;wynik 15 $w=StringInStr($a,"m",0,-1) ;wynik 22 $w=StringInStr($a,"Ó",2) ;wynik 0

Przetwarzanie stringów (funkcje AutoIt'a)

Tworzenie stringu z określonej ilości początkowych znaków innego stringu StringLeft StringLeft ( "string", count )

"string" - string przetwarzany

count - ilość znaków stringu wynikowego

Funkcja zwraca string złożony z count pierwszych znaków stringu argumentu.

Jeżeli count jest większe od długości stringu argumentu, to będzie on zwrócony w całości.

Jeżeli count <= 0 to zwrócony będzie string pusty.

Przykład: $w=StringLeft("Coś sobie wytniemy",5) ;wynik "Coś s"

Tworzenie stringu z określonej ilości końcowych znaków innego stringu StringRight StringRight ( "string", count )

"string" - string przetwarzany

count - ilość znaków stringu wynikowego

Funkcja zwraca string złożony z count ostatnich znaków stringu argumentu.

Jeżeli count jest większe od długości stringu argumentu, to będzie on zwrócony w całości.

Jeżeli count <= 0 to zwrócony będzie string pusty.

Przykład: $w=StringRight("Coś sobie wytniemy",10) ;wynik "e wytniemy"

Tworzenie stringu z określonej ilości znaków z wnętrza innego stringu StringMid StringMid ( "string", start [, count] ) "string" - string przetwarzany

start - od którego elementu ma być tworzony string wynikowy

Opcjonalnie:

count - ilość znaków stringu wynikowego (domyślnie do końca stringu)

Funkcja zwraca string złożony z count znaków stringu argumentu poczynając od pozycji start.

Jeżeli nie użyjemy argumentu count to string będzie zwrócony do końca.

Jeżeli count jest większe od długości pozostałej części stringu argumentu, to będzie on zwrócony do końca.

Jeżeli count = 0 to zwrócony będzie string pusty, count < 0 jest ignorowane.

Przykład: $w=StringMid("Coś sobie wytniemy",3) ;wynik "ś sobie wytniemy" $w=StringMid("Coś sobie wytniemy",3,100) ;wynik "ś sobie wytniemy" $w=StringMid("Coś sobie wytniemy",3,-1) ;wynik "ś sobie wytniemy" $w=StringMid("Coś sobie wytniemy",3,5) ;wynik "ś sob"

Tworzenie stringu przez usunięcie określonej ilości początkowych elementów stringu argumentu StringTrimLeft StringTrimLeft ( "string", count ) "string" - string przetwarzany

count - ilość usuniętych początkowych znaków

Jeżeli count jest większe od długości stringu argumentu, to będzie zwrócony string pusty.

Jeżeli count <= 0 to będzie zwrócony cały string.

Przykład: $w=StringTrimLeft("Coś sobie wytniemy",3) ;wynik " sobie wytniemy"

Tworzenie stringu przez usunięcie określonej ilości końcowych elementów stringu argumentu StringTrimRight StringTrimRight ( "string", count ) "string" - string przetwarzany

count - ilość usuniętych końcowych znaków

Jeżeli count jest większe od długości stringu argumentu, to będzie zwrócony string pusty.

Jeżeli count <= 0 to będzie zwrócony cały string.

Przykład: $w=StringTrimRight("Coś sobie wytniemy",3) ;wynik "Coś sobie wytni"

Tworzenie stringu przez zamianę wszystkich liter stringu argumentu na małe StringLower StringLower ( "string" ) "string" - string przetwarzany

Funkcja uwzględnia ustawienia regionalne tzn. że działa prawidłowo także z polskimi literami. Przykład: $w=StringLower("COŚ sOBIE zmienimy",3) ;wynik "coś sobie zmienimy"

Tworzenie stringu przez zamianę wszystkich liter stringu argumentu na duże StringUpper StringUpper ( "string" ) "string" - string przetwarzany

Funkcja uwzględnia ustawienia regionalne tzn. że działa prawidłowo także z polskimi literami.

Przykład: $w=StringUpper("coś sOBIE zmienimy",3) ;wynik "COŚ SOBIE ZMIENIMY"

Tworzenie stringu przez zamianę w stringu argumentu jednego podstringu na inny StringReplace StringReplace ( "string", "szukany", "nowy" [, flag1 [, flag2]] ) "string" - string przetwarzany

"szukany" - podstring do zamiany

"nowy" - podstring na który zostanie zamieniony "szukany"

Pozostałe opcjonalnie:

flag1 - ile wystąpień podstringu "szukany" ma być zamienione na podstring "nowy" (domyślna warość 0, co oznacza że wszystkie wystąpienia)

flag2 - określa czy mają być odróżniane duże litery od małych

0 - nierozróżniane z uwzględnieniem ustawień lokalnych np. Ó i ó nie są rozróżniane (domyślne)

1 - rozróżnianie wielkości liter