Funkcje do manipulacji ciągami znaków

** ${StrCase}

    ResultVar String Type(|L|U|T|S|<>)

Konwertuje ciąg znaków "String" na ciąg "Type" z określoną wielkością znaków. Używa LogicLib.

Parametry:

Zwracana wartość -> ResultVar:

Ciąg znaków "String" jako ciąg "Type" z określoną wielkością znaków.

Przykład:

      ${StrCase} $0 '"Vocę" to "TY" po polsku.' "U"
                                [_(_)_()__()__()_(___)_]

      $0 = '"VOCĘ" TP "TY" PO POLSKU.'

* ${StrClb}

    ResultVar String Action(|>|<|<>)    ResultVar String Type(|L|U|T|S|<>)

Wykonuje akcje na schowku, w zależności od wartości parametru "Action". Używa LogicLib.

Parametry:

Zwracana wartość -> ResultVar:

Jeśli parametr "Action" = "<" lub "<>" - Ciąg znaków String został znaleziony w schowku.

*** ${StrIOToNSIS}

    ResultVar String

Konwertuje ciąg znaków "String" wtyczki Install Options, aby był obsługiwany przez NSIS. Konwertowane są znaki Escape, back-slash, carriage return, line feed oraz tab.

Parametry:

Zwracana wartość -> ResultVar:

Ciąg znaków "String" obsługiwany przez NSIS.

Przykład:

      ${StrIOToNSIS} $0 "\r\n\t\\To jest przykład\\"
                                       [()()()()_____________()]

      $0 = "$\r$\n$\t\To jest przykład\"

* ${StrLoc}

    ResultVar String StrToSearchFor CounterDirection(>|<)

Wyszukuje ciągu znaków "StrToSearchFor" w ciągu znaków "String" i zwraca jego położenie, w zależności od kierunku przeszukiwania "CounterDirection".

Parametry:

Zwracana wartość -> ResultVar:

Wyszukuje lokalizację ciągu znaków "StrToSearchFor", w zależności od kierunku "OffsetDirection".

Przykład:

      ${StrLoc} $0 "To jest przykład" "jest" "<"
                                 (__)<<<<<<<<<<<

      $0 = "9"

*** ${StrNSISToIO}

    ResultVar String

Konwertuje ciąg znaków "String" z formatu NSIS, aby był zgodny z wtyczką Install Options. Konwertowane są znaki: Escape, back-slash, carriage return, line feed oraz tab.

Parametry:

Zwracana wartość -> ResultVar:

Ciąg znaków "String" zgodny z wtyczką Install Options.

Przykład:

      ${StrNSISToIO} $0 "$\r$\n$\t\To jest przykład\"
                                      [(_)(_)(_)^____________^]

      $0 = "\r\n\t\\To jest przykład\\"

***** ${StrRep}

    ResultVar String StrToReplace ReplacementString

Wyszukuje wszystkie wystąpienia ciągu znaków "StrToReplace" w ciągu znaków "String", zastępując go ciągiem znaków "ReplacementString".

Parametry:

Zwracana wartość -> ResultVar:

Ciąg znaków "String" z wszystkimi wystąpieniami ciągu znaków "StringToReplace", zamienianymi na ciąg znaków "ReplacementString".

Przykład:

      ${StrRep} $0 "To jest tylko przykład" "tylko" "pierwszy"
                             [______(    )_______]

      $0 = "To jest pierwszy przykład"

*** ${StrSort}

    ResultVar String LeftStr CenterStr RightStr IncludeLeftStr(1|0)
    IncludeCenterStr(1|0) IncludeRightStr(1|0)

Wyszukuje ciąg znaków "CenterStr" w ciągu znaków "String" zwracając tylko wartości znajdujące się pomiędzy ciągami znaków "LeftStr" oraz "RightStr", łącznie z ciągiem "CenterStr" (lub nie) używając "IncludeCenterStr" oraz/lub z ciągiem "LeftStr" używając "IncludeLeftStr" oraz "RightStr" używając "IncludeRightStr".

