NAME

TUI::Objects::NSCollection - internal non-storable collection base class

DESCRIPTION

TNSCollection is the non-storable base variant of the Turbo Vision collection classes. It exists primarily for internal use, most notably by the stream and resource management infrastructure.

This class provides the same operational behavior as TCollection, but is not intended to be used directly by application code. Public-facing code should always use TCollection or one of its derived classes instead.

The non-storable variants are required to separate internal framework mechanisms from the storable collection types used elsewhere in the library.

VARIABLES

%ITEMS

Internal global hash used to maintain item references for all TCollection objects.

The collection elements are stored as references in this hash. Keys are derived using Hash::Util::FieldHash::id, ensuring stable and unique identification of collection items.

This variable is for internal use only and mirrors the reference handling approach of the original Turbo Vision implementation.

See also Scalar::Util::refaddr.

NOTE

This class is considered internal.

Although TNSCollection implements a full collection interface, it should not be instantiated or subclassed directly outside of the framework itself.

SEE ALSO

TUI::Objects::Collection, TUI::Objects::SortedCollection, TUI::Objects::StringCollection

AUTHORS

Borland International (original Turbo Vision design)

J. Schneider <brickpool@cpan.org> (Perl implementation and maintenance)

COPYRIGHT AND LICENSE

Copyright (c) 1990-1994, 1997 by Borland International

Copyright (c) 2021-2026 the "AUTHORS" as listed above.

This software is licensed under the MIT license (see the LICENSE file, which is part of the distribution).