Utiliser une macro NMAKE

Fonctions de macro

NMAKE fournit un ensemble de fonctions qui peuvent être utilisées pour modifier des chaînes, des listes d’éléments et des chemins d’accès aux fichiers. Ces fonctions sont disponibles dans NMAKE à partir de Visual Studio 2022.

Syntaxe de la fonction

Les fonctions utilisent la syntaxe suivante :

$(function_name arg0,arg1,arg2...)

Les arguments d’une fonction peuvent être n’importe quelle chaîne et peuvent inclure des appels de macro imbriqués. Sauf dans les cas spéciaux, les arguments ne peuvent pas être null.

Tout espace blanc supplémentaire entre le nom de la fonction et la liste d’arguments est ignoré. Si le premier argument nécessite un espace blanc de début, utilisez une macro qui contient l’espace blanc nécessaire :

SINGLESPACE=$(subst ',,' ') # Use "subst" since a normal assignment trims trailing whitespace.
$(subst $(SINGLESPACE)an,irec,red ant) # Evaluates to "redirect"

Les virgules dans une liste d’arguments sont toujours considérées comme des séparateurs d’arguments et ne peuvent pas être échappées. Si un argument nécessite une virgule littérale, utilisez une macro qui contient une virgule à la place :

COMMA=,
INPUT=a, b
$(subst $(COMMA) , and ,$(INPUT)) # Evaluates to "a and b"

Syntaxe de liste

Certaines fonctions prennent en charge une liste d’éléments séparés par des espaces blancs. Un espace blanc supplémentaire est ignoré au début de la liste, à la fin de la liste ou entre chaque élément. Les listes produites par une fonction utilisent un espace unique entre chaque élément comme séparateur et n’ont pas d’espace blanc de début ou de fin.

Par exemple, la fonction de liste la plus simple est strip, qui prend un argument de liste unique et produit une liste avec exactement les mêmes éléments (mais avec l’espace blanc nettoyé comme ci-dessus) :

$(strip a   b   c d    ) # Evaluates to "a b c d"

Syntaxe du modèle

Certaines fonctions prennent en charge l’utilisation d’un modèle. Un modèle est une chaîne qui contient un caractère générique unique qui peut correspondre à n’importe quel nombre de caractères. Le premier % d’un modèle est le caractère générique, et tous les caractères ultérieurs % sont traités comme des littéraux. N’importe % où avant que le caractère générique réel puisse être échappé à l’aide \ (autrement dit, \% est traité comme un littéral %). Tout \ élément qui échapperait au caractère générique peut être échappé avec un autre \ ( \\% il est donc traité comme un littéral \ suivi du caractère générique). Pour être considéré comme une correspondance, tous les caractères d’entrée doivent être mis en correspondance par le modèle ; les correspondances partielles ne sont pas prises en charge.

Les modèles peuvent être démontrés à l’aide de la filter fonction, qui conserve uniquement les éléments qui correspondent au modèle :

$(filter abc,abc) # Evaluates to "abc" - exactly matches
$(filter bc,abc) # Evaluates to "" - pattern "bc" only matches part of the item "abc"
$(filter %ef,abcdef) # Evaluates to "abcdef" - wildcard matches "abcd"
$(filter a%f,abcdef) # Evaluates to "abcdef" - wildcard matches "bcde"
$(filter %abc,abc) # Evaluates to "abc" - wildcard doesn't need to match any characters
$(filter a%c%d,abcd abc%d) # Evaluates to "abc%d" - only the first `%` is a wildcard, the rest are literals
$(filter a\%b%d,a%bcd) # Evaluates to "a%bcd" - `%` before the wildcard must be escaped with `\`
$(filter a\\%cd,a\bcd) # Evaluates to "a\bcd" - a `\` that would escape the wildcard must be escaped with another `\`
$(filter a%c\\%d,abc\\%d) # Evaluates to "abc\\%d" - any `\` after the wildcard isn't treated as an escape
$(filter \\a%f,\\abcdef) # Evaluates to "\\abcdef" - any `\\` that isn't directly before the wildcard isn't treated as an escape

Fonctions par catégorie