CCDictionary is a class like NSDictionary in Obj-C . More...

#include <CCDictionary.h>

Inheritance diagram for CCDictionary:

Collaboration diagram for CCDictionary:

Public Member Functions
	CCDictionary ()
	The constructor of CCDictionary. More...

	~CCDictionary ()
	The destructor of CCDictionary NA. More...

unsigned int	count ()
	Get the count of elements in CCDictionary. More...

CCArray *	allKeys ()
	Return all keys of elements. More...

CCArray *	allKeysForObject (CCObject *object)
	Get all keys according to the specified object. More...

CCObject *	objectForKey (const std::string &key)
	Get the object according to the specified string key. More...

CCObject *	objectForKey (intptr_t key)
	Get the object according to the specified integer key. More...

const CCString *	valueForKey (const std::string &key)
	Get the value according to the specified string key. More...

const CCString *	valueForKey (intptr_t key)
	Get the value according to the specified integer key. More...

void	setObject (CCObject *pObject, const std::string &key)
	Insert an object to dictionary, and match it with the specified string key. More...

void	setObject (CCObject *pObject, intptr_t key)
	Insert an object to dictionary, and match it with the specified string key. More...

void	removeObjectForKey (const std::string &key)
	Remove an object by the specified string key. More...

void	removeObjectForKey (intptr_t key)
	Remove an object by the specified integer key. More...

void	removeObjectsForKeys (CCArray *pKeyArray)
	Remove objects by an array of keys. More...

void	removeObjectForElememt (CCDictElement *pElement)
	Remove an object by an element. More...

void	removeAllObjects ()
	Remove all objects in the dictionary. More...

CCObject *	randomObject ()
	Return a random object in the dictionary. More...

bool	writeToFile (const char *fullPath)
	Write a dictionary to a plist file. More...

virtual void	acceptVisitor (CCDataVisitor &visitor)

Function override
virtual CCObject *	copyWithZone (CCZone *pZone)
	This function is used for deepcopy elements from source dictionary to destination dictionary. More...

Public Member Functions inherited from CCObject
	CCObject (void)

virtual	~CCObject (void)
	NA. More...

void	release (void)

void	retain (void)

CCObject *	autorelease (void)

CCObject *	copy (void)

bool	isSingleReference (void) const

unsigned int	retainCount (void) const

virtual bool	isEqual (const CCObject *pObject)

virtual void	acceptVisitor (CCDataVisitor &visitor)

virtual void	update (float dt)

	CCObject (const CCObject &)

CCObject &	operator= (const CCObject &)

virtual void	encodeWithCoder (DS_Dictionary *)

virtual bool	canEncode ()

CCObjectType	getObjType () const

virtual int	getTag () const

virtual void	setTag (int nTag)

void	setObjType (CCObjectType)

virtual CCObject *	copyWithZone (CCZone *pZone)

Static Public Member Functions
static CCDictionary *	create ()
	Create a dictionary. More...

static CCDictionary *	createWithDictionary (CCDictionary *srcDict)
	Create a dictionary with an existing dictionary. More...

static CCDictionary *	createWithContentsOfFile (const char *pFileName)
	Create a dictionary with a plist file. More...

static CCDictionary *	createWithContentsOfFileThreadSafe (const char *pFileName)
	Create a dictionary with a plist file. More...

Static Public Member Functions inherited from CCObject
static CCObject *	createWithCoder (DS_Dictionary *)

Public Attributes
CCDictElement *	m_pElements
	All the elements in dictionary. More...

Public Attributes inherited from CCObject
unsigned int	m_uID

int	m_nLuaID

Additional Inherited Members
Protected Attributes inherited from CCObject
unsigned int	m_uReference

unsigned int	m_uAutoReleaseCount

int	m_nTag

int	m_eObjType

unsigned int	m_uObjectIdxInArray

Detailed Description

CCDictionary is a class like NSDictionary in Obj-C .

Note: Only the pointer of CCObject or its subclass can be inserted to CCDictionary.
// Create a dictionary, return an autorelease object.

CCDictionary* pDict = CCDictionary::create();

// Insert objects to dictionary

CCString* pValue1 = CCString::create("100");

CCString* pValue2 = CCString::create("120");

CCInteger* pValue3 = CCInteger::create(200);

pDict->setObject(pValue1, "key1");

pDict->setObject(pValue2, "key2");

pDict->setObject(pValue3, "key3");

// Get the object for key

CCString* pStr1 = (CCString*)pDict->objectForKey("key1");

CCLog("{ key1: %s }", pStr1->getCString());

CCInteger* pInteger = (CCInteger*)pDict->objectForKey("key3");

CCLog("{ key3: %d }", pInteger->getValue());

cocos2d::CCDictionary
CCDictionary is a class like NSDictionary in Obj-C .
Definition: CCDictionary.h:175

