GAWK(1)

NAZWA
gawk - język wyszukiwania i przetwarzania wzorców

SKŁADNIA
gawk [ opcje w stylu POSIX lub GNU ] -f plik-programu [ -- ] plik ...
gawk [ opcje w stylu POSIX lub GNU ] [ -- ] tekst-programu plik ...

OPIS
Gawk jest implementacją GNU języka programowania AWK. Odpowiada on definicji tego języka z POSIX 1003.1. Wersja ta jest z kolei oparta na opisie z The AWK Programming Language, napisanym przez Aho, Kernighana i Weinbergera. Gawk udostępnia dodatkowe funkcje z bieżącej wersji awk Briana Kernighana oraz wiele rozszerzeń charakterystycznych dla GNU.

Wiersz poleceń składa się z opcji dla gawk, tekstu programu (jeśli nie podano go poprzez opcję -f lub --include) i wartości, które mają być udostępnione w predefiniowanych zmiennych ARGC i ARGV.

WSTĘP
Niniejsza strona podręcznika jest bardzo zwięzła. Wszystkie szczegóły opisano w GAWK: Efektywne programowanie w AWK i należy się z nim zapoznać aby poznać pełny opis danej funkcji. Tam, gdzie to możliwe, zamieszczone są odnośniki do wersji online tego podręcznika.

FORMAT OPCJI
Opcje gawk mogą być zarówno tradycyjnymi POSIX-owymi jednoliterowymi opcjami, jak i długimi opcjami w stylu GNU. Opcje POSIX-owe zaczynają się pojedynczym “-”, a opcje GNU “--”. Opcje w stylu GNU są udostępniane zarówno dla właściwości specyficznych dla GNU, jak i dla właściwości POSIX-owych. Inne implementacje AWK prawdopodobnie jednak będą przyjmować tylko tradycyjne, jednoliterowe opcje.

Opcje specyficzne dla gawk są używane zwykle w długiej postaci. Argumenty przekazywane długim opcjom w stylu GNU są łączone z opcją przy użyciu znaku =, bez dodatkowych spacji lub przekazywane w następnym argumencie wiersza poleceń (tj. bez znaku równości i po spacji).

Oprócz tego, każda długa opcja ma odpowiadającą jej opcję krótką, dzięki czemu funkcjonalność danej opcji może być używana ze skryptów wykonywalnych #!.

OPCJE
Gawk akceptuje następujące opcje. Najpierw podane są opcje standardowe, następnie opcje do rozszerzeń gawk, ułożone alfabetycznie według krótkiej opcji.

-f plik-programu,
    --file plik-programu Odczytuje źródło programu AWK z pliku plik-programu, zamiast odczytywać go z pierwszego argumentu wiersza poleceń. Można użyć wielu opcji -f. Pliki odczytywane za pomocą -f są traktowane w ten sposób, jak gdyby zaczynały się wyrażeniem @namespace "awk".

-F fs,
    --field-separator fs Używa fs jako wejściowego separatora pola (wartość predefiniowanej zmiennej FS).

-v var=val, --assign var=val
    Przyznaje zmiennej var wartość val. Robi to przed uruchomieniem programu. Takie wartości zmiennych są dostępne dla reguły BEGIN programu AWK.

-b, --characters-as-bytes Traktuje wszelkie dane wejściowe jako znaki jednobajtowe. Niniejszą opcję przesłania opcja --posix.

-c, --traditional Pracuje w trybie zgodności. W trybie tym, gawk zachowuje się identycznie z UNIX awk; nie jest rozpoznawane żadne ze specyficznych dla GNU rozszerzeń. Postać --traditional jest preferowana. Zobacz ROZSZERZENIA GNU, dla dalszych informacji.

-C, --copyright Wypisuje krótką wersję informacji o prawach autorskich GNU na standardowe wyjście i pomyślnie kończy działanie.

-d[plik], --dump-variables[=plik]
    Wypisuje do pliku posortowaną listę zmiennych globalnych, ich typów i końcowych wartości. Domyślnym plikiem jest awkvars.out w katalogu bieżącym.

-D[plik], --debug[=plik]
    Włącza debugowanie programów AWK. Domyślnie, debuger odczytuje polecenia interaktywnie z klawiatury (standardowego wejścia). Opcjonalny argument plik określa plik z listą poleceń do debugera, w celu wykonania ich nieinteraktywnie.

    W tym trybie wykonania, gawk ładuje kod źródłowy AWK i czeka na polecenia debugowania. Gawk może debugować jedynie źródła programu AWK przekazane opcjami -f i --include. Debuger udokumentowano w GAWK: Efektywne programowanie w AWK; zob. https://www.gnu.org/software/gawk/manual/html_node/Debugger.html#Debugger.

-e tekst-programu,
    --source tekst-programu Używa tekstu-programu jako kodu źródłowego AWK. Każdy argument podany za pomocą opcji -e jest traktowana tak, jak gdyby zaczynała się instrukcją @namespace "awk".

-E plik, --exec plik
    Podobnie jednak do -f, opcja ta jest przetwarzana na końcu. Powinna być używana w skryptach #!, szczególnie w przypadku aplikacji CGI, aby unikać przekazywania opcji lub kodu źródłowego (!) w wierszu poleceń z URL-a. Opcja ta wyłącza przypisania zmiennych wiersza poleceń.

-g, --gen-pot Przegląda i analizuje program AWK program, i tworzy na standardowym wyjściu plik formatu GNU .pot (Portable Object Template), zawierający wpisy dla wszystkich podlegających lokalizacji łańcuchów w programie. Sam program nie jest wykonywany.

-h, --help Wypisuje na standardowe wyjście krótkie podsumowanie dostępnych opcji. Zgodnie z GNU Coding Standards, te opcje powodują natychmiastowe, pomyślne zakończenie pracy.

-i plik-do-włączenia, --include plik-do-włączenia
    Ładuje bibliotekę źródłową awk. Wyszukiwanie biblioteki ma miejsce za pomocą zmiennej środowiskowej AWKPATH. Jeśli pierwotne wyszukiwanie zawiedzie, kolejne będzie wykonane po dołączeniu przyrostka .awk. Plik będzie załadowany jednokrotnie (tj. eliminowane są duplikaty), a kod nie tworzy źródła głównego programu. Pliki odczytywane za pomocą --include są traktowane tak, jak gdyby zaczynały się instrukcją @namespace "awk".

-I, --trace Wypisuje wewnętrzne nazwy kodów bajtowych w trakcie ich wykonywania, przy działającym programie. Ślad jest wypisywany na standardowe wyjście błędów. Każdy „kod operacji” („op code”) jest poprzedzany na wyjściu znakiem +.

-l biblioteka,
    --load biblioteka Ładuje rozszerzenie gawk z biblioteki współdzielonej. Wyszukiwanie biblioteki ma miejsce za pomocą zmiennej środowiskowej AWKLIBPATH. Jeśli pierwotne wyszukiwanie zawiedzie, kolejne będzie wykonane po dołączeniu domyślnego przyrostka (rozszerzenia) biblioteki współdzielonej dla danej platformy. Oczekuje się, że procedura inicjalizacji biblioteki będzie miała nazwę dl_load().

