StringsList is the main container used as array of strings. More...

#include <classlist.h>

Inheritance diagram for StringsList:

Classes
struct	iterator

Public Member Functions
	StringsList (const StringsList &r)

void	operator= (const StringsList &Src)

int	Count () const

int	GetAmount () const

const comms::cStr &	operator[] (int pos) const

comms::cStr &	operator[] (int pos)

void	Clear ()

void	Free ()

int	Add (const char *str)

void	RemoveAt (int pos, int num=1)

int	IndexOf (const char *str) const

void	Split (const char WhatToSplit, const char delimiters=" ,;\t")

const char *	GetLast () const

comms::cStr &	GetLast ()

comms::cStr &	GetAt (int idx)

const comms::cStr &	GetAt (int idx) const

void	Insert (int pos, const char *str)

bool	IsEmpty () const

const char *	GetFirst () const

comms::cStr &	GetFirst ()

void	RemoveLast ()

int	AddOnce (const char *str)

void	Sort (cList< comms::cStr >::Compare *C)

void	Sort (const cList< comms::cStr >::CompareFunctor &F)

void	Sort (const int Index, const int Count, cList< comms::cStr >::Compare *C)

void	Sort (int Index, int Count, const cList< comms::cStr >::CompareFunctor &F)

comms::cList< comms::cStr >	ToList () const

void	FromList (const cList< comms::cStr > &list)

virtual bool	DelElement (int Index) override
	removes element if the operation supported

virtual void	Save (TagsList &xml, void ClassPtr, void Extra=NULL) override
	Save class to the XML structure.

virtual bool	Load (TagsList &xml, void ClassPtr, void Extra=NULL) override
	Load the class from the XML structure.

virtual const char *	GetClassName () const override
	return class name there if need. Usually you don't need, if you are using AUTONEW or SERIALIZE

virtual void	reset_class (void *ptr)
	Clearing all registered content of the class. If DataPtr is nullptr, this class will be cleared.

virtual bool	FullCopy (const void SrcData, const void SrcDataExtra, BaseClass Dest, void DestData, void DestExtraPtr, CECopyContext C) override
	Fast copy from one BaseClass to another. Names and types correspondence used to copy.

virtual void	SaveBin (void Data, void Extra, BinStream Out, Enumerator ExDictionary, Enumerator *SkipList) override
	Save in binaly form. Use only for temporary storage in memory!!!

virtual void	LoadBin (void Data, void Extra, BinStream In, Enumerator ExDictionary) override
	Load the class from the memory. Use only for temporary storage in memory!!!

virtual void	UpdateHash (HashSummator &H, void data=nullptr, void extra=nullptr) override
	returns hash value dependent on data fields of this class

virtual bool	CheckDirectCasting () const override

virtual void	CountObjects (int &required_index, int counter, HashSummator hash, BaseClassElement result, const std::function< bool(BaseClassElement )> *ForEachElem, bool OnlyPointersMode) override
	This is the main function used for the access to class members. Each class that has SERIALIZE section creates this function automatically. It may count members, return hash, give element-wise access to any member. Instead of keeping registered fields that routine gives fast dynamic access to any member. If you making own container, you should create this function as well, othervice your class will not be serialized correctly even if you will make GetElement(...) function.

	AUTONEW (StringsList)

iterator	begin ()

iterator	end ()

iterator	begin () const

iterator	end () const

Public Member Functions inherited from BaseClass
BaseClass *	GetRoot ()
	BaseClass is like a tree, and you always can get the root of the tree using this function.

	BaseClass (const BaseClass &)

virtual	~BaseClass ()
	virtual destructor

