System::ArraySegment< T > Class Template Reference

Represents a segment of the one-dimensional array. 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...

#include <array_segment.h>

Inherits System::Object.

Public Member Functions
System::ArrayPtr< T >	get_Array ()
int32_t	get_Offset ()
int32_t	get_Count ()
	ArraySegment (System::ArrayPtr< T > array)
	ArraySegment (System::ArrayPtr< T > array, int32_t offset, int32_t count)
int32_t	GetHashCode () const override
	Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...
virtual bool	Equals (System::SharedPtr< Object > obj) override
bool	Equals (ArraySegment< T > obj)
	ArraySegment ()
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...
Object &	operator= (Object const &x)
	Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
Object *	SharedRefAdded ()
	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 TypeInfo &	GetType () 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...

Additional Inherited Members
Public Types inherited from System::Object
typedef SmartPtr< Object >	ptr
	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 TypeInfo &	Type ()
	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

template<typename T>
class System::ArraySegment< T >

Represents a segment of the one-dimensional array. 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.

#include <system/array_segment.h>
#include <system/smart_ptr.h>
 
using namespace System;
 
void Print(const SmartPtr<ArraySegment<String>> &segment)
{
  for (auto i = segment->get_Offset(); i < segment->get_Offset() + segment->get_Count(); i++)
  {
    std::cout << segment->get_Array()[i] << ' ';
  }
  std::cout << std::endl;
}
 
int main()
{
  // Create and fill the array.
  auto array = System::MakeObject<Array<String>>(3);
  array[0] = u"First";
  array[1] = u"Second";
  array[2] = u"Third";
 
  // Create the array segment that contains the entire array.
  auto fullArray = MakeObject<ArraySegment<String>>(array);
 
  // Print the array segment items.
  Print(fullArray);
 
  // Create the array segment.
  auto segment = MakeObject<ArraySegment<String>>(array, 1, 2);
 
  // Print the array segment items.
  Print(segment);
 
  return 0;
}
/*
This code example produces the following output:
First Second Third
Second Third
*/

Template Parameters

T	The type of the array segment elements.

Constructor & Destructor Documentation

ArraySegment() [1/3]

template<typename T >

System::ArraySegment< T >::ArraySegment ( System::ArrayPtr< T >  array )

inline

ArraySegment() [2/3]

template<typename T >

System::ArraySegment< T >::ArraySegment ( System::ArrayPtr< T >  array, int32_t  offset, int32_t  count  )

inline

ArraySegment() [3/3]

template<typename T >

System::ArraySegment< T >::ArraySegment ( )

inline

Member Function Documentation

Equals() [1/2]

template<typename T >

bool System::ArraySegment< T >::Equals ( ArraySegment< T >  obj )

inline

Equals() [2/2]

template<typename T >

virtual bool System::ArraySegment< T >::Equals ( System::SharedPtr< Object >  obj )

inlineoverridevirtual

get_Array()

template<typename T >

System::ArrayPtr< T > System::ArraySegment< T >::get_Array ( )

inline

get_Count()

template<typename T >

int32_t System::ArraySegment< T >::get_Count ( )

inline

get_Offset()

template<typename T >

int32_t System::ArraySegment< T >::get_Offset ( )

inline

GetHashCode()

template<typename T >

int32_t System::ArraySegment< T >::GetHashCode ( ) const

inlineoverridevirtual

Analog of C# Object.GetHashCode() method. Enables hashing of custom objects.

Returns

Hash code value as calculated by corresponding class.

Reimplemented from System::Object.