-L [wartość], --lint[=wartość]
    Zapewnia ostrzeżenia o konstrukcjach, które są wątpliwe lub nieprzenośne na inne implementacje AWK. Lista dopuszczalnych wartości jest dostępna pod adresem https://www.gnu.org/software/gawk/manual/html_node/Options.html#Options.

-M, --bignum Wymusza korzystanie z arytmetyki liczb o dowolnej precyzji. Opcja ta nie odniesie skutku, jeśli nie skompilowano gawk z obsługą bibliotek GMP i MPFR GNU (w takim przypadku gawk wypisze ostrzeżenie).

    UWAGA: Funkcja ta istnieje warunkowo. Główny opiekun gawk się nie zajmuje, jednak robi to jeden z członków zespołu deweloperskiego. Jeśli sytuacja ulegnie zmianie na niekorzyść, funkcja zostanie usunięta z gawk.

-n, --non-decimal-data Rozpoznaje wartości ósemkowe i szesnastkowe w danych wejściowych. Opcji tej należy używać ze szczególną ostrożnością!

-N, --use-lc-numeric Zmusza gawk do korzystania ze znaku dziesiętnego z locale (ustawień językowych), przy przetwarzaniu danych wejściowych.

-o[plik], --pretty-print[=plik]
    Wypisuje wersję programu sformatowaną za pomocą pretty-print do pliku. Domyślnym plikiem jest awkprof.out w bieżącym katalogu. Opcja ta wymusza --no-optimize.

-O, --optimize Włącza domyślne optymalizacje gawka wobec wewnętrznej reprezentacji programu. Opcja domyślnie włączona.

-p[plik-prof], --profile[=plik-prof]
    Rozpoczyna sesję profilowania i wysyła dane profilowania do pliku-prof. Domyślnie jest to awkprof.out w bieżącym katalogu. Profil zawiera liczbę wykonań każdej instrukcji programu (na lewym marginesie) oraz liczbę wywołań funkcji dla każdej funkcji użytkownika. W tym trybie gawk działa wolniej. Opcja wymusza --no-optimize.

-P, --posix Włącza tryb zgodności i wyłącza wiele podstawowych rozszerzeń.

-r, --re-interval Włącza użycie wyrażeń przedziałowych (interval expressions) w dopasowaniu wyrażeń regularnych. Wyrażenia przedziałowe są domyślnie włączone, a opcja ta pozostaje ze względu na kompatybilność wsteczną.

-s, --no-optimize Wyłącza domyślne optymalizacje gawka wobec wewnętrznej reprezentacji programu.

-S, --sandbox Uruchamia gawk w trybie piaskownicy, wyłączając funkcję system(), przekierowanie wejścia za pomocą getline, przekierowania wyjścia za pomocą print i printf oraz ładowanie rozszerzeń dynamicznych. Wykonywanie poleceń (poprzez potoki) również jest wyłączone.

-t, --lint-old Daje ostrzeżenia o konstrukcjach, które nieprzenośne na pierwotną wersję UNIX awk.

-V, --version Wypisuje na standardowe wyjście informacje o danej kopii programu gawk. Jest to przydatne przy zgłaszaniu błędów. Zgodnie z GNU Coding Standards, te opcje powodują natychmiastowe, pomyślne zakończenie pracy.

--  Sygnalizuje koniec opcji. Dzięki temu następne argumenty programu AWK mogą rozpoczynać się myślnikiem „-”. [Na przykład rozpoczynające się myślnikiem nazwy plików].

W trybie zgodności wszelkie inne opcje są zaznaczane jako niepoprawne, lecz poza tym są ignorowane. W normalnym trybie działania, jeśli dostarczono tekst programu AWK, nieznane opcje są mu przekazywane w tablicy ARGV, aby mógł je sobie sam przetworzyć.

Ze względu na kompatybilność z POSIX, można skorzystać z opcji -W, po której należy podać nazwę długiej opcji.

WYWOŁANIE PROGRAMU AWK
Program AWK składa się z sekwencji opcjonalnych dyrektyw, instrukcji wzorzec-akcja oraz opcjonalnych definicji funkcji.

    @include "nazwa_pliku"
    @load "nazwa_pliku"
    @namespace "nazwa"
    wzorzec    { instrukcje akcji }
    function nazwa(lista parametrów) { instrukcje }

Gawk first reads the program source from the program-file(s) if specified, from arguments to --source, or from the first non-option argument on the command line. The -f and --source options may be used multiple times on the command line. Gawk reads the program text as if all the program-files and command line source texts had been concatenated together.

In addition, lines beginning with @include may be used to include other source files into your program. This is equivalent to using the --include option.

Lines beginning with @load may be used to load extension functions into your program. This is equivalent to using the --load option.

The environment variable AWKPATH specifies a search path to use when finding source files named with the -f and --include options. If this variable does not exist, the default path is ".:/usr/local/share/awk". (The actual directory may vary, depending upon how gawk was built and installed.) If a file name given to the -f option contains a “/” character, no path search is performed.

The environment variable AWKLIBPATH specifies a search path to use when finding source files named with the --load option. If this variable does not exist, the default path is "/usr/local/lib/gawk". (The actual directory may vary, depending upon how gawk was built and installed.)

Gawk executes AWK programs in the following order. First, all variable assignments specified via the -v option are performed. Next, gawk compiles the program into an internal form. Then, gawk executes the code in the BEGIN rule(s) (if any), and then proceeds to read each file named in the ARGV array (up to ARGV[ARGC-1]). If there are no files named on the command line, gawk reads the standard input.

If a filename on the command line has the form var=val it is treated as a variable assignment. The variable var will be assigned the value val. (This happens after any BEGIN rule(s) have been run.)

Jeśli wartość konkretnego elementu ARGV jest pusta (""), to gawk ją pomija.

For each input file, if a BEGINFILE rule exists, gawk executes the associated code before processing the contents of the file. Similarly, gawk executes the code associated with ENDFILE rules after processing the file.

For each record in the input, gawk tests to see if it matches any pattern in the AWK program. For each pattern that the record matches, gawk executes the associated action. The patterns are tested in the order they occur in the program.

Finally, after all the input is exhausted, gawk executes the code in the END rule(s) (if any).

  Command Line Directories
According to POSIX, files named on the awk command line must be text files. The behavior is “undefined” if they are not. Most versions of awk treat a directory on the command line as a fatal error.

For gawk, a directory on the command line produces a warning, but is otherwise skipped. If either of the --posix or --traditional options is given, then gawk reverts to treating directories on the command line as a fatal error.

ZMIENNE, REKORDY I POLA
AWK variables are dynamic; they come into existence when they are first used. Their values are either floating-point numbers or strings, or both, depending upon how they are used. Additionally, gawk allows variables to have regular-expression type. AWK also has one dimensional arrays; arrays with multiple dimensions may be simulated. However, gawk provides true arrays of arrays. Several pre-defined variables are set as a program runs; these are described as needed and summarized below.

  Rekordy
Rekordy są zwykle rozdzielone znakami nowego wiersza. Można to zmienić przypisując wartości wbudowanej zmiennej RS. Więcej szczegółów na stronie https://www.gnu.org/software/gawk/manual/html_node/Records.html.

  Pola