virtual DWORD	GetClassMask ()
	Masking elements of class. Each member has mask. Element is serializable/visible only if (it's_mask & hosting_class_mask) != 0.

DWORD &	ClassMask ()

void	ForEach (const std::function< bool(BaseClassElement *el)> &fn, bool OnlyPointsers=false)
	Calls function for each class member. This function used in _EACH ... _EACH_END cycle.

virtual bool	CopyBaseClass (BaseClass *Dest, bool Add=false)
	Copy base class to other class uning names correspondence.

virtual int	GetAmountOfElementsInUI ()
	return amount of elements represented in UI

virtual int	GetAmountOfElementsInXML ()
	return amount of elements taht will be stored in XML

virtual cStruct *	pySerialize ()
	returns a list of python-generated properties for serialization and UI

virtual void	RegisterMembers ()
	Reload this function to register members. Usually you don't need to do this if you are using any of SERIALIZE methods of registration.

virtual int	GetAmountOfElements ()
	return complete amount of elements. Even invisible, masked and non-serialized elements will be counted

virtual int	GetClassSize () const
	return actual size of this class

virtual BaseClass *	new_element () const
	construct pointer to class of the same type like this. Elements will not be copied into the new place

virtual bool	GetElement (BaseClassElement &res, int idx, const void Ptr=nullptr, const void Extra=nullptr)

bool	GetElementByName (const char Name, void Ptr, void *Extra, BaseClassElement &res, bool UI=false, bool Serialize=true)
	The function returns complete information about the member by it's name.

bool	GetElementByNameAndType (const char Name, const char Type, void Ptr, void Extra, BaseClassElement &res, bool UI=false, bool Serialize=true)

void	DeleteDefaultSubFields (TagsList &xml, void ClassPtr, void Extra=NULL)
	Short form saving. Fields that are unchanged in comparison to default will be skipped in XML.

virtual bool	ShouldSaveInShortForm ()
	Return true if class should be saved in short form mandatory.

virtual int	ExpandWith (const char ElmName, void base)
	Expand array with class ElmName.

template<class Type = BaseClass>
bool	valid () const
	call it to check if this BaseClass pointer is valid

template<>
bool	valid () const

BaseClass *	auto_cast (void *ptr) const
	if class is directly castable the function returns ptr cased to BaseClass, othervice this pointrer returned. If NULL returned - something is wrong.

virtual bool	ReadFromFile (const char *Name, bool very_safe_with_backup=false)
	Save the object to file or binary stream. Example.

virtual bool	WriteToFile (const char *Name)

virtual bool	WriteToFileIfChanged (const char *Name)

virtual void	ToBS (BinStream &bs, bool IncludeLength)

virtual void	FromBS (BinStream &bs)

virtual void	ToBS (BinStream &bs, void data, void extra, bool IncludeLength)

virtual void	FromBS (BinStream &bs, void data, void extra)

virtual void	ToStr (comms::cStr &bs)

virtual void	FromStr (const comms::cStr &bs)

virtual bool	CheckIfFunction () const
	Special function for integrating in editor.

virtual int	condition_call (void *ptr)
	return -1 to do nothing, 0 if you want to hide everything after this registered member, 1 if you want to show

virtual BaseClass *	GetParent () const

template<typename type >
type *	FindParent ()

virtual void	SetParent (BaseClass *Parent)
	set parent recursively

virtual void	SimplySetParent (BaseClass *Parent)
	set parent directly to this, not affecting members

virtual bool	MayBeParent ()

virtual bool	CheckCompartabilityWith (const char *TypeName, int TypeSize)
	Checking for errors of registration.

virtual bool	ProcessInEditor (BaseClass *Parent)
	Editor will call next function always when it is visible in tree. Return true if overriden.

virtual bool	RenderInScene (BaseClass *Parent)
	Editor will call next function to render in-scene controls always when it is visible in tree. Return true if overriden.

virtual bool	HandleKey (int code)
	Editor will call next function when key pressed.

virtual bool	OnChangeMember (BaseClass MembClass, void MembPtr, void MembExtra, const char MembName)
	Editor will call it every time when member changes and editor is able to recognise it.

virtual void	BeforeChangeMember (BaseClass MembClass, void MembPtr, void MembExtra, const char MembName)
	Editor will call it every time before the changes.

virtual int	GetElementLevel (const char *EName)

virtual BaseWidget *	OnCreateControlFromScratch (const ClassEditorContext &Context, Rct &Rect)
	Create completely own control for ClassEditor.

virtual void	OnModifyControl (const char FieldName, BaseWidget W, ClassEditorContext &Context)
	Call for every member of registered class registered class.

virtual bool	CanBeDragged (const char *MemberID, int &dx, int &dy)
	Use it for build a Drag & Drop element.

virtual bool	CanAcceptDrag (const char *MemberID)

virtual bool	OnStartDrag (const char *MemberID)

virtual bool	OnEndDrag (const char *MemberID)

virtual bool	OnAcceptDrag (BaseClass DraggedItemParent, const char DraggedMemberID, const char *AcceptorMemberID, iRct MyRect)

virtual bool	UsePointerInHashCalculation ()

virtual bool	SkipHash ()

virtual bool	IsArray () const

virtual const char *	GetCmdID ()

void	SetParents ()
	set parents to this for all child members

void	SetParentsSafe ()
	set parents to this for all child members, each child will be tested for validity

virtual void	UpdateClassMembersAndMask (bool recursive)

virtual bool	CallFromScript () const

virtual void	CallFromScript (const bool &b)

Additional Inherited Members
Static Public Member Functions inherited from BaseClass
static const char *	GetCurrentSaveFile ()

static bool &	UI_definition ()

static bool &	Serialization ()

Static Public Attributes inherited from BaseClass
static const char *	CurrentSaveFile
	If user triggers saving class to file, last filename stored there.

static bool	SaveInShortForm

Protected Member Functions inherited from BaseClass
void	test_presence_integrity ()

void	register_this ()

void	remove_this ()

Static Protected Member Functions inherited from BaseClass
static std::mutex &	get_bc_mutex ()
	mutex for register_this / remove_this

static uni_hash< _empty, cPtrDiff,(1<< 18), 2048 > &	presence ()
	each BaseClass registered in this list

Protected Attributes inherited from BaseClass
BaseClass *	ParentBC
	pointer to the parent class in the tree

DWORD	_ClassMask
	Result of GetClassMask() written there. GetClassMask() is not const, so can't use it in const functions. The field introduced to use masking in const functions.

bool	bCallFromScript

Detailed Description

StringsList is the main container used as array of strings.

Member Function Documentation

◆ CheckDirectCasting()

virtual bool StringsList::CheckDirectCasting ( ) const

inlineoverridevirtual

BaseClass corresponds to some other data type. For example _int correctonds to int, etc... In this case you can't cast pointer to data to BaseClass*. But in some cases BaseClass may be directlt castable, for example if it has registered members, or it is ClassArray. This function is to define if class is directly castable.

Returns: Return true if void* ClassPtr may be directly casted to BaseClass*

Reimplemented from BaseClass.

◆ CountObjects()

virtual void StringsList::CountObjects	(	int &	required_index,
		int *	counter,
		HashSummator *	hash,
		BaseClassElement *	result,
		const std::function< bool(BaseClassElement )>	ForEachElem,
		bool	OnlyPointersMode )

overridevirtual

This is the main function used for the access to class members. Each class that has SERIALIZE section creates this function automatically.
It may count members, return hash, give element-wise access to any member. Instead of keeping registered fields that routine gives fast dynamic access to any member.
If you making own container, you should create this function as well, othervice your class will not be serialized correctly even if you will make GetElement(...) function.

Parameters

required_index	Index of required element if result != nullptr
counter	if nonzero, the elements count returned there.
hash	if nonzero, returns hash value for this class.
result	if nonzero, gives access to the member with index required_index.
ForEachElem	if nonzero, the function will be called for each class element.
OnlyPointersMode	If true, the field name will not be filled for speed purposes.

Reimplemented from BaseClass.

◆ DelElement()

virtual bool StringsList::DelElement ( int Index )

overridevirtual

removes element if the operation supported

Reimplemented from BaseClass.

◆ FullCopy()

virtual bool StringsList::FullCopy	(	const void *	SrcData,
		const void *	SrcDataExtra,
		BaseClass *	Dest,
		void *	DestData,
		void *	DstDataExtra,
		CECopyContext *	C )

overridevirtual

Fast copy from one BaseClass to another. Names and types correspondence used to copy.

Parameters

SrcData	Data data pointer
SrcDataExtra	Src extra
Dest	Destination class
DestData	Destination data
DstDataExtra	Destination extra
C	copy context

Returns: true if successful

Reimplemented from BaseClass.

◆ GetClassName()

virtual const char * StringsList::GetClassName ( ) const

inlineoverridevirtual

return class name there if need. Usually you don't need, if you are using AUTONEW or SERIALIZE

Reimplemented from BaseClass.

◆ Load()

virtual bool StringsList::Load	(	TagsList &	xml,
		void *	ClassPtr,
		void *	Extra = NULL )

overridevirtual

Load the class from the XML structure.

Parameters

xml	The source XML
ClassPtr	The pointer to the data, equals to this if class is directly castable
Extra	Extra data pointer

Returns: true if successful

Reimplemented from BaseClass.

◆ LoadBin()

virtual void StringsList::LoadBin	(	void *	Data,
		void *	Extra,
		BinStream *	In,
		Enumerator *	ExDictionary )

overridevirtual

Load the class from the memory. Use only for temporary storage in memory!!!

Parameters

Data	Pointer to the class data
Extra	Extra data
In	binary stream to read data from
ExDictionary	Additional dictionary

Reimplemented from BaseClass.

◆ reset_class()

virtual void StringsList::reset_class ( void * DataPtr )

virtual

Clearing all registered content of the class. If DataPtr is nullptr, this class will be cleared.

Reimplemented from BaseClass.

◆ Save()

virtual void StringsList::Save	(	TagsList &	xml,
		void *	ClassPtr,
		void *	Extra = NULL )

overridevirtual

Save class to the XML structure.

Parameters

xml	The result
ClassPtr	The pointer to the data, equals to this if class is directly castable
Extra	Extra data pointer

Reimplemented from BaseClass.

◆ SaveBin()

virtual void StringsList::SaveBin	(	void *	Data,
		void *	Extra,
		BinStream *	Out,
		Enumerator *	ExDictionary,
		Enumerator *	SkipList )

overridevirtual

Save in binaly form. Use only for temporary storage in memory!!!

Parameters

Data	data pointer
Extra	extra pointer
Out	Output stream
ExDictionary	Dictionary for enumerators
SkipList	Skip list for enumerators

Reimplemented from BaseClass.

◆ UpdateHash()

virtual void StringsList::UpdateHash	(	HashSummator &	S,
		void *	data = nullptr,
		void *	extra = nullptr )

overridevirtual

returns hash value dependent on data fields of this class

Parameters

data	Data ptr pointer to data
extra	Extra ptr pointer to methadata

Returns: Hash value returns some value dependent on the class inner data. Usually only serializable data influences on th return value.

Reimplemented from BaseClass.

The documentation for this class was generated from the following file:

include/ClassEngine/classlist.h

Classes

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ CheckDirectCasting()

◆ CountObjects()

◆ DelElement()

◆ FullCopy()

◆ GetClassName()

◆ Load()

◆ LoadBin()

◆ reset_class()

◆ Save()

◆ SaveBin()

◆ UpdateHash()