# dmd.root.response

Parse command line arguments from `response` files.

#### Discussion

This file is not shared with other compilers which use the DMD front-end.

#### Authors

Walter Bright

#### License

Boost License 1.0

Source: root/response.d

Documentation: https://dlang.org/phobos/dmd_root_response.html

Coverage: https://codecov.io/gh/dlang/dmd/src/master/src/dmd/root/response.d

- `responseExpand`

  #### Declaration

  `alias `responseExpand` = responseExpandFrom!(lookupInEnvironment).responseExpandFrom;`

- `responseExpandFrom`

  #### Declaration

  `nothrow bool `responseExpandFrom`(alias lookup)(ref Strings `args`);`

  Expand any response files in command line. Response files are arguments that look like: @NAME The names are resolved by calling the 'lookup' function passed as a template parameter. That function is expected to first check the environment and then the file system. Arguments are separated by spaces, tabs, or newlines. These can be imbedded within arguments by enclosing the argument in "". Backslashes can be used to escape a ". A line comment can be started with #. Recursively expands nested response files.

  #### Discussion

  To use, put the arguments in a Strings object and call this on it.
  Digital Mars's MAKE program can be notified that a program can accept long command lines via environment variables by preceding the rule line for the program with a *.

  #### Parameters

  `lookup` | alias to a function that is called to look up response file arguments in the environment. It is expected to accept a `null`- terminated string and return a mutable char[] that ends with a `null`-terminator or `null` if the response file could not be resolved.
  `Strings `args`` | array containing arguments as `null`-terminated strings

  #### Return Value

  `true` on success, `false` if a response file could not be expanded.

- `insertArgumentsFromResponse`

  #### Declaration

  `nothrow bool `insertArgumentsFromResponse`(char[] `buffer`, ref Strings `args`, ref size_t `argIndex`);`

  Take the contents of a response-file '`buffer`', parse it and put the resulting arguments in '`args`' at '`argIndex`'. '`argIndex`' will be updated to point just after the inserted arguments. The logic of this should match that in setargv()

  #### Parameters

  `char[] `buffer`` | mutable string containing the response file
  `Strings `args`` | list of arguments
  `size_t `argIndex`` | position in '`args`' where response arguments are inserted

  #### Return Value

  `true` if another response argument was found