Przy odczytywaniu każdego rekordu wejściowego, gawk dzieli rekord na pola za pomocą wartości zmiennej FS służącej jako separator pól. Dodatkowo, zmiennymi FIELDWIDTHS i FPAT można kontrolować dzielenie pól wejściowych. Więcej szczegółów opisano, począwszy od strony https://www.gnu.org/software/gawk/manual/html_node/Fields.html.

Do każdego pola w rekordzie wejściowym można odwołać się przez jego pozycję: $1, $2, itd. $0 jest całym rekordem, łącznie z początkowymi i końcowymi białymi znakami.

Zmienna NF jest ustawiana na całkowitą liczbę pól w rekordzie wejściowym.

References to non-existent fields (i.e., fields after $NF) produce the null string. However, assigning to a non-existent field (e.g., $(NF+2) = 5) increases the value of NF, creates any intervening fields with the null string as their values, and causes the value of $0 to be recomputed, with the fields being separated by the value of OFS. References to negative numbered fields cause a fatal error. Decrementing NF causes the values of fields past the new value to be lost, and the value of $0 to be recomputed, with the fields being separated by the value of OFS.

Przypisanie wartości istniejącemu polu powoduje ponowne utworzenie całego rekordu podczas odwołania się do $0. Podobnie, przypisanie wartości do $0 powoduje, że rekord jest ponownie dzielony, tworząc nowe wartości pól.

  Wbudowane zmienne
Poniżej wypisano wbudowano zmienne programu gawk. Lista ta jest celowo zwięzła. Więcej szczegółów opisano na stronie https://www.gnu.org/software/gawk/manual/html_node/Built_002din-Variables.

ARGC
    Liczba argumentów wiersza poleceń.

ARGIND
    Indeks w tablicy ARGV bieżąco przetwarzanego pliku.

ARGV
    Tablica argumentów wiersza poleceń. Tablica ta jest indeksowana od 0 do ARGC - 1.

BINMODE
    Na systemach nie-POSIX-owych, określa użycie trybu „binarnego” do wszystkich operacji wejścia/wyjścia plików. Więcej szczegółów pod adresem https://www.gnu.org/software/gawk/manual/html_node/PC-Using.html.

CONVFMT
    Format konwersji dla liczb, domyślnie "%.6g".

ENVIRON
    Tablica zawierająca wartości bieżącego środowiska. Tablica ta jest indeksowana zmiennymi środowiskowymi, każdy element tablicy jest wartością danej zmiennej.

ERRNO
    Jeśli pojawi się błąd systemowy podczas przekierowywania dla getline, podczas odczytu dla getline lub podczas close(), to ERRNO jest ustawiana na łańcuch opisujący błąd. Podlega on tłumaczeniu przy ustawieniach locale innych niż angielskie.

FIELDWIDTHS
    Jest rozdzieloną białymi znakami listą szerokości pól. Jeśli zmienna ta jest ustawiona, to gawk rozbija wejście na pola o stałych szerokościach (domyślnie rozbija je według wartości separatora FS). Każdą szerokość pola można opcjonalnie poprzedzić wartościami rozdzielonymi dwukropkiem, określającymi liczbę znaków do pominięcia, przed rozpoczęciem pola.

FILENAME
    Nazwa pliku bieżącego pliku wejściowego. Jeśli nie podano plików w wierszu poleceń, FILENAME przechowuje wartość „-”. Wartość zmiennej FILENAME jest niezdefiniowana wewnątrz reguły BEGIN (chyba że zostanie nadana przez getline).

FNR Liczba rekordów wejściowych w bieżącym pliku wejściowym.

FPAT
    Wyrażenie regularne opisujące zawartość pól w rekordzie. Jeśli zmienna ta jest ustawiona, to gawk przetwarza wejście na pola pasujące do wyrażenia regularnego, zamiast używać wartości FS jako separatora pól.

FS  Separator pól wejściowych, domyślnie spacja. Więcej szczegółów pod adresem https://www.gnu.org/software/gawk/manual/html_node/Field-Separators.html.

FUNCTAB
    Tablica, której indeksy i powiązane wartości są nazwami wszystkich zdefiniowanych przez użytkownika lub będących rozszerzeniami funkcjami w programie. UWAGA: w tablice FUNCTAB nie można używać instrukcji delete.

IGNORECASE
    Kontroluje wrażliwość na wielkość znaków wszystkich wyrażeń regularnych i operacji na łańcuchach tekstowych. Więcej szczegółów pod adresem https://www.gnu.org/software/gawk/manual/html_node/Case_002dsensitivity.html.

LINT
    Zapewnia dynamiczną kontrolę opcji --lint z wnętrza programu AWK.

NF  Liczba pól w bieżącym rekordzie wejściowym.

NR  Całkowita liczba odczytanych do tej pory rekordów wejściowych.

OFMT
    Format wyjściowy liczb, domyślnie "%.6g".

OFS Separator pól wyjściowych, domyślnie spacja.

ORS Separator rekordów wyjściowych, domyślnie nowa linia.

PREC
    Robocza precyzja liczb zmiennoprzecinkowych o dowolnej precyzji, domyślnie 53.

PROCINFO
    Elementy tej tablicy zapewniają dostęp do informacji o działającym programie AWK. Więcej szczegółów pod adresem https://www.gnu.org/software/gawk/manual/html_node/Auto_002dset.

ROUNDMODE
    Tryb zaokrąglania w przypadku arytmetyki liczb o dowolnej precyzji, domyślnie "N" (tryb roundTiesToEven IEEE-754). Więcej szczegółów pod adresem https://www.gnu.org/software/gawk/manual/html_node/Setting-the-rounding-mode.

RS  Separator rekordów wejściowych, domyślnie nowy wiersz.

RT  Zakończenie rekordu. Gawk ustawia RT na tekst wejściowy, który pasował do znaku lub wyrażenia regularnego określonego przez RS.

RSTART
    Indeks pierwszego znaku dopasowanego funkcją match(); 0 w przypadku braku dopasowania.

RLENGTH
    Długość łańcucha dopasowanego funkcją match(); -1 w przypadku braku dopasowania.

SUBSEP
    Łańcuch, używany do rozdzielania wielokrotnych indeksów w elementach tablicowych, domyślnie jest to "\034".

SYMTAB
    An array whose indices are the names of all currently defined global variables and arrays in the program. You may not use the delete statement with the SYMTAB array, nor assign to elements with an index that is not a variable name.

TEXTDOMAIN
    Dziedzina tekstowa programu AWK. Stosowane od odszukania zlokalizowanych tłumaczeń łańcuchów znakowych programu.

  Tablice
Tablice są indeksowane wyrażeniem, ujętym w nawiasy kwadratowe ([ i ]). Jeśli wyrażenie jest listą wyrażeń (wyraż, wyraż ...) to indeks tablicy jest sklejany z wartości (łańcuchowych) każdego wyrażenia, oddzielonych wartością zmiennej SUBSEP. [Uwaga: jest tak dlatego, że AWK używa tablic asocjacyjnych - tak jakby słownikowych - nie ma tu normalnych liczbowych indeksów - indeksem może być cokolwiek, najczęściej łańcuch. Symulowanie tablic wielowymiarowych polega właśnie na sklejaniu poszczególnych indeksów w unikalny łańcuch -- przyp. tłum.] Właściwość ta jest używana do symulacji wielowymiarowych tablic. Na przykład:

    i = "A"; j = "B"; k = "C"
    x[i, j, k] = "hello, world\n"

