glib-mkenums – En ligne dans le cloud

PROGRAMME:

Nom

glib-mkenums - Utilitaire de génération de descriptions d'énumérations en langage C

SYNOPSIS

glib-mkenums [FICHIER D'OPTIONS...]

DESCRIPTION

glib-mkenums est un petit utilitaire de script Perl qui analyse le code C pour extraire les définitions d'énumération
et produit des descriptions d'énumération basées sur des modèles de texte spécifiés par l'utilisateur.
ce script est souvent utilisé pour produire du code C qui contient des valeurs d'énumération sous forme de chaînes.
les programmes peuvent fournir des chaînes de noms de valeurs pour l'introspection.

glib-mkenums prend en entrée une liste de fichiers de code C valides. Les options spécifiées contrôlent
le texte qui est sorti, certaines substitutions sont effectuées sur les modèles de texte pour
mots-clés entourés de caractères @.

Production texte substitutions
Certains mots-clés entourés de caractères @ seront substitués dans le texte émis. Pour le
exemples de substitution des mots-clés ci-dessous, l'exemple de définition d'énumération suivant est
assumé:

@EnumName@
Le nom de l'énumération en cours de traitement, les noms d'énumération sont supposés être correctement
namespaced et utiliser des majuscules mixtes pour séparer les mots (par exemple PrefixTheXEnum).

@enum_name@
Le nom de l'énumération avec les mots en minuscules et séparés par des traits de soulignement (par exemple
préfixe_le_xénum).

@ENUMNAME@
Le nom de l'énumération avec les mots en majuscules et séparés par des traits de soulignement (par exemple
PREFIXE_LE_XENUM).

@ENUMSHORT@
Le nom de l'énumération avec les mots en majuscules et séparés par des traits de soulignement, le préfixe supprimé
(par exemple THE_XENUM).

@ENUMPREFIX@
Le préfixe du nom de l'énumération (par exemple PREFIX).

@VALUENAME@
Le nom de la valeur d'énumération en cours de traitement avec des mots en majuscules et séparés par des mots
par des traits de soulignement, il s'agit de la notation littérale supposée des valeurs d'énumération dans les sources C
(par exemple PREFIX_THE_XVALUE).

@valuenick@
Un surnom pour la valeur d'énumération en cours de traitement, il est généralement généré par
en supprimant les mots préfixes communs de toutes les valeurs d'énumération de l'énumération actuelle, les mots
sont en minuscules et les traits de soulignement sont remplacés par un signe moins (par exemple, la valeur x).

@valuenum@
Valeur entière de l'énumération en cours de traitement. Ce calcul est le suivant :
grâce à perl pour tenter d'évaluer l'expression telle qu'elle apparaît dans le code source C.
Si l’évaluation échoue alors glib-mkenums quittera avec un statut d'erreur, mais cela uniquement
Cela se produit si @valuenum@ apparaît dans votre modèle de production de valeur. (Depuis : 2.26)

@taper@
Ceci est remplacé soit par « enum » soit par « flags », selon que la valeur enum
les définitions contenaient ou non des opérateurs de décalage de bits (par exemple des drapeaux).

@Taper@
Identique à @type@ avec la première lettre en majuscule (par exemple Flags).

@TAPER@
Identique à @type@ avec toutes les lettres en majuscules (par exemple FLAGS).

@nom de fichier@
Le nom du fichier d'entrée en cours de traitement (par exemple foo.h).

@basename@
Nom de base du fichier d'entrée en cours de traitement (par exemple, foo.h). (Depuis : 2.22)

Trigraphe extensions
Certains commentaires C sont traités spécialement dans les définitions d'énumération analysées, ces commentaires commencent
sortir avec la séquence de trigraphes /*< et terminer avec la séquence de trigraphes >*/. Par énumération
définition, les options « skip » et « flags » peuvent être spécifiées, pour indiquer cette énumération
définition à ignorer, ou à traiter comme une définition d'indicateurs, ou à spécifier le
préfixe commun à supprimer de toutes les valeurs pour générer des surnoms de valeur, respectivement.
L'option « underscore_name » peut être utilisée pour spécifier la séparation des mots utilisée dans le
Fonction *_get_type(). Par exemple, /*< underscore_name=gnome_vfs_uri_hide_options >*/.

Par définition de valeur, les options « skip » et « nick » sont prises en charge. La première entraîne la
valeur à ignorer, et cette dernière peut être utilisée pour spécifier la valeur générée automatiquement
surnom. Exemples :

OPTIONS

--fhead TEXTE
Éteindre TEXTE avant de traiter les fichiers d'entrée.

--fprod TEXTE
Éteindre TEXTE chaque fois qu'un nouveau fichier d'entrée est en cours de traitement.

--ftail TEXTE
Éteindre TEXTE une fois que tous les fichiers d'entrée ont été traités.

--eprod TEXTE
Éteindre TEXTE chaque fois qu'une énumération est rencontrée dans les fichiers d'entrée.

--vhead TEXTE
Éteindre TEXTE avant d'itérer sur l'ensemble des valeurs d'une énumération.

--vprod TEXTE
Éteindre TEXTE pour chaque valeur d'une énumération.

--vtail TEXTE
Éteindre TEXTE après avoir parcouru toutes les valeurs d'une énumération.

--commentaires TEXTE
Modèle pour les commentaires générés automatiquement, la valeur par défaut (pour les générations de code C) est « /* »
@commentaire@ */".

--modèle DOSSIER
Lire les modèles du fichier fourni. Les modèles sont inclus dans des fichiers spécialement formatés.
Commentaires C
où la section peut être un en-tête de fichier, une production de fichier, une queue de fichier, une production d'énumération,
en-tête de valeur, production de valeur, queue de valeur ou commentaire.

--identifiant-préfixe PRÉFIXE
Indique quelle partie du nom d'énumération doit être interprétée comme le préfixe (par exemple, le
« Gtk » dans « GtkDirectionType »). Normalement, cela se fait automatiquement, mais vous
il peut être nécessaire de remplacer la valeur par défaut si votre espace de noms est en majuscules de manière étrange.

--préfixe-symbole PRÉFIXE
Indique quel préfixe doit être utilisé pour correspondre au préfixe d'identification dans les éléments associés
Noms de fonctions C (par exemple, le « gtk » dans « gtk_direction_type_get_type ». De manière équivalente, ceci
est la version minuscule du composant préfixe des noms de valeur d'énumération (par exemple, le
« GTK » dans « GTK_DIR_UP ». La valeur par défaut est le préfixe de l'identifiant, converti en
minuscule.

--Aidez-moi
Imprimez une brève aide et quittez.

--version
Version imprimable et sortie.

Utiliser glib-mkenums en ligne avec les services onworks.net