cocos2d::CCDictionary::objectForKey
CCObject * objectForKey(const std::string &key)
Get the object according to the specified string key.

cocos2d::CCDictionary::setObject
void setObject(CCObject *pObject, const std::string &key)
Insert an object to dictionary, and match it with the specified string key.

cocos2d::CCDictionary::create
static CCDictionary * create()
Create a dictionary.

cocos2d::CCInteger
Definition: CCInteger.h:15

cocos2d::CCInteger::create
static CCInteger * create(int v)
Definition: CCInteger.h:21

cocos2d::CCInteger::getValue
int getValue() const
Definition: CCInteger.h:19

cocos2d::CCString
Definition: CCString.h:45

cocos2d::CCString::getCString
const char * getCString() const
get the C string

cocos2d::CCString::create
static CCString * create(const std::string &str)
create a string with std string, you can also pass a c string pointer because the default constructor...

cocos2d::CCLog
void CC_DLL CCLog(const char *pszFormat,...)
Output Debug message.

NA

Constructor & Destructor Documentation

◆ CCDictionary()

CCDictionary ( )

The constructor of CCDictionary.

NA

◆ ~CCDictionary()

~CCDictionary ( )

The destructor of CCDictionary NA.

Member Function Documentation

◆ acceptVisitor()

virtual void acceptVisitor ( CCDataVisitor & visitor )

virtual

Reimplemented from CCObject.

◆ allKeys()

CCArray * allKeys ( )

Return all keys of elements.

Returns: The array contains all keys of elements. It's an autorelease object yet.

◆ allKeysForObject()

CCArray * allKeysForObject ( CCObject * object )

Get all keys according to the specified object.

Warning: We use '==' to compare two objects

Returns: The array contains all keys for the specified object. It's an autorelease object yet.

◆ copyWithZone()

virtual CCObject * copyWithZone ( CCZone * pZone )

virtual

This function is used for deepcopy elements from source dictionary to destination dictionary.

You shouldn't invoke this function manually since it's called by CCObject::copy. NA NA

Reimplemented from CCCopying.

◆ count()

unsigned int count ( )

Get the count of elements in CCDictionary.

Returns: The count of elements.

◆ create()

static CCDictionary * create ( )

static

Create a dictionary.

Returns: A dictionary which is an autorelease object.

See also: createWithDictionary(CCDictionary*), createWithContentsOfFile(const char*), createWithContentsOfFileThreadSafe(const char*).

◆ createWithContentsOfFile()

static CCDictionary * createWithContentsOfFile ( const char * pFileName )

static

Create a dictionary with a plist file.

Parameters

pFileName The name of the plist file.

Returns: A dictionary which is an autorelease object.

See also: create(), createWithDictionary(CCDictionary*), createWithContentsOfFileThreadSafe(const char*).

◆ createWithContentsOfFileThreadSafe()

static CCDictionary * createWithContentsOfFileThreadSafe ( const char * pFileName )

static

Create a dictionary with a plist file.

Note: the return object isn't an autorelease object. This can make sure not using autorelease pool in a new thread. Therefore, you need to manage the lifecycle of the return object. It means that when you don't need it, CC_SAFE_RELEASE needs to be invoked.

Parameters

pFileName The name of the plist file.

Returns: A dictionary which isn't an autorelease object. NA

◆ createWithDictionary()

static CCDictionary * createWithDictionary ( CCDictionary * srcDict )

static

Create a dictionary with an existing dictionary.

Parameters

srcDict The exist dictionary.

Returns: A dictionary which is an autorelease object.

See also: create(), createWithContentsOfFile(const char*), createWithContentsOfFileThreadSafe(const char*).

◆ objectForKey() [1/2]

CCObject * objectForKey ( const std::string & key )

Get the object according to the specified string key.

Note: The dictionary needs to use string as key. If integer is passed, an assert will appear.

Parameters

key	The string key for searching.

Returns: The object matches the key. You need to force convert it to the type you know.
// Assume that the elements are CCString* pointers. Convert it by following code.

CCString* pStr = (CCString*)pDict->objectForKey("key1");

// Do something about pStr.

// If you don't know the object type, properly you need to use dynamic_cast<SomeType*> to check it.

CCString* pStr2 = dynamic_cast<CCString*>(pDict->objectForKey("key1"));

if (pStr2 != NULL) {

// Do something about pStr2

}

NULL
#define NULL
Definition: CCPlatformDefine.h:30

See also: objectForKey(intptr_t)

◆ objectForKey() [2/2]

CCObject * objectForKey ( intptr_t key )

Get the object according to the specified integer key.

Note: The dictionary needs to use integer as key. If string is passed, an assert will appear.

Parameters

key	The integer key for searching.

Returns: The object matches the key.

See also: objectForKey(const std::string&)

◆ randomObject()

CCObject * randomObject ( )

Return a random object in the dictionary.

Returns: The random object.