przypisuje łańcuch "hello, world\n" elementowi tablicy x, o indeksie będącym łańcuchem "A\034B\034C". Wszystkie tablice w AWK są asocjacyjne, tj. indeksowane wartościami łańcuchowymi.

The special operator in may be used to test if an array has an index consisting of a particular value:

    if (val in array) 	print array[val]

Jeśli tablica posiada wielokrotne indeksy, można użyć konstrukcji (i, j) in array.

Konstrukcja in może być również użyta w pętli for do iterowania poprzez wszystkie elementy tablicy [ponieważ jest ona asocjacyjna, nie można jej iterować przez przelecenie indeksu od zera do najwyższej wartości - indeks może być tu przecież dowolnym łańcuchem - przyp. tłum.]. Jednak konstrukcja (i, j) in array działa tylko w testach, nie w pętlach for.

Element można skasować z tablicy przy użyciu polecenia delete. Poleceniem delete można się też posłużyć do skasowania całej zawartości tablicy, przez podanie jej nazwy bez indeksu.

gawk obsługuje prawdziwe tablice wielowymiarowe. Nie wymaga, aby były one „prostokątne”, jak w C lub C++. Więcej szczegółów pod adresem https://www.gnu.org/software/gawk/manual/html_node/Arrays.

  Przestrzenie nazw
Gawk obsługuje uproszczoną funkcjonalność przestrzeni nazw, aby pomóc obejść ograniczenia, wynikające z tego, że wszystkie zmienne w AWK są globalne.

Nazwa kwalifikowalna składa się z dwóch prostych identyfikatorów połączonych podwójnym dwukropkiem (::). Lewa strona identyfikatora reprezentuje przestrzeń nazw, a prawa — jej zmienną. Wszystkie proste (niekwalifikowalne) nazwy są uważane za znajdujące się w „bieżącej” przestrzeni nazw; domyślną przestrzenią nazw jest awk. Jednak proste identyfikatory składające się jedynie z wielkich liter są zawsze przypisywane przestrzeni nazw awk, nawet jeśli bieżąca przestrzeń nazw jest inna.

Można zmienić bieżącą przestrzeń nazw za pomocą dyrektywy @namespace "nazwa".

Standardowe, predefiniowane nazwy funkcji wbudowanych nie mogą być użyte jako nazwy przestrzeni nazw. Nazwy dodatkowych funkcji zapewnianych przez gawk mogą być używane jako przestrzenie nazw lub jako proste identyfikatory w innych przestrzeniach nazw. Więcej szczegółów opisano pod adresem https://www.gnu.org/software/gawk/manual/html_node/Namespaces.html#Namespaces.

  Typy zmiennych i konwersje
Zmienne oraz pola mogą być liczbami (zmiennoprzecinkowymi), łańcuchami lub jednym i drugim naraz. Mogą być też wyrażeniami regularnymi. Interpretacja wartości zmiennej zależy od kontekstu. Jeśli jest użyta w wyrażeniu numerycznym, jest interpretowana jako liczba; jeśli jest użyta w wyrażeniu łańcuchowym, to jest traktowana jak łańcuch.

Aby wymusić traktowanie zmiennej jako liczby, należy do niej dodać zero; aby wymusić traktowanie jej jako łańcucha, należy dokleić do niej łańcuch zerowy.

Niezainicjowane zmienne mają wartość numeryczną zero i łańcuchową "" (zero lub pusty łańcuch).

Podczas konwersji łańcucha na liczbę, obróbka jest dokonywana przy użyciu funkcji strtod(3). Liczba jest przekształcana na łańcuch przy użyciu wartości CONVFMT jako parametru formatującego dla sprintf(3), oraz wartości numerycznej jako argumentu. Jednak, nawet mimo że wszystkie liczby w AWK są zmiennoprzecinkowe, wartości całkowite są zawsze konwertowane jak całkowite (integer).

Gawk dokonuje porównań w następujący sposób: Jeśli dwie wartości są numeryczne, to są porównywane numerycznie. Jeśli jedna z wartości jest numeryczna, a druga łańcuchowa, która jest “łańcuchem numerycznym”, to porównania są również dokonywane numerycznie. W przeciwnym wypadku wartość numeryczna jest konwertowana do łańcucha i dokonywane jest porównanie łańcuchowe. Dwa łańcuchy są, oczywiście, porównywane jako łańcuchy.

Zauważ, że stałe znakowe, takie jak "57" nie są łańcuchami numerycznymi - są one stałymi łańcuchowymi. Pojęcie „łańcuchów numerycznych” odnosi się wyłącznie do pól, wejścia getinput, FILENAME, elementów ARGV, ENVIRON i elementów tablicy utworzonej funkcją split() lub patsplit(), będących łańcuchami numerycznymi. Podstawową koncepcją jest to, że wyglądające na numeryczne dane z wejścia użytkownika, i tylko one, są traktowane w opisany sposób.

  Stałe ósemkowe i szesnastkowe
W kodzie źródłowym programów AWK można korzystać ze stałych ósemkowych i szesnastkowych w stylu języka C. Na przykład, ósemkowa wartość 011 jest równa dziesiętnej 9, a szesnastkowa 0x11 jest równa dziesiętnej 17.

  Stałe łańcuchowe
Stałe łańcuchowe w AWK są sekwencjami znaków ujętymi w cudzysłowy (jak "wartość"). Wewnątrz łańcuchów rozpoznawane są pewne sekwencje specjalne, jak w C. Więcej szczegółów pod adresem https://www.gnu.org/software/gawk/manual/html_node/Escape-Sequences.

  Stałe wyrażeń regularnych
Stała wyrażenia regularnego jest sekwencją znaków ujętych pomiędzy ukośniki (jak /wartość/).

Sekwencji specjalnych opisanych w podręczniku można też używać wewnątrz stałych wyrażeń regularnych (np., /[ \t\f\n\r\v]/ dopasowuje białe znaki).

Gawk zapewnia stałe wyrażeń regularnych ze ścisłą kontrolą typów. Są one zapisywane z początkowym symbolem @ (jak: @/wartość/). Takie zmienne mogą być przypisane do wartości skalarnych (zmiennych, elementów tablicy) i przekazywane do funkcji zdefiniowanych przez użytkownika. Przypisane w ten sposób zmienne mają zwykły typ wyrażenia regularnego.

WZORCE I AKCJE
AWK jest językiem zorientowanym liniowo. Najpierw przychodzi wzorzec, a potem akcja. Instrukcje akcji są zawarte w nawiasach { i }. Pominąć można zarówno wzorzec, jak i akcję, lecz oczywiście nie obydwa te pola naraz. Jeśli pominięto wzorzec, to akcja jest wykonywana dla każdego z rekordów wejścia. Brakująca akcja jest z kolei równoważna akcji

    { print }

która wypisuje cały rekord.

Komentarze rozpoczynają się znakiem # i trwają aż do końca wiersza. Do oddzielania instrukcji można używać pustych wierszy. Zwykle instrukcja kończy się wraz z nowym wierszem, jednak nie jest to regułą w przypadku wierszy kończących się na przecinek, {, ?, :, && lub ||. Dla wierszy kończących się na do lub else również wystąpi automatyczna kontynuacja instrukcji w następnym wierszu. W innych przypadkach, wiersz może być kontynuowany przez zakończenie go znakiem „\”; w takim wypadku znak nowego wiersza jest ignorowany. Jednak „\” po znaku # nie jest traktowane w specjalny sposób.

