Note: This is a low level API function. A high level function implementing the same functionality with a simplified usage pattern exists. This function is available as an alternative if the default library behaviour is not desirable.