Update historical dst offset for timezone.
[platform/framework/native/appfw.git] / inc / FBaseColArrayList.h
index eef2c9c..a789693 100644 (file)
@@ -1,5 +1,4 @@
 //
-// Open Service Platform
 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
 //
 // Licensed under the Apache License, Version 2.0 (the License);
@@ -140,7 +139,7 @@ public:
         *
         * @return              An error code
         * @param[in]   capacity        The number of elements @n
-        *                                              The default capacity is @c 10.
+        *                                                      The default capacity is @c 10.
         * @exception   E_SUCCESS                 The method is successful.
         * @exception   E_INVALID_ARG     A specified input parameter is invalid, or
         *                                                                the specified @c capacity is negative.
@@ -162,7 +161,7 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in]   collection      A collection to add
+        * @param[in]   collection                      A collection to add
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_OPERATION     The current state of the instance prohibits the execution of the specified operation, or
         *                                                                      the @c collection is modified during the operation of this method.
@@ -177,7 +176,7 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in]   pObj            An pointer to object to add
+        * @param[in]   pObj                    An pointer to object to add
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG   The specified input parameter is invalid.
         * @remarks             This method performs a shallow copy. It adds just the pointer; not the element itself.
@@ -192,7 +191,7 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in]   collection      A collection to add
+        * @param[in]   collection                      A collection to add
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_OPERATION     The current state of the instance prohibits the execution of the specified operation, or
         *                                                                      the @c collection is modified during the operation of this method.
@@ -218,12 +217,12 @@ public:
         *
         * @since 2.0
         *
-        * @return        An instance of the IBidirectionalEnumerator derived class, @n
-        *                              else @c null if some exception occurs
-        * @remarks      Use this method to obtain a bidirectional enumerator (an instance of the IBidirectionalEnumerator derived class)
-        *                              to iterate over a collection (an instance of the IList derived class).
-        *                   The specific error code can be accessed using GetLastResult() method.
-        * @see           Tizen::Base::Collection::IBidirectionalEnumerator
+        * @return                      An instance of the IBidirectionalEnumerator derived class, @n
+        *                                      else @c null if some exception occurs
+        * @remarks                     Use this method to obtain a bidirectional enumerator (an instance of the IBidirectionalEnumerator derived class)
+        *                                      to iterate over a collection (an instance of the IList derived class).
+        *                                      The specific error code can be accessed using GetLastResult() method.
+        * @see                         Tizen::Base::Collection::IBidirectionalEnumerator
         */
        virtual IBidirectionalEnumerator* GetBidirectionalEnumeratorN(void) const;
 
@@ -234,7 +233,7 @@ public:
         *
         * @return              The object at the specified @c index of this list, @n
         *                              else @c null if the index is not valid
-        * @param[in]   index   The index of the object in the calling list to read
+        * @param[in]   index                                   The index of the object in the calling list to read
         * @exception   E_SUCCESS                               The method is successful.
         * @exception   E_OUT_OF_RANGE                  The specified @c index is outside the bounds of the data structure, or
         *                                                                              the specified @c index is either equal to or greater than the number of elements or less than @c 0.
@@ -274,7 +273,7 @@ public:
         *                                                                              - The specified index is outside the bounds of the data structure. @n
         *                                                                              - The specified @c startIndex is either equal to or greater than the number of elements or less than @c 0. @n
         *                                                                              - The @c count is greater than the number of elements starting from @c startIndex
-        *                                                                                      or less than @c 0.
+        *                                                                              or less than @c 0.
         * @remarks             The IList stores just the pointers to the elements in the list, not the elements themselves.
         *              The specific error code can be accessed using the GetLastResult() method.
         */
@@ -308,8 +307,8 @@ public:
         * @param[out]  index           The index of the object
         * @exception   E_SUCCESS                               The method is successful.
         * @exception   E_OUT_OF_RANGE                  The specified index is outside the bounds of the data structure, or
-        *                                                                                      the specified @c startIndex is either equal to or greater than the number of elements or less than @c 0.
-        * @exception   E_OBJ_NOT_FOUND         The specified @c obj is not found.
+        *                                                                              the specified @c startIndex is either equal to or greater than the number of elements or less than @c 0.
+        * @exception   E_OBJ_NOT_FOUND                 The specified @c obj is not found.
         * @see                 LastIndexOf()
         */
        virtual result IndexOf(const Object& obj, int startIndex, int& index) const;
@@ -330,8 +329,8 @@ public:
         *                                                                              - The specified index is outside the bounds of the data structure. @n
         *                                                                              - The specified @c startIndex is either equal to or greater than the number of elements or less than @c 0. @n
         *                                                                              - The @c count is greater than the number of elements starting from @c startIndex