Wiele instrukcji można też zgrupować w jednym wierszu, oddzielając je znakiem „;”. Tyczy się to zarówno instrukcji w części akcji z pary wzorzec-akcja (zwykły przypadek), jak i do samych instrukcji wzorzec-akcja.

  Wzorce
Wzorce w AWK mogą być jedną z następujących rzeczy:

    BEGIN
    END
    BEGINFILE
    ENDFILE
    /wyrażenie regularne/
    wyrażenie relacyjne
    wzorzec && wzorzec
    wzorzec || wzorzec
    wzorzec ? wzorzec : wzorzec
    (wzorzec)
    ! wzorzec
    wzorzec1, wzorzec2

BEGIN i END są dwoma specjalnymi rodzajami wzorców, które nie są porównywane z danymi wejściowymi. Części akcji wszelkich wzorców BEGIN są łączone, tak jakby wszystkie one zostały napisane w pojedynczej regule BEGIN. Są one wykonywane przed rozpoczęciem odczytywania danych wejściowych. Podobnie, wszelkie reguły END są również łączone i wykonywane po wyczerpaniu danych wejściowych. (lub po dojściu do instrukcji exit.) Wzorce BEGIN i END nie mogą być łączone z innymi wzorcami w wyrażeniach wzorcowych. Wzorcom BEGIN i END nie może brakować części definiującej akcję.

BEGINFILE and ENDFILE are additional special patterns whose actions are executed before reading the first record of each command-line input file and after reading the last record of each file. Inside the BEGINFILE rule, the value of ERRNO is the empty string if the file was opened successfully. Otherwise, there is some problem with the file and the code should use nextfile to skip it. If that is not done, gawk produces its usual fatal error for files that cannot be opened.

Dla wzorców /wyrażeń regularnych/ powiązana instrukcja wykonywana jest dla każdego rekordu wejściowego, który odpowiada zadanemu wyrażeniu regularnemu. Wyrażenia regularne są w gruncie rzeczy tymi samymi wyrażeniami, które można spotkać w egrep(1). Więcej informacji o wyrażeniach regularnych znajduje się na stronie https://www.gnu.org/software/gawk/manual/html_node/Regexp.html.

wyrażenie relacyjne może używać dowolnego operatora ze zdefiniowanych w sekcji o akcjach operatorów. Ogólnie, testują one, czy określone pola odpowiadają określonym wyrażeniom regularnym.

Operatory &&, ||, i ! są logicznymi AND, OR i NOT, podobnie jak w języku C. Są one obliczane w sposób skrócony, podobnie jak w C, i służą głównie do łączenia bardziej podstawowych wyrażeń wzorcowych. Podobnie jak w większości języków, dla wymuszenia kolejności porównywania można użyć nawiasów.

Operator ?: działa podobnie jak ten sam operator w C. Jeśli pierwszy wzorzec jest prawdziwy, to do testowania używany jest następny wzorzec; w przeciwnym wypadku używany jest trzeci wzorzec. Obliczany jest tylko albo drugi albo trzeci wzorzec.

Forma wzorzec1, wzorzec2 wyrażenia jest nazywana wzorcem zakresu. Dopasowuje ona wszystkie rekordy wejście, poczynając od rekordu, który odpowiada wzorcowi1, aż do rekordu pasującego do wzorzec2, włącznie. Nie łączy się to z innymi rodzajami wyrażeń wzorcowych.

  Akcje
Instrukcje akcji są zawarte w nawiasach { i }. Instrukcje akcji składają się ze zwyczajnych instrukcji przypisania, warunków i instrukcji pętli, które można znaleźć w większości innych języków programowania. Operatory, instrukcje sterującymi, a także instrukcje wejścia/wyjścia są opracowane na podstawie tych, spotykanych w języku C.

  Operatory
Operatory w AWK, w kolejności malejącego priorytetu, to

(...)
    Grupowanie

$   Odniesienie się do pola.

++ --
    Inkrementuj i dekrementuj. Zarówno przedrostkowe i przyrostkowe.

^   Potęgowanie.

+ - !
    Jednoargumentowy plus, minus i logiczna negacja.

* / %
    Mnożenie, dzielenie i modulo (reszta dzielenia).

+ - Dodawanie i odejmowanie.

odstęp
    Konkatenacja (złączenie) łańcuchów.

|   |&
    Przekierowanie wejścia/wyjścia potokiem dla getline, print i printf.

< > <= >= == !=
    Regularne operatory relacyjne.

~ !~
    Dopasowanie wyrażenia regularnego, wyrażenie przeciwne.

in  Przynależność do tablicy.

&&  Koniunkcja logiczna AND.

||  Alternatywa logiczna OR.

?:  The C conditional expression. This has the form expr1 ? expr2 : expr3. If expr1 is true, the value of the expression is expr2, otherwise it is expr3. Only one of expr2 and expr3 is evaluated.

= += -= *= /= %= ^=
    Przypisanie. Obsługiwane jest zarówno przypisanie absolutne (zmienna = wartość) jak i przypisanie operatorowe (inne formy).

  Instrukcje sterujące
Instrukcje sterujące są następujące:

    if (warunek) instrukcja [ else instrukcja ]
    while (warunek) instrukcja
    do instrukcja while (warunek)
    for (wyraż1; wyraż2; wyraż3) instrukcja
    for (var in tablica) instrukcja
    break
    continue
    delete tablica[indeks]
    delete tablica
    exit [ wyrażenie ]
    { instrukcje }
    switch (wyrażenie) { case wartość|wyraż-regul : instrukcja ... [ default: instrukcja ]
    }

  Instrukcje I/O
Instrukcje I/O są następujące:

close(plik [, jak])
    Zamyka otwarty plik, potok lub proces współbieżny (co-process). Opcjonalnego jak powinno się używać wyłącznie do zamykania jednego końca dwukierunkowego potoku do procesu współbieżnego. Musi to być wartość łańcuchowa, albo "to" albo "from".

getline
    Ustawia $0 z następnego rekordu wejściowego; ustawia NF, NR, FNR, RT.

getline <plik
    Ustawia $0 z następnego rekordu pliku; ustawia NF, RT.

getline var
    Ustawia var z następnego rekordu wejściowego; ustawia NR, FNR, RT.

getline var <plik
    Ustawia var z następnego rekordu pliku; ustawia RT.

polecenie | getline [var]
    Run command, piping the output either into $0 or var, as above, and RT.

polecenie |& getline [var]
    Run command as a coprocess piping the output either into $0 or var, as above, and RT. (The command can also be a socket. See the subsection Special File Names, below.)

fflush([plik])
    Flush any buffers associated with the open output file or pipe file. If file is missing or if it is the null string, then flush all open output files and pipes.

next
    Stop processing the current input record. Read the next input record and start processing over with the first pattern in the AWK program. Upon reaching the end of the input data, execute any END rule(s).

nextfile
    Stop processing the current input file. The next input record read comes from the next input file. Update FILENAME and ARGIND, reset FNR to 1, and start processing over with the first pattern in the AWK program. Upon reaching the end of the input data, execute any ENDFILE and END rule(s).

