Funkcje standardów i ciągów — odniesienie (iLogic)

iLogic obsługuje zestaw funkcji ciągów dla parametrów tekstowych, które można wstawić w reguły iLogic.

Aby uzyskać dostęp do funkcji ciągów, rozwiń węzeł Ciągi na karcie System w obszarze Szablony kodu okna dialogowego Edycja reguły funkcji iLogic.

Standardowe funkcje ciągów

Większość funkcji ciągów stosowanych w iLogic stanowi część standardowej biblioteki ciągów VB.NET. Obejmują one:

Left() CStr()
Compare Now()
Len() DateString
Right() TimeString
Mid() Val(string)
LCase() Przeczytaj cały tekst
UCase()  

Dokumentacja tych funkcji jest dostępna pod adresem http://msdn.microsoft.com/en-us/library/system.string_methods (VS.80).aspx

Funkcje ciągów iLogic

Kilka funkcji ciągów występuje wyłącznie w iLogic:

Funkcja Cel Przykłady:
CDblAny(string) Dokonuje konwersji ciągu tekstowego na podwójną wartość. Podobnie, jak standardowa funkcja VB.NET: CDbl. Dokonuje konwersji ciągu tekstowego, używając przecinka lub kropki jako separatora dziesiętnego, bez względu na ustawienia językowe systemu Windows. Może się nie powieść, jeśli ciąg tekstowy nie reprezentuje prawidłowej wartości numerycznej.

x = CDblAny("3.14159") zwraca 3.14159

x = CDblAny("3,14159") zwraca 3.14159

RoundToFraction(value, fractionFactor, RoundingMethod.Round)

Formatuje wartość numeryczną (value) jako ciąg tekstowy w postaci ułamka, by odzwierciedlić pomiary w calach.

Zwraca ułamek (np. „1/2”) lub liczbę i ułamek (np. „3 5/8”). Zaokrągla wartość do wielokrotności współczynnika ułamkowego (fractionFactor).

Wartość fractionFactor musi wynosić 1/2, 1/4, 1/8, 1/16, 1/32, 1/64 lub 1/128.

RoundingMethod.Round zaokrągla do najbliższej wielokrotności wartości fractionFactor.

RoundToFraction(0.7502, 1/4, RoundingMethod.Round)' zwraca "1/4"

RoundToFraction(value, fractionFactor, RoundingMethod.RoundUp)

Formatuje wartość numeryczną (value) jako ciąg tekstowy w postaci ułamka, by odzwierciedlić pomiary w calach.

Zwraca ułamek (np. "1/2") lub liczbę i ułamek (np. "3 5/8"). Zaokrągla wartość do wielokrotności współczynnika ułamkowego (fractionFactor).

Wartość fractionFactor musi wynosić 1/2, 1/4, 1/8, 1/16, 1/32, 1/64 lub 1/128.

RoundingMethod.RoundUp zaokrągla do najbliższej wielokrotności wartości fractionFactor równej lub większej niż wartość (value).

RoundToFraction (0.7502, 1/4, RoundingMethod.RoundUp) ' zwraca "3/4"

RoundToFraction (0.749, 1/4, RoundingMethod.RoundUp) ' zwraca "3/4"

RoundToFraction (0.749, 1/8, RoundingMethod.RoundUp) ' zwraca "3/4"

RoundToFraction (0.7, 1/8, RoundingMethod.RoundUp) ' zwraca "3/4"

RoundToFraction (0.6, 1/4, RoundingMethod.RoundUp) ' zwraca "3/4"

RoundToFraction (0.6, 1/8, RoundingMethod.RoundUp) ' zwraca "5/8"

RoundToFraction(value, fractionFactor, RoundingMethod.RoundDown)

Formatuje wartość numeryczną (value) jako ciąg tekstowy w postaci ułamka, by odzwierciedlić pomiary w calach.

Zwraca ułamek (np. "1/2") lub liczbę i ułamek (np. "3 5/8"). Zaokrągla wartość do wielokrotności współczynnika ułamkowego (fractionFactor).

Wartość fractionFactor musi wynosić 1/2, 1/4, 1/8, 1/16, 1/32, 1/64 lub 1/128.

RoundingMethod.RoundDown zaokrągla do najbliższej wielokrotności wartości fractionFactor równej lub mniejszej niż wartość (value).

RoundToFraction (0.7502, 1/4, RoundingMethod.RoundDown) ' zwraca "3/4"

RoundToFraction (0.749, 1/4, RoundingMethod.RoundDown) ' zwraca "1/2"

FormatAsFraction(value, [numberOfDecimals])

Formatuje wartość numeryczną (value) jako ciąg tekstowy w postaci ułamka, by odzwierciedlić pomiary w calach.

Zwraca ułamek (np. "1/2") lub liczbę i ułamek (np. "3 5/8"). Wyłącznie, jeśli wartość może zostać wyrażona jako ułamek całkowity o mianowniku drugiej potęgi (do wartości maksymalnej 128, próg tolerancji 0.0000001). W przeciwnym przypadku zwraca ułamek dziesiętny.

Jeśli wynikiem jest ułamek dziesiętny, argument numberofDecimals (liczba miejsc dziesiętnych) definiuje zaokrąglenie tworzonego ciągu tekstowego. Argument ten jest opcjonalny, jeśli nie został wstawiony wartość domyślna wynosi 3.

FormatAsFraction (0.75) ' zwraca "3/4"

FormatAsFraction (2.375)' zwraca "2 3/8"

FormatAsFraction (2,4) ' zwraca "2.4"

FormatAsFraction (2.00001) ' zwraca "2"

Uwaga: Funkcja CDblAny może służyć do konwersji wartości parametrów tekstowych iLogic na wartości liczbowe.