System::Collections::Specialized::StringCollection Class Reference

Indexed list of strings. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...

Inherits System::Collections::Generic::IEnumerable< System::String >.

Classes

class  Enumerator
 Enumerator type to iterate through string collection. More...
 

Public Member Functions

 StringCollection ()
 Constructs empty string collection. More...
 
SharedPtr< Generic::IEnumerator< System::String > > GetEnumerator () override
 Gets enumerator iterating through current collection. More...
 
int get_Count () const
 Gets number of elements in collection. More...
 
System::Stringoperator[] (int index)
 Accessor function. More...
 
System::String idx_get (int index) const
 Gets value at specified position. More...
 
void idx_set (int index, const System::String &value)
 Sets value at specified position. More...
 
int Add (const System::String &value)
 Adds value to the end of the list. More...
 
void AddRange (const ArrayPtr< System::String > &range)
 Add elements into container. More...
 
void CopyTo (const ArrayPtr< System::String > &arr, const int32_t index) const
 Copy elements to existing arra elements. More...
 
void Clear ()
 Deletes all elements. More...
 
bool Contains (const System::String &value) const
 Checks whether specific string is present in container. More...
 
int IndexOf (const System::String &value) const
 Looks for specific string in container. More...
 
void Insert (int index, const System::String &value)
 Inserts specific value into container. More...
 
void Remove (const System::String &value)
 Removes first occurrence of specified string. More...
 
void RemoveAt (int index)
 Removes element at specified position. More...
 
std::vector< System::String > & data ()
 Internal data structure accessor. More...
 
const std::vector< System::String > & data () const
 Internal data structure accessor. More...
 
- Public Member Functions inherited from System::Collections::Generic::IEnumerable< System::String >
System::String LINQ_ElementAt (int index)
 Returns the element at a specified index in a sequence. More...
 
System::String LINQ_First ()
 Returns the first element of a sequence. More...
 
System::String LINQ_First (const Func< System::String, bool > &predicate)
 Returns the first element of a sequence that satisfy the specified condition. More...
 
System::String LINQ_FirstOrDefault ()
 Returns the first element of a sequence, or a default value if the sequence is empty. More...
 
System::String LINQ_FirstOrDefault (std::function< bool(System::String)> predicate)
 Returns the first element of the sequence that satisfies a condition or a default value if no such element is found. More...
 
System::String LINQ_Last ()
 Returns the last element of a sequence. More...
 
System::String LINQ_LastOrDefault ()
 Returns the last element of a sequence, or a default value if the sequence is empty. More...
 
SharedPtr< List< System::String > > LINQ_ToList ()
 Creates a List<T> from a sequence. More...
 
int LINQ_Count ()
 Returns the number of elements in the sequence (calculated via direct counting). More...
 
int LINQ_Count (const Func< System::String, bool > &predicate)
 Returns the number of elements in the sequence that satisfy the specified condition. More...
 
System::ArrayPtr< System::StringLINQ_ToArray ()
 Creates an array from a sequence. More...
 
bool LINQ_All (std::function< bool(System::String)> predicate)
 Determines whether all elements of a sequence satisfy a condition. More...
 
bool LINQ_Any ()
 Determines whether a sequence contains any elements. More...
 
bool LINQ_Any (std::function< bool(System::String)> predicate)
 Determines whether any element of a sequence exists or satisfies a condition. More...
 
SharedPtr< IEnumerable< System::String > > LINQ_Where (std::function< bool(System::String)> predicate)
 Filters a sequence based on the specified predicate. More...
 
bool LINQ_Contains (System::String value)
 Determines if a sequence contains a specified value. More...
 
SharedPtr< IEnumerable< ResultType > > LINQ_Cast ()
 Casts the elements to the specified type. More...
 
SharedPtr< IEnumerable< Result > > LINQ_Cast ()
 
SharedPtr< IEnumerable< System::String > > LINQ_OrderBy (const Func< System::String, Key > &keySelector)
 Sorts the elements of a sequence in ascending order according to the key values selected by keySelector. More...
 
SharedPtr< IEnumerable< Source > > LINQ_OrderBy (const Func< Source, Key > &keySelector)
 
SharedPtr< IEnumerable< System::String > > LINQ_OrderByDescending (const Func< System::String, Key > &keySelector)
 Sorts the elements of a sequence in descending order according to the key values selected by keySelector. More...
 
SharedPtr< IEnumerable< Source > > LINQ_OrderByDescending (const Func< Source, Key > &keySelector)
 
SharedPtr< IEnumerable< ResultType > > LINQ_OfType ()
 Filters the elements of the sequence based on the specified type. More...
 
