What is a use case for this function? If you can think of one, add an example to the doc. If you can't, then remove this function.