glib-mkenums — online w chmurze

PROGRAM:

IMIĘ

glib-mkenums — narzędzie do generowania opisu enum w języku C

STRESZCZENIE

glib-mkenums [PLIK OPCJI...]

OPIS

glib-mkenums to małe narzędzie perla-skryptu, które analizuje kod C w celu wyodrębnienia definicji enum
i tworzy opisy wyliczeniowe na podstawie szablonów tekstowych określonych przez użytkownika. Bardzo
często ten skrypt jest używany do tworzenia kodu C, który zawiera wartości wyliczeniowe jako ciągi znaków, więc
programy mogą dostarczać ciągi nazw wartości do introspekcji.

glib-mkenums pobiera listę poprawnych plików kodu C jako dane wejściowe. Opcje określone control
tekstu, który jest wyprowadzany, w szablonach tekstowych wykonywane są pewne podstawienia
słowa kluczowe ujęte w znaki @.

Produkcja XNUMX substytucje
Niektóre słowa kluczowe ujęte w znaki @ zostaną zastąpione w emitowanym tekście. Dla
Przykłady podstawienia słów kluczowych poniżej, następujący przykład enum definicja jest
przypuszczalny:

@EnumNazwa@
Nazwa aktualnie przetwarzanego wyliczenia, zakłada się, że nazwy wyliczeń są poprawne
przestrzeni nazw i używać mieszanych wielkich liter do oddzielania słów (np. PrefixTheXEnum).

@nazwa_wyliczenia@
Nazwa enum ze słowami pisanymi małymi literami i oddzielonymi podkreśleniami (np
prefix_the_xenum).

@ENUMNAME@
Nazwa enum ze słowami pisanymi wielkimi literami i słowami oddzielonymi podkreśleniami (np
PREFIX_THE_XENUM).

@ENUMSHORT@
Nazwa wyliczeniowa ze słowami pisanymi wielkimi literami i wyrazami oddzielonymi podkreśleniami, z usuniętym prefiksem
(np. THE_XENUM).

@ENUMPREFIX@
Prefiks nazwy wyliczenia (np. PREFIX).

@NAZWA WARTOŚCI@
Aktualnie przetwarzana nazwa wartości wyliczenia ze słowami pisanymi wielkimi literami i oddzielonymi wyrazami
przez podkreślenia, jest to przyjęty dosłowny zapis wartości wyliczeniowych w źródłach C
(np. PREFIX_THE_XVALUE).

@valuenick@
Pseudonim aktualnie przetwarzanej wartości wyliczeniowej, zwykle generowany przez
usuwanie wspólnych słów prefiksu ze wszystkich wartości wyliczeniowych bieżącego wyliczenia, słów
są małymi literami, a podkreślenia są zastępowane przez minus (np. wartość-x).

@numer_wartości@
Wartość całkowita dla aktualnie przetwarzanej wartości wyliczenia. Oblicza się to wg
za pomocą Perl aby spróbować ocenić wyrażenie, które pojawia się w kodzie źródłowym C.
Jeśli ocena się nie powiedzie, to glib-mkenums zakończy się ze statusem błędu, ale tylko tym
dzieje się tak, jeśli @wartośćnum@ pojawia się w szablonie tworzenia wartości. (Od: 2.26)

@typ@
Jest to zastępowane przez „wyliczenie” lub „flagi”, w zależności od tego, czy wartość wyliczenia
definicje zawierały operatory przesunięcia bitowego lub nie (np. flagi).

@Typ@
To samo co @type@ z pierwszą wielką literą (np. Flagi).

@TYP@
To samo co @typ@ z wielkimi literami (np. FLAGI).

@Nazwa pliku@
Nazwa aktualnie przetwarzanego pliku wejściowego (np. foo.h).

@nazwa bazy@
Podstawowa nazwa aktualnie przetwarzanego pliku wejściowego (np. foo.h). (Od: 2.22)

Trygraf rozszerzenia
Niektóre komentarze C są traktowane specjalnie w parsowanych definicjach enum, takie komentarze zaczynają się
out z sekwencją trygrafów /*< i zakończyć sekwencją trygrafów >*/. Na wyliczenie
definicji można określić opcje „pomiń” i „flagi”, aby wskazać to wyliczenie
definicję, która ma zostać pominięta lub traktowana jako definicja flagi, lub określić
wspólny przedrostek, który ma zostać usunięty ze wszystkich wartości w celu wygenerowania odpowiednio pseudonimów wartości.
Opcji „underscore_name” można użyć do określenia separacji słów używanej w pliku
*_get_type() funkcja. Na przykład /*< nazwa_podkreślenia=gnome_vfs_uri_hide_options >*/.

Dla definicji wartości obsługiwane są opcje „pomiń” i „nick”. Ten pierwszy powoduje
wartość do pominięcia, a ta ostatnia może być użyta do określenia wartości generowanej automatycznie
przezwisko. Przykłady:

OPCJE

--głowa TEKST
Zgasić TEKST przed przetwarzaniem plików wejściowych.

--fprod TEKST
Zgasić TEKST za każdym razem, gdy przetwarzany jest nowy plik wejściowy.

--płatek TEKST
Zgasić TEKST po przetworzeniu wszystkich plików wejściowych.

--eprod TEKST
Zgasić TEKST za każdym razem, gdy w plikach wejściowych zostanie napotkane wyliczenie.

--vhead TEKST
Zgasić TEKST przed iteracją po zbiorze wartości wyliczenia.

--wprod TEKST
Zgasić TEKST dla każdej wartości wyliczenia.

--vtail TEKST
Zgasić TEKST po iteracji po wszystkich wartościach enum.

--uwagi TEKST
Szablon dla automatycznie generowanych komentarzy, domyślny (dla generowania kodu C) to "/*
@komentarz@ */".

--szablon FILE
Odczytaj szablony z podanego pliku. Szablony są dołączone do specjalnie sformatowanych
komentarze C
gdzie sekcja może być nagłówkiem pliku, produkcją pliku, zakończeniem pliku, produkcją wyliczenia,
nagłówek wartości, produkcja wartości, ogon wartości lub komentarz.

--identyfikator-przedrostek PREFIKSÓW
Wskazuje, jaka część nazwy enum powinna być interpretowana jako przedrostek (np
„Gtk” w „GtkDirectionType”). Zwykle zostanie to wymyślone automatycznie, ale ty
może być konieczne zastąpienie wartości domyślnej, jeśli przestrzeń nazw jest dziwnie pisana dużymi literami.

--symbol-przedrostek PREFIKSÓW
Wskazuje, jakiego prefiksu należy użyć, aby odpowiadał prefiksowi identyfikatora w pokrewnych
Nazwy funkcji C (np. „gtk” w „gtk_direction_type_get_type”. Równoważnie to
jest małą wersją składnika prefiksu nazw wartości wyliczeniowych (np
„GTK” w „GTK_DIR_UP”. Wartością domyślną jest przedrostek identyfikatora, przekonwertowany na
małe litery.

--help
Wydrukuj krótką pomoc i wyjdź.

--wersja
Wydrukuj wersję i wyjdź.

Korzystaj z glib-mkenums online, korzystając z usług onworks.net