SharedPtr< IEnumerable< Result > > LINQ_OfType ()
 
SharedPtr< IEnumerable< ResultType > > LINQ_Select (const Func< System::String, ResultType > &selector)
 Transforms elements of a sequence. More...
 
SharedPtr< IEnumerable< ResultType > > LINQ_Select (const Func< System::String, int32_t, ResultType > &selector)
 Transforms each element of a sequence into a new form by incorporating the element's index. More...
 
SharedPtr< IEnumerable< Result > > LINQ_Select (const Func< Source, Result > &selector)
 
SharedPtr< IEnumerable< Result > > LINQ_Select (const Func< Source, int32_t, Result > &selector)
 
SharedPtr< IEnumerable< System::String > > LINQ_Concat (SharedPtr< IEnumerable< System::String >> sequence)
 Concatenates two sequences. More...
 
System::SharedPtr< IEnumerable< System::SharedPtr< System::Linq::IGrouping< Key, System::String > > > > LINQ_GroupBy (System::Func< System::String, Key > keyPredicate)
 Groups the elements of a sequence. More...
 
SharedPtr< IEnumerable< SharedPtr< System::Linq::IGrouping< Key, Source > > > > LINQ_GroupBy (System::Func< Source, Key > keyPredicate)
 
SharedPtr< IEnumerable< ResultType > > LINQ_SelectMany (const Func< System::String, SharedPtr< IEnumerable< ResultType >>> &selector)
 Projects each element of a sequence and combines the resulting sequences into one sequence. More...
 
SharedPtr< IEnumerable< Result > > LINQ_SelectMany (const Func< Source, SharedPtr< IEnumerable< Result >>> &selector)
 
iterator begin () noexcept
 Gets iterator pointing to the first element (if any) of the collection. This iterator can't be used to change a referenced object because GetEnumerator() returns a copy-object of T. More...
 
const_iterator begin () const noexcept
 Gets iterator pointing to the first element (if any) of the const-qualified instance of the collection. More...
 
iterator end () noexcept
 Gets iterator pointing right after the last element (if any) of the collection. This iterator can't be used to change a referenced object because GetEnumerator() returns a copy-object of T. More...
 
const_iterator end () const noexcept
 Gets iterator pointing right after the last element (if any) of the const-qualified instance of the collection. More...
 
const_iterator cbegin () const noexcept
 Gets iterator pointing to the first const-qualified element (if any) of the collection. More...
 
const_iterator cend () const noexcept
 Gets iterator pointing right after the last const-qualified element (if any) of the collection. More...
 
- Public Member Functions inherited from System::Object
 Object ()
 Creates object. Initializes all internal data structures. More...
 
virtual ~Object ()
 Destroys object. Frees all internal data structures. More...
 
 Object (Object const &x)
 Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
Objectoperator= (Object const &x)
 Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
ObjectSharedRefAdded ()
 Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int SharedRefRemovedSafe ()
 Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int RemovedSharedRefs (int count)
 Decreases shared reference count by specified value. More...
 
Detail::SmartPtrCounter * WeakRefAdded ()
 Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
void WeakRefRemoved ()
 Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
Detail::SmartPtrCounter * GetCounter ()
 Gets reference counter data structure associated with the object. More...
 
int SharedCount () const
 Gets current value of shared reference counter. More...
 
void Lock ()
 Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...
 
void Unlock ()
 Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...
 
virtual bool Equals (ptr obj)
 Compares objects using C# Object.Equals semantics. More...
 
virtual int32_t GetHashCode () const
 Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...
 
virtual String ToString () const
 Analog of C# Object.ToString() method. Enables converting custom objects to string. More...
 
virtual ptr MemberwiseClone () const
 Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...
 
virtual const TypeInfoGetType () const
 Gets actual type of object. Analog of C# System.Object.GetType() call. More...
 
virtual bool Is (const TypeInfo &targetType) const
 Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...
 
virtual void SetTemplateWeakPtr (uint32_t argument)
 Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...
 
virtual bool FastCast (const Details::FastRttiBase &helper, void **out_ptr) const
 For internal purposes only. More...
 
template<>
bool ReferenceEquals (String const &str, std::nullptr_t)
 Specialization of Object::ReferenceEquals for case of string and nullptr. More...
 
template<>
bool ReferenceEquals (String const &str1, String const &str2)
 Specialization of Object::ReferenceEquals for case of strings. More...
 

Protected Member Functions

 ~StringCollection () override
 Destructor. More...
 
- Protected Member Functions inherited from System::Collections::Generic::IEnumerable< System::String >
 ~IEnumerable () override
 Destructor. More...
 