See also: objectForKey(intptr_t), objectForKey(const std::string&) NA

◆ removeAllObjects()

void removeAllObjects ( )

Remove all objects in the dictionary.

See also: removeObjectForKey(const std::string&), removeObjectForKey(intptr_t), removeObjectsForKeys(CCArray*), removeObjectForElememt(CCDictElement*).

◆ removeObjectForElememt()

void removeObjectForElememt ( CCDictElement * pElement )

Remove an object by an element.

Parameters

pElement The element need to be removed.

See also: removeObjectForKey(const std::string&), removeObjectForKey(intptr_t), removeObjectsForKeys(CCArray*), removeAllObjects(). NA

◆ removeObjectForKey() [1/2]

void removeObjectForKey ( const std::string & key )

Remove an object by the specified string key.

Parameters

key	The string key for searching.

See also: removeObjectForKey(intptr_t), removeObjectsForKeys(CCArray*), removeObjectForElememt(CCDictElement*), removeAllObjects().

◆ removeObjectForKey() [2/2]

void removeObjectForKey ( intptr_t key )

Remove an object by the specified integer key.

Parameters

key	The integer key for searching.

See also: removeObjectForKey(const std::string&), removeObjectsForKeys(CCArray*), removeObjectForElememt(CCDictElement*), removeAllObjects().

◆ removeObjectsForKeys()

void removeObjectsForKeys ( CCArray * pKeyArray )

Remove objects by an array of keys.

Parameters

pKeyArray The array contains keys to be removed.

See also: removeObjectForKey(const std::string&), removeObjectForKey(intptr_t), removeObjectForElememt(CCDictElement*), removeAllObjects().

◆ setObject() [1/2]

void setObject	(	CCObject *	pObject,
		const std::string &	key
	)

Insert an object to dictionary, and match it with the specified string key.

Note: Whe the first time this method is invoked, the key type will be set to string. After that you can't setObject with an integer key. If the dictionary contains the key you passed, the object matching the key will be released and removed from dictionary. Then the new object will be inserted after that.

Parameters

pObject	The Object to be inserted.
key	The string key for searching.

See also: setObject(CCObject*, intptr_t)

◆ setObject() [2/2]

void setObject	(	CCObject *	pObject,
		intptr_t	key
	)

Insert an object to dictionary, and match it with the specified string key.

Note: Then the first time this method is invoked, the key type will be set to string. After that you can't setObject with an integer key. If the dictionary contains the key you passed, the object matching the key will be released and removed from dictionary. Then the new object will be inserted after that.

Parameters

pObject	The Object to be inserted.
key	The string key for searching.

See also: setObject(CCObject*, const std::string&)

◆ valueForKey() [1/2]

const CCString * valueForKey ( const std::string & key )

Get the value according to the specified string key.

Note: Be careful to use this function since it assumes the objects in the dictionary are CCString pointer.

Parameters

key	The string key for searching

Returns: An instance of CCString. It will return an empty string if the objects aren't CCString pointer or the key wasn't found.

See also: valueForKey(intptr_t)

◆ valueForKey() [2/2]

const CCString * valueForKey ( intptr_t key )

Get the value according to the specified integer key.

Note: Be careful to use this function since it assumes the objects in the dictionary are CCString pointer.

Parameters

key	The string key for searching.

Returns: An instance of CCString. It will return an empty string if the objects aren't CCString pointer or the key wasn't found.

See also: valueForKey(intptr_t)

◆ writeToFile()

bool writeToFile ( const char * fullPath )

Write a dictionary to a plist file.

Parameters

fullPath The full path of the plist file. You can get writeable path by getWritablePath()

Returns: true if successed, false if failed NA

Member Data Documentation

◆ m_pElements

CCDictElement* m_pElements

All the elements in dictionary.

Note: For internal usage, we need to declare this member variable as public since it's used in UT_HASH.

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

/home/runner/work/cocos-headers/cocos-headers/cocos2dx/cocoa/CCDictionary.h

Public Member Functions

Static Public Member Functions

Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ CCDictionary()

◆ ~CCDictionary()

Member Function Documentation

◆ acceptVisitor()

◆ allKeys()

◆ allKeysForObject()

◆ copyWithZone()

◆ count()

◆ create()

◆ createWithContentsOfFile()

◆ createWithContentsOfFileThreadSafe()

◆ createWithDictionary()

◆ objectForKey() [1/2]

◆ objectForKey() [2/2]

◆ randomObject()

◆ removeAllObjects()

◆ removeObjectForElememt()

◆ removeObjectForKey() [1/2]

◆ removeObjectForKey() [2/2]

◆ removeObjectsForKeys()

◆ setObject() [1/2]

◆ setObject() [2/2]

◆ valueForKey() [1/2]

◆ valueForKey() [2/2]

◆ writeToFile()

Member Data Documentation

◆ m_pElements