print
    Wypisuje bieżący rekord. Rekord wyjściowy zakończony jest wartością ORS.

print lista-wyrażeń
    Wypisuje wyrażenia. Każde wyrażenie jest oddzielone wartością OFS. Wyjściowy rekord jest kończony wartością ORS.

print lista-wyrażeń >plik
    Wypisuje wyrażenia do pliku. Każde wyrażenie jest rozdzielone wartością OFS. Rekord wyjściowy jest zakończony wartością ORS.

printf fmt, lista-wyrażeń
    Formatuje i wypisuje/

printf fmt, lista-wyrażeń >plik
    Formatuje i wypisuje do pliku.

system(cmd-line)
    Wywołuje polecenie systemowe cmd-line, i zwraca jego status wyjścia. (funkcja może nie być dostępna na systemach nie POSIX-owych). Pełne informacje o statusie zakończenia są dostępne pod adresem https://www.gnu.org/software/gawk/manual/html_node/I_002fO-Functions.html#I_002fO-Functions.

Dozwolone są też dodatkowe przekierowania wejścia i wyjścia dla print i printf.

print ... >> plik
    Dokleja wyjście do pliku.

print ... | polecenie
    Zapisuje do potoku.

print ... |& polecenie
    Send data to a coprocess or socket. (See also the subsection Special File Names, below.)

The getline command returns 1 on success, zero on end of file, and -1 on an error. If the errno(3) value indicates that the I/O operation may be retried, and PROCINFO["input", "RETRY"] is set, then -2 is returned instead of -1, and further calls to getline may be attempted. Upon an error, ERRNO is set to a string describing the problem.

NOTE: Failure in opening a two-way socket results in a non-fatal error being returned to the calling function. If using a pipe, coprocess, or socket to getline, or from print or printf within a loop, you must use close() to create new instances of the command or socket. AWK does not automatically close pipes, sockets, or coprocesses when they return EOF.

The AWK versions of the printf statement and sprintf() function are similar to those of C. For details, see https://www.gnu.org/software/gawk/manual/html_node/Printf.html.

  Specjalne nazwy plików
Podczas przekierowań I/O przy użyciu print czy też printf do pliku, albo przy użyciu getline z pliku, gawk rozpoznaje wewnętrznie pewne specjalne nazwy plików. Te nazwy plików umożliwiają dostęp do otwartych deskryptorów plików, dziedziczonych po procesie rodzicielskim gawk'a (zazwyczaj powłoce). Inne pliki specjalne zapewniają dostęp do informacji o uruchomionym procesie gawk. Z tych specjalnych nazw plików można również korzystać w wierszu poleceń do określania plików danych. Te nazwy to:

-   Standardowe wejście.

/dev/stdin
    Standardowe wejście.

/dev/stdout
    Standardowe wyjście.

/dev/stderr
    Standardowe wyjście diagnostyczne.

/dev/fd/n
    Plik związany z otwartym deskryptorem pliku n.

Poniższych specjalnych nazw plików można używać z operatorem procesu współbieżnego |& do tworzenia witrualnych połączeń sieciowych TCP/IP:

/inet/tcp/lport/rhost/rport
/inet4/tcp/lport/rhost/rport
/inet6/tcp/lport/rhost/rport
    Files for a TCP/IP connection on local port lport to remote host rhost on remote port rport. Use a port of 0 to have the system pick a port. Use /inet4 to force an IPv4 connection, and /inet6 to force an IPv6 connection. Plain /inet uses the system default (most likely IPv4). Usable only with the |& two-way I/O operator.

/inet/udp/lport/rhost/rport
/inet4/udp/lport/rhost/rport
/inet6/udp/lport/rhost/rport
    Podobne, lecz używa UDP/IP zamiast TCP/IP.

  Funkcje numeryczne
AWK ma następujące wbudowane funkcje arytmetyczne:

atan2(y, x)
    Zwraca arcus tangens y/x w radianach.

cos(wyraż)
    Zwraca cosinus z wyraż w radianach.

exp(wyraż)
    funkcja wykładnicza.

int(wyraż)
    Skraca do liczby całkowitej.

log(wyraż)
    funkcja logarytmu naturalnego.

rand()
    Return a random number N, between zero and one, such that 0 ≤ N < 1.

sin(wyraż)
    Zwraca sinus z wyraż w radianach.

sqrt(wyraż)
    Return the square root of expr.

srand([wyraż])
    Używa wyraż jako nowego ziarno dla generatora liczb losowych. Bez podanego wyraż, używa czasu dnia. Zwraca poprzednie ziarno generatora liczb losowych.

  Funkcje łańcuchowe
Gawk posiada następujące wbudowane funkcje łańcuchowe; szczegółowy opis pod adresem https://www.gnu.org/software/gawk/manual/html_node/String-Functions.

asort(s [, d [, how] ])
    Return the number of elements in the source array s. Sort the contents of s using gawk's normal rules for comparing values, and replace the indices of the sorted values s with sequential integers starting with 1. If the optional destination array d is specified, first duplicate s into d, and then sort d, leaving the indices of the source array s unchanged. The optional string how controls the direction and the comparison mode. Valid values for how are described in https://www.gnu.org/software/gawk/manual/html_node/String-Functions.html#String-Functions. s and d are allowed to be the same array; this only makes sense when supplying the third argument as well.

asorti(s [, d [, how] ])
    Return the number of elements in the source array s. The behavior is the same as that of asort(), except that the array indices are used for sorting, not the array values. When done, the array is indexed numerically, and the values are those of the original indices. The original values are lost; thus provide a second array if you wish to preserve the original. The purpose of the optional string how is the same as for asort(). Here too, s and d are allowed to be the same array; this only makes sense when supplying the third argument as well.

gensub(r, s, h [, t])
    W łańcuchu docelowym t wyszukuje podłańcuchy odpowiadające wyrażeniu regularnemu r. Jeżeli h jest łańcuchem zaczynającym się od g lub G, to zastępuje wszystkie znalezione dopasowania r przez s. W przeciwnym wypadku, h jest liczbą wskazującą, które z kolejnych dopasowań r ma zostać zastąpione. Jeżeli nie podano t, to zamiast niego używane jest $0. Wewnątrz tekstu zastępującego s, można posłużyć się sekwencją \n, gdzie n jest cyfrą od 1 do 9, wskazującą na tekst dopasowany przez n-te podwyrażenie w nawiasach. Sekwencja \0 oznacza cały dopasowany tekst, tak samo jak znak &. W przeciwieństwie do sub() i gsub(), jako wynik funkcji zwracany jest zmieniony łańcuch, zaś pierwotny łańcuch docelowy pozostaje nie zmieniony.

