StrInsertRangeL

Description

Insert a contiguous range of characters at idx, preserving the order of trailing characters. L-form (ownership-transfer); source range zeroed-on-take per the L-form invariant.

For Zstr/Cstr (const) source ranges use StrInsertMany.

Success

Returns true; str grew by count characters at idx; trailing characters shifted right by count; source range zeroed-on-take per the L-form invariant.

Failure

Returns false on allocation failure; source range was already zeroed-on-take, str is unchanged.

Usage example (Cross-references)

    /// TAGS: Str, Insert, Range
    ///
    #define StrInsertRange(str, varr, idx, count) StrInsertRangeL((str), (varr), (idx), (count))
    
    ///