Dev C%2b%2b Dictionary
PyDictObject
¶A software developer: a game dev; a web dev. Dictionaries are represented by the Dictionary class. TKey represents the data type used for the dictionary’s keys (similar to the words in a standard dictionary or the terms you look up).
Dev-C is an integrated development environment (IDE) for the C programming language. It presents a feature-rich environment, tools for writing and debugging, as well as a compiler to provide you with all the tools necessary to program software in C. C is a multi-paradigm language, which means that it offers lots of different ways of doing things. You could implement the dictionary as a group of functions, as a C programmer would. You might be able to do it using functional programming using templates. Or you could create a class.
This subtype of PyObject
represents a Python dictionary object.
PyDict_Type
¶This instance of PyTypeObject
represents the Python dictionarytype. This is the same object as dict
in the Python layer.
PyDict_Check
(PyObject *p)¶Return true if p is a dict object or an instance of a subtype of the dicttype.
PyDict_CheckExact
(PyObject *p)¶Return true if p is a dict object, but not an instance of a subtype ofthe dict type.
PyDict_New
()¶Return a new empty dictionary, or NULL
on failure.
PyDictProxy_New
(PyObject *mapping)¶Return a types.MappingProxyType
object for a mapping whichenforces read-only behavior. This is normally used to create a view toprevent modification of the dictionary for non-dynamic class types.
PyDict_Clear
(PyObject *p)¶Empty an existing dictionary of all key-value pairs.
PyDict_Contains
(PyObject *p, PyObject *key)¶Determine if dictionary p contains key. If an item in p is matcheskey, return 1
, otherwise return 0
. On error, return -1
.This is equivalent to the Python expression keyinp
.
PyDict_Copy
(PyObject *p)¶Return a new dictionary that contains the same key-value pairs as p.
PyDict_SetItem
(PyObject *p, PyObject *key, PyObject *val)¶Insert val into the dictionary p with a key of key. key must behashable; if it isn’t, TypeError
will be raised. Return0
on success or -1
on failure. This function does not steal areference to val.
PyDict_SetItemString
(PyObject *p, const char *key, PyObject *val)¶Insert val into the dictionary p using key as a key. key shouldbe a constchar*
. The key object is created usingPyUnicode_FromString(key)
. Return 0
on success or -1
onfailure. This function does not steal a reference to val.
PyDict_DelItem
(PyObject *p, PyObject *key)¶Remove the entry in dictionary p with key key. key must be hashable;if it isn’t, TypeError
is raised.If key is not in the dictionary, KeyError
is raised.Return 0
on success or -1
on failure.
PyDict_DelItemString
(PyObject *p, const char *key)¶Remove the entry in dictionary p which has a key specified by the string key.If key is not in the dictionary, KeyError
is raised.Return 0
on success or -1
on failure.
PyDict_GetItem
(PyObject *p, PyObject *key)¶Return the object from dictionary p which has a key key. Return NULL
if the key key is not present, but without setting an exception.
Note that exceptions which occur while calling __hash__()
and__eq__()
methods will get suppressed.To get error reporting use PyDict_GetItemWithError()
instead.
PyDict_GetItemWithError
(PyObject *p, PyObject *key)¶Variant of PyDict_GetItem()
that does not suppressexceptions. Return NULL
with an exception set if an exceptionoccurred. Return NULL
without an exception set if the keywasn’t present.
PyDict_GetItemString
(PyObject *p, const char *key)¶This is the same as PyDict_GetItem()
, but key is specified as aconstchar*
, rather than a PyObject*
.
Note that exceptions which occur while calling __hash__()
and__eq__()
methods and creating a temporary string objectwill get suppressed.To get error reporting use PyDict_GetItemWithError()
instead.
PyDict_SetDefault
(PyObject *p, PyObject *key, PyObject *defaultobj)¶This is the same as the Python-level dict.setdefault()
. If present, itreturns the value corresponding to key from the dictionary p. If the keyis not in the dict, it is inserted with value defaultobj and defaultobjis returned. This function evaluates the hash function of key only once,instead of evaluating it independently for the lookup and the insertion.
PyDict_Items
(PyObject *p)¶Return a PyListObject
containing all the items from the dictionary.
PyDict_Keys
(PyObject *p)¶Return a PyListObject
containing all the keys from the dictionary.
PyDict_Values
(PyObject *p)¶Return a PyListObject
containing all the values from the dictionaryp.
PyDict_Size
(PyObject *p)¶Return the number of items in the dictionary. This is equivalent tolen(p)
on a dictionary.
PyDict_Next
(PyObject *p, Py_ssize_t *ppos, PyObject **pkey, PyObject **pvalue)¶Iterate over all key-value pairs in the dictionary p. ThePy_ssize_t
referred to by ppos must be initialized to 0
prior to the first call to this function to start the iteration; thefunction returns true for each pair in the dictionary, and false once allpairs have been reported. The parameters pkey and pvalue should eitherpoint to PyObject*
variables that will be filled in with each keyand value, respectively, or may be NULL
. Any references returned throughthem are borrowed. ppos should not be altered during iteration. Itsvalue represents offsets within the internal dictionary structure, andsince the structure is sparse, the offsets are not consecutive.
For example:
The dictionary p should not be mutated during iteration. It is safe tomodify the values of the keys as you iterate over the dictionary, but onlyso long as the set of keys does not change. For example:
PyDict_Merge
(PyObject *a, PyObject *b, int override)¶Dev C 2b 2b Dictionary Math
Iterate over mapping object b adding key-value pairs to dictionary a.b may be a dictionary, or any object supporting PyMapping_Keys()
and PyObject_GetItem()
. If override is true, existing pairs in awill be replaced if a matching key is found in b, otherwise pairs willonly be added if there is not a matching key in a. Return 0
onsuccess or -1
if an exception was raised.
PyDict_Update
(PyObject *a, PyObject *b)¶This is the same as PyDict_Merge(a,b,1)
in C, and is similar toa.update(b)
in Python except that PyDict_Update()
doesn’t fallback to the iterating over a sequence of key value pairs if the secondargument has no “keys” attribute. Return 0
on success or -1
if anexception was raised.
PyDict_MergeFromSeq2
(PyObject *a, PyObject *seq2, int override)¶Dev C 2b 2b Dictionary Words
Update or merge into dictionary a, from the key-value pairs in seq2.seq2 must be an iterable object producing iterable objects of length 2,viewed as key-value pairs. In case of duplicate keys, the last wins ifoverride is true, else the first wins. Return 0
on success or -1
if an exception was raised. Equivalent Python (except for the returnvalue):