===============================================================================

SYNTAX :: substr( main , target , replacement ) ;

This sfun will scan the "main" string for instances of the "target" string
. It will then replace these instances with the "replacement" string.

The resulting version of the "main" string will then be returned.
