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 const(char)* 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

    null on success, or the first response file that could not be found

  • 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