-        *                                                                                      or less than @c 0.
-        * @exception   E_OBJ_NOT_FOUND         The specified @c obj is not found.
+        *                                                                              or less than @c 0.
+        * @exception   E_OBJ_NOT_FOUND                 The specified @c obj is not found.
         * @see                 LastIndexOf()
         */
        virtual result IndexOf(const Object& obj, int startIndex, int count, int& index) const;
@@ -357,7 +356,7 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in]   pObj        The pointer to object to insert
+        * @param[in]   pObj    The pointer to object to insert
         * @param[in]   index   The index at which the object must be inserted
         * @exception   E_SUCCESS                               The method is successful.
         * @exception   E_INVALID_ARG                   The specified input parameter is invalid.
@@ -400,7 +399,7 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in]   obj     An object to remove
+        * @param[in]   obj                             An object to remove
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_OBJ_NOT_FOUND The specified @c obj is not found.
         * @see                 Add()
@@ -415,7 +414,7 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in]   index   The index at which the object must be removed
+        * @param[in]   index                                   The index at which the object must be removed
         * @exception   E_SUCCESS                               The method is successful.
         * @exception   E_OUT_OF_RANGE                  The specified index is outside the bounds of the data structure, or
         *                                                                              the specified @c index is either equal to or greater than the number of elements or less than @c 0.
@@ -451,7 +450,7 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in]   collection The collection to remove from this list
+        * @param[in]   collection                      The collection to remove from this list
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_OPERATION     The current state of the instance prohibits the execution of the specified operation, or
         *                                                                      the @c collection is modified during the operation of this method.
@@ -474,8 +473,8 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in]   pObj            An pointer to object to set
-        * @param[in]   index   The index at which the object must be set
+        * @param[in]   pObj                                    An pointer to object to set
+        * @param[in]   index                                   The index at which the object must be set
         * @exception   E_SUCCESS                               The method is successful.
         * @exception   E_INVALID_ARG                   The specified input parameter is invalid.
         * @exception   E_OUT_OF_RANGE                  The specified index is outside the bounds of the data structure, or
@@ -492,8 +491,8 @@ public:
         * @return              An error code
         * @param[in]   newCapacity     The new capacity of this list
         * @exception   E_SUCCESS               The method is successful.
-        * @exception   E_INVALID_ARG   The specified input parameter is invalid, or
-        *                                                                the @c newCapacity is negative.
+        * @exception   E_INVALID_ARG   The specified input parameter is invalid, or
+        *                                                              the @c newCapacity is negative.
         * @remarks             When the new capacity is less than the current capacity, the elements
         *                              within the truncated memory are not destroyed.
         * @see                 Construct()
@@ -508,7 +507,7 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @param[in]   comparer        The IComparer implementation to use when comparing elements
+        * @param[in]   comparer                The IComparer implementation to use when comparing elements
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG   The specified input parameter is invalid.
         */
@@ -558,14 +557,14 @@ public:
         * @since 2.0
         *
         * @return              @c true if the list contains all the elements of the specified @c collection, @n
-        *                                      else @c false
+        *                              else @c false
         * @param[in]   collection      The collection to check for in the list
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_OPERATION     The current state of the instance prohibits the execution of the specified operation, or
         *                                                                      the @c collection is modified during the operation of this method.
         * @remarks             The specific error code can be accessed using the GetLastResult() method.
         * @remarks             If the given @c collection is empty, this method will return @c true.
-        * @see                 Contains()
+        * @see                 Contains()
         */
        virtual bool ContainsAll(const ICollection& collection) const;
 
@@ -595,10 +594,10 @@ public:
        virtual int GetHashCode(void) const;
 
        /**
-        * Distinguish between ArrayList and LinkedList.
+        * Distinguish between %ArrayList and LinkedList.
         *
         * @since 2.0
-        * @return      @c true if it is an ArrayList, @n
+        * @return      @c true if it is an %ArrayList, @n
         *                      else @c false if it is a LinkedList
         */
        virtual bool IsRandomAccessible(void) const
@@ -634,8 +633,8 @@ private:
         * Sorts the specified sub-list.
         *
         * @return              An error code
-        * @param[in]   startIndex The starting point of the sub-list to sort
-        * @param[in]   endIndex The end point of the sub-list to sort
+        * @param[in]   startIndex              The starting point of the sub-list to sort
+        * @param[in]   endIndex                The end point of the sub-list to sort
         * @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 elements.