nmake-function-filterout.md

description	title	ms.date	helpviewer_keywords	monikerRange
Learn more about: filterout, filterouti NMAKE functions	filterout, filterouti NMAKE functions	9/30/2021	filterout NMAKE function filterouti NMAKE function NMAKE function, filterout NMAKE function, filterouti	>=msvc-170

filterout, filterouti NMAKE functions

Evaluates to a list of items that don't match any patterns.

Syntax

$(filterout filters,input)
$(filterouti filters,input)

Parameters

filters
A list of one or more patterns to filter by.

input
The list to be filtered.

Return value

A list of all of the items in input that don't match any patterns in filters.

Remarks

filterouti is the case-insensitive version of filterout.

This macro function is available starting in Visual Studio 2022, in NMAKE version 14.30 or later.

Example

$(filterout He%,Hello Hey Hi) # Evaluates to "Hi" - "Hello" and "Hey" match the filter
$(filterout %y %i,Hello Hey Hi) # Evaluates to "Hello" - items are kept if they don't match any filters, "Hey" and "Hi" each match one filter
$(filterout H%,Hello Hey Hi) # Evaluates to "" - each of the items matched the filter

$(filterout he%,Hello Hey Hi) # Evaluates to "Hello Hey Hi" - filterout is case-sensitive
$(filterouti he%,Hello Hey Hi) # Evaluates to "Hi" - filterouti is case-insensitive

See also

Macros and NMAKE
NMAKE functions by category
filter, filteri