uCalc API Version: 2.1.3-preview.2 Released: 6/16/2026

Warning

uCalc API Preview Release Notice:The documentation describes the intended behavior of the API. The current preview build contains incomplete features, unoptimized performance, and is subject to breaking changes.

ChildStringOption = [ChildStringOptions]

Property

Product: 

String Library

Class: 

String

Gets the option

Remarks

Many functions create a new string object derived from another given object. This option determines the persistence of previously derived objects. The right option depends on what you want to do. If you're looking to conserve memory, then ClearAll may be the option you need. However, with this option, you can no longer refer to previously derived strings, otherwise the behavior will be undefined (such as crashing). You may delay object deletetion be removing only the ones that overlap in location with the newly derived string. The decision to delete may be delayed based on when an object is being written to. ChildStringOptions::ClearOverlapOnWrite, allows you to have multiple overlapping views of the same parent string without any conflict. Only when modifying a derived string are overlapped derived strings removed. Corresponding Detach options are similar, except that instead of actually erasing an overlapping object, it is disassociated from the parent string. It can continue to be used as an independent string without undefined behavior. With this option, the independent strings are erased only when the parent string itself is erased.

Examples