Raufaza – co to jest i jak ją stosować?

Raufaza to nie nazwa narzędzia programistycznego ani instrukcji deklarowania zmiennych, lecz prawdopodobnie literówka lub zniekształcona nazwa. Warto najpierw ustalić właściwe określenie, aby nie zastosować błędnej metody. Sprawdź możliwe znaczenia i dowiedz się, jak bezpiecznie postąpić w zależności od kontekstu.

Co oznacza słowo „raufaza”?

Termin „raufaza” nie jest standardowym pojęciem używanym w dokumentacji Power Query, Visual Basic, .NET ani Bootstrap. W przekazanym materiale występują natomiast opisy zmiennych, zapytań języka M, instrukcji Dim, opóźnionego wykonania LINQ oraz narzędzi Sass.

Najbardziej prawdopodobne jest, że „raufaza” powstała w wyniku błędu podczas wpisywania, automatycznego rozpoznawania tekstu albo kopiowania treści. Bez dodatkowego kontekstu nie da się przypisać jej jednej, poprawnej definicji.

„Raufaza” nie jest rozpoznawalną nazwą funkcji, instrukcji ani technologii opisanej w dostarczonym materiale.

Jak rozpoznać właściwe pojęcie?

Znaczenie można ustalić, analizując miejsce, w którym pojawiła się ta nazwa. W tekstach technicznych podobnie brzmiące wyrazy mogą odnosić się do zupełnie różnych czynności:

deklarowania i inicjalizowania zmiennej w Visual Basic,
tworzenia kroków zapytania w języku Power Query M,
definiowania klas narzędziowych w Bootstrapie i Sass,
wykonywania zapytania LINQ dopiero podczas odczytu danych.

Pomocny jest również fragment kodu znajdujący się obok nieznanej nazwy. Instrukcja Dim wskazuje zwykle na Visual Basic, słowo let na Power Query M, a mapa $utilities na konfigurację narzędzi Bootstrap.

Jeśli chodziło o zmienną w Visual Basic

W Visual Basic zmienną tworzy się najczęściej za pomocą instrukcji Dim. Można określić jej nazwę, typ danych oraz wartość początkową.

Dim quantity As Integer = 10
Dim message As String = "Rozpoczęto"

Nazwa zmiennej może zawierać litery, cyfry i znak podkreślenia, ale nie powinna zaczynać się od cyfry. Przy włączonej opcji Option Explicit każda używana zmienna musi być wcześniej zadeklarowana.

W jednej instrukcji można utworzyć kilka zmiennych, jednak typ przypisany po wspólnej klauzuli As dotyczy zmiennych znajdujących się przed nią:

Dim a, b, c As Single
Dim x, y As Double

W tym przykładzie zmienne a, b i c mają typ Single, natomiast x i y – typ Double.

Jeśli chodziło o zmienną w Power Query M

Power Query M buduje zapytanie z kolejnych kroków umieszczonych między słowami let i in. Każdy krok ma nazwę oraz wyrażenie, a następny krok może korzystać z wyniku wcześniejszego.

let
    Dane = Table.FromRecords({
        [Produkt = "wędka", Cena = 100],
        [Produkt = "siatka", Cena = 25]
    }),
    Wynik = Table.TransformColumns(Dane, {"Produkt", Text.Proper})
in
    Wynik

Język M rozróżnia wielkość liter. Jeżeli nazwa kroku zawiera spacje, należy użyć zapisu z symbolem # i nazwą w cudzysłowie, na przykład #”Nazwa kroku”.

Każdy krok powinien odwoływać się do poprawnie zapisanej nazwy poprzedniego etapu. Błąd w nazwie lub wielkości liter może zatrzymać przetwarzanie zapytania.

Jeśli chodziło o wykonanie zapytania LINQ

Zapytania LINQ często działają zgodnie z zasadą opóźnionego wykonania. Oznacza to, że samo utworzenie zapytania nie musi od razu odczytać danych.

var result = from n in numbers
             where n < 5
             select n;

Zapytanie zostanie wykonane dopiero podczas przejścia po wynikach, na przykład w pętli foreach. Jeżeli kolekcja źródłowa zmieni się wcześniej, wynik może uwzględnić nowe wartości.

Aby zapisać stan danych w chwili tworzenia zapytania, można użyć metody ToList() albo ToArray():

var result = (from n in numbers
              where n < 5
              select n).ToList();

Wtedy późniejsze modyfikacje kolekcji źródłowej nie zmienią już utworzonej listy wynikowej.

Jeśli chodziło o narzędzie Bootstrap Sass

W materiale pojawia się także API narzędzi Bootstrap, które korzysta z map Sass. Służy ono do dodawania, modyfikowania i usuwania klas pomocniczych generowanych w CSS.

Przykładowe narzędzie definiuje właściwość CSS, wartości oraz opcjonalną nazwę klasy:

$utilities: (
  "cursor": (
    property: cursor,
    class: cursor,
    responsive: true,
    values: auto pointer grab
  )
);

Wartość responsive: true powoduje wygenerowanie wariantów dla punktów przerwania. Z kolei funkcja map-remove() pozwala usunąć wybrane narzędzia z domyślnej mapy.

Jak bezpiecznie wyjaśnić nieznaną nazwę?

Przed użyciem terminu w kodzie lub dokumentacji warto sprawdzić jego pisownię oraz źródło. Pomocne są następujące czynności:

skopiowanie całego zdania, w którym występuje nazwa,
sprawdzenie fragmentu kodu znajdującego się bezpośrednio obok,
porównanie terminu z dokumentacją używanej technologii,
zweryfikowanie, czy nazwa nie powstała przez błąd OCR lub autokorekty.

Nie należy tworzyć własnej funkcji, zmiennej ani instrukcji o nazwie „raufaza” tylko dlatego, że pojawiła się w niejasnym materiale. Taki zapis może utrudnić późniejsze utrzymanie projektu i nie rozwiąże problemu, jeśli pierwotnie chodziło o inne pojęcie.

Warto zapamiętać:

„Raufaza” nie jest standardowym terminem technicznym z dostarczonego materiału.
W Visual Basic zmienne deklaruje się instrukcją Dim.
W Power Query M zmienne i kroki zapisuje się między let oraz in.
W LINQ wynik można utrwalić przez ToList() lub ToArray().