@@ -46,112 +46,112 @@ uint32_t size; size_t count; } /** - * Creates a new OFDictionary. + * \brief Creates a new OFDictionary. * * \return A new autoreleased OFDictionary */ + dictionary; /** - * Creates a new OFDictionary with the specified dictionary. + * \brief Creates a new OFDictionary with the specified dictionary. * * \param dictionary An OFDictionary * \return A new autoreleased OFDictionary */ + dictionaryWithDictionary: (OFDictionary*)dictionary; /** - * Creates a new OFDictionary with the specified key and object. + * \brief Creates a new OFDictionary with the specified key and object. * * \param key The key * \param object The object * \return A new autoreleased OFDictionary */ + dictionaryWithObject: (id)object forKey: (id )key; /** - * Creates a new OFDictionary with the specified keys and objects. + * \brief Creates a new OFDictionary with the specified keys and objects. * * \param keys An array of keys * \param objects An array of objects * \return A new autoreleased OFDictionary */ + dictionaryWithObjects: (OFArray*)objects forKeys: (OFArray*)keys; /** - * Creates a new OFDictionary with the specified keys objects. + * \brief Creates a new OFDictionary with the specified keys objects. * * \param firstKey The first key * \return A new autoreleased OFDictionary */ + dictionaryWithKeysAndObjects: (id )firstKey, ...; /** - * Initializes an already allocated OFDictionary. + * \brief Initializes an already allocated OFDictionary. * * \return An initialized OFDictionary */ - init; /** - * Initializes an already allocated OFDictionary with the specified - * OFDictionary. + * \brief Initializes an already allocated OFDictionary with the specified + * OFDictionary. * * \param dictionary An OFDictionary * \return An initialized OFDictionary */ - initWithDictionary: (OFDictionary*)dictionary; /** - * Initializes an already allocated OFDictionary with the specified key and - * object. + * \brief Initializes an already allocated OFDictionary with the specified key + * and object. * * \param key The key * \param object The object * \return A new initialized OFDictionary */ - initWithObject: (id)object forKey: (id )key; /** - * Initializes an already allocated OFDictionary with the specified keys and - * objects. + * \brief Initializes an already allocated OFDictionary with the specified keys + * and objects. * * \param keys An array of keys * \param objects An array of objects * \return A new initialized OFDictionary */ - initWithObjects: (OFArray*)objects forKeys: (OFArray*)keys; /** - * Initializes an already allocated OFDictionary with the specified keys and - * objects. + * \brief Initializes an already allocated OFDictionary with the specified keys + * and objects. * * \param firstKey The first key * \return A new initialized OFDictionary */ - initWithKeysAndObjects: (id )firstKey, ...; /** - * Initializes an already allocated OFDictionary with the specified key and - * va_list. + * \brief Initializes an already allocated OFDictionary with the specified key + * and va_list. * * \param firstKey The first key * \param arguments A va_list of the other arguments * \return A new initialized OFDictionary */ - initWithKey: (id )firstKey arguments: (va_list)arguments; /** - * Returns the object for the given key or nil if the key was not found. + * \brief Returns the object for the given key or nil if the key was not found. * * The returned object is not retained and autoreleased for performance * reasons! * * \param key The key whose object should be returned @@ -158,34 +158,37 @@ * \return The object for the given key or nil if the key was not found */ - (id)objectForKey: (id)key; /** + * \brief Returns an OFEnumerator to enumerate through the dictionary's keys. + * * \return An OFEnumerator to enumerate through the dictionary's keys */ - (OFEnumerator*)keyEnumerator; #ifdef OF_HAVE_BLOCKS /** - * Executes a block for each key / object pair. + * \brief Executes a block for each key / object pair. * * \param block The block to execute for each key / object pair. */ - (void)enumerateKeysAndObjectsUsingBlock: (of_dictionary_enumeration_block_t)block; /** - * Returns a new dictionary, mapping each object using the specified block. + * \brief Returns a new dictionary, mapping each object using the specified + * block. * * \param block A block which maps an object for each object * \return A new, autorelease OFDictionary */ - (OFDictionary*)mappedDictionaryUsingBlock: (of_dictionary_map_block_t)block; /** - * Returns a new dictionary, only containing the objects for which the block - * returns YES. + * \brief Returns a new dictionary, only containing the objects for which the + * block returns YES. * * \param block A block which determines if the object should be in the new * dictionary * \return A new, autoreleased OFDictionary */