# PreprocessingTool

@Incubating
interface PreprocessingTool : Tool(source)

### Deprecated

The Gradle software model is deprecated and will be removed in Gradle 10. Use the new component model (e.g. `cpp-application`, `cpp-library`, `swift-application`, `swift-library`, `xctest`) instead.

A tool that permits configuration of the C preprocessor.

#### Since

2.10

## Functions

args
Link copied to clipboard
abstract fun args(args: Array<String>)
Adds a number of arguments to be passed to the tool.
define
Link copied to clipboard
abstract fun define(name: String)
Defines a named preprocessor macros to use when compiling this binary.
abstract fun define(name: String, definition: String)
Defines a named preprocessor macro with a value, which will be used when compiling this binary.
getArgs
Link copied to clipboard
abstract fun getArgs(): List<String>
The arguments passed when executing this tool.
getMacros
Link copied to clipboard
abstract fun getMacros(): Map<String, String>
The set of preprocessor macros to define when compiling this binary.