Parametry:

Zwracana wartość -> ResultVar:

Ciąg znaków znajdujący się pomiędzy ciągiem znaków "LeftStr" oraz "RightStr" wyszukanego ciągu "CenterStr", wraz z dołączonym (lub nie) ciągiem znaków "LeftStr" oraz "RightStr", jeśli wartość "IncludeLeftRightStr" równa jest 1 oraz/lub z ciągiem znaków "CenterStr", jeśli wartość "IncludeCenterStr" równa jest 1.

Przykład:

      ${StrSort} $0 "To jest fajny przykład" " jest" "" "ład" "0" "0" "0"
                             [__(__)_________]( )
                                    C                    R
      $0 = "To jest fajny przyk"

***** ${StrStr}

    ResultVar String StrToSearchFor

Wyszukuje ciągu znaków "StrToSearchFor" w ciągu znaków "String".

Parametry:

Zwracana wartość -> ResultVar:

Ciąg znaków "StrToSearchFor" plus ciąg znaków znajdujący się po ciągu znaków "StrToSearchFor" w ciągu znaków "String".

Przykład:

      ${StrStr} $0 "To jest tylko przykład" "tylko"
                   >>>>>>>>>{__)_______]

      $0 = "tylko przykład"

***** ${StrStrAdv}

    ResultVar String StrToSearchFor SearchDirection(>|<)
    ResultStrDirection(>|<) DisplayStrToSearch(1|0) Loops CaseSensitive(0|1)

Wyszukuje ciąg znaków "StrToSearchFor" w ciągu znaków "String" w kierunku określonym przez "SearchDirection" oraz liczbą powtórzeń "Loops".

Parametry:

Zwracana wartość -> ResultVar:

Ciąg znaków "StrToSearchFor", jeśli wartość "DisplayStrToSearch" równa jest 1, plus wynikowy ciąg znaków po lub przed ciągiem znaków "StrToSearchFor", w zależności od "ResultStrDirection".

Wyniki z błędami:

Jeśli ciąg znaków "StrToSearchFor" nie został znaleziony, zwrócony zostanie pusty ciąg znaków.

Jeśli ciąg znaków "StrToSearchFor" jest pusty, zwrócony zostanie ciąg znaków "String" i ustawiona zostanie flaga błędu.

Jeśli ciąg znaków "String" jest pusty, zwrócony zostanie ciąg znaków i ustawiona zostanie flaga błędu.

Przykład:

      ${StrStrAdv} $0 "To JEST naprawdę tylko przykład" "JEST " ">" ">" "0" "0" "1"
                            >>>>>(   )[___________________]                       

      $0 = "naprawdę tylko przykład"

**** ${StrTok}

    ResultVar String Separators ResultPart[L] SkipEmptyParts(1|0)

Zwraca część "ResultPart" znajdującą się pomiędzy dwoma separatorami "Separators" wewnątrz ciągu znaków "String".

Parametry:

Zwracana wartość -> ResultVar:

Ciąg znaków "String" z liczbą "Part" pomiędzy separatorami "Separators".

Przykład:

      1) ${StrTok} $0 "This is, or is not, just an example" " ," "4" "1"
                                  (  )  ()  () () [_]   (  )  ()   (      )
                                  0     1   2  3  4     5     6    7 
         $0 = "not"

      2) ${StrTok} $0 "This is, or is not, just an example" " ," "4" "0"
                                  (  ) () ^() [] ( ) ^(  )   ()  (      )
                                  0    1  23  4  5   67      8    9
         $0 = "is"

* ${StrTrimNewLines}

    ResultVar String

Usuwa niepotrzebne nowe linie na końcu ciągu znaków "String".

Parametry:

Zwracana wartość -> ResultVar:

Ciąg znaków "String" bez usuniętych nowych linii na końcu.

Przykład:

      ${StrTrimNewLines} $0 "$\r$\nTo jest przykład$\r$\n$\r$\n"
                                            [__________________(_)(_)(_)(_)]

      $0 = "$\r$\nTo jest przykład"