Additional Inherited Members

- Public Types inherited from System::Collections::Generic::IEnumerable< System::String >
typedef IEnumerator< System::StringIEnumeratorType
 Enumerator type. More...
 
using ValueType = System::String
 
using iterator = EnumeratorBasedIterator< System::String, IEnumerator< System::String > >
 
using const_iterator = iterator
 
- Public Types inherited from System::Object
typedef SmartPtr< Objectptr
 Alias for smart pointer type. More...
 
- Static Public Member Functions inherited from System::Object
static bool ReferenceEquals (ptr const &objA, ptr const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, T const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, std::nullptr_t)
 Reference-compares value type object with nullptr. More...
 
template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares reference type objects in C# style. More...
 
template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares value type objects in C# style. More...
 
static const TypeInfoType ()
 Implements C# typeof(System.Object) construct. More...
 
template<>
bool Equals (float const &objA, float const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 
template<>
bool Equals (double const &objA, double const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 

Detailed Description

Indexed list of strings. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument.

Constructor & Destructor Documentation

◆ StringCollection()

System::Collections::Specialized::StringCollection::StringCollection ( )

Constructs empty string collection.

◆ ~StringCollection()

System::Collections::Specialized::StringCollection::~StringCollection ( )
overrideprotected

Destructor.

Member Function Documentation

◆ Add()

int System::Collections::Specialized::StringCollection::Add ( const System::String value)

Adds value to the end of the list.

Parameters
valueString to add.
Returns
Index of inserted element.

◆ AddRange()

void System::Collections::Specialized::StringCollection::AddRange ( const ArrayPtr< System::String > &  range)

Add elements into container.

Parameters
rangeContainer of elements to insert.

◆ Clear()

void System::Collections::Specialized::StringCollection::Clear ( )

Deletes all elements.

◆ Contains()

bool System::Collections::Specialized::StringCollection::Contains ( const System::String value) const

Checks whether specific string is present in container.

Parameters
valueString to look for.
Returns
True if string is found, false otherwise.

◆ CopyTo()

void System::Collections::Specialized::StringCollection::CopyTo ( const ArrayPtr< System::String > &  arr,
const int32_t  index 
) const

Copy elements to existing arra elements.

Parameters
arrArray to copy data to.
indexIndex in destination array to start data copying at.

◆ data() [1/2]

std::vector<System::String>& System::Collections::Specialized::StringCollection::data ( )

Internal data structure accessor.

Returns
Reference to internal data structure.

◆ data() [2/2]

const std::vector<System::String>& System::Collections::Specialized::StringCollection::data ( ) const

Internal data structure accessor.

Returns
Const reference to internal data structure.

◆ get_Count()

int System::Collections::Specialized::StringCollection::get_Count ( ) const

Gets number of elements in collection.

Returns
Actual element count.

◆ GetEnumerator()

SharedPtr<Generic::IEnumerator<System::String> > System::Collections::Specialized::StringCollection::GetEnumerator ( )
inlineoverridevirtual

Gets enumerator iterating through current collection.

Returns
Newly created enumerator iterating through current collection.

Implements System::Collections::Generic::IEnumerable< System::String >.

◆ idx_get()

System::String System::Collections::Specialized::StringCollection::idx_get ( int  index) const

Gets value at specified position.

Parameters
indexIndex to get string from.
Returns
String at specified position.

◆ idx_set()

void System::Collections::Specialized::StringCollection::idx_set ( int  index,
const System::String value 
)

Sets value at specified position.

Parameters
indexIndex to set string at.
valueString value to set at specified index.

◆ IndexOf()

int System::Collections::Specialized::StringCollection::IndexOf ( const System::String value) const

Looks for specific string in container.

Parameters
valueString to look for.
Returns
Index of first occurrence of specified string or -1 if not found.

◆ Insert()

void System::Collections::Specialized::StringCollection::Insert ( int  index,
const System::String value 
)

Inserts specific value into container.

Parameters
indexIndex to insert string into.
valueValue to insert into specified position.

◆ operator[]()

System::String& System::Collections::Specialized::StringCollection::operator[] ( int  index)

Accessor function.

Parameters
indexIndex to get element at.
Returns
Reference to string at specified position, either existing or newly created.

◆ Remove()

void System::Collections::Specialized::StringCollection::Remove ( const System::String value)

Removes first occurrence of specified string.

Parameters
valueString to remove.

◆ RemoveAt()

void System::Collections::Specialized::StringCollection::RemoveAt ( int  index)

Removes element at specified position.

Parameters
indexIndex to remove element at.