NMAKE マクロを使用する

マクロの関数

NMAKE には、文字列、項目の一覧、ファイル パスを変更するために使用できる一連の関数が含まれています。 それらの関数は、Visual Studio 2022 以降の NMAKE で使用できます。

関数の構文

関数では、次の構文を使用します。

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

関数への引数には任意の文字列を指定できます。また、入れ子になったマクロ呼び出しを含めることができます。 特殊な場合を除き、引数を null にすることはできません。

関数名と引数リストの間の余分な空白文字は無視されます。 最初の引数の先頭に空白が必要な場合は、必要な空白文字を含むマクロを使用します。

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

引数リスト内のコンマは常に引数の区切り記号と見なされ、エスケープできません。 引数にリテラル コンマが必要な場合は、代わりにコンマが含まれるマクロを使用します。

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

リスト構文

一部の関数では、空白で区切られた項目のリストをサポートしています。 リストの先頭、リストの末尾、または各項目間の余分な空白文字は無視されます。 関数によって生成されるリストでは、各項目間の区切り記号として 1 つのスペースを使用し、先頭または末尾に空白文字は付きません。

たとえば、最も単純なリスト関数は strip で、単一のリスト引数を取り、まったく同じ項目が含まれるリストを生成します (ただし、前述のように空白文字はクリーンアップされます)。

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

パターンの構文

一部の関数では、"パターン" の使用をサポートしています。 パターンとは、任意の数の文字と一致する単一のワイルドカードが含まれる文字列のことです。 パターンの最初の % がワイルドカードであり、以降の % 文字はリテラルとして扱われます。 実際のワイルドカードより前にある % は、\ を使用してエスケープできます (つまり、\% はリテラルの % として扱われます)。 ワイルドカードをエスケープする \ は、別の \ を使用してエスケープできます (これで \\% はリテラルの \ とそれに続くワイルドカードとして扱われます)。 一致と見なされるには、すべての入力文字がパターンに一致する必要があります。部分一致はサポートされていません。

filter 関数を使用したパターンを次に示します。パターンと一致する項目のみが保持されます。

$(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

カテゴリ別の関数