Implement new API function to reduce duplication
completed by: Johannes Schulte
This is a follow-on to a new API design task.
This task involves implementing a new function that will measurably help reduce code duplication. You'll need to have already identified a piece of duplicated code that needs to be refactored and/or modified.
This task involves implementing the function per the header doxygen comment specification. Make sure your implementation is clean, fits well with our existing conventions, and is an efficient implementation that will help reduce code. Be meticulous.
Submit a patch file with your implementation.