Obiekty predefiniowane > MapValue - obiekt predefiniowany | | Drukuj |
Jest to dynamiczna mapa łącząca nazwę (typu String) ze zmienną określonego typu. Elementy mapy nie są automatycznie sortowane, a ich indeksy są niezmienne do momentu jawnego wywołania polecenia sortowania lub usunięcia elementu. Mapy mogą tworzyć tablice i wchodzić w skład innych obiektów. Elementami mapy mogą być zmienne proste dowolnego typu.
Operacja podstawiania mapy do mapy (mapa1 = mapa2) nie jest dozwolona.
Mapy mogą być przekazywane jako argumenty funkcji, wówczas zmienna lokalna funkcji wskazuje na kolekcję mapy wskazanej jako argument (kolekcja nie jest powielana).
Atrybuty
Typ |
Nazwa |
Opis |
typ |
Określa typ przechowywanych wartości. Atrybutu tego nie należy używać bezpośrednio, w przyszłych wersjach języka raportów może zostać usunięty. Do ustawiania lub pobrania typu mapy należy używać metody Type. |
Metody
Metoda wywołana bez argumentu zwraca nadany wcześniej typ mapy. Metoda wywołana z argumentem ustawia typ danych mapy. Jako argumentu można użyć nazwy predefiniowanych typów danych języka raportów.
Typ mapy może być zmieniony dopiero po usunięciu wszystkich jej elementów przy użyciu metody Clear.
Składnia Int Type ([ tdef])
Argumenty
|
Umożliwia pobranie zmiennej dla podanego klucza lub indeksu. Dla funkcji dwuargumentowej automatycznie tworzy element, o ile nie istnieje i inicjalizuje go podaną wartością. Wartość początkowa jest obliczana tylko w momencie tworzenia nowego elementu.
Składnia Get (Int idx) lub Get (String key [, wart_p])
Argumenty |
Umożliwia pobranie wartości klucza dla podanego indeksu.
Składnia String GetKey (Int idx)
Argumenty
|
Umożliwia określenie ilości elementów mapy.
Składnia Int Size ( )
Argumenty Brak. |
Ustawie wartość elementu dla podanego klucza. Jeżeli element o podanym kluczu nie istnieje, to dodaje nowy element określonego typu do mapy.
Składnia Int Set (String key, value)
Argumenty
|
Umożliwia usunięcie wszystkich elementów mapy.
Składnia Int Clear ( )
Argumenty Brak. |
Zwraca indeks elementu o podanym jako argument kluczu. Umożliwia sprawdzenie, czy dany klucz istnieje. Jeżeli klucz nie istnieje, metoda zwróci wartość zero.
Składnia Int Index (String key)
Argumenty
|
Usuwa z mapy element o podanym jako argument kluczu. Indeksy pozostałych elementów mapy zostają zmienione.
Składnia Int Del (String key)
Argumenty
|
Sortuje elementy mapy alfabetycznie w zależności od wartości argumentu ord. Indeksy pozostałych elementów mapy zostają zmienione.
Składnia Int Sort (Int ord)
Argumenty
|