Add an info log in Terminate()
[platform/framework/native/appfw.git] / inc / FBaseColIMap.h
index cc2992f..01faca3 100644 (file)
@@ -28,7 +28,6 @@
 #include <FBaseColIMapEnumerator.h>
 #include <FBaseObject.h>
 
-
 namespace Tizen { namespace Base { namespace Collection
 {
 
@@ -36,8 +35,8 @@ class IList;
 class MapEntry;
 
 /**
- * @interface IMap
- * @brief      This interface represents a collection of key-value pairs.
+ * @interface  IMap
+ * @brief              This interface represents a collection of key-value pairs.
  *
  * @since 2.0
  *
@@ -135,7 +134,7 @@ public:
         *
         * @return              The value associated with the specified key, @n
         *                              else @c null if an exception occurs
-        * @param[in]   key     The key to find the associated value
+        * @param[in]   key                             The key to find the associated value
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG   The specified input parameter is invalid, or
         *                                                              the comparer has failed to compare the keys.
@@ -152,7 +151,7 @@ public:
         *
         * @return              The value associated with the specified key, @n
         *                              else @c null if an exception occurs
-        * @param[in]   key     The key to find the associated value
+        * @param[in]   key                             The key to find the associated value
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG   The specified input parameter is invalid, or
         *                                                              the comparer has failed to compare the keys.
@@ -169,7 +168,7 @@ public:
         *
         * @return              A pointer to a list of all the keys in the map, @n
         *                              else @c null if an exception occurs
-        * @remarks             
+        * @remarks
         *                              - The order of the keys is the same as the corresponding values in the IList interface returned by the GetValuesN() method.
         *                              - The %IList interface stores just the pointers to the elements in the map, not the elements themselves.
         *                              - The specific error code can be accessed using the GetLastResult() method.
@@ -184,7 +183,7 @@ public:
         *
         * @return              A pointer to a list of all the values in the map, @n
         *                              else @c null if an exception occurs
-        * @remarks             
+        * @remarks
         *                              - The IList stores just the pointers to the elements in the map, not the elements themselves.
         *                              - The specific error code can be accessed using the GetLastResult() method.
         * @see                 GetKeysN()
@@ -199,12 +198,12 @@ public:
         * @return              An error code
         * @param[in]   key The key to remove
         * @param[in]   forceDeletion           Set to @c true to deallocate the object, @n
-        *                                                              else @c false
+        *                                                                      else @c false
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG   A specified input parameter is invalid, or
         *                                                              the comparer has failed to compare the keys.
         * @exception   E_OBJ_NOT_FOUND The specified @c key is not found in the map.
-        * @remarks             
+        * @remarks
         *                              - Based on the specified element deleter, the remove operation not only gets rid of an element from a list, but also deletes its object instance. @n
         *                              The element deleter style is recommended rather than using the @c forceDeletetion argument in the remove method. @n
         *                              If both an element deleter and forceDeleteion are set, the remove operation follows @c forceDeletion setting.
@@ -248,7 +247,7 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in]   key The key for which the value is to remove
+        * @param[in]   key                             The key for which the value is to remove
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG   A specified input parameter is invalid, or
         *                                                              the comparer has failed to compare the keys.
@@ -264,8 +263,8 @@ public:
         * @since 2.0
         *
         * @param[in]   forceDeletion           Set to @c true to deallocate all the objects, @n
-        *                                                              else @c false
-        * @remarks             
+        *                                                                      else @c false
+        * @remarks
         *                              - Based on the specified element deleter, the remove operation not only gets rid of an element from a list, but also deletes its object instance. @n
         *                              The element deleter style is recommended rather than using the @c forceDeletetion argument in the remove method. @n
         *                              If both an element deleter and forceDeleteion are set, the remove operation follows @c forceDeletion setting.
@@ -314,15 +313,15 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in]   key     The key for which the value is to replace
-        * @param[in]   value   The new value
+        * @param[in]   key     The key for which the value is to replace
+        * @param[in]   value   The new value
         * @param[in]   forceDeletion           Set to @c true to deallocate the object, @n
-        *                                                              else @c false
+        *                                                                      else @c false
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG   A specified input parameter is invalid, or
         *                                                              the comparer has failed to compare the keys.
         * @exception   E_OBJ_NOT_FOUND The specified @c key is not found in the map.
-        * @remarks     
+        * @remarks
         *                      - Use the Add(Object*, Object*) method to add a new key-value pair.
         *                      - Based on the specified element deleter, the set operation not only gets rid of an element from a list, but also deletes its object instance. @n
         *                      The element deleter style is recommended rather than using the @c forceDeletetion argument in the set method. @n
@@ -367,14 +366,14 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in] key               The key for which the value is to replace
+        * @param[in]   key             The key for which the value is to replace
         * @param[in]   pValue  The pointer to new value
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG   A specified input parameter is invalid, or
         *                                                              the comparer has failed to compare the keys.
         * @exception   E_OBJ_NOT_FOUND The specified @c key is not found in the map.
-        * @remarks     Use the Add(Object*, Object*) method to add a new key-value pair.
-        * @see         GetValue()
+        * @remarks             Use the Add(Object*, Object*) method to add a new key-value pair.
+        * @see                 GetValue()
         */
        virtual result SetValue(const Object& key, Object* pValue) = 0;
 
@@ -412,7 +411,7 @@ public:
         *
         * @return              @c true if the map contains the specified key, @n
         *                              else @c false
-        * @param[in]   key     The key to locate
+        * @param[in]   key                     The key to locate
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG   A specified input parameter is invalid, or
         *                                                              the comparer has failed to compare the keys.
@@ -439,7 +438,7 @@ public:
        *
        * @since 2.0
        *
-       * @return                       IMapEnumerator object of this map, @n
+       * @return               IMapEnumerator object of this map, @n
        *                               else @c null if an exception occurs
        * @exception    E_SUCCESS               The method is successful.
        * @remarks              The specific error code can be accessed using the GetLastResult() method.
@@ -467,7 +466,6 @@ protected:
        //
        virtual void IMap_Reserved1(void) { }
 
-
        //
        // This method is for internal use only. Using this method can cause behavioral, security-related,
        // and consistency-related issues in the application.