gsub(r, s [, t])
    For each substring matching the regular expression r in the string t, substitute the string s, and return the number of substitutions. If t is not supplied, use $0. An & in the replacement text is replaced with the text that was actually matched. Use \& to get a literal &. (This must be typed as "\\&"; see https://www.gnu.org/software/gawk/manual/html_node/Gory-Details.html#Gory-Details for a fuller discussion of the rules for ampersands and backslashes in the replacement text of sub(), gsub(), and gensub().)

index(s, t)
    Return the index of the string t in the string s, or zero if t is not present. (This implies that character indices start at one.)

length([s])
    Return the length of the string s, or the length of $0 if s is not supplied. With an array argument, length() returns the number of elements in the array.

match(s, r [, a])
    Zwraca pozycję w s, gdzie pojawia się wyrażenie regularne r. Jeśli nie podano r, zwracane jest zero. Jeśli jest jednak obecne, to dodatkowo ustawiane są zmienne RSTART i RLENGTH. Zauważ, że kolejność argumentów jest taka sama jak dla operatora ~: str ~ re. See https://www.gnu.org/software/gawk/manual/html_node/String-Functions.html#String-Functions for a description of how the array a is filled if it is provided.

patsplit(s, a [, r [, seps] ])
    Split the string s into the array a and the separators array seps on the regular expression r, and return the number of fields. Element values are the portions of s that matched r. The value of seps[i] is the possibly null separator that appeared after a[i]. The value of seps[0] is the possibly null leading separator. If r is omitted, FPAT is used instead. The arrays a and seps are cleared first. Splitting behaves identically to field splitting with FPAT.

split(s, a [, r [, seps] ])
    Split the string s into the array a and the separators array seps on the regular expression r, and return the number of fields. If r is omitted, FS is used instead. The arrays a and seps are cleared first. seps[i] is the field separator matched by r between a[i] and a[i+1]. Splitting behaves identically to field splitting.

sprintf(fmt, lista-wyraż)
    wypisuje listę-wyraż według fmt, i zwraca łańcuch wyjściowy.

strtonum(str)
    Examine str, and return its numeric value. If str begins with a leading 0, treat it as an octal number. If str begins with a leading 0x or 0X, treat it as a hexadecimal number. Otherwise, assume it is a decimal number.

sub(r, s [, t])
    Podobne do gsub(), lecz podmienia tylko pierwszy odpowiadający podłańcuch. Zwraca zero albo jeden.

substr(s, i [, n])
    Zwraca maksymalnie n-znakowy podłańcuch łańcucha s, zaczynający się od pozycji i. Jeśli pominięto parametr n, użyta zostaje reszta s.

tolower(str)
    Zwraca kopię łańcucha str, w której wszystkie wielkie litery zostały zastąpione małymi. Nie alfabetyczne znaki pozostają bez zmian.

toupper(str)
    Zwraca kopię łańcucha str, w której wszystkie małe litery zostały zastąpione wielkimi. Nie alfabetyczne znaki pozostają bez zmian.

Gawk jest świadomy wielobajtowości. Oznacza to, że index(), length(), substr() i match() działają wobec znaków, nie bajtów.

  Funkcje czasu
Gawk provides the following functions for obtaining time stamps and formatting them. Details are provided in https://www.gnu.org/software/gawk/manual/html_node/Time-Functions.

mktime(datespec [, utc-flag])
    Turn datespec into a time stamp of the same form as returned by systime(), and return the result. If utc-flag is present and is non-zero or non-null, the time is assumed to be in the UTC time zone; otherwise, the time is assumed to be in the local time zone. If datespec does not contain enough elements or if the resulting time is out of range, mktime() returns -1. See https://www.gnu.org/software/gawk/manual/html_node/Time-Functions.html#Time-Functions for the details of datespec.

strftime([format [, timestamp[, utc-flag]]])
    Format timestamp according to the specification in format. If utc-flag is present and is non-zero or non-null, the result is in UTC, otherwise the result is in local time. The timestamp should be of the same form as returned by systime(). If timestamp is missing, the current time of day is used. If format is missing, a default format equivalent to the output of date(1) is used. The default format is available in PROCINFO["strftime"]. See the specification for the strftime() function in ISO C for the format conversions that are guaranteed to be available.

systime()
    Zwraca bieżący czas dnia w liczbach sekund od początku Epoki (czyli od północy UTC, 1 stycznia 1970 na systemach POSIX-owych).

  Funkcje operujące na bitach
Gawk supplies the following bit manipulation functions. They work by converting double-precision floating point values to uintmax_t integers, doing the operation, and then converting the result back to floating point. Passing negative operands to any of these functions causes a fatal error.

Funkcje czasu to:

and(v1, v2 [, ...])
    Return the bitwise AND of the values provided in the argument list. There must be at least two.

compl(val)
    Zwraca bitowe uzupełnienie val.

lshift(val, ile)
    Zwraca wartość val, przesuniętą w lewo o ile bitów.

or(v1, v2 [, ...])
    Return the bitwise OR of the values provided in the argument list. There must be at least two.

rshift(val, ile)
    Zwraca wartość val, przesuniętą w prawo o ile bitów.

xor(v1, v2 [, ...])
    Return the bitwise XOR of the values provided in the argument list. There must be at least two.

  Funkcje typu
The following functions provide type related information about their arguments.

isarray(x)
    Zwraca prawdę, jeśli x jest tablicą lub fałsz w innym przypadku.

typeof(x)
    Return a string indicating the type of x. The string will be one of "array", "number", "regexp", "string", "strnum", "unassigned", or "undefined".

  Funkcje internacjonalizacji
The following functions may be used from within your AWK program for translating strings at run-time. For full details, see https://www.gnu.org/software/gawk/manual/html_node/I18N-Functions.html#I18N-Functions.

bindtextdomain(katalog [, domena])
    Specify the directory where gawk looks for the .gmo files, in case they will not or cannot be placed in the “standard” locations. It returns the directory where domain is “bound.”

    Domyślną domeną jest wartość TEXTDOMAIN. Jeśli katalog jest łańcuchem pustym (""), to bindtextdomain() zwraca bieżące wiązanie dla zadanej domeny.

dcgettext(łańcuch [, domena [, kategoria]])
    Zwraca tłumaczenie łańcucha w domenie tekstowej domena dla kategorii locale kategoria. Domyślną domeną jest bieżąca wartość TEXTDOMAIN. Domyślną wartością kategorii jest "LC_MESSAGES".

dcngettext(string1, string2, number [, domain [, category]])
    Return the plural form used for number of the translation of string1 and string2 in text domain domain for locale category category. The default value for domain is the current value of TEXTDOMAIN. The default value for category is "LC_MESSAGES".

  Boolean Valued Functions
You can create special Boolean-typed values; see the manual for how they work and why they exist.

mkbool(expression)
    Based on the boolean value of expression return either a true value or a false value. True values have numeric value one. False values have numeric value zero.

FUNKCJE UŻYTKOWNIKA
Funkcje w AWK są definiowane następująco:

    function nazwa(lista parametrów) { instrukcje }

Functions execute when they are called from within expressions in either patterns or actions. Actual parameters supplied in the function call are used to instantiate the formal parameters declared in the function. Arrays are passed by reference, other variables are passed by value.

Local variables are declared as extra parameters in the parameter list. The convention is to separate local variables from real parameters by extra spaces in the parameter list. For example:

    function  f(p, q,     a, b)	# a i b są lokalne { 	... }

    /abc/	{ ... ; f(1, 2) ; ... }

The left parenthesis in a function call is required to immediately follow the function name, without any intervening whitespace. This restriction does not apply to the built-in functions listed above.

Funkcje mogą wołać siebie nawzajem i mogą być rekurencyjne. Parametry funkcji używane jako zmienne lokalne są podczas wywołania funkcji inicjalizowane na łańcuch pusty i liczbę zero. Chcąc, by funkcja zwracała wartość należy posłużyć się składnią: return wyraż. Wartość zwracana przez funkcję jest niezdefiniowana jeśli nie podano wartości zwracanej lub funkcja kończy pracę bez jawnej instrukcji powrotu.

Jeżeli użyto --lint, to gawk ostrzega o wywołaniach niezdefiniowanych funkcji podczas analizy składni, a nie w czasie wykonania. Wywołanie niezdefiniowanej funkcji w czasie wykonania powoduje błąd krytyczny.

Functions may be called indirectly. To do this, assign the name of the function to be called, as a string, to a variable. Then use the variable as if it were the name of a function, prefixed with an @ sign, like so:
    function myfunc() { 	print "myfunc called" 	... }

    {	... 	the_func = "myfunc" 	@the_func()	# call through the_func to myfunc 	... }

Jeżeli użyto --lint, to gawk ostrzega o wywołaniach niezdefiniowanych funkcji podczas analizy składni, a nie w czasie wykonania. Wywołanie niezdefiniowanej funkcji w czasie wykonania powoduje błąd krytyczny.

DYNAMICZNE ŁADOWANIE NOWYCH FUNKCJI
You can dynamically add new functions written in C or C++ to the running gawk interpreter with the @load statement. The full details are beyond the scope of this manual page; see https://www.gnu.org/software/gawk/manual/html_node/Dynamic-Extensions.html#Dynamic-Extensions.

SYGNAŁY
The gawk profiler accepts two signals. SIGUSR1 causes it to dump a profile and function call stack to the profile file, which is either awkprof.out, or whatever file was named with the --profile option. It then continues to run. SIGHUP causes gawk to dump the profile and function call stack and then exit.

INTERNACJONALIZACJA
Stałe łańcuchowe są ciągami znaków ujętymi w cudzysłowy. W środowiskach innych niż angielskojęzyczne, możliwe jest oznakowanie łańcuchów w programie AWK jako wymagających tłumaczenia na własny język narodowy. Łańcuchy takie są oznaczone w programie AWK przez początkowy znak podkreślenia (“_”). Na przykład,

    gawk 'BEGIN { print "hello, world" }'

zawsze wypisuje hello, world. Ale,

    gawk 'BEGIN { print _"hello, world" }'

might print bonjour, monde in France. See https://www.gnu.org/software/gawk/manual/html_node/Internationalization.html#Internationalization for the steps involved in producing and running a localizable AWK program.

ROZSZERZENIA GNU
Gawk has a too-large number of extensions to POSIX awk. They are described in https://www.gnu.org/software/gawk/manual/html_node/POSIX_002fGNU.html. All the extensions can be disabled by invoking gawk with the --traditional or --posix options.

ZMIENNE ŚRODOWISKOWE
The AWKPATH environment variable can be used to provide a list of directories that gawk searches when looking for files named via the -f, --file, -i and --include options, and the @include directive. If the initial search fails, the path is searched again after appending .awk to the filename.

Do podania listy katalogów przeglądanych przez gawk podczas poszukiwania plików zadanych opcjami -l i --load można posłużyć się zmienną środowiskową AWKLIBPATH.

The GAWK_PERSIST_FILE environment variable, if present, specifies a file to use as the backing store for persistent memory. This is an experimental feature. See GAWK: Efektywne programowanie w AWK for the details.

The GAWK_READ_TIMEOUT environment variable can be used to specify a timeout in milliseconds for reading input from a terminal, pipe or two-way communication including sockets.

For connection to a remote host via socket, GAWK_SOCK_RETRIES controls the number of retries, and GAWK_MSEC_SLEEP the interval between retries. The interval is in milliseconds. On systems that do not support usleep(3), the value is rounded up to an integral number of seconds.

Jeśli w środowisku istnieje zmienna POSIXLY_CORRECT to gawk zachowuje się tak, jakby podano mu w wierszu poleceń opcję --posix. Jeśli podano opcję --lint, gawk wyda ostrzeżenie o tym efekcie.

STATUS ZAKOŃCZENIA
If the exit statement is used with a value, then gawk exits with the numeric value given to it.

Otherwise, if there were no problems during execution, gawk exits with the value of the C constant EXIT_SUCCESS. This is usually zero.

If an error occurs, gawk exits with the value of the C constant EXIT_FAILURE. This is usually one.

If gawk exits because of a fatal error, the exit status is 2. On non-POSIX systems, this value may be mapped to EXIT_FAILURE.

INFORMACJA O WERSJI
This man page documents gawk, version 5.2.

AUTORZY
The original version of UNIX awk was designed and implemented by Alfred Aho, Peter Weinberger, and Brian Kernighan of Bell Laboratories. Brian Kernighan continues to maintain and enhance it.

Paul Rubin i Jay Fenlason, z Free Software Foundation, napisali wersję gawk, zgodną z oryginalną wersją awk, rozprowadzaną w Seventh Edition UNIX. John Woods wprowadził wiele poprawek. David Trueman, z pomocą Arnolda Robbinsa, uczynił gawk zgodnym z nową wersją UNIX awk. Arnold Robbins jest bieżącym opiekunem projektu.

See GAWK: Efektywne programowanie w AWK for a full list of the contributors to gawk and its documentation.

See the README file in the gawk distribution for up-to-date information about maintainers and which ports are currently supported.

ZGŁOSZENIA BŁĘDÓW
If you find a bug in gawk, please use the gawkbug(1) program to report it.

Full instructions for reporting a bug are provided in https://www.gnu.org/software/gawk/manual/html_node/Bugs.html. Please carefully read and follow the instructions given there. This will make bug reporting and resolution much easier for everyone involved. Really.

USTERKI
Opcja -F niekoniecznie ma właściwość przypisywania zmiennych; pozostaje tylko dla zgodności wstecznej.

This manual page is too long; gawk has too many features.

ZOBACZ TAKŻE
egrep(1), sed(1), gawkbug(1), printf(3), and strftime(3).

The AWK Programming Language, Alfred V. Aho, Brian W. Kernighan, Peter J. Weinberger, Addison-Wesley, 1988. ISBN 0-201-07981-X.

GAWK: Efektywne programowanie w AWK, Edition 5.2, shipped with the gawk source. The current version of this document is available online at https://www.gnu.org/software/gawk/manual.

The GNU gettext documentation, available online at https://www.gnu.org/software/gettext.

PRZYKŁADY
Wypisz i posortuj nazwy zgłoszeniowe (login) wszystkich użytkowników:

	BEGIN	{ FS = ":" } 		{ print $1 | "sort" }

Zlicz linie w pliku:

		{ nlines++ } 	END	{ print nlines }

Poprzedź każdą linię jej numerem w pliku:

	{ print FNR, $0 }

Konkatenatuj i numeruj linie (wariacja tematu):

	{ print NR, $0 }

Run an external command for particular lines of data:

	tail -f access_log | 	awk '/myhome.html/ { system("nmap " $1 ">> logdir/myhome.html") }'

KOPIOWANIE NINIEJSZEJ DOKUMENTACJI
Copyright © 1989, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022 Free Software Foundation, Inc.

Permission is granted to make and distribute verbatim copies of this manual page provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual page under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual page into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Foundation.

TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys <pborys@dione.ids.pl> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 (https://www.gnu.org/licenses/gpl-3.0.html) lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.