WORLD_EXECUTE WORLD_READ)
INSTALL(DIRECTORY ${CMAKE_SOURCE_DIR}/res/common/opt/usr/etc DESTINATION ../opt/usr)
+INSTALL(DIRECTORY ${CMAKE_SOURCE_DIR}/res/common/usr/bin DESTINATION ../usr)
IF("${ARCH}" MATCHES "arm")
INSTALL(DIRECTORY ${CMAKE_SOURCE_DIR}/res/arm/usr/etc DESTINATION ../usr)
ELSEIF("${ARCH}" MATCHES "x86")
INSTALL(DIRECTORY ${CMAKE_SOURCE_DIR}/src/security/inc/ DESTINATION include/osp/security FILES_MATCHING PATTERN "*.h")
INSTALL(DIRECTORY ${CMAKE_SOURCE_DIR}/src/system/inc/ DESTINATION include/osp/system FILES_MATCHING PATTERN "*.h")
INSTALL(DIRECTORY ${CMAKE_SOURCE_DIR}/src/text/inc/ DESTINATION include/osp/text FILES_MATCHING PATTERN "*.h")
-INSTALL(DIRECTORY ${CMAKE_SOURCE_DIR}/src/server/inc/ DESTINATION include/osp/server/ FILES_MATCHING PATTERN "*.h")
-INSTALL(DIRECTORY ${CMAKE_SOURCE_DIR}/src/system-server/inc/ DESTINATION include/osp/system-server/ FILES_MATCHING PATTERN "*.h")
+INSTALL(DIRECTORY ${CMAKE_SOURCE_DIR}/src/server/appfw/inc/ DESTINATION include/osp/server/appfw/ FILES_MATCHING PATTERN "*.h")
+INSTALL(DIRECTORY ${CMAKE_SOURCE_DIR}/src/server/system/inc/ DESTINATION include/osp/server/system/ FILES_MATCHING PATTERN "*.h")
* @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FApp.h> @n
- * @b Library : @b osp-appfw
+ * @b Library: @b osp-appfw
*
* The %App namespace contains classes for application development, including application life-cycle management, usage of
- * functionality exported by other applications through AppControl, and access to application registry and resources. %Tizen
+ * the functionality exported by other applications through AppControl, and access to the application registry and resources. %Tizen
* also provides various macros for debugging purposes.
- * @n
+ *
* For more information on the %App namespace features and the macros, see <a href="../org.tizen.native.appprogramming/html/guide/app/app_namespace.htm">App Guide</a> and <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/debugging_macros.htm">Debugging Macros</a>.
*
* The following diagram illustrates the relationships between the classes belonging to the %App namespace.
*
* The %App class is the base class of a %Tizen native application.
* A %Tizen native application must be inherited from the UiApp or ServiceApp class. These classes are inherited from the %App class. This class provides the basic features necessary to define an application.
- * @n
+ *
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/app_namespace.htm">App Guide</a>, <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/tizen_app_model/application_lifecycle.htm">Application Life-cycle</a>, and <a href="../org.tizen.native.appprogramming/html/guide/app/app_system_events.htm">System Events</a>.
*
*/
/**
* @if OSPDEPREC
- * Gets the list of the launch arguments. @n
+ * Gets the list of launch arguments. @n
* For more information on the launch arguments, see <a href="../org.tizen.native.appprogramming/html/guide/app/launching_other_apps_within_apps.htm">Launching Other Applications</a>.
*
- * @brief <i> [Deprecated] </i>
+ * @brief <i> [Deprecated] </i>
* @deprecated This method is deprecated. Instead of using this method, it is recommended to use IAppControlProviderEventListener
- * to acquire delivered arguments list.
+ * to acquire the delivered arguments list.
* @since 2.0
*
* @return A pointer to the list that contains the Tizen::Base::String instances of the launch arguments
* Gets the locale-independent name of the application.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
* @section CompGetAppNamePageIssue Issues
* Implementation of this method in %Tizen API versions prior to 2.1 has the following issue: @n
*
- * -# GetAppName() returns the localized name of the application while the meaning of the application name is ambiguous.
- * There are different use cases for locale-dependent name and localized name and the platform does not provide
- * a method for obtaining language-neutral name.
+ * -# The GetAppName() method returns the localized name of the application while the meaning of the application name is ambiguous.
+ * There are different use cases for the locale-dependent name and the localized name. The platform does not provide
+ * any method for obtaining the language-neutral name.
*
* @section CompGetAppNamePageResolution Resolutions
* The issue mentioned above is resolved in %Tizen API version 2.1 as follows: @n
*
- * -# GetAppDisplayName() is introduced to acquire localized name and GetAppName() returns locale-independent application name.
+ * -# The GetAppDisplayName() method is introduced to acquire the localized application name and the GetAppName() method returns the locale-independent application name.
*/
/**
AppId GetAppId(void) const;
/**
- * Gets the path of the application's root directory where the application is installed.
+ * Gets the path to the application's root directory where the application is installed.
*
* @since 2.0
*
* @return The application's root directory path
+ * @remarks If the platform policy is changed or the device is different, the returned file path can be different. @n
+ * Rather than changing the returned file path as hard coding, use as it is.
*/
Tizen::Base::String GetAppRootPath(void) const;
/**
- * Gets the path of the application's data directory used to store its own private data.
+ * Gets the path to the application's data directory where its private data is stored.
*
* @since 2.0
*
* @return The application's data directory path
+ * @remarks If the platform policy is changed or the device is different, the returned file path can be different. @n
+ * Rather than changing the returned file path as hard coding, use as it is.
*/
Tizen::Base::String GetAppDataPath(void) const;
/**
- * Gets the path of the application's resource directory that ships resource files delivered with the application
- * package.
+ * Gets the path to the application's resource directory that ships the resource files that are delivered with the application package.
*
* @since 2.0
*
* @return The application's resource directory path
+ * @remarks If the platform policy is changed or the device is different, the returned file path can be different. @n
+ * Rather than changing the returned file path as hard coding, use as it is.
*/
Tizen::Base::String GetAppResourcePath(void) const;
/**
- * Gets the path of the application's shared directory to export data to other applications.
+ * Gets the path to the application's shared directory to export data to other applications.
*
* @since 2.1
*
* @return The application's shared directory path
+ * @remarks If the platform policy is changed or the device is different, the returned file path can be different. @n
+ * Rather than changing the returned file path as hard coding, use as it is.
*/
Tizen::Base::String GetAppSharedPath(void) const;
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE This instance is in an invalid state.
*/
* including restoring the application's states, must be done in the %OnAppInitializing() method.
* If this method fails, the application's state changes to App::TERMINATED.
*
- * @since 2.0
+ * @since 2.0
*
- * @return @c true if the method is successful, @n
- * else @c false
+ * @return @c true if the method is successful, @n
+ * else @c false
* @param[in] appRegistry The instance of AppRegistry that manages the application's states
* @remarks Introducing the modal dialogs (for example, MessageBox) in this method is not allowed,
- * because it blocks the initialization procedure.
+ * because it blocks the initialization procedure.
*/
virtual bool OnAppInitializing(AppRegistry& appRegistry) = 0;
/**
* Called when the application's initialization is finished. @n
* After the %OnAppInitialized() method succeeds, the application's state changes to App::RUNNING.
- * If this method fails, the application's state changes to App::TERMINATING and the App::OnAppTerminating() method is called.
+ * If this method fails, the application's state changes to App::TERMINATING and the OnAppTerminating() method is called.
*
* @since 2.0
*
/**
* Called when the application is requested to terminate. @n
* The %OnAppWillTerminate() method returns @c false to prevent the application from getting terminated.
- * If this method returns @c true, the application's state changes to App::TERMINATING and the App::OnAppTerminating() method is called.
+ * If this method returns @c true, the application's state changes to App::TERMINATING and the OnAppTerminating() method is called.
*
* @since 2.0
*
/**
* Called when the application's state changes to App::TERMINATING. @n
- * All the activities involved in terminating the application, including saving the application's states, must be done in the %OnAppTerminating() method.
+ * All the activities involved in terminating the application, including saving the application's states, must be done by the %OnAppTerminating() method.
* After this method, the application code cannot be executed. The application is destroyed subsequently. @n
*
- * An application's termination is triggered either by the system or other applications. @n
- * When the termination is triggered by the system because of conditions such as power-off and OOM, it is called "urgent termination" and during these terminations %OnAppTerminating(), cannot be executed properly.
+ * An application's termination is triggered either by the system or by other applications. @n
+ * When the termination is triggered by the system because of conditions, such as power-off, and OOM, it is called "urgent termination" and during these terminations the %OnAppTerminating() method cannot be executed properly.
* When an application is terminated because of a power-off, although this method is called, it should be executed in a short duration. And when an application is killed by OOM, this method is not called. @n
- * This implies that this method is not likely to be called during an urgent termination, and hence the application should save the critical data as often as possible.
- * For example, the application can set a check point or use the callback for low memory.
- * When an application is terminated by self or other applications, it is called "normal termination" and during these terminations this method is executed properly because more time is provided for executing it as compared to an urgent termination (however, it does have a limit of 3-5 seconds). @n
+ * This implies that this method is not likely to be called during an urgent termination, and hence the application should save its critical data as often as possible.
+ * For example, the application can set a check point or use a callback for low memory issues.
+ * When an application terminates itself or is terminated by other applications, it is called "normal termination" and during these terminations this method is executed properly because more time is provided for execution as compared to an urgent termination (however, it does have a limit of 3-5 seconds). @n
* When this method is called, the main loop has already been quit.
* Thus, the application should not use any kind of asynchronous API that has callbacks triggered by the main loop.
*
* @since 2.0
*
- * @return @c true if the method is successful, @n
- * else @c false
+ * @return @c true if the method is successful, @n
+ * else @c false
* @param[in] appRegistry The instance that manages the application's states
* @param[in] urgentTermination Set to @c true if the application is terminated by the system, @n
* else @c false
virtual bool OnAppTerminating(AppRegistry& appRegistry, bool urgentTermination = false) = 0;
/**
- * Called when the system detects that the system wide memory or application heap memory is insufficient to run the application any further. @n
+ * Called when the system detects that the system wide memory or the application heap memory is insufficient to run the application any further. @n
* Resources that are not in use currently can be released using the %OnLowMemory() method.
*
* @since 2.0
/**
* Called when the battery level changes. @n
- * It is recommended that the application decides whether to terminate by itself by considering its own battery power consumption, if the battery level is Tizen::System::BATTERY_LEVEL_CRITICAL.
+ * It is recommended that the application decides whether to terminate itself by considering its own battery power consumption, if the battery level is Tizen::System::BATTERY_LEVEL_CRITICAL.
*
* @since 2.0
*
*
* @return An error code
* @param[in] requestId The user defined event ID
- * @param[in] pArgs A pointer to an argument list of type Tizen::Base::String
+ * @param[in] pArgs A pointer to the argument list of type Tizen::Base::String
* @exception E_SUCCESS The method is successful.
* @see OnUserEventReceivedN()
*/
* @since 2.0
*
* @param[in] requestId The user defined event ID
- * @param[in] pArgs A pointer to an argument list of type Tizen::Base::String
+ * @param[in] pArgs A pointer to the argument list of type Tizen::Base::String
*/
virtual void OnUserEventReceivedN(RequestId requestId, Tizen::Base::Collection::IList* pArgs);
/**
- * Gets the %App instance's pointer.
+ * Gets a pointer to the %App instance.
*
* @since 2.0
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_contact.htm">Contact Application Control</a>.
*
* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.contacts".
* @since 2.0
* @endif
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_calendar.htm">Calendar Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
-* Instead of this variable, use the literal, L"tizen.calendar".
+* Instead of this variable, use the literal, L"tizen.calendar".
* @since 2.0
* @endif
*/
* @if OSPDEPREC
* The Todo %AppControl ID.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This application control provider name is deprecated.
-* @b OPERATION_PICK:
-* @since 2.0
+* @brief <i> [Deprecated] </i>
+* @deprecated This application control provider name is deprecated.
+* @b OPERATION_PICK:
+* @since 2.0
*
-* @remarks This constant is currently not available.
+* @remarks This constant is currently not available.
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_TODO;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_call.htm">Call Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
-* Instead of this variable, use the literal, L"tizen.phone" with operation L"http://tizen.org/appcontrol/operation/dial".
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* Instead of this variable, use the literal, L"tizen.phone", with the operation L"http://tizen.org/appcontrol/operation/dial".
* @since 2.0
* @endif
*/
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_call.htm">Call Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
-* Instead of this variable, use the literal, L"tizen.phone" with operation L"http://tizen.org/appcontrol/operation/call".
-* @since 2.0
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* Instead of this variable, use the literal, L"tizen.phone", with the operation L"http://tizen.org/appcontrol/operation/call".
+* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/systeminfo
*
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_message.htm">Message Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.messages".
* @since 2.0
*
-* @remarks An MMS attachment may contain either an image, audio, video, vCard, vCalendar or a combination of an image, audio, vCard, and vCalendar files. @n
-* MMS attachments cannot contain a video in combination with an image or an audio file.
+* @remarks
+* - An MMS attachment may contain either an image, an audio, a video, a vCard, a vCalendar, or a combination of an image, an audio, a vCard, and a vCalendar file.
+* - MMS attachments cannot contain a video in combination with an image or an audio file.
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_MESSAGE;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_email.htm">Email Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
-* Instead of this variable, use the literal, L"tizen.email".
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* Instead of this variable, use the literal, L"tizen.email".
* @since 2.0
* @endif
*/
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_media.htm">Media Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
-* Instead of this variable, use the literal, L"tizen.filemanager" or L"tizen.gallery".
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* Instead of this variable, use the literal, L"tizen.filemanager", or L"tizen.gallery".
* @since 2.0
* @endif
*/
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_image.htm">Image Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.imageviewer".
* @since 2.0
* @endif
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_video.htm">Video Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.videoplayer".
* @since 2.0
* @endif
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_audio.htm">Audio Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.musicplayer".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_AUDIO;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_browser.htm">Browser Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.internet".
-* @since 2.0
+* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/web.service
* @endif
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_camera.htm">Camera Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.camera".
* @since 2.0
* @endif
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_bluetooth.htm">Bluetooth Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.bluetooth".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_BT;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_settings.htm">Settings Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.settings".
* @since 2.0
* @endif
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_contact.htm">Contact Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.contacts".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_CONTACT;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_certmgr.htm">Certificate Manager Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.certificatemanager".
* @since 2.0
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_calendar.htm">Calendar Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.calendar".
* @since 2.0
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_call.htm">Call Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.phone".
-* @since 2.0
+* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/systeminfo
*
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_message.htm">Message Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.messages".
-* @since 2.0
+* @since 2.0
*
-* @remarks An MMS attachment may contain either an image, audio, video, vCard, vCalendar or a combination of an image, audio, vCard, and vCalendar files. @n
-* MMS attachments cannot contain a video in combination with an image or an audio file. @n
-* From Tizen 2.0, the CC and BCC recipients are merged with the TO recipients when launching the MMS app control.
+* @remarks An MMS attachment may contain either an image, an audio, a video, a vCard, a vCalendar, or a combination of an image, an audio, a vCard, and a vCalendar file. @n
+* MMS attachments cannot contain a video in combination with an image or an audio file. @n
+* From %Tizen 2.0, the CC and BCC recipients are merged with the TO recipients while launching the MMS application control.
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_MESSAGE;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_email.htm">Email Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.email".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_EMAIL;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_media.htm">Media Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
-* Instead of this variable, use the literal, L"tizen.filemanager" or L"tizen.gallery".
+* Instead of this variable, use the literal, L"tizen.filemanager", or L"tizen.gallery".
* @since 2.0
* @endif
*/
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_image.htm">Image Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.imageviewer".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_IMAGE;
-/*
+/**
* @if OSPDEPREC
-* The ImageCrop application control provider ID @n
+* The Image Editor %AppControl provider ID @n
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in a future release.
* use the literal, L"tizen.imageeditor", instead of this variable.
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_IMAGE_EDITOR;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_video.htm">Video Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.videoplayer".
* @since 2.0
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_audio.htm">Audio Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.musicplayer".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_AUDIO;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_browser.htm">Browser Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.internet".
-* @since 2.0
+* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/web.service
*
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_camera.htm">Camera Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.camera".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_CAMERA;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_bluetooth.htm">Bluetooth Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.bluetooth".
-* @since 2.0
+* @since 2.0
*
-* @remarks Bluetooth functionality cannot be tested on the Emulator.
+* @remarks Bluetooth functionality cannot be tested on the Emulator.
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_BLUETOOTH;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_settings.htm">Settings Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"tizen.settings".
* @since 2.0
* Operation Add. @n
* Adds an application item.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/add".
* @since 2.0
* @endif
/**
* @if OSPDEPREC
* Operation Pick. @n
-* Picks some application item(s).
+* Picks an application item(s).
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/pick".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String OPERATION_PICK;
* Operation Edit. @n
* Edits an application item.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/edit".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String OPERATION_EDIT;
* Operation View. @n
* Shows the application content.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/view".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String OPERATION_VIEW;
* Operation Play. @n
* Plays the application content.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/view".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String OPERATION_PLAY;
* Operation Default. @n
*
* Uses the default operation specific to the application control.
-* An application control can export its functionality using an operation. If the application control exports only one operation, OPERATION_DEFAULT can act as an alias for the operation.
+* An application control can export its functionality using an operation. If the application control exports only one operation, ::OPERATION_DEFAULT can act as the alias for that operation.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/main".
* @since 2.0
* @endif
* @if OSPDEPREC
* Operation Capture.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/createcontent".
* @since 2.0
* @endif
* Operation Add. @n
* Adds an application item.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/add".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_OPERATION_ADD;
* Operation Default. @n
*
* Uses the default operation specific to the application control.
-* An application control can export its functionality using an operation. If the application control exports only one operation, OPERATION_DEFAULT can act as an alias for the operation.
+* An application control can export its functionality using an operation. If the application control exports only one operation, ::OPERATION_DEFAULT can act as an alias for that operation.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* @if OSPDEPREC
* Operation Main. @n
*
-* All the application exports the implicit %AppControl with %APPCONTROL_OPERATION_MAIN operation.
+* All the applications export the implicit %AppControl with the %APPCONTROL_OPERATION_MAIN operation.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/main".
-* @since 2.0
+* @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_OPERATION_MAIN;
/**
* @if OSPDEPREC
* Operation Pick. @n
-* Picks some application item(s).
+* Picks an application item(s).
*
* @brief <i> [Deprecated] </i>
-* @deprecated This variable is providyed only for backward compatibility and will be deleted in the near future.
+* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/pick".
* @since 2.0
* @endif
/**
* @if OSPDEPREC
* Operation Record. @n
-* Records the content.
+* Records the application content.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
/**
* @if OSPDEPREC
* Operation Share. @n
-* Shares the contents.
+* Shares the application content.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
/**
* @if OSPDEPREC
* Operation Crop. @n
-* Shows image with the crop rectangle.
+* Shows the image with the crop rectangle.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
/**
* @if OSPDEPREC
- * Not specified category.
+ * No specified category.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
/**
* @if OSPDEPREC
* The media category. @n
- * Specifying App::APPCONTROL_CATEGORY_MEDIA is equivalent to specifying all the App::APPCONTROL_CATEGORY_AUDIO,
+ * Specifying %APPCONTROL_CATEGORY_MEDIA is equivalent to specifying the App::APPCONTROL_CATEGORY_AUDIO,
* App::APPCONTROL_CATEGORY_IMAGE, and App::APPCONTROL_CATEGORY_VIDEO categories.
*
* @brief <i> [Deprecated] </i>
/**
* @if OSPDEPREC
- * The complete URI handling category corresponding to AppManager::StartAppControl().
+ * The complete URI handling category corresponding to the AppManager::StartAppControl() method.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
/**
* @if OSPDEPREC
- * The %AppControl operation is canceled.
+ * The %AppControl operation is cancelled.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* @brief This class represents the application control behavior.
* @since 2.0
*
-* @final This class is not intended for extension.
+* @final This class is not intended for extension.
*
-* The %AppControl class represents the application control behavior that provides a standard mechanism for using specific operations exported by other applications.
+* The %AppControl class represents the application control behavior that provides a standard mechanism for using specific operations exported by other applications.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">Application Controls</a>.
*
* String telUri = L"tel:12345678900";
*
* AppControl* pAc = AppManager::FindAppControlN(L"tizen.phone", L"http://tizen.org/appcontrol/operation/dial");
-* if(pAc)
+* if(pAc)
* {
* pAc->Start(&telUri, null, null, null);
* delete pAc;
* @privilege %http://tizen.org/privilege/application.launch
*
* @return An error code
- * @param[in] pDataList The data list to deliver to the resolved application control @n
- * The maximum size of the list is 4096 bytes.
- * @param[in] pListener The application control callback listener @n
- * Some application controls need to get the callback result by implementing the IAppControlEventListener interface.
+ * @param[in] pDataList The data list to deliver to the resolved application control @n
+ * The maximum size of the list is 4096 bytes.
+ * @param[in] pListener The application control callback listener @n
+ * Some application controls get the callback result by implementing the IAppControlEventListener interface.
* @exception E_SUCCESS The method is successful.
* @exception E_MAX_EXCEEDED The size of @c pDataList has exceeded the maximum limit.
- * @exception E_OBJ_NOT_FOUND The target application control resource is not found.
- * @exception E_IN_PROGRESS The application control is in progress: @n
- * - The application has already started an %AppControl. @n
+ * @exception E_OBJ_NOT_FOUND The target application control resource has not been found.
+ * @exception E_IN_PROGRESS The application control is in progress:
+ * - The application has already started an %AppControl.
* - The target application has already started.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate of target application. @b Since: @b 2.1
- * @remarks If the IAppControlEventListener instance (@c pListener) needs to get the
- * callback result for an application control, it must be valid till
- * IAppControlEventListener::OnAppControlCompleted() is invoked.
- * For example, a form object listener must not be deleted before the
- * system invokes %IAppControlEventListener::OnAppControlCompleted().
+ * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate as that of the target application. @b Since: @b 2.1
+ * @remarks If the specified @c pListener needs to get the callback result for an application control, it must be valid till IAppControlEventListener::OnAppControlCompleted() is invoked. @n
+ * For example, a form object listener must not be deleted before the system invokes %IAppControlEventListener::OnAppControlCompleted().
* @see AppManager::FindAppControlN()
* @see AppManager::FindAppControlsN()
* @endif
result Start(const Tizen::Base::Collection::IList* pDataList, IAppControlEventListener* pListener);
/**
- * Starts the found application control. @n
- * Once the found application starts, the calling application goes to the background and the found
+ * Starts the located application control. @n
+ * Once the located application starts, the calling application goes to the background and the located
* application is displayed.
*
* @since 2.0
* @privilege %http://tizen.org/privilege/application.launch
*
* @return An error code
- * @param[in] pUriData A pointer to the URI data
- * @param[in] pDataType A pointer to the MIME type (RFC 2046) data
- * @param[in] pExtraData A pointer to an argument map of key and value pair where the key is of type String and the value is of type String or of type ArrayList of String to deliver to the resolved application @n
- * The maximum size is 16 kilo bytes.
- * @param[in] pListener The application control callback listener @n
- * Some application need to get the result by implementing the IAppControlResponseListener interface.
+ * @param[in] pUriData A pointer to the URI data
+ * @param[in] pDataType A pointer to the MIME type (RFC 2046) data
+ * @param[in] pExtraData A pointer to the argument map of the key and value pair, where the key is of type Tizen::Base::String and the value is of type %Tizen::Base::String or of type Tizen::Base::Collection::ArrayList of %Tizen::Base::String, which is delivered to the resolved application @n
+ * The maximum size is 16 kilo bytes.
+ * @param[in] pListener The application control callback listener @n
+ * Some applications get the result by implementing the IAppControlResponseListener interface.
* @exception E_SUCCESS The method is successful.
* @exception E_MAX_EXCEEDED The size of @c pExtraData has exceeded the maximum limit.
- * @exception E_OBJ_NOT_FOUND The target application control is not found.
+ * @exception E_OBJ_NOT_FOUND The target application control has not been found.
* @exception E_IN_PROGRESS The application control is in progress: @n
* - The application has already started an %AppControl.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate of target application. @b Since: @b 2.1
- * @remarks If the calling application needs to get some result for application control,
- * it must be valid till IAppControlResponseListener::OnAppControlCompleteResponseReceived() is invoked.
+ * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate as that of the target application. @b Since: @b 2.1
+ * @remarks If the calling application needs to get some result for the application control,
+ * it must be valid till IAppControlResponseListener::OnAppControlCompleteResponseReceived() is invoked. @n
* For example, a form object listener must not be deleted before the
* system invokes %IAppControlResponseListener::OnAppControlCompleteResponseReceived().
* @see AppManager::FindAppControlN()
result Start(const Tizen::Base::String* pUriData, const Tizen::Base::String* pDataType, const Tizen::Base::Collection::IMap* pExtraData, IAppControlResponseListener* pListener);
/**
- * Finds the matching application control with given operation ID, URI pattern, data type, and category and
- * starts the found one. @n
- * If there are more than one application controls found, then the selection is shown for user and the one that the user selects is started.
+ * Finds the matching application control with the given operation ID, URI pattern, data type, and category, after which it
+ * starts the found application control. @n
+ * If more than one application control is found, then user selection is enabled and the one selected by the user is started.
* When the found application control is started, the URI pattern, MIME type, and extra data is delivered using IAppControlProviderEventListener.
*
* @since 2.0
* @privilege %http://tizen.org/privilege/application.launch
*
* @return An error code
- * @param[in] operationId The operation ID
- * @param[in] pUriPattern A URI pattern which is used for application control resolution and is delivered as the argument
- * @param[in] pDataType The MIME type (RFC 2046) or file extension @n
- * The '.' prefix must be used when specifying the file extension.
- * @param[in] pCategory The application control category
- * @param[in] pExtraData A pointer to an argument map of key and value pair where the key is of type Tizen::Base::String and the value is of
- * type %Tizen::Base::String or of type Tizen::Base::Collection::ArrayList of %Tizen::Base::String to deliver to
- * the resolved application @n
- * The maximum size is 16 kilo bytes.
- * @param[in] pListener A listener that gets notified
- * @exception E_SUCCESS The method is successful.
- * @exception E_MAX_EXCEEDED The size of @c pDataList has exceeded the maximum limit.
- * @exception E_OBJ_NOT_FOUND The application control is not found.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @param[in] operationId The operation ID
+ * @param[in] pUriPattern The URI pattern that is used for the application control resolution which is delivered as an argument
+ * @param[in] pDataType The MIME type (RFC 2046) or file extension @n
+ * The '.' prefix must be used while specifying the file extension.
+ * @param[in] pCategory The application control category
+ * @param[in] pExtraData A pointer to the argument map of the key and value pair, where the key is of type Tizen::Base::String and the value is of
+ * type %Tizen::Base::String or of type Tizen::Base::Collection::ArrayList of %Tizen::Base::String which is delivered to
+ * the resolved application @n
+ * The maximum size is 16 kilo bytes.
+ * @param[in] pListener The listener that gets notified
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_MAX_EXCEEDED The size of @c pDataList has exceeded the maximum limit.
+ * @exception E_OBJ_NOT_FOUND The application control has not been found.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate of target application. @b Since: @b 2.1
+ * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate as that of the target application. @b Since: @b 2.1
*/
static result FindAndStart(const Tizen::Base::String& operationId, const Tizen::Base::String* pUriPattern, const Tizen::Base::String* pDataType, const Tizen::Base::String* pCategory, const Tizen::Base::Collection::IMap* pExtraData, IAppControlResponseListener* pListener);
*
* @since 2.0
*
- * @param[in] pListener The listener to stop receiving the application control result
+ * @param[in] pListener The listener to stop from receiving the application control result
*/
static void StopAppControlResponseListener(IAppControlResponseListener* pListener);
*
* @since 2.0
*
- * @return The name of the application providing this %AppControl instance
+ * @return The name of the application that provides this %AppControl instance
*/
Tizen::Base::String GetAppName(void) const;
AppId GetAppId(void) const;
/**
- * @if OSPDEPREC
+ * @if OSPDEPREC
* Gets the associated application control provider ID.
*
* @brief <i> [Deprecated] </i>
- * @deprecated This method is deprecated because application ID replaced the role of provider ID. @n
+ * @deprecated This method is deprecated because the application ID has replaced the role of the provider ID. @n
* Instead of using this method, use GetAppId().
* @since 2.0
*
* @return The application control provider ID
- * @endif
+ * @endif
*/
Tizen::Base::String GetAppControlProviderId(void) const;
*
* @since 2.0
*
- * @return A pointer to the list of application control categories, @n
- * else @c null if an error occurs
- * @exception E_SUCCESS The method is successful.
+ * @return A pointer to the list of application control categories, @n
+ * else @c null if an error occurs
+ * @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
/**
* Stops the activated application control. @n
- * The %Stop() method works only with the following %AppControls provided by the platform:
+ * The %Stop() method works only with the following AppControls provided by the platform:
* tizen.bluetooth, tizen.calendar, tizen.camera, tizen.certificatemanager, tizen.contacts,
* tizen.email, tizen.filemanager, tizen.gallery, tizen.imageviewer, tizen.mmsmessages, and tizen.smsmessages.
*
* @since 2.0
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/application.launch
*
- * @return An error code
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_OPERATION The application control is not permitted to call this method.
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_INVALID_OPERATION The application control is not permitted to call this method.
* @remarks This method is asynchronous.
*/
result Stop(void);
* The %AppControl provider registers or unregisters the IAppControlProviderEventListener listener
* for providing the %AppControl functionality, looks up for the delivered %AppControl request information,
* and sends the %AppControl result back to the calling application. @n
- *
- * The request ID is used to identify each %AppControl request and can be acquired using
- * IAppControlProviderEventListener::OnAppControlRequestReceived().
+ * The request ID is used to identify each %AppControl request and can be acquired using the
+ * IAppControlProviderEventListener::OnAppControlRequestReceived() method.
*
*/
class _OSP_EXPORT_ AppControlProviderManager
{
public:
/**
- * Gets the application control provider manager instance.
+ * Gets a pointer to the %AppControlProviderManager instance.
*
* @since 2.0
*
- * @return A pointer to the %AppControlProviderManager instance if it succeeds, @n
- * else @c null
+ * @return A pointer to the %AppControlProviderManager instance, @n
+ * else @c null if it fails
*/
static AppControlProviderManager* GetInstance(void);
* Sets the application control provider listener to the application control provider manager. @n
* The listener gets notified when the application control request is received from other applications.
* To unset the listener, pass a @c null value to the listener parameter. @n
- *
- * If the application does not set the listener using %SetAppControlProviderEventListener(),
+ * If the application does not set the listener using the %SetAppControlProviderEventListener() method,
* then the application is launched or moves to the foreground without invoking any listener
* for the application request from another application.
*
* @since 2.0
*
- * @return An error code
- * @param[in] pListener The application control provider listener
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance has not been properly constructed.
- * @exception E_INVALID_OPERATION The listener must be set for the valid %App class.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks If the application is newly launched with the AppControl request, then %SetAppControlProviderEventListener() must
- * be set before invoking IAppControlProviderEventListener::OnAppControlRequestReceived().
- * For valid %AppControl request handling, %SetAppControlProviderEventListener() must be called within
- * App::OnAppInitializing().
+ * @return An error code
+ * @param[in] pListener The application control provider listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE This instance has not been properly constructed.
+ * @exception E_INVALID_OPERATION The listener must be set for the valid App class.
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks
+ * - If the application is newly launched with the AppControl request, then the %SetAppControlProviderEventListener() method must
+ * be set before invoking the IAppControlProviderEventListener::OnAppControlRequestReceived() method.
+ * - For valid %AppControl request handling, the %SetAppControlProviderEventListener() method within App::OnAppInitializing()
+ * must be called.
*/
result SetAppControlProviderEventListener(IAppControlProviderEventListener* pListener);
*
* @since 2.0
*
- * @return The application ID @n
- * If an error occurs, an empty string is returned.
- * @param[in] reqId The requestID
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The application control request is not found.
+ * @return The application ID, @n
+ * else an empty string is returned if an error occurs
+ * @param[in] reqId The requestID
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The application control request has not been found.
* @exception E_INVALID_STATE This instance has not been properly constructed.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
AppId GetClientAppId(RequestId reqId) const;
/**
* Sends the result list for the application control request. @n
- * The client receives the result by implementing IAppControlResponseListener::OnAppControlCompleteResponseReceived().
+ * The client receives the result by implementing the IAppControlResponseListener::OnAppControlCompleteResponseReceived() method.
*
* @since 2.0
*
- * @return An error code
- * @param[in] reqId The application control request ID
+ * @return An error code
+ * @param[in] reqId The application control request ID
* @param[in] appControlResult The application control result
- * @param[in] pExtraData A pointer to an extra argument map of key and value pair where the key is of type Tizen::Base::String and the value is of type %Tizen::Base::String or type Tizen::Base::Collection::ArrayList of %Tizen::Base::String
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The application control request is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] pExtraData A pointer to the extra argument map of the key and value pair, where the key is of type Tizen::Base::String and the value is of type %Tizen::Base::String or of type Tizen::Base::Collection::ArrayList of %Tizen::Base::String
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The application control request has not been found.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
result SendAppControlResult(RequestId reqId, AppCtrlResult appControlResult, const Tizen::Base::Collection::IMap* pExtraData);
* @final This class is not intended for extension.
*
* The %AppManager class manages all the applications.
- * The application manager supports normal and conditional application launch, and application control search and launch.
+ * The application manager supports both normal and conditional application launch as well as application control search and launch.
* It looks up the specific application control from the application control registry and creates an application control instance.
- * @n
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/launching_other_apps_within_apps.htm">Launching Other Applications</a> and <a href="../org.tizen.native.appprogramming/html/guide/app/registering_launch_condition.htm">Registering a Launch Condition</a>, and <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">Application Controls</a>.
+ *
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/launching_other_apps_within_apps.htm">Launching Other Applications</a>, <a href="../org.tizen.native.appprogramming/html/guide/app/registering_launch_condition.htm">Registering a Launch Condition</a>, and <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">Application Controls</a>.
*/
class _OSP_EXPORT_ AppManager
: public Tizen::Base::Object
*/
enum LaunchOption
{
- LAUNCH_OPTION_DEFAULT /**< The launch option: default */
+ LAUNCH_OPTION_DEFAULT /**< The default launch option */
};
/**
*
* @since 2.0
*
- * @return A pointer to the newly created AppControl instance if a matched %AppControl is found, @n
- * else @c null
+ * @return A pointer to the newly created AppControl instance, if a matched %AppControl is found, @n
+ * else @c null if it fails
* @param[in] appId The application ID
* @param[in] operationId The operation ID
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The application control is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * Either the file operation or the DB operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks %Tizen platform defines platform-defined alias for application ID and this aliased application ID
+ * @exception E_OBJ_NOT_FOUND The application control has not been found.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - Either the file operation or the DB operation has failed.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - The %Tizen platform defines a platform-defined alias for the application ID and this aliased application ID
* can be used to find the AppControl. For more information, see
* <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">here</a>.
*
static AppControl* FindAppControlN(const AppId& appId, const Tizen::Base::String& operationId);
/**
- * Finds a list of AppControl instances that matches the specified operation ID, category,
+ * Finds a list of AppControl instances that match the specified operation ID, category,
* data type, and URI pattern.
*
* @since 2.0
*
- * @return A pointer to the list of the AppControl instances that matches the specified operation ID, category, URI, and data type, @n
- * else @c null if it fails
- * @param[in] pOperationId The operation ID
- * @param[in] pCategory The application category
- * @param[in] pDataType The MIME type (RFC 2046) or file extension @n
- * The '.' prefix must be used when specifying the file extension.
- * @param[in] pUriPattern The URI pattern
+ * @return A pointer to the list of the AppControl instances that match the specified operation ID, category, URI, and data type, @n
+ * else @c null if it fails
+ * @param[in] pOperationId The operation ID
+ * @param[in] pCategory The application category
+ * @param[in] pDataType The MIME type (RFC 2046) or file extension @n
+ * The '.' prefix must be used while specifying the file extension.
+ * @param[in] pUriPattern The URI pattern
*
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG At least one of the specified @c pOperationId, @c pCategory, @c pDataType, or @c pUriScheme must not be @c null.
- * @exception E_INVALID_FORMAT The specified URI scheme is invalid (RFC 2396).
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG At least one of the specified @c pOperationId, @c pCategory, @c pDataType, or @c pUriScheme must not be @c null.
+ * @exception E_INVALID_FORMAT The specified URI scheme is invalid (RFC 2396).
* @exception E_UNSUPPORTED_FORMAT The specified file extension for @c pDataType is not supported.
- * @exception E_OBJ_NOT_FOUND The application control is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * Either the file operation or the DB operation has failed.
+ * @exception E_OBJ_NOT_FOUND The application control has not been found.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - Either the file operation or the DB operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static Tizen::Base::Collection::IList* FindAppControlsN(const Tizen::Base::String* pOperationId, const Tizen::Base::String* pCategory, const Tizen::Base::String* pDataType, const Tizen::Base::String* pUriPattern);
/**
* @if OSPDEPREC
* Starts the application control if there is only one application control that matches the specified URI, operation ID, and data type. @n
- * If there are more than one application controls, the one that the user selects is started.
+ * If there are more than one application controls, then the user selected one is started.
*
- * @brief <i> [Deprecated] </i>
+ * @brief <i> [Deprecated] </i>
* @deprecated This method is deprecated because IAppControlListener is deprecated and replaced by IAppControlResponselistener.
* Instead of using this method, use AppControl::FindAndStart().
* @since 2.0
* @privilege %http://tizen.org/privilege/application.launch
*
* @return An error code
- * @param[in] uriData The URI that has a maximum size of @c 1024 bytes
- * @param[in] pOperationId The operation ID
- * @param[in] pDataType The MIME type (RFC 2046) or file extension @n
- * The '.' prefix must be used for the @c dataType when specifying the file extension.
- * @param[in] pListener A listener that gets notified when the resolved application control has started
- * @exception E_SUCCESS The method is successful.
- * @exception E_MAX_EXCEEDED The size of @c uri has exceeded the maximum limit.
+ * @param[in] uriData The URI that has a maximum size of @c 1024 bytes
+ * @param[in] pOperationId The operation ID
+ * @param[in] pDataType The MIME type (RFC 2046) or file extension @n
+ * The '.' prefix must be used for the @c dataType while specifying the file extension.
+ * @param[in] pListener The listener that gets notified when the resolved application control is started
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_MAX_EXCEEDED The size of @c uri has exceeded the maximum limit.
* @exception E_UNSUPPORTED_FORMAT The specified file extension for @c pDataType is not supported.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_OBJ_NOT_FOUND The application control is not found.
- * @exception E_IN_PROGRESS The target application control is in progress.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_OBJ_NOT_FOUND The application control has not been found.
+ * @exception E_IN_PROGRESS The target application control is in progress.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*
* @see App::GetAppArgumentListN()
* @see FindAppControlN()
/**
* @if OSPDEPREC
* Starts the application control if there is only one application control that matches the specified operation ID, category, URI, and data type. @n
- * If there are more than one application controls, the one that the user selects is started.
+ * If there are more than one application controls, then the user selected one is started.
*
- * @brief <i> [Deprecated] </i>
+ * @brief <i> [Deprecated] </i>
* @deprecated This method is deprecated because IAppControlListener is deprecated and replaced by IAppControlResponselistener.
* Instead of using this method, use AppControl::FindAndStart().
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/application.launch
*
- * @return An error code
- * @param[in] pOperationId The operation ID
- * @param[in] pCategory The application control category
- * @param[in] pDataType The MIME type (RFC 2046) or file extension @n
- * The '.' prefix must be used when specifying the file extension.
- * @param[in] pUriPattern A URI pattern which is used for application control resolution and delivered as the argument
- * @param[in] pDataList The data list that is delivered to the resolved application control @n
- * It has a maximum size of @c 1024 bytes.
- * @param[in] pListener A listener that gets notified when the resolved application control has started
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG At least one of the specified @c pOperationId, @c pCategory, @c pDataType, or @c pUri must not be @c null.
- * @exception E_MAX_EXCEEDED The size of @c pDataList has exceeded the maximum limit.
+ * @return An error code
+ * @param[in] pOperationId The operation ID
+ * @param[in] pCategory The application control category
+ * @param[in] pDataType The MIME type (RFC 2046) or file extension @n
+ * The '.' prefix must be used while specifying the file extension.
+ * @param[in] pUriPattern The URI pattern which is used for the application control resolution and is delivered as an argument
+ * @param[in] pDataList The data list that is delivered to the resolved application control @n
+ * It has a maximum size of @c 1024 bytes.
+ * @param[in] pListener The listener that gets notified when the resolved application control is started
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG At least one of the specified @c pOperationId, @c pCategory, @c pDataType, or @c pUri must not be @c null.
+ * @exception E_MAX_EXCEEDED The size of @c pDataList has exceeded the maximum limit.
* @exception E_UNSUPPORTED_FORMAT The specified file extension for @c pDataType is not supported.
- * @exception E_OBJ_NOT_FOUND The application control is not found.
- * @exception E_IN_PROGRESS The target application control is in progress.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_OBJ_NOT_FOUND The application control has not been found.
+ * @exception E_IN_PROGRESS The target application control is in progress.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks For delivered launch arguments, see App::GetAppArgumentListN().
- * @see App::GetAppArgumentListN()
* @see FindAppControlsN()
* @see AppControl::Start()
* @endif
*
* @since 2.0
*
- * @return A pointer to the SqlDataControl instance if a matching data control is found, @n
- * else @c null
+ * @return A pointer to the SqlDataControl instance, if a matching data control is found, @n
+ * else @c null if it fails
* @param[in] providerId The provider ID
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The data control specified with the @c providerId is not found.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_OBJ_NOT_FOUND The data control specified with the @c providerId has not been found.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*
* @since 2.0
*
- * @return A pointer to the MapDataControl instance if a matching data control is found, @n
- * else @c null
+ * @return A pointer to the MapDataControl instance, if a matching data control is found, @n
+ * else @c null if it fails
* @param[in] providerId The provider ID
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The data control specified with the @c providerId is not found.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_OBJ_NOT_FOUND The data control specified with the @c providerId has not been found.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
static MapDataControl* GetMapDataControlN(const Tizen::Base::String& providerId);
/**
- * Gets the path of the read-only shared directory exported by an other application specified with an application ID.
+ * Gets the path of the read-only shared directory exported by another application specified with an application ID.
*
* @since 2.0
*
* else an empty string if an exception occurs
* @param[in] appId The application ID
* @exception E_SUCCESS The method is successful.
- * @exception E_APP_NOT_INSTALLED The expected shared directory cannot be found
- * because the application specified with @c appId cannot be installed.
- * @remarks
- * - The returned path can be invalid when the application with specified with @c appId is uninstalled.
- * - The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_APP_NOT_INSTALLED The expected shared directory has not been found
+ * because the application specified by @c appId cannot be installed.
+ * @remarks
+ * - The returned path can be invalid when the application specified by @c appId is uninstalled.
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - If the platform policy is changed or the device is different, the returned file path can be different. @n
+ * Rather than changing the returned file path as hard coding, use as it is.
*/
static Tizen::Base::String GetAppSharedPath(const AppId& appId);
/**
- * Gets the application manager instance.
+ * Gets a pointer to the %AppManager instance.
*
* @since 2.0
*
/**
* @if OSPDEPREC
* Launches the default application with the given @c appId. @n
- * The launch arguments are given as App::OnUserEventReceivedN() or can be obtained by
- * invoking App::GetAppArgumentListN(), especially within App::OnAppInitializing().
+ * The launch arguments are given by the App::OnUserEventReceivedN() method or can be obtained by
+ * invoking the App::GetAppArgumentListN() method, especially within App::OnAppInitializing().
*
* @brief <i> [Deprecated] </i>
- * @deprecated This method is deprecated because sending argument with %LaunchApplication() is not recommended. @n
- * Instead of using this method, use %LaunchApplication() without launch arguments or AppControl::Start().
- * @since 2.0
+ * @deprecated This method is deprecated because sending arguments through the %LaunchApplication() method is not recommended. @n
+ * Instead of using this method, use the %LaunchApplication() method without launch arguments or AppControl::Start().
+ * @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/application.launch
*
- * @return An error code
- * @param[in] appId The application's ID to execute
+ * @return An error code
+ * @param[in] appId The ID of the application to execute
* @param[in] pArguments A pointer to the list of string arguments that has a maximum size of @c 1024 bytes
* @param[in] option The launch option (currently only AppManager::LAUNCH_OPTION_DEFAULT is available)
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @exception E_INVALID_ARG The specified @c appId is empty.
- * @exception E_OBJ_NOT_FOUND The target application is not installed.
+ * @exception E_OBJ_NOT_FOUND The target application has not been installed.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_MAX_EXCEEDED The size of @c appId or @c pArguments has exceeded the maximum limit.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate of target application. @b Since: @b 2.1
+ * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate as that of the target application. @b Since: @b 2.1
* @endif
*/
result LaunchApplication(const AppId& appId, const Tizen::Base::Collection::IList* pArguments, LaunchOption option = LAUNCH_OPTION_DEFAULT);
/**
* Launches the default application with the given @c appId.
*
- * @since 2.0
+ * @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/application.launch
*
- * @return An error code
- * @param[in] appId The application's ID to execute
+ * @return An error code
+ * @param[in] appId The ID of the application to execute
* @param[in] option The launch option (currently only AppManager::LAUNCH_OPTION_DEFAULT is available)
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_APP_NOT_INSTALLED The target application is not installed.
+ * @exception E_APP_NOT_INSTALLED The target application has not been installed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate of target application. @b Since: @b 2.1
+ * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate as that of the target application. @b Since: @b 2.1
*/
result LaunchApplication(const AppId& appId, LaunchOption option = LAUNCH_OPTION_DEFAULT);
* @privilege %http://tizen.org/privilege/appmanager.kill @n
* (%http://tizen.org/privilege/application.kill is deprecated.)
*
- * @return An error code
- * @param[in] appId The application's ID to execute
+ * @return An error code
+ * @param[in] appId The ID of the application to execute
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_OBJ_NOT_FOUND The application is either not installed or is not running.
+ * @exception E_OBJ_NOT_FOUND Either of the following conditions has occurred:
+ * - The application is not installed.
+ * - The application is not running.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
result TerminateApplication(const AppId& appId);
/**
- * Checks whether an application is running.
+ * Checks whether the application is running.
*
* @since 2.0
*
- * @return @c true if the application is running, @n
- * else @c false
- * @param[in] appId The installed application ID
+ * @return @c true if the application is running, @n
+ * else @c false
+ * @param[in] appId The installed application's ID
*/
bool IsRunning(const AppId& appId) const;
/**
- * Gets a list of running applications at the time of invocation.
+ * Gets the list of running applications at the time of the invocation.
*
* @since 2.0
*
- * @return A pointer to the running state application list (AppId), @n
- * else @c null if an error occurs
+ * @return A pointer to the running state application list (AppId), @n
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
/**
* Registers an application with a specific condition and launches it if the condition is met. @n
- * If the requested application is already running, the application is notified through IAppLaunchConditionEventListener::OnAppLaunchConditionMetN().
- * The launch arguments are given as input parameters to %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN().
+ * If the requested application is already running, the application is notified through the IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
+ * The launch arguments are given as input parameters to the %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
*
- * @since 2.0
+ * @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/application.launch
- * @feature %http://tizen.org/feature/network.nfc for L"NFC='command'" or %http://tizen.org/feature/usb.accessory for "Serial='command'" in the value of @c condition
+ * @feature %http://tizen.org/feature/network.nfc for L"NFC='command'" or %http://tizen.org/feature/usb.accessory for "Serial='command'" in the value of @c condition
*
* @return An error code
* @param[in] condition The launch condition for the application @n
- * The condition has L"Key='value'" format and is case sensitive. To use single or double quotes in the condition values, prefix them with a slash (\' or \"). @n
- * For more information on the condition formats, see <a href="../org.tizen.native.appprogramming/html/guide/app/registering_launch_condition.htm">Registering a Launch Condition</a>.
- * <table><tr><th>Condition Format</th><th>Meaning</th></tr>
- <tr><td>L"DateTime='mm/dd/yyyy hh:mm:ss'"</td>
- <td>The specified condition is the local due time.</td></tr>
- <tr><td>L"DueTime='mm/dd/yyyy hh:mm:ss' LaunchPeriod='mm'"</td>
- <td>The specific condition is the time period after due time.</td></tr>
- <tr><td>L"WeeklyTime='EEE HH:mm:ss'"</td>
- <td>The specified condition is a day of a week with a specific time at which the application is launched on a weekly basis. For multiple descriptions, "," delimiter can be used as shown in the following example: <br>i"'Mon 09:00:00', 'Tue 09:00:00', 'Wed 09:00:00', 'Thu 09:00:00', 'Fri 09:00:00'"<br> To specify the day of the week, it must be in one of the following supported string format: <br>Mon: Monday<br>Tue: Tuesday<br>Wed: Wednesday<br>Thu: Thursday<br>Fri: Friday<br>Sat: Saturday<br>Sun: Sunday</td></tr>
- <tr><td>L"Serial='command'"</td><td>The specified condition is a serial
- communication input command.</td></tr>
- <tr><td>L"NFC='command'"</td><td>The specified condition is a Near Field Communication (NFC) tag that has the NFC Data Exchange Format (NDEF) data.
- </td></tr></table> @n
-
- *
- * @param[in] pArguments A list of string arguments that has a maximum size of @c 1024 bytes @n
- * The parameter can also contain @c null. @n
- * For more information on the arguments, see <a href="../org.tizen.native.appprogramming/html/guide/app/launching_other_apps_within_apps.htm">Launching Other Applications</a>.
- * @param[in] option The launch option (currently only AppManager::LAUNCH_OPTION_DEFAULT is available)
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The launch condition is empty or too long (Maximum 400 bytes).
- * @exception E_INVALID_FORMAT The specified condition format is invalid.
- * @exception E_INVALID_CONDITION The specified condition format is valid but the condition has at least one or more invalid values.
- * @exception E_OBJ_ALREADY_EXIST The specified @c condition is already registered by a different application.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_MAX_EXCEEDED The size of @c pArguments has exceeded the maximum limit.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>. @b Since: @b 2.1
- *
- * @remarks When the registered application is about to be launched, the registered launch condition and arguments are given as parameters to IAppLaunchConditionEventListener::OnAppLaunchConditionMetN().
- * @remarks The newly introduced launch condition does not work on the previous SDK version and the E_INVALID_CONDITION exception is returned.
- * @remarks Registering the same launch condition overwrites the previous launch argument without throwing an exception.
- * @remarks The launch period requires more consideration because an inappropriate short period value may lead
- * to an adverse effect on the device battery.
- * @remarks For the NFC launch condition, the detected NDEF message can be acquired using the @c pExtraData parameter of the %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
- * @remarks Before calling this method, check whether the feature is supported by Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
+ * The condition has L"Key='value'" format and is case sensitive. To use single or double quotes in the condition values, prefix them with a slash (\' or \"). @n
+ * For more information on the condition formats, see <a href="../org.tizen.native.appprogramming/html/guide/app/registering_launch_condition.htm">Registering a Launch Condition</a>.
+ * <table><tr><th>Condition Format</th><th>Meaning</th></tr>
+ * <tr><td>L"DateTime='mm/dd/yyyy hh:mm:ss'"</td>
+ * <td>The specified condition is the local due time.</td></tr>
+ * <tr><td>L"DueTime='mm/dd/yyyy hh:mm:ss' LaunchPeriod='mm'"</td>
+ * <td>The specified condition is the time period after the due time.</td></tr>
+ * <tr><td>L"WeeklyTime='EEE HH:mm:ss'"</td>
+ * <td>The specified condition is a day of a week with a specific time at which the application is launched on a weekly basis. For multiple descriptions, "," delimiter can be used as shown in the following example: <br>i"'Mon 09:00:00', 'Tue 09:00:00', 'Wed 09:00:00', 'Thu 09:00:00', 'Fri 09:00:00'"<br> To specify the day of the week, it must be in one of the following supported string format: <br>Mon: Monday<br>Tue: Tuesday<br>Wed: Wednesday<br>Thu: Thursday<br>Fri: Friday<br>Sat: Saturday<br>Sun: Sunday</td></tr>
+ * <tr><td>L"Serial='command'"</td><td>The specified condition is a serial
+ * communication input command.</td></tr>
+ * <tr><td>L"NFC='command'"</td><td>The specified condition is a Near Field Communication (NFC) tag that has the NFC Data Exchange Format (NDEF) data.
+ * </td></tr></table> @n
+ *
+ *
+ * @param[in] pArguments The list of string arguments that has a maximum size of @c 1024 bytes @n
+ * This parameter can also contain @c null. @n
+ * For more information on the arguments, see <a href="../org.tizen.native.appprogramming/html/guide/app/launching_other_apps_within_apps.htm">Launching Other Applications</a>.
+ * @param[in] option The launch option (currently only AppManager::LAUNCH_OPTION_DEFAULT is available)
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The launch condition is empty or too long (Maximum 400 bytes).
+ * @exception E_INVALID_FORMAT The specified condition format is invalid.
+ * @exception E_INVALID_CONDITION The specified condition format is valid but the condition has at least one or more invalid values.
+ * @exception E_OBJ_ALREADY_EXIST The specified @c condition is already registered by a different application.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_MAX_EXCEEDED The size of @c pArguments has exceeded the maximum limit.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>. @b Since: @b 2.1
+ *
+ * @remarks
+ * - When the registered application is about to be launched, the registered launch condition and arguments are given as parameters to the
+ * IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
+ * - For the NFC launch condition, the detected NDEF message can be acquired using the @c pExtraData parameter of the
+ * %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
+ * - The newly introduced launch condition does not work on the previous SDK version and @c E_INVALID_CONDITION is returned.
+ * - Registering the same launch condition overwrites the previous launch argument without throwing an exception.
+ * - The launch period requires more consideration because an inappropriate short period value may lead to an adverse effect on the device battery.
+ * - Before calling this method, check whether the feature is supported by Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
* @see UnregisterAppLaunch()
* @see IsAppLaunchRegistered()
* @see LaunchApplication(const AppId&, LaunchOption);
/**
* Unregisters the previously registered launch condition.
*
- * @since 2.0
+ * @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/application.launch
*
* @return An error code
- * @exception E_SUCCESS Either of the following conditions has occurred:
+ * @exception E_SUCCESS Either of the following conditions has occurred:
* - The method is successful.
* - There is no registered launch condition.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @see RegisterAppLaunch()
* @see IsAppLaunchRegistered()
*/
* @return An error code
* @param[in] condition The launch condition for the application
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified launch condition is not found.
+ * @exception E_OBJ_NOT_FOUND The specified launch condition has not been found.
* @exception E_SYSTEM A system error has occurred.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
result UnregisterAppLaunch(const Tizen::Base::String& condition);
/**
- * Checks whether a launch condition is registered for the application.
+ * Checks whether the launch condition is registered for the application.
*
* @since 2.0
*
- * @return @c true if a condition is already registered to the application invoking this method, @n
+ * @return @c true if the condition is already registered for the application, @n
* else @c false
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
bool IsAppLaunchRegistered(void) const;
/**
- * Registers the specified application with a specific condition and launches it if the condition is met. @n
- * If the requested application is already running, the application is notified through IAppLaunchConditionEventListener::OnAppLaunchConditionMetN().
- * The launch arguments are given as input parameters to %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN().
+ * Registers the specified application with the specified condition and launches it if the condition is met. @n
+ * If the requested application is already running, the application is notified through the IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
+ * The launch arguments are given as input parameters to the %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
*
* @since 2.0
* @privlevel partner
* @privilege %http://tizen.org/privilege/appmanager.launch
- * @feature %http://tizen.org/feature/network.nfc for L"NFC='command'" or %http://tizen.org/feature/usb.accessory for L"Serial='command'" in the value of @c condition
+ * @feature %http://tizen.org/feature/network.nfc for L"NFC='command'", or %http://tizen.org/feature/usb.accessory for L"Serial='command'" in the value of @c condition
*
* @return An error code
* @param[in] appId The ID of the application registered for launch
* @param[in] condition The launch condition for the application @n
* The condition has L"Key='value'" format and is case sensitive. To use single or double quotes in the condition values, prefix them with a slash (\' or \"). @n
* For more information on the condition formats, see <a href="../org.tizen.native.appprogramming/html/guide/app/registering_launch_condition.htm">Registering a Launch Condition</a>.
- * <table><tr><th>Condition Format</th><th>Meaning</th></tr>
- <tr><td>L"DateTime='mm/dd/yyyy hh:mm:ss'"</td>
- <td>The specified condition is the local due time.</td></tr>
- <tr><td>L"DueTime='mm/dd/yyyy hh:mm:ss' LaunchPeriod='mm'"</td>
- <td>The specific condition is the time period after due time.</td></tr>
- <tr><td>L"WeeklyTime='EEE HH:mm:ss'"</td>
- <td>The specified condition is a day of a week with a specific time at which the application is launched on a weekly basis. For multiple descriptions, "," delimiter can be used as shown in the following example: <br>i"'Mon 09:00:00', 'Tue 09:00:00', 'Wed 09:00:00', 'Thu 09:00:00', 'Fri 09:00:00'"<br> To specify the day of the week, it must be in one of the following supported string format: <br>Mon: Monday<br>Tue: Tuesday<br>Wed: Wednesday<br>Thu: Thursday<br>Fri: Friday<br>Sat: Saturday<br>Sun: Sunday</td></tr>
- <tr><td>L"Serial='command'"</td><td>The specified condition is a serial
- communication input command.</td></tr>
- <tr><td>L"NFC='command'"</td><td>The specified condition is a Near Field Communication (NFC) tag that has the NFC Data Exchange Format (NDEF) data.
- </td></tr></table> @n
-
- *
- * @param[in] pArguments A list of string arguments that has a maximum size of @c 1024 bytes @n
- * The parameter can also contain @c null. @n
- * For more information on the arguments, see <a href="../org.tizen.native.appprogramming/html/guide/app/launching_other_apps_within_apps.htm">Launching Other Applications</a>.
- * @param[in] option The launch option (currently only AppManager::LAUNCH_OPTION_DEFAULT is available)
- * @exception E_SUCCESS The method is successful.
- * @exception E_APP_NOT_INSTALLED The application is not installed.
- * @exception E_INVALID_ARG The launch condition is empty or too long (Maximum 400 bytes).
- * @exception E_INVALID_FORMAT The specified condition format is invalid.
- * @exception E_INVALID_CONDITION The specified condition format is valid but the condition has at least one or more invalid values.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_MAX_EXCEEDED The size of @c pArguments has exceeded the maximum limit.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>. @b Since: @b 2.1
- *
- * @remarks When the registered application is about to be launched, the registered launch condition and arguments are given as parameters to IAppLaunchConditionEventListener::OnAppLaunchConditionMetN().
- * @remarks The newly introduced launch condition does not work on the previous SDK version and the @c E_INVALID_CONDITION exception is returned.
- * @remarks Registering the same launch condition overwrites the previous launch argument without throwing an exception.
- * @remarks The launch period requires more consideration because an inappropriate short period value may lead
- * to an adverse effect on the device battery.
- * @remarks For the NFC launch condition, the detected NDEF message can be acquired using the @c pExtraData parameter of the %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
- * @remarks Before calling this method, check whether the feature is supported by Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
+ * <table><tr><th>Condition Format</th><th>Meaning</th></tr>
+ * <tr><td>L"DateTime='mm/dd/yyyy hh:mm:ss'"</td>
+ * <td>The specified condition is the local due time.</td></tr>
+ * <tr><td>L"DueTime='mm/dd/yyyy hh:mm:ss' LaunchPeriod='mm'"</td>
+ * <td>The specified condition is the time period after the due time.</td></tr>
+ * <tr><td>L"WeeklyTime='EEE HH:mm:ss'"</td>
+ * <td>The specified condition is a day of a week with a specific time at which the application is launched on a weekly basis. For multiple descriptions, "," delimiter can be used as shown in the following example: <br>i"'Mon 09:00:00', 'Tue 09:00:00', 'Wed 09:00:00', 'Thu 09:00:00', 'Fri 09:00:00'"<br> To specify the day of the week, it must be in one of the following supported string format: <br>Mon: Monday<br>Tue: Tuesday<br>Wed: Wednesday<br>Thu: Thursday<br>Fri: Friday<br>Sat: Saturday<br>Sun: Sunday</td></tr>
+ * <tr><td>L"Serial='command'"</td><td>The specified condition is a serial
+ * communication input command.</td></tr>
+ * <tr><td>L"NFC='command'"</td><td>The specified condition is a Near Field Communication (NFC) tag that has the NFC Data Exchange Format (NDEF) data.
+ * </td></tr></table> @n
+ *
+ *
+ * @param[in] pArguments The list of string arguments that has a maximum size of @c 1024 bytes @n
+ * The parameter can also contain @c null. @n
+ * For more information on the arguments, see <a href="../org.tizen.native.appprogramming/html/guide/app/launching_other_apps_within_apps.htm">Launching Other Applications</a>.
+ * @param[in] option The launch option (currently only AppManager::LAUNCH_OPTION_DEFAULT is available)
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_APP_NOT_INSTALLED The application has not been installed.
+ * @exception E_INVALID_ARG The launch condition is empty or too long (Maximum 400 bytes).
+ * @exception E_INVALID_FORMAT The specified condition format is invalid.
+ * @exception E_INVALID_CONDITION The specified condition format is valid but the condition has at least one or more invalid values.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_MAX_EXCEEDED The size of @c pArguments has exceeded the maximum limit.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>. @b Since: @b 2.1
+ *
+ * @remarks
+ * - When the registered application is about to be launched, the registered launch condition and arguments are given as parameters to the
+ * IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
+ * - For the NFC launch condition, the detected NDEF message can be acquired using the @c pExtraData parameter of the
+ * %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
+ * - The newly introduced launch condition does not work on the previous SDK version and @c E_INVALID_CONDITION is returned.
+ * - Registering the same launch condition overwrites the previous launch argument without throwing an exception.
+ * - The launch period requires more consideration because an inappropriate short period value may lead
+ * to an adverse effect on the device battery.
+ * - Before calling this method, check whether the feature is supported by Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
* @see UnregisterAppLaunch()
* @see IsAppLaunchRegistered()
* @see LaunchApplication(const AppId&, LaunchOption);
- * @see IAppLaunchConditionEventListener::OnAppLaunchConditionMetN()
* @see Tizen::Base::DateTime::ToString()
* @see Tizen::Io::SerialPort
*/
* @privilege %http://tizen.org/privilege/appmanager.launch
*
* @return An error code
- * @param[in] appId The application ID
+ * @param[in] appId The application ID
* @param[in] pCondition The launch condition to unregister @n
* If the parameter contains @c null, all the conditions are unregistered.
* @exception E_SUCCESS The method is successful.
- * @exception E_APP_NOT_INSTALLED The application is not installed.
- * @exception E_OBJ_NOT_FOUND The specified launch condition is not found.
+ * @exception E_APP_NOT_INSTALLED The application has not been installed.
+ * @exception E_OBJ_NOT_FOUND The specified launch condition has not been found.
* @exception E_SYSTEM A system error has occurred.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @privlevel partner
* @privilege %http://tizen.org/privilege/appmanager.launch
*
- * @return @c true if a condition is already registered to the specified application with the specified condition, @n
+ * @return @c true if the condition is already registered for the specified application with the specified condition, @n
* else @c false
- * @param[in] appId The application ID
- * @param[in] pCondition The launch condition to register for the specified @c appId @n
- * If the parameter contains @c null, the method checks for any registered launch condition for the specified @c appId.
+ * @param[in] appId The application ID
+ * @param[in] pCondition The launch condition to register for the specified @c appId @n
+ * If the parameter contains @c null, the method checks for any registered launch condition for the specified @c appId.
* @exception E_SUCCESS The method is successful.
- * @exception E_APP_NOT_INSTALLED The application is not installed.
+ * @exception E_APP_NOT_INSTALLED The application has not been installed.
* @exception E_SYSTEM A system error has occurred.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*
* @since 2.0
*
- * @return An error code
- * @param[in] listener The listener to receive the checkpoint event
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_ALREADY_EXIST The listener is already set.
- * @exception E_SYSTEM A system error has occurred.
+ * @return An error code
+ * @param[in] listener The listener to receive the checkpoint event
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_ALREADY_EXIST The listener is already set.
+ * @exception E_SYSTEM A system error has occurred.
*
*/
result SetCheckpointEventListener(IAppCheckpointEventListener& listener);
/**
* @if OSPDEPREC
* Sends the result list for the application control request. @n
- * The client can get the result list by implementing IAppControlEventListener::OnAppControlCompleted().
+ * The client gets the result list by implementing the IAppControlEventListener::OnAppControlCompleted() method.
*
- * @brief <i> [Deprecated] </i>
+ * @brief <i> [Deprecated] </i>
* @deprecated This method is deprecated because a new method has been added. @n
- * Instead of using this method, use AppControlProviderManager::SendAppControlResult().
+ * Instead of using this method, use AppControlProviderManager::SendAppControlResult().
* @since 2.0
*
* @return An error code
- * @param[in] appControlRequestId The application control request ID @n
- * The application control request ID is given as an argument for
- * App::GetAppArgumentListN() or App::OnUserEventReceivedN().
- * @param[in] pResultList The list of the result strings of the application control
+ * @param[in] appControlRequestId The application control request ID @n
+ * The application control request ID is given as an argument to the
+ * App::GetAppArgumentListN() method or the App::OnUserEventReceivedN() method.
+ * @param[in] pResultList The list of the result strings of the application control
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The application control request is not found.
+ * @exception E_OBJ_NOT_FOUND The application control request has not been found.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
* @see IAppControlEventListener
static result SendAppControlResult(const Tizen::Base::String& appControlRequestId, const Tizen::Base::Collection::IList* pResultList);
/**
- * Sets an IAppLaunchConditionEventListener to the %AppManager. @n
- * The listener gets notified when the application is launched by the registered condition.
- *
- * @since 2.0
- *
- * @param[in] pListener The event listener @n
- * To unset the listener, pass a @c null value to the listener parameter.
- * @remarks If the application is newly launched by the condition, then %SetAppLaunchConditionEventListener() must
- * be set within App::OnAppInitializing().
- * If the application does not set the listener using %SetAppLaunchConditionEventListener(),
- * then the application is launched without invoking any listener for the condition.
- * @see RegisterAppLaunch()
- */
+ * Sets an IAppLaunchConditionEventListener for the %AppManager. @n
+ * The listener gets notified when the application is launched by the registered condition.
+ *
+ * @since 2.0
+ *
+ * @param[in] pListener The event listener @n
+ * To unset the listener, pass a @c null value to the listener parameter.
+ * @remarks If the application is newly launched by the condition, then the %SetAppLaunchConditionEventListener() method
+ * within App::OnAppInitializing() must be set. @n
+ * If the application does not set the listener using the %SetAppLaunchConditionEventListener() method,
+ * then the application is launched without invoking any listener for the condition.
+ * @see RegisterAppLaunch()
+ */
void SetAppLaunchConditionEventListener(IAppLaunchConditionEventListener* pListener);
/**
- * Adds an IActiveAppEventListener to the %AppManager. @n
+ * Adds an IActiveAppEventListener for the %AppManager. @n
* The listener gets notified when the active application is changed.
*
* @since 2.0
* @exception E_OBJ_ALREADY_EXIST The listener is already added.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks Active application is the top most window with focus.
+ * @remarks The active application is the top most window with focus.
* @see GetActiveApp()
* @see RemoveActiveAppEventListener()
*/
* @return An error code
* @param[in] listener The event listener
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified @c listener is not found.
+ * @exception E_OBJ_NOT_FOUND The specified @c listener has not been found.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @see GetActiveApp()
result RemoveActiveAppEventListener(IActiveAppEventListener& listener);
/**
- * Gets the current active application AppId.
+ * Gets the current active application's ID.
*
* @since 2.0
*
* @privilege %http://tizen.org/privilege/appusage
*
* @return An error code
- * @param[out] appId The AppId of the active application
+ * @param[out] appId The ID of the active application
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks Active application is the top most window with focus.
+ * @remarks The active application is the top most window with focus.
* @see AddActiveAppEventListener()
* @see RemoveActiveAppEventListener()
*/
result GetActiveApp(AppId& appId);
/**
- * Checks whether the specified application is declared as preferred application for any AppControl resolution
+ * Checks whether the specified application is declared as the preferred application for any AppControl resolution
*
* @since 2.2
- * @privlevel platform
+ * @privlevel platform
* @privilege %http://tizen.org/privilege/appmanager.setting
*
* @return @c true if the application is running, @n
- * else @c false
- * @param[in] appId Application ID
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_APP_NOT_INSTALLED The specified application is not installed.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks For more information on AppControl resolution, see <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">Application Controls</a>.
+ * else @c false
+ * @param[in] appId The application ID
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_APP_NOT_INSTALLED The specified application has not been installed.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - For more information on AppControl resolution, see <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">Application Controls</a>.
*/
- bool IsUserPreferredAppForAppControlResolution(const AppId& appId) const;
+ bool IsUserPreferredAppForAppControlResolution(const AppId& appId) const;
/**
- * Clear user preference for all AppControl resolutions on the specified application.
+ * Clears the user preference for all the AppControl resolutions of the specified application.
*
* @since 2.2
- * @privlevel platform
+ * @privlevel platform
* @privilege %http://tizen.org/privilege/appmanager.setting
*
- * @return An error code
+ * @return An error code
* @param[in] appId The preferred application's ID
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_APP_NOT_INSTALLED The specified application is not installed.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_APP_NOT_INSTALLED The specified application has not been installed.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @remarks For more information on AppControl resolution, see <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">Application Controls</a>.
*/
result ClearUserPreferenceForAppControlResolution(const AppId& appId);
*
* @final This class is not intended for extension.
*
- * The %AppRegistry class lets an application to save or restore its preferences.
+ * The %AppRegistry class lets an application save or restore its preferences.
* An instance of this class can be obtained through the Application class.
* Also, since an application's state is generally restored in the App::OnAppInitializing() method and saved in the App::OnAppTerminating() method, an instance of this class is passed as an argument when these methods are invoked.
* @n
*
* @since 2.0
*
- * @return An error code
- * @param[in] key A key corresponding to the value
- * @param[in] value A string value
+ * @return An error code
+ * @param[in] key The key corresponding to the string value
+ * @param[in] value The string value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c key is empty or is string with '\0' and @htmlonly '\n' @endhtmlonly.
- * @exception E_KEY_ALREADY_EXIST The key has already been used in the application preferences.
+ * @exception E_INVALID_ARG The specified @c key is empty or is a string with '\0' and @htmlonly '\n' @endhtmlonly.
+ * @exception E_KEY_ALREADY_EXIST The specified @c key has already been used in the application preferences.
* @remarks In order to save the value in the persistent storage, the Save() method must be called.
*/
result Add(const Tizen::Base::String& key, const Tizen::Base::String& value);
*
* @since 2.0
*
- * @return An error code
- * @param[in] key A key corresponding to the value
- * @param[in] value An integer value
+ * @return An error code
+ * @param[in] key The key corresponding to the integer value
+ * @param[in] value The integer value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c key is empty or is string with '\0' and @htmlonly '\n' @endhtmlonly.
- * @exception E_KEY_ALREADY_EXIST The key has already been used in the application preferences.
+ * @exception E_INVALID_ARG The specified @c key is empty or is a string with '\0' and @htmlonly '\n' @endhtmlonly.
+ * @exception E_KEY_ALREADY_EXIST The specified @c key has already been used in the application preferences.
* @remarks In order to save the value in the persistent storage, the Save() method must be called.
*/
result Add(const Tizen::Base::String& key, int value);
*
* @since 2.0
*
- * @return An error code
- * @param[in] key A key corresponding to the value
- * @param[in] value A floating point value
+ * @return An error code
+ * @param[in] key The key corresponding to the floating point value
+ * @param[in] value The floating point value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c key is empty or is string with '\0' and @htmlonly '\n' @endhtmlonly.
- * @exception E_KEY_ALREADY_EXIST The key has already been used in the application preferences.
+ * @exception E_INVALID_ARG The specified @c key is empty or is a string with '\0' and @htmlonly '\n' @endhtmlonly.
+ * @exception E_KEY_ALREADY_EXIST The specified @c key has already been used in the application preferences.
* @remarks In order to save the value in the persistent storage, the Save() method must be called.
*/
result Add(const Tizen::Base::String& key, double value);
/**
- * Sets a string value associated with the specified @c key.
+ * Sets the string value associated with the specified @c key.
*
* @since 2.0
*
- * @return An error code
- * @param[in] key A key corresponding to the value
- * @param[in] value A string value
+ * @return An error code
+ * @param[in] key The key corresponding to the string value
+ * @param[in] value The string value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c key is empty or is string with '\0' and @htmlonly '\n' @endhtmlonly.
+ * @exception E_INVALID_ARG The specified @c key is empty or is a string with '\0' and @htmlonly '\n' @endhtmlonly.
* @exception E_KEY_NOT_FOUND The specified @c key is not used in the application preferences.
* @remarks In order to save the value in the persistent storage, the Save() method must be called.
*/
result Set(const Tizen::Base::String& key, const Tizen::Base::String& value);
/**
- * Sets an integer value associated with the specified @c key.
+ * Sets the integer value associated with the specified @c key.
*
* @since 2.0
*
- * @return An error code
- * @param[in] key A key corresponding to the value
- * @param[in] value An integer value
+ * @return An error code
+ * @param[in] key The key corresponding to the integer value
+ * @param[in] value The integer value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c key is empty or is string with '\0' and @htmlonly '\n' @endhtmlonly.
+ * @exception E_INVALID_ARG The specified @c key is empty or is a string with '\0' and @htmlonly '\n' @endhtmlonly.
* @exception E_KEY_NOT_FOUND The specified @c key is not used in the application preferences.
* @remarks In order to save the value in the persistent storage, the Save() method must be called.
*/
result Set(const Tizen::Base::String& key, int value);
/**
- * Sets a floating point value associated with the specified @c key.
+ * Sets the floating point value associated with the specified @c key.
*
* @since 2.0
*
- * @return An error code
- * @param[in] key A key corresponding to the value
- * @param[in] value A floating point value
+ * @return An error code
+ * @param[in] key The key corresponding to the floating point value
+ * @param[in] value The floating point value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c key is empty or is string with '\0' and @htmlonly '\n' @endhtmlonly.
+ * @exception E_INVALID_ARG The specified @c key is empty or is a string with '\0' and @htmlonly '\n' @endhtmlonly.
* @exception E_KEY_NOT_FOUND The specified @c key is not used in the application preferences.
* @remarks In order to save the value in the persistent storage, the Save() method must be called.
*/
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
*/
result Save(void);
/**
- * Removes a preference associated with the specified @c key.
+ * Removes the preference associated with the specified @c key.
*
* @since 2.0
*
- * @return An error code
- * @param[in] key The key of the value to remove
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] key The key of the value to remove
+ * @exception E_SUCCESS The method is successful.
* @exception E_KEY_NOT_FOUND The specified @c key is not used in the application preferences.
*/
result Remove(const Tizen::Base::String& key);
/**
- * Gets a string value associated with the specified @c key.
+ * Gets the string value associated with the specified @c key.
*
* @since 2.0
*
- * @return An error code
- * @param[in] key The key of the value to retrieve
- * @param[out] value A string value to retrieve
+ * @return An error code
+ * @param[in] key The key of the string value to retrieve
+ * @param[out] value The string value to retrieve
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c key is empty or is string with '\0' and @htmlonly '\n' @endhtmlonly.
+ * @exception E_INVALID_ARG The specified @c key is empty or is a string with '\0' and @htmlonly '\n' @endhtmlonly.
* @exception E_KEY_NOT_FOUND The specified @c key is not used in the application preferences.
*/
result Get(const Tizen::Base::String& key, Tizen::Base::String& value) const;
/**
- * Gets an integer value associated with the specified @c key.
+ * Gets the integer value associated with the specified @c key.
*
* @since 2.0
*
- * @return An error code
- * @param[in] key The key of the value to retrieve
- * @param[out] value An integer value to retrieve
+ * @return An error code
+ * @param[in] key The key of the integer value to retrieve
+ * @param[out] value The integer value to retrieve
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c key is empty or is string with '\0' and @htmlonly '\n' @endhtmlonly.
+ * @exception E_INVALID_ARG The specified @c key is empty or is a string with '\0' and @htmlonly '\n' @endhtmlonly.
* @exception E_KEY_NOT_FOUND The specified @c key is not used in the application preferences.
*/
result Get(const Tizen::Base::String& key, int& value) const;
/**
- * Gets a floating point value associated with the specified @c key.
+ * Gets the floating point value associated with the specified @c key.
*
* @since 2.0
*
- * @return An error code
- * @param[in] key The key of the value to retrieve
- * @param[out] value A floating point value to retrieve
+ * @return An error code
+ * @param[in] key The key of the floating point value to retrieve
+ * @param[out] value The floating point value to retrieve
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c key is empty or is string with '\0' and @htmlonly '\n' @endhtmlonly.
+ * @exception E_INVALID_ARG The specified @c key is empty or is a string with '\0' and @htmlonly '\n' @endhtmlonly.
* @exception E_KEY_NOT_FOUND The specified @c key is not used in the application preferences.
*/
result Get(const Tizen::Base::String& key, double& value) const;
/**
- * Gets the %AppRegistry instance pointer.
+ * Gets a pointer to the %AppRegistry instance.
*
* @since 2.0
*
- * @return A pointer to the %AppRegistry instance, @n
- * else @c null if it fails
+ * @return A pointer to the %AppRegistry instance, @n
+ * else @c null if it fails
*/
static AppRegistry* GetInstance(void);
//
/**
- * @file FAppAppResource.h
- * @brief This is the header file for the %AppResource class.
+ * @file FAppAppResource.h
+ * @brief This is the header file for the %AppResource class.
*
* This header file contains the declarations of the %AppResource class.
*/
{
/**
-* @class AppResource
-* @brief This class provides convenient methods to load application resources at run time.
+* @class AppResource
+* @brief This class provides convenient methods to load application resources at run time.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
* The %AppResource class provides convenient methods to load application resources at run time: @n
-* - Use AppResource::GetString() to get handle and display localized strings.
-* - Use AppResource::GetBitmapN() to obtain a bitmap image that matches the screen density.
-* - If the matching image does not exist, the image of the baseline density folder, ScreenDensity-High is used.
+* - Use the AppResource::GetString() method to get a handle and display localized strings.
+* - Use the AppResource::GetBitmapN() method to obtain a bitmap image that matches the screen density.
+* - If a matching image does not exist, the image of the baseline density folder, ScreenDensity-High is used.
*
-* The instance of this class can be obtained through App::GetAppResource().
+* The instance of this class can be obtained through the App::GetAppResource() method.
*
* The following example demonstrates how to use the %AppResource class to get strings.
*
* @return An error code
* @param[in] resourceId The resource ID of type Tizen::Base::String that describes the resource
* @param[out] loadedString The string obtained from the loaded application resource
- * @exception E_SUCCESS The method is successful.
- * @exception E_FAILURE The argument passed is not found.
- * @exception E_INVALID_ARG The argument passed to a method contains an invalid resource ID.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_FAILURE The argument passed has not been found.
+ * @exception E_INVALID_ARG The argument passed to the method contains an invalid resource ID.
*/
result GetString(const Tizen::Base::String& resourceId, Tizen::Base::String& loadedString) const;
/**
* Gets the bitmap at the specified path. @n
* The %GetBitmapN() method interprets the given resource path and reads the best matching image file for the current device resolution. @n
- * To load the bitmap image from a file, give the name of the file as the input parameter and not the file path (For example: "img.png").
- * Then, the system will first look for the image file in the folder specific to the current device resolution, such as
+ * To load the bitmap image from a file, give the name of the file as the input parameter and not the file path (For example, "img.png").
+ * The system will first look for the image file in the folder specific to the current device resolution, such as
* '720x1280' and if the file does not exist, it will then search the folder that corresponds to the current screen density,
* such as 'screen-density-xhigh'. After searching the density folder, all the other density folders are searched in the order high to low.
* If the requested image file is found in a density-specific folder that is different from the current screen density, the bitmap returned from this method is pre-scaled.
- * But in case of requested image file is saved as ".#.png" (For example : "img.#.png"), then a bitmap instance which is value of returned pointer is not pre-scaled.
- * So, it is recommended to use ".#.png" as extension (For example : "ninePatchImg.#.png") for nine-patch image file.
+ * But in case the requested image file is saved as ".#.png" (For example, "img.#.png"), then the bitmap instance of the returned pointer is not pre-scaled.
+ * So, it is recommended to use ".#.png" as the extension (For example, "ninePatchImg.#.png") for a nine-patch image file.
* Currently supported image formats are: JPEG, GIF, PNG, BMP, TIFF, and WBMP.
* For more information on the features, see <a href="../org.tizen.native.appprogramming/html/multiple_screen/autoscale_resource_fallback.htm">Resource Fallback and Prescaling.</a>
*
* @since 2.0
*
- * @return A pointer to the Bitmap instance generated from the specified file
+ * @return A pointer to the Tizen::Graphics::Bitmap instance generated from the specified file
* @param[in] imagePath The relative path starting from the directory @b "res/screen-density-XXX/" or @b "res/AxB", @n
- * where A and B represent the screen width and height of the supported device models, respectively.
+ * where A and B represent the screen width and screen height of the supported device models, respectively.
* @param[in] pixelFormat The pixel format of the resulting bitmap
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_UNSUPPORTED_FORMAT The image file format or specified pixel format is not supported.
+ * @exception E_UNSUPPORTED_FORMAT Either the image file format or the specified @c pixelFormat is not supported.
* @exception E_FILE_NOT_FOUND The specified file cannot be found.
* @exception E_SYSTEM A system error has occurred.
* @remarks
* - The specific error code can be accessed using the GetLastResult() method.
- * - There is a high probability for an occurrence of an out-of-memory exception. If possible, check whether the exception is E_OUT_OF_MEMORY or not. For more information on how to handle the out-of-memory exception, refer <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/exception_check.htm">here</a>.
+ * - There is a high probability for an occurrence of an out-of-memory exception. If possible, check whether the exception is @c E_OUT_OF_MEMORY or not.
+ * For more information on how to handle the out-of-memory exception, refer
+ * <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/exception_check.htm">here</a>.
*/
Tizen::Graphics::Bitmap* GetBitmapN(const Tizen::Base::String& imagePath, Tizen::Graphics::BitmapPixelFormat pixelFormat) const;
/**
* Gets the bitmap at the specified path. @n
* The %GetBitmapN() method interprets the given resource path and reads the best matching image file for the current device resolution. @n
- * To load the bitmap image from a file, give the name of the file as the input parameter and not the file path (For example: "img.png").
- * Then, the system will first look for the image file in the folder specific to the current device resolution, such as
+ * To load the bitmap image from a file, give the name of the file as the input parameter and not the file path (For example, "img.png").
+ * The system will first look for the image file in the folder specific to the current device resolution, such as
* '720x1280' and if the file does not exist, it will then search the folder that corresponds to the current screen density,
* such as 'screen-density-xhigh'. After searching the density folder, all the other density folders are searched in the order high to low.
* If the requested image file is found in a density-specific folder that is different from the current screen density, the bitmap returned from this method is pre-scaled.
- * But in case of requested image file is saved as ".#.png" (For example : "img.#.png"), then a bitmap instance which is value of returned pointer is not pre-scaled.
- * So, it is recommended to use ".#.png" as extension (For example : "ninePatchImg.#.png") for nine-patch image file.
+ * But in case the requested image file is saved as ".#.png" (For example, "img.#.png"), then the bitmap instance of the returned pointer is not pre-scaled.
+ * So, it is recommended to use ".#.png" as the extension (For example, "ninePatchImg.#.png") for a nine-patch image file.
* Currently supported image formats are: JPEG, GIF, PNG, BMP, TIFF, and WBMP.
* For more information on the features, see <a href="../org.tizen.native.appprogramming/html/multiple_screen/autoscale_resource_fallback.htm">Resource Fallback and Prescaling.</a>
*
* @since 2.0
*
- * @return A pointer to the Tizen::Graphics::Bitmap instance generated from the specified file
+ * @return A pointer to the Tizen::Graphics::Bitmap instance generated from the specified file
* @param[in] imagePath The relative path starting from the density directory @b "res/screen-density-XXX/" or @b "res/AxB", @n
- * where A and B represent the width and height of the screen of the supported device models, respectively
+ * where A and B represent the screen width and screen height of the supported device models, respectively
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
* @exception E_UNSUPPORTED_FORMAT The image file format is not supported.
* @exception E_SYSTEM A system error has occurred.
* @remarks
* - The specific error code can be accessed using the GetLastResult() method.
- * - There is a high probability for an occurrence of an out-of-memory exception. If possible, check whether the exception is E_OUT_OF_MEMORY or not. For more information on how to handle the out-of-memory exception, refer <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/exception_check.htm">here</a>.
+ * - There is a high probability for an occurrence of an out-of-memory exception. If possible, check whether the exception is @c E_OUT_OF_MEMORY or not.
+ * For more information on how to handle the out-of-memory exception, refer
+ * <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/exception_check.htm">here</a>.
*/
Tizen::Graphics::Bitmap* GetBitmapN(const Tizen::Base::String& imagePath) const;
/**
- * Gets the %AppResource instance pointer.
+ * Gets a pointer to the %AppResource instance.
*
- * @since 2.0
+ * @since 2.0
*
- * @return A pointer to the %AppResource instance, @n
- * else @c null if it fails
+ * @return A pointer to the %AppResource instance, @n
+ * else @c null if it fails
*/
static AppResource* GetInstance(void);
/**
- * Gets the resource instance of the specified resource path.
- * @since 2.0
+ * Gets an %AppResource instance of the specified @c resourcePath.
+ * @since 2.0
* @return A pointer to the %AppResource instance, @n
* else @c null if it fails
* @param[in] resourcePath The relative path starting from the resource directory path of the current application
* @exception E_SUCCESS The method is successful.
- * @exception E_FILE_NOT_FOUND The specified resource path does not exist.
- * @exception E_INVALID_ARG The length of the specified path is @c 0 or exceeds system limitations.
- * @exception E_SYSTEM Initializing string and bitmap resource is failed due to system error.
+ * @exception E_FILE_NOT_FOUND The specified @c resourcePath does not exist.
+ * @exception E_INVALID_ARG Either of the following conditions has occured:
+ * - The length of the specified path is @c 0.
+ * - The length of the specified path exceeds system limitations.
+ * @exception E_SYSTEM Initializing the string and the bitmap resource has failed due to a system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static AppResource* LoadAppResource(const Tizen::Base::String& resourcePath);
/**
- * Gets the application resource instance of the specified @c appId.
+ * Gets an %AppResource instance of the specified @c appId.
*
* @since 2.0
*
* @privlevel platform
- * @privilege %http://tizen.org/privilege/appsetting
+ * @privilege %http://tizen.org/privilege/appsetting
*
* @return A pointer to the %AppResource instance, @n
* else @c null if it fails
- * @param[in] appId The AppId of the installed application
+ * @param[in] appId The ID of the installed application
* @exception E_SUCCESS The method is successful.
- * @exception E_DATA_NOT_FOUND The instance of specified @c appId does not provide the string resource.
+ * @exception E_DATA_NOT_FOUND The specified @c appId does not provide the required string resource.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_APP_NOT_INSTALLED The specified @c appId is not found in the list of installed applications.
- * @exception E_SYSTEM Initializing string and bitmap resource has failed due to a system error.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_APP_NOT_INSTALLED The specified @c appId has not been found in the list of installed applications.
+ * @exception E_SYSTEM Initializing the string and the bitmap resource has failed due to a system error.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static AppResource* GetInstanceByAppId(const AppId& appId);
/**
- * Releases the application resource instance of the specified @c appId.
+ * Releases the %AppResource instance of the specified @c appId.
*
* @since 2.0
*
- * @privlevel platform
+ * @privlevel platform
* @privilege %http://tizen.org/privilege/appsetting
*
* @return An error code
- * @param[in] appId The AppId of the installed application
+ * @param[in] appId The ID of the installed application
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The application resource instance of the specified @c appId is not found.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks Individual instances are managed by the platform. @n
- * It is recommended to release instances to reduce memory usage.
+ * @exception E_OBJ_NOT_FOUND The application resource instance of the specified @c appId has not been found.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @remarks
+ * - Individual instances are managed by the platform.
+ * - It is recommended to release instances to reduce memory usage.
*/
static result ReleaseInstanceByAppId(const AppId& appId);
* @final This class is not intended for extension.
*
* The %AppSetting class is a helper class for an application to save or restore its settings.
- * A setting entity is composed of a string-typed key and a value. The value type must be only of these three types: @c int, @c bool, and @c String.
- * The settings are pre-defined in setting/setting.xml in the application's base directory
+ * A setting entity is composed of a string-typed key and a value. The value type must only be of three types: @c int, @c bool, and @c String.
+ * The settings are pre-defined at setting/setting.xml in the application's base directory
* and they can be easily set with %Tizen IDE (<a href="../org.tizen.native.appprogramming/html/ide_sdk_tools/creating_running_app_setting.htm">Creating and Using Application Settings</a>, <a href="../org.tizen.native.appprogramming/html/ide_sdk_tools/application_settings_editor.htm">Application Settings Editor</a>).
- * (The setting.xml is a symbolic link to the currently used setting file, which is related to the current version of the application.) @n
- * The %AppSetting class is basically used for specific applications such as IME, which have no UI.
+ * (setting.xml is a symbolic link to the currently used setting file, which is related to the current version of the application.) @n
+ * The %AppSetting class is basically used for specific applications which have no UI, such as IME.
* Because the applications have no external way to modify their settings, users can adjust the setting values through the setting application, which is delegated to manage the settings.
- * For supporting the consistency of setting values between two applications, the target application and the setting application, when setting a value in the setting application, the target application is notified from the setting application through
- * IAppSettingEventListener::OnAppSettingChanged()
- * For detailed example on this class, see <a href="../org.tizen.native.appprogramming/html/tutorials/app_tutorial/task_app_settings.htm?resultof=%22%41%70%70%53%65%74%74%69%6e%67%22%20%22%61%70%70%73%65%74%74%69%6e%67%22%20">Task: App Setting</a>.
+ * For supporting the consistency between the setting values of two applications, that is, the target application and the setting application, the setting application notifies the target application through
+ * the IAppSettingEventListener::OnAppSettingChanged() method when setting a value.
+ *
+ * For a detailed example on the %AppSetting class, see <a href="../org.tizen.native.appprogramming/html/tutorials/app_tutorial/task_app_settings.htm?resultof=%22%41%70%70%53%65%74%74%69%6e%67%22%20%22%61%70%70%73%65%74%74%69%6e%67%22%20">Task: App Setting</a>.
*
* @see IAppSettingEventListener
*/
{
public:
/**
- * Gets the application setting instance.
+ * Gets the pointer to the %AppSetting instance.
*
* @since 2.0
*
- * @return A pointer to the %AppSetting instance for the last setting, @n
+ * @return The pointer to the %AppSetting instance for the last setting, @n
* else @c null if it fails
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
static AppSetting* GetInstance(void);
/**
- * Gets the application setting instance of the specified version.
+ * Gets the pointer to the %AppSetting instance of the specified version.
*
* @since 2.0
*
- * @return A pointer to the %AppSetting instance, @n
+ * @return The pointer to the %AppSetting instance, @n
* else @c null if it fails
- * @param[in] settingVersion The version of setting is retrieved from GetAppSettingVersionListN()
+ * @param[in] settingVersion The version of the setting which is retrieved from GetAppSettingVersionListN()
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified version is not found.
+ * @exception E_OBJ_NOT_FOUND The specified version has not been found.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
- * @see GetAppSettingVersionListN()
*/
static AppSetting* GetInstance(const Tizen::Base::String& settingVersion);
/**
- * Gets the application setting instance of the specified AppId.
+ * Gets an %AppSetting instance of the specified ID.
*
* @since 2.0
*
*
* @return A pointer to the %AppSetting instance, @n
* else @c null if it fails
- * @param[in] appId The AppId of the application that has a valid application setting
+ * @param[in] appId The ID of the application that has a valid application setting
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The instance of specified AppId does not have setting information.
+ * @exception E_OBJ_NOT_FOUND The specified @c appId does not have the required setting information.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_APP_NOT_INSTALLED The AppId is not found.
+ * @exception E_APP_NOT_INSTALLED The @c appId has not been found.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @remarks The specific error code can be accessed using the GetLastResult() method.
static AppSetting* GetInstanceByAppId(const AppId& appId);
/**
- * Releases the specified application setting instance.
+ * Releases the specified %AppSetting instance.
*
* @since 2.0
*
* @privilege %http://tizen.org/privilege/appsetting
*
* @return An error code
- * @param[in] appId The AppId of the application that has a valid application setting
+ * @param[in] appId The ID of the application that has a valid application setting
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified instance of AppId is not found or already released.
+ * @exception E_OBJ_NOT_FOUND Either of the following conditions has occurred:
+ * - The specified @c appId has not been found.
+ * - The specified @c appId is already released.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks Individual instances are managed by the platform. @n
- * It is recommended to release instances to reduce memory usage.
+ * @remarks
+ * - Individual instances are managed by the platform.
+ * - It is recommended to release instances to reduce memory usage.
* @see GetInstanceByAppId()
*/
static result ReleaseInstanceByAppId(const AppId& appId);
/**
- * Gets a list of all the versions that existed prior to the current version. @n
- * The versions listed are based on the setting.xml file, which is generated when an application is installed.
+ * Gets the list of all the versions that existed prior to the current version. @n
+ * The versions are listed based on the setting.xml file, which is generated when an application is installed.
*
* @since 2.0
*
- * @return A pointer to the list that contains the Tizen::Base::String instances of version list @n
- * The latest version string is located in the first position. If the old version does not exist then return empty collection.
+ * @return A pointer to the list that contains the Tizen::Base::String instances of the version list @n
+ * The latest version string is located at the first position @n
+ * If the old version does not exist then an empty collection is returned.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
static Tizen::Base::Collection::IList* GetAppSettingVersionListN(void);
/**
- * Gets a @c bool value associated with the specified @c id.
+ * Gets the @c bool value associated with the specified @c id.
*
* @since 2.0
*
* @return An error code
- * @param[in] id The ID of the value to retrieve
- * @param[out] value A boolean value to retrieve
+ * @param[in] id The ID of the boolean value to retrieve
+ * @param[out] value The boolean value to retrieve
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_OBJ_NOT_FOUND The specified @c id is not found in the application setting.
+ * @exception E_OBJ_NOT_FOUND The specified @c id has not been found in the application setting.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_TYPE_MISMATCH The operation has attempted to access different types.
+ * @exception E_TYPE_MISMATCH The types accessed by the method do not match.
*/
result GetValue(const Tizen::Base::String& id, bool& value) const;
/**
- * Gets an integer value associated with the specified @c id.
+ * Gets the integer value associated with the specified @c id.
*
* @since 2.0
*
* @return An error code
- * @param[in] id The ID of the value to retrieve
- * @param[out] value An integer value to retrieve
+ * @param[in] id The ID of the integer value to retrieve
+ * @param[out] value The integer value to retrieve
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_OBJ_NOT_FOUND The specified @c id is not found in the application setting.
+ * @exception E_OBJ_NOT_FOUND The specified @c id has not been found in the application setting.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_TYPE_MISMATCH The operation has attempted to access different types.
+ * @exception E_TYPE_MISMATCH The types accessed by the method do not match.
*/
result GetValue(const Tizen::Base::String& id, int& value) const;
/**
- * Gets a string value associated with the specified @c id.
+ * Gets the string value associated with the specified @c id.
*
* @since 2.0
*
* @return An error code
- * @param[in] id The id of the value to retrieve
- * @param[out] value A string value to retrieve
+ * @param[in] id The ID of the string value to retrieve
+ * @param[out] value The string value to retrieve
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_OBJ_NOT_FOUND The specified @c id is not found in the application setting.
+ * @exception E_OBJ_NOT_FOUND The specified @c id has not been found in the application setting.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_TYPE_MISMATCH The operation has attempted to access different types.
+ * @exception E_TYPE_MISMATCH The types accessed by the method do not match.
*/
result GetValue(const Tizen::Base::String& id, Tizen::Base::String& value) const;
/**
- * Sets a @c bool value associated with the specified @c id.
+ * Sets the @c bool value associated with the specified @c id.
*
* @since 2.0
*
* @return An error code
- * @param[in] id The ID of the value to modify
- * @param[in] value A boolean value
+ * @param[in] id The ID of the boolean value to modify
+ * @param[in] value The boolean value
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_OBJ_NOT_FOUND The specified @c id is not found in the application setting.
+ * @exception E_OBJ_NOT_FOUND The specified @c id has not been found in the application setting.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_TYPE_MISMATCH The operation has attempted to access different types.
+ * @exception E_TYPE_MISMATCH The types accessed by the method do not match.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
result SetValue(const Tizen::Base::String& id, bool value);
/**
- * Sets an integer value associated with the specified @c id.
+ * Sets the integer value associated with the specified @c id.
*
* @since 2.0
*
* @return An error code
- * @param[in] id The ID of the value to modify
- * @param[in] value An integer value
+ * @param[in] id The ID of the integer value to modify
+ * @param[in] value The integer value
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_OBJ_NOT_FOUND The specified @c id is not found in the application setting.
- * @exception E_OUT_OF_RANGE The specified @c value is out of range.
+ * @exception E_OBJ_NOT_FOUND The specified @c id has not been found in the application setting.
+ * @exception E_OUT_OF_RANGE The specified @c value is out of the valid range.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_TYPE_MISMATCH The operation has attempted to access different types.
+ * @exception E_TYPE_MISMATCH The types accessed by the method do not match.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
result SetValue(const Tizen::Base::String& id, int value);
/**
- * Sets a string value associated with the specified @c id.
+ * Sets the string value associated with the specified @c id.
*
* @since 2.0
*
* @return An error code
- * @param[in] id The ID of the value to modify
- * @param[in] value A string value
+ * @param[in] id The ID of the string value to modify
+ * @param[in] value The string value
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_OBJ_NOT_FOUND The specified @c id is not found in the application setting.
- * @exception E_OUT_OF_RANGE The specified string length is out of range.
+ * @exception E_OBJ_NOT_FOUND The specified @c id has not been found in the application setting.
+ * @exception E_OUT_OF_RANGE The specified string length is out of the valid range.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_TYPE_MISMATCH The operation has attempted to access different types.
+ * @exception E_TYPE_MISMATCH The types accessed by the method do not match.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
result SetValue(const Tizen::Base::String& id, const Tizen::Base::String& value);
/**
- * Sets a setting event listener.
+ * Sets the setting event listener.
*
* @since 2.0
*
*
* @final This class is not intended for extension.
*
- * The %DataControlProviderManager class helps a data control provider application to handle data control requests from other applications and to send results or error message for each data control operation.
+ * The %DataControlProviderManager class helps a data control provider application to handle data control requests from other applications, and to send results or error messages for each data control operation.
*/
class _OSP_EXPORT_ DataControlProviderManager
: public Tizen::Base::Object
public:
/**
- * Sets an SQL-friendly interface based data control provider listener to the data control provider manager. @n
- * The listener gets notified when a data control request is received from the other applications.
+ * Sets an SQL-friendly interface based data control provider listener for the data control provider manager. @n
+ * The listener gets notified when a data control request is received from other applications.
* To unset the listener, pass a @c null value to the listener parameter.
*
* @since 2.0
* The listener must implement the ISqlDataControlProviderEventListener interface.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE This instance has not been properly constructed.
- * @exception E_INVALID_OPERATION The listener must be set for a service application.
+ * @exception E_INVALID_OPERATION The listener has not been set for a service application.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks This method must be called in App::OnAppInitializing() for setting the data control provider listener
+ * @remarks This method must be called by the App::OnAppInitializing() method for setting the data control provider listener
* before receiving the data control request.
*/
result SetSqlDataControlProviderEventListener(ISqlDataControlProviderEventListener* pListener);
/**
- * Sets a key-value structured data control provider listener to the data control provider manager. @n
- * The listener gets notified when a data control request is received from the other applications.
+ * Sets a key-value structured data control provider listener for the data control provider manager. @n
+ * The listener gets notified when a data control request is received from other applications.
* To unset the listener, pass a @c null value to the listener parameter.
*
* @since 2.0
* The listener must implement the IMapDataControlProviderEventListener interface.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE This instance has not been properly constructed.
- * @exception E_INVALID_OPERATION The listener must be set for a service application.
+ * @exception E_INVALID_OPERATION The listener has not been set for a service application.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks This method must be called in App::OnAppInitializing() for setting the data control provider listener
+ * @remarks This method must be called by the App::OnAppInitializing() method for setting the data control provider listener
* before receiving the data control request.
*/
result SetMapDataControlProviderEventListener(IMapDataControlProviderEventListener* pListener);
/**
- * Sends the success result and the result set of SELECT request to the application requesting the SQL-friendly interface based
+ * Sends the success result and the result set of the SELECT request to the application requesting for the SQL-friendly interface based
* data control. @n
* The data control provider must call the %SendSqlDataControlSelectResult() method to notify success to the requesting application.
* The application requesting the data control can get the success result and the result set
* @param[in] pDbEnum The Tizen::Io::DbEnumerator instance to obtain the result set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG Either of the following conditions has occurred:
- * - This method cannot send result for the specified @c reqId of INSERT, UPDATE, or DELETE requests.
- * - Tizen::Io::Database or Tizen::Io::DbStatement instance associated with the specified @c pDbEnum is deleted.
- * @exception E_OBJ_NOT_FOUND The data control request specified with the @c reqId does not exist.
- * @exception E_OBJECT_LOCKED The database instance associated to the specified @c pDbEnum is locked.
- * @exception E_INVALID_FORMAT The database file associated to the specified @c pDbEnum is malformed.
+ * - The result for the specified @c reqId of the INSERT, UPDATE, or DELETE request cannot be sent.
+ * - The Tizen::Io::Database or Tizen::Io::DbStatement instance associated with the specified @c pDbEnum is deleted.
+ * @exception E_OBJ_NOT_FOUND The data control request specified by the @c reqId does not exist.
+ * @exception E_OBJECT_LOCKED The database instance associated with the specified @c pDbEnum is locked.
+ * @exception E_INVALID_FORMAT The database file associated with the specified @c pDbEnum is in an invalid format.
* @exception E_IO Either of the following conditions has occurred:
- * - An unexpected device failure has occurred as the media ejected suddenly.
- * - %File corruption is detected.
- * @exception E_MAX_EXCEEDED The size of sending buffer has exceeded the maximum limit.
+ * - An unexpected device failure has occurred as the media ejected suddenly.
+ * - %File corruption has been detected.
+ * @exception E_MAX_EXCEEDED The size of the sending buffer has exceeded the maximum limit.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @see Tizen::App::DataControlProviderManager::SendSqlDataControlInsertResult()
* @see Tizen::App::DataControlProviderManager::SendSqlDataControlUpdateDeleteResult()
* @see Tizen::App::DataControlProviderManager::SendDataControlError()
- * @see Tizen::App::ISqlDataControlProviderEventListener
*/
result SendSqlDataControlSelectResult(RequestId reqId, Tizen::Io::IDbEnumerator* pDbEnum);
/**
- * Sends the success result of INSERT request and the last inserted row ID to the application requesting
+ * Sends the success result of the INSERT request and the last inserted row ID to the application requesting for
* the SQL-friendly interface based data control. @n
* The data control provider must call the %SendSqlDataControlInsertResult() method to notify success to the requesting application.
* The application requesting the data control can get the success result and the last inserted row ID
*
* @return An error code
* @param[in] reqId The request ID
- * @param[in] insertRowId The row ID of database changed by INSERT request
+ * @param[in] insertRowId The row ID of the database changed by the INSERT request
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG This method cannot send result for the specified @c reqId of SELECT, UPDATE, or DELETE request.
- * @exception E_OBJ_NOT_FOUND The data control request specified with the @c reqId does not exist.
+ * @exception E_INVALID_ARG The result for the specified @c reqId of the SELECT, UPDATE, or DELETE request cannot be sent.
+ * @exception E_OBJ_NOT_FOUND The data control request specified by the @c reqId does not exist.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @see Tizen::App::DataControlProviderManager::SendSqlDataControlSelectResult()
* @see Tizen::App::DataControlProviderManager::SendSqlDataControlUpdateDeleteResult()
* @see Tizen::App::DataControlProviderManager::SendDataControlError()
- * @see Tizen::App::ISqlDataControlProviderEventListener
* @see Tizen::Io::Database::GetLastInsertRowId()
*/
result SendSqlDataControlInsertResult(RequestId reqId, long long insertRowId);
/**
- * Sends the success result of UPDATE / DELETE request to the application requesting the SQL-friendly interface based data control. @n
+ * Sends the success result of the UPDATE or DELETE request to the application requesting for the SQL-friendly interface based data control. @n
* The data control provider must call the %SendSqlDataControlUpdateDeleteResult() method to notify success to the requesting application.
* The application requesting the data control can get the success result by implementing Tizen::App::ISqlDataControlResponseListener.
*
* @return An error code
* @param[in] reqId The request ID
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG This method cannot send result for the specified @c reqId of SELECT or INSERT request.
- * @exception E_OBJ_NOT_FOUND The data control request specified with the @c reqId does not exist.
+ * @exception E_INVALID_ARG The result for the specified @c reqId of the SELECT or INSERT request cannot be sent.
+ * @exception E_OBJ_NOT_FOUND The data control request specified by the @c reqId does not exist.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @see Tizen::App::DataControlProviderManager::SendSqlDataControlSelectResult()
* @see Tizen::App::DataControlProviderManager::SendSqlDataControlInsertResult()
result SendSqlDataControlUpdateDeleteResult(RequestId reqId);
/**
- * Sends the success result and the result list of the provider to the application requesting the key-value structured
+ * Sends the success result and the result list of the provider to the application requesting for the key-value structured
* data control. @n
* The data control provider must call the %SendMapDataControlResult() method to notify success to the requesting application.
* The application requesting the data control can get the success result and the result set
* @param[in] reqId The request ID
* @param[in] pResultValueList The result list to request @n
* The type of objects contained in the specified @c pResultValueList must be
- * Tizen::Base::String class.
+ * Tizen::Base::String.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG Either of the following conditions has occurred:
- * - The specified @c pResultValueList must be @c null if the request is one of
- * AddValue, SetValue, RemoveValue queries.
- * - The specified @c pResultValueList must not be @c null if the request is
- * GetValue() query.
- * @exception E_OBJ_NOT_FOUND The data control request specified with the @c reqId does not exist.
- * @exception E_MAX_EXCEEDED The size of sending buffer has exceeded the maximum limit.
+ * - The specified @c pResultValueList must be @c null if the request is an
+ * AddValue(), SetValue(), or RemoveValue() query.
+ * - The specified @c pResultValueList must not be @c null if the request is
+ * a GetValue() query.
+ * @exception E_OBJ_NOT_FOUND The data control request specified by the @c reqId does not exist.
+ * @exception E_MAX_EXCEEDED The size of the sending buffer has exceeded the maximum limit.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @see Tizen::App::DataControlProviderManager::SendDataControlError()
- * @see Tizen::App::IMapDataControlProviderEventListener
*/
result SendMapDataControlResult(RequestId reqId, Tizen::Base::Collection::IList* pResultValueList = null);
/**
- * Sends the provider error message to the application requesting the data control. @n
+ * Sends the provider error message to the application requesting for the data control. @n
* The data control provider must call the %SendDataControlError() method to notify failure to the requesting application.
* The application requesting the data control can get the failure result and the error message
* by implementing Tizen::App::ISqlDataControlResponseListener.
* @param[in] reqId The request ID
* @param[in] errorMsg The provider-defined error message
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The data control request specified with the @c reqId does not exist.
- * @exception E_MAX_EXCEEDED The size of sending buffer has exceeded the maximum limit.
+ * @exception E_OBJ_NOT_FOUND The data control request specified by the @c reqId does not exist.
+ * @exception E_MAX_EXCEEDED The size of the sending buffer has exceeded the maximum limit.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The recommended data size is under 16KB because severe system performance degradation may occur for large messages. @c E_MAX_EXCEEDED may be returned for messages over 16KB size.
+ * @remarks The recommended data size is under 16KB because a severe system performance degradation may occur for larger messages. @n
+ * @c E_MAX_EXCEEDED may be returned for messages over 16KB size.
* @see Tizen::App::DataControlProviderManager::SendSqlDataControlSelectResult()
* @see Tizen::App::DataControlProviderManager::SendSqlDataControlInsertResult()
* @see Tizen::App::DataControlProviderManager::SendSqlDataControlUpdateDeleteResult()
* @see Tizen::App::DataControlProviderManager::SendMapDataControlResult()
- * @see Tizen::App::ISqlDataControlProviderEventListener
* @see Tizen::App::IMapDataControlProviderEventListener
*/
result SendDataControlError(RequestId reqId, const Tizen::Base::String& errorMsg);
/**
- * Gets the data control provider manager instance.
+ * Gets a pointer to the %DataControlProviderManager instance.
*
* @since 2.0
*
- * @return A pointer to the %DataControlProviderManager instance if it succeeds, @n
- * else @c null
+ * @return A pointer to the %DataControlProviderManager instance, @n
+ * else @c null if it fails
*/
static DataControlProviderManager* GetInstance(void);
/**
* @interface IActiveAppEventListener
- * @brief This interface is the listener interface for receiving the AppId of active application.
+ * @brief This interface is the listener interface for receiving the ID of an active application.
*
* @since 2.0
*
- *
* The %IActiveAppEventListener interface is the listener interface for receiving the active application change events.
- * The class that processes an active application change event implements this interface and registers using
+ * The class that processes an active application change event implements this interface and registers it using
* the AppManager::AddActiveAppEventListener() method.
*
*/
{
public:
/**
- * This polymorphic destructor should be overridden if required. This way,
- * the destructors of the derived classes are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*
*
* @since 2.0
*
- * @param[in] appId The AppId of the active application
+ * @param[in] appId The ID of the active application
*/
virtual void OnActiveAppChanged(const AppId& appId) = 0;
//
/**
- * @file FAppIAppCheckPointEventListener.h
- * @brief This is the header file for the %IAppCheckpointEventListener interface.
+ * @file FAppIAppCheckPointEventListener.h
+ * @brief This is the header file for the %IAppCheckpointEventListener interface.
*
* This header file contains the declarations of the %IAppCheckpointEventListener interface. @n
* If a checkpoint event is generated, a method of this interface is called.
/**
* @interface IAppCheckpointEventListener
- * @brief This interface defines the listener for the checkpoint event.
+ * @brief This interface defines the listener for a checkpoint event.
*
* @since 2.0
*
- * The %IAppCheckpointEventListener interface is used for receiving the checkpoint event.
- * The event is fired when the system is about to terminate an application due to, for example, low memory or when another application
- * is being launched.
+ * The %IAppCheckpointEventListener interface is used for receiving a checkpoint event.
+ * The event is fired when the system is about to terminate an application due to reasons such as, low memory or when another application
+ * is being launched.
* @n
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/tizen_app_model/multitasking_in_tizen.htm">Multitasking in Tizen</a>.
*
{
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
* Called when a checkpoint event occurs.
*
* @since 2.0
- * @param[in] appRegistry The application registry
+ * @param[in] appRegistry The application's registry
*/
virtual void OnAppCheckpointing(AppRegistry& appRegistry) = 0;
//
/**
- * @file FAppIAppControlEventListener.h
- * @brief This is the header file for the %IAppControlEventListener interface.
+ * @if OSPDEPREC
+ * @file FAppIAppControlEventListener.h
+ * @brief This is the header file for the %IAppControlEventListener interface.
*
* This header file contains the declarations of the %IAppControlEventListener interface.
+ * @endif
*/
#ifndef _FAPP_IAPP_CONTROL_EVENT_LISTENER_H_
/**
* @if OSPDEPREC
* @interface IAppControlEventListener
-* @brief <i>[Deprecated]</i> This interface defines a listener for the AppControl result events.
+* @brief <i>[Deprecated]</i> This interface defines a listener for the %AppControl result events.
*
* @deprecated This interface is deprecated. Instead of using this interface, use the IAppControlResponseListener interface.
* @since 2.0
public:
/**
* @if OSPDEPREC
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @brief <i> [Deprecated] </i>
/**
* @if OSPDEPREC
* Called when the application control is completed. @n
- * The client can get callback result for some application controls by implementing this listener. @n
- * %OnAppControlCompleted() is called after AppControl::Start() with listener for some application controls.
+ * The client can get the callback result for some application controls by implementing this listener. @n
+ * The %OnAppControlCompleted() method is called after AppControl::Start() is done listening to application controls.
*
* @brief <i> [Deprecated] </i>
*
* @deprecated This interface is deprecated. Instead of using this interface, use the IAppControlResponseListener interface.
* @since 2.0
*
- * @param[in] providerId The provider ID
- * @param[in] operationId The operation ID used in application control invocation
- * @param[in] pResultList The list of callback strings of application control
+ * @param[in] providerId The provider ID
+ * @param[in] operationId The operation ID used for application control invocation
+ * @param[in] pResultList The list of callback strings for application control
*
- * @remarks The specified @c pResultList provides the result code for the first array element.
- * @remarks When the invoked application control is terminated without sending a result,
- * then this method is invoked with @c pResultList and it contains App::APPCONTROL_RESULT_TERMINATED.
- * @remarks Switching forms using Tizen::Ui::Controls::Frame::SetCurrentForm() in this listener disables the upcoming form
- * (UiApp::OnForeground()). If %UiApp::OnForeground() is being used in the application logic,
- * it is recommended to avoid switching forms in this listener.
+ * @remarks
+ * - The specified @c pResultList provides the result code for the first array element.
+ * - When the invoked application control is terminated without sending a result,
+ * then this method is invoked with @c pResultList and it contains App::APPCONTROL_RESULT_TERMINATED.
+ * - Switching forms using Tizen::Ui::Controls::Frame::SetCurrentForm() in this listener disables the upcoming form
+ * (UiApp::OnForeground()). @n If the %UiApp::OnForeground() method is being used in the application logic, it is recommended to avoid switching forms in this listener.
* @see Tizen::App::AppControl
* @endif
*/
//
/**
- * @file FAppIAppControlListener.h
- * @brief This is the header file for the %IAppControlListener interface.
+ * @if OSPDEPREC
+ * @file FAppIAppControlListener.h
+ * @brief This is the header file for the %IAppControlListener interface.
*
* This header file contains the declarations of the %IAppControlListener interface.
+ * @endif
*/
#ifndef _FAPP_IAPP_CONTROL_LISTENER_H_
/**
* @if OSPDEPREC
* @interface IAppControlListener
- * @brief <i>[Deprecated]</i> This interface defines a listener for the AppControl start and result events.
+ * @brief <i>[Deprecated]</i> This interface defines a listener for the %AppControl start and result events.
*
* @deprecated This interface is deprecated. Instead of using this interface, use the IAppControlResponseListener interface.
* @since 2.0
public:
/**
* @if OSPDEPREC
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @brief <i>[Deprecated]</i>
{
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*
* @since 2.0
*
- * @param[in] reqId The application control request ID
+ * @param[in] reqId The application control request ID
* @param[in] operationId The application control operation ID
* @param[in] pUriData A pointer to the URI data
* @param[in] pMimeType A pointer to the MIME type (RFC 2046) data
- * @param[in] pExtraData A pointer to an argument map of key and value pair where the key is of type Tizen::Base::String and the value is of type %Tizen::Base::String or of type Tizen::Base::Collection::ArrayList of %Tizen::Base::String
- * @remarks To reply to the application control request, use AppControlProviderManager::SendAppControlResult() with the given request ID.
- * @remarks When the application receives the AppControl request on the background,
- * %OnAppControlRequestReceived() is invoked before UiApp::OnForeground().
- * @remarks When the application control is resolved with the file extension with AppControl::FindAndStart(),
- * the delivered file extension is converted to the corresponding MIME type in the @c pMimeType parameter.
+ * @param[in] pExtraData A pointer to the argument map of the key and value pair, where the key is of type Tizen::Base::String and the value is of type %Tizen::Base::String or of type Tizen::Base::Collection::ArrayList of %Tizen::Base::String
+ * @remarks
+ * - To reply to the application control request, use the AppControlProviderManager::SendAppControlResult() method with the given request ID. @n
+ * When the application receives the AppControl request in the background,
+ * the %OnAppControlRequestReceived() method is invoked before the UiApp::OnForeground() method.
+ * - When the application control is resolved with the file extension returned by the AppControl::FindAndStart() method,
+ * the delivered file extension is converted to the corresponding MIME type in the @c pMimeType parameter.
*/
virtual void OnAppControlRequestReceived(RequestId reqId, const Tizen::Base::String& operationId, const Tizen::Base::String* pUriData, const Tizen::Base::String* pMimeType, const Tizen::Base::Collection::IMap* pExtraData) = 0;
//
/**
- * @file FAppIAppControlResponseListener.h
- * @brief This is the header file for the %IAppControlResponseListener interface.
+ * @file FAppIAppControlResponseListener.h
+ * @brief This is the header file for the %IAppControlResponseListener interface.
*
* This header file contains the declarations of the %IAppControlResponseListener interface.
*/
{
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
virtual ~IAppControlResponseListener(void) {}
/**
- * Called when the response for application control completion is received.
+ * Called when the response for an application control completion is received.
*
* @since 2.0
*
- * @param[in] appId The ID of the requested application
- * @param[in] operationId The operation ID used in application control invocation
+ * @param[in] appId The ID of the requested application
+ * @param[in] operationId The operation ID used in the application control invocation
* @param[in] appControlResult The application control result
- * @param[in] pExtraData A pointer to an result map of key and value pair where the key of type Tizen::Base::String and the value of
- * type %Tizen::Base::String or of type Tizen::Base::ArrayList of %Tizen::Base::String
+ * @param[in] pExtraData A pointer to the result map of the key and value pair, where the key is of type Tizen::Base::String and the value is of
+ * type %Tizen::Base::String or of type Tizen::Base::Collection::ArrayList of %Tizen::Base::String
* @remarks The application control completion result is received when the requested application control
- * sends the result using AppControlProviderManager::SendAppControlResult().
+ * sends the result using the AppControlProviderManager::SendAppControlResult() method.
* @see AppControl
*/
virtual void OnAppControlCompleteResponseReceived(const AppId& appId, const Tizen::Base::String& operationId, AppCtrlResult appControlResult, const Tizen::Base::Collection::IMap* pExtraData) = 0;
/**
- * Called when the application control is about to start or to be canceled by the user resolution. @n
+ * Called when the application control is about to start or is to be cancelled by the user resolution. @n
* The calling application can get the result of the resolution by implementing this empty body method.
*
* @since 2.0
*
- * @param[in] appId The ID of the requested application
- * @param[in] operationId The operation ID used in application control invocation
- * @param[in] r The result of the application control start response @n
- * The exception code may be given through this parameter.
- * @exception E_SUCCESS The method is successful.
- * @exception E_OPERATION_CANCELED The application control resolve request is canceled by a user operation.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM A system error has occurred.
+ * @param[in] appId The ID of the requested application
+ * @param[in] operationId The operation ID used in the application control invocation
+ * @param[in] r The result of the application control start response @n
+ * The following exceptions may be given through this parameter.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OPERATION_CANCELED The application control resolve request has been cancelled by the user operation.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_SYSTEM A system error has occurred.
* @remarks This method is invoked only for the implicit AppControl resolution.
- * @see AppControl
* @see AppControl::FindAndStart()
*/
virtual void OnAppControlStartResponseReceived(const AppId& appId, const Tizen::Base::String& operationId, result r) {}
//
/**
- * @file FAppIAppFrame.h
- * @brief This is the header file for the %IAppFrame interface.
+ * @file FAppIAppFrame.h
+ * @brief This is the header file for the %IAppFrame interface.
*
* This header file contains the declarations of the %IAppFrame interface.
*/
*
* @since 2.0
*
- * The %IAppFrame interface provides methods for the application frame. A frame is the outermost boundary of the application UI.
+ * The %IAppFrame interface provides methods for the application frame.
+ * A frame is the outermost boundary of the application UI.
*/
class IAppFrame
{
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*
* @since 2.0
*
- * @return A pointer to the Tizen::Graphics::Canvas class
+ * @return A pointer to the Tizen::Graphics::Canvas instance
*/
virtual Tizen::Graphics::Canvas* GetCanvasN(void) const = 0;
*
* @since 2.0
*
- * @return An error code
- * @param[in] listener A Tizen::Ui::IKeyEventListener instance to add
+ * @return An error code
+ * @param[in] listener An instance of Tizen::Ui::IKeyEventListener to add
* @exception E_SUCCESS The method is successful.
*/
virtual result AddKeyEventListener(Tizen::Ui::IKeyEventListener& listener) = 0;
*
* @since 2.0
*
- * @return An error code
- * @param[in] listener A Tizen::Ui::IKeyEventListener instance to remove
+ * @return An error code
+ * @param[in] listener An instance of Tizen::Ui::IKeyEventListener to remove
* @exception E_SUCCESS The method is successful.
*/
virtual result RemoveKeyEventListener(Tizen::Ui::IKeyEventListener& listener) = 0;
*
* @since 2.0
*
- * @return An error code
- * @param[in] listener A Tizen::Ui::ITouchEventListener instance to add
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] listener An instance of Tizen::Ui::ITouchEventListener to add
+ * @exception E_SUCCESS The method is successful.
*/
virtual result AddTouchEventListener(Tizen::Ui::ITouchEventListener& listener) = 0;
*
* @since 2.0
*
- * @return An error code
- * @param[in] listener A Tizen::Ui::ITouchEventListener instance to add
+ * @return An error code
+ * @param[in] listener An instance of Tizen::Ui::ITouchEventListener to add
* @exception E_SUCCESS The method is successful.
*/
virtual result RemoveTouchEventListener(Tizen::Ui::ITouchEventListener& listener) = 0;
*
* @since 2.0
*
- * @return An error code
- * @param[in] listener A Tizen::Ui::IWindowEventListener instance to remove
+ * @return An error code
+ * @param[in] listener An instance of Tizen::Ui::IWindowEventListener to remove
* @exception E_SUCCESS The method is successful.
*/
virtual result AddWindowEventListener(Tizen::Ui::IWindowEventListener& listener) = 0;
*
* @since 2.0
*
- * @return An error code
- * @param[in] listener A Tizen::Ui::IWindowEventListener instance to remove
+ * @return An error code
+ * @param[in] listener An instance of Tizen::Ui::IWindowEventListener to remove
* @exception E_SUCCESS The method is successful.
*/
virtual result RemoveWindowEventListener(Tizen::Ui::IWindowEventListener& listener) = 0;
*
* @since 2.0
*
- * @return A pointer to Tizen::Ui::Controls::Frame if successful, @n
- * else @c null
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance is in an invalid state.
- * @exception E_UNSUPPORTED_OPERATION This method cannot be supported.
+ * @return A pointer to the Tizen::Ui::Controls::Frame instance, @n
+ * else @c null if it fails
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE This instance is in an invalid state.
+ * @exception E_UNSUPPORTED_OPERATION This method is not supported.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Ui::Controls::Frame* GetFrame(void) = 0;
//
/**
- * @file FAppIAppLaunchConditionEventListener.h
- * @brief This is the header file for the %IAppLaunchConditionEventListener interface.
+ * @file FAppIAppLaunchConditionEventListener.h
+ * @brief This is the header file for the %IAppLaunchConditionEventListener interface.
*
* This header file contains the declarations of the %IAppLaunchConditionEventListener interface.
*/
{
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
* @since 2.0
*
* @param[in] condition The registered condition for the application launch
- * @param[in] pArguments A list of string arguments specified when the condition is registered
- * @param[in] pExtraData A pointer to the instance of object that system delivered, @n
+ * @param[in] pArguments The list of string arguments specified when the condition is registered
+ * @param[in] pExtraData A pointer to the Tizen::Base::Object instance that the system delivered, @n
* else @c null if there is no extra data
*
- * @remarks If extra data is required to be delivered, @c pExtraData contains the data,
+ * @remarks If the extra data has to be delivered, @c pExtraData contains the data,
* and this must be freed by the launched application after use.
- * ( Currently, only NFC condition uses this to deliver to Tizen::Net::Nfc::NdefMessage. )
+ * ( Currently, only the NFC condition uses this to deliver to Tizen::Net::Nfc::NdefMessage. )
* @see Tizen::App::AppManager::RegisterAppLaunch()
* @see Tizen::App::AppManager::SetAppLaunchConditionEventListener()
*
- * The following example demonstrates how to use the %OnAppLaunchConditionMetN() method to get Tizen::Net::Nfc::NdefMessage instance, when an application is launched by NFC condition.
+ * The following example demonstrates how to use the %OnAppLaunchConditionMetN() method to get the Tizen::Net::Nfc::NdefMessage instance, when an application is launched by the NFC condition.
* @code
* NdefMessage* pMessage = dynamic_cast<NdefMessage*>(pExtraData);
* @endcode
/**
* @interface IAppSettingEventListener
- * @brief This interface is the listener interface for receiving the setting change events.
+ * @brief This interface is the listener interface for receiving setting change events.
*
* @since 2.0
*
- * The %IAppSettingEventListener interface is the listener interface for receiving the setting change events.
- * The class that processes a setting change event implements this interface and registers using
+ * The %IAppSettingEventListener interface is the listener interface for receiving setting change events.
+ * The class that processes a setting change event implements this interface and registers it using
* the AppSetting::SetAppSettingEventListener() method.
*
*/
{
public:
/**
- * This polymorphic destructor should be overridden if required. This way,
- * the destructors of the derived classes are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*
- * @remarks This method is invoked only in the main thread
+ * @remarks This method is invoked only in the main thread.
*/
virtual ~IAppSettingEventListener(void) {}
*
* @param[in] id The ID of the application setting whose value is changed
*
- * @remarks This method is invoked only in the main thread
+ * @remarks This method is invoked only in the main thread.
*/
virtual void OnAppSettingChanged(const Tizen::Base::String& id) = 0;
/**
* @interface IMapDataControlProviderEventListener
- * @brief This interface defines a listener for dealing with key-value structured data control request.
+ * @brief This interface defines a listener for dealing with a key-value structured data control request.
*
* @since 2.0
*
- * The %IMapDataControlProviderEventListener interface defines a listener for dealing with key-value structured data control request.
+ * The %IMapDataControlProviderEventListener interface defines a listener for dealing with a key-value structured data control request.
*
* The following example demonstrates how to use the %IMapDataControlProviderEventListener interface.
* @code
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
virtual ~IMapDataControlProviderEventListener(void) {}
/**
- * Called when the request for getting the value list is received from key-value structured data control consumer. @n
+ * Called when the request for obtaining the value list is received from the key-value structured data control consumer. @n
* The provider must implement this listener for providing its own data.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific map to get from @n
+ * @param[in] dataId The string that identifies the specific map to obtain from @n
* The string consists of one or more components, separated by a slash('/').
- * @param[in] key A key of the value list to obtain
- * @remarks For replying to the data control request, use DataControlProviderManager::SendMapDataControlResult()
- * or DataControlProviderManager::SendDataControlError().
+ * @param[in] key The key of the value list to obtain
+ * @remarks For replying to the data control request, use the DataControlProviderManager::SendMapDataControlResult() method
+ * or the DataControlProviderManager::SendDataControlError() method.
*/
virtual void OnMapDataControlGetValueRequestReceived(RequestId reqId, const Tizen::Base::String& providerId,
const Tizen::Base::String& dataId, const Tizen::Base::String& key) = 0;
/**
- * Called when the request for adding the value is received from key-value structured data control consumer. @n
+ * Called when the request for adding the value is received from the key-value structured data control consumer. @n
* The provider must implement this listener for providing its own data.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific map to add to @n
+ * @param[in] dataId The string that identifies the specific map to add to @n
* The string consists of one or more components, separated by a slash('/').
- * @param[in] key A key of the value list to add
- * @param[in] value A value to add
- * @remarks For replying to the data control request, use DataControlProviderManager::SendMapDataControlResult()
- * or DataControlProviderManager::SendDataControlError().
+ * @param[in] key The key of the value list to add
+ * @param[in] value The value to add
+ * @remarks For replying to the data control request, use the DataControlProviderManager::SendMapDataControlResult() method
+ * or the DataControlProviderManager::SendDataControlError() method.
*/
virtual void OnMapDataControlAddValueRequestReceived(RequestId reqId, const Tizen::Base::String& providerId,
const Tizen::Base::String& dataId, const Tizen::Base::String& key, const Tizen::Base::String& value) = 0;
/**
- * Called when the request for replacing the value is received from key-value structured data control consumer. @n
+ * Called when the request for replacing the value is received from the key-value structured data control consumer. @n
* The provider must implement this listener for providing its own data.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific map to update @n
+ * @param[in] dataId The string that identifies the specific map to update @n
* The string consists of one or more components, separated by a slash('/').
- * @param[in] key A key of the value to replace
- * @param[in] oldValue A value to replace
- * @param[in] newValue A new value to replace the existing value
- * @remarks For replying to the data control request, use DataControlProviderManager::SendMapDataControlResult()
- * or DataControlProviderManager::SendDataControlError().
+ * @param[in] key The key of the value to replace
+ * @param[in] oldValue The value to replace
+ * @param[in] newValue The new value that replaces the existing value
+ * @remarks For replying to the data control request, use the DataControlProviderManager::SendMapDataControlResult() method
+ * or the DataControlProviderManager::SendDataControlError() method.
*/
virtual void OnMapDataControlSetValueRequestReceived(RequestId reqId, const Tizen::Base::String& providerId,
const Tizen::Base::String& dataId, const Tizen::Base::String& key, const Tizen::Base::String& oldValue,
const Tizen::Base::String& newValue) = 0;
/**
- * Called when the request for removing the value is received from key-value structured data control consumer. @n
+ * Called when the request for removing the value is received from the key-value structured data control consumer. @n
* The provider must implement this listener for providing its own data.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific map to remove from @n
+ * @param[in] dataId The string that identifies the specific map to remove from @n
* The string consists of one or more components, separated by a slash('/').
- * @param[in] key A key of the value to remove
- * @param[in] value A value to remove
- * @remarks For replying to the data control request, use DataControlProviderManager::SendMapDataControlResult()
- * or DataControlProviderManager::SendDataControlError().
+ * @param[in] key The key of the value to remove
+ * @param[in] value The value to remove
+ * @remarks For replying to the data control request, use the DataControlProviderManager::SendMapDataControlResult() method
+ * or the DataControlProviderManager::SendDataControlError() method.
*/
virtual void OnMapDataControlRemoveValueRequestReceived(RequestId reqId, const Tizen::Base::String& providerId,
const Tizen::Base::String& dataId, const Tizen::Base::String& key, const Tizen::Base::String& value) = 0;
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
virtual ~IMapDataControlResponseListener(void) {}
/**
- * Called when the result value list is received from key-value structured data control provider. @n
+ * Called when the result value list is received from the key-value structured data control provider. @n
* The application requesting the data control can get the result value list by implementing this listener. @n
- * This listener must be registered by MapDataControl::SetMapDataControlResponseListener() for receiving the result value set.
- * It is called after MapDataControl::GetValue().
+ * This listener must be registered by the MapDataControl::SetMapDataControlResponseListener() method for receiving the result value set.
+ * It is called after the MapDataControl::GetValue() method.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific map to get from @n
+ * @param[in] dataId The string that identifies the specific map to obtain from @n
* The string consists of one or more components, separated by a slash('/').
- * @param[in] resultValueList The result value list of data control request getting matching values @n
- * The type of objects contained in the specified @c resultValueList is
- * Tizen::Base::String class.
+ * @param[in] resultValueList The result value list of the data control request that gets the matching values @n
+ * The type of objects contained in the specified @c resultValueList are
+ * Tizen::Base::String.
* @param[in] providerResult Set to @c true if the data control provider successfully processed the request getting the values, @n
* else @c false
* @param[in] pErrorMsg The error message from the data control provider
bool providerResult, const Tizen::Base::String* pErrorMsg) = 0;
/**
- * Called when the response is received from key-value structured data control provider. @n
+ * Called when the response is received from the key-value structured data control provider. @n
* The application requesting the data control can get the result by implementing this listener. @n
- * This listener must be registered by MapDataControl::SetMapDataControlResponseListener() for receiving the result response.
- * It is called after MapDataControl::AddValue().
+ * This listener must be registered by the MapDataControl::SetMapDataControlResponseListener() method for receiving the result response.
+ * It is called after the MapDataControl::AddValue() method.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific map to add to @n
+ * @param[in] dataId The string that identifies the specific map to add to @n
* The string consists of one or more components, separated by a slash('/').
* @param[in] providerResult Set to @c true if the data control provider successfully processed the request adding a value, @n
* else @c false
const Tizen::Base::String& dataId, bool providerResult, const Tizen::Base::String* pErrorMsg) = 0;
/**
- * Called when the response is received from key-value structured data control provider. @n
- * The application requesting the data control can get the result for some data controls by implementing this listener. @n
- * This listener must be registered by MapDataControl::SetMapDataControlResponseListener() for receiving the result response.
- * It is called after MapDataControl::SetValue().
+ * Called when the response is received from the key-value structured data control provider. @n
+ * The application requesting the data control can get the result by implementing this listener. @n
+ * This listener must be registered by the MapDataControl::SetMapDataControlResponseListener() method for receiving the result response.
+ * It is called after the MapDataControl::SetValue() method.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific map to update @n
+ * @param[in] dataId The string that identifies the specific map to update @n
* The string consists of one or more components, separated by a slash('/').
* @param[in] providerResult Set to @c true if the data control provider successfully processed the request replacing a value, @n
* else @c false
const Tizen::Base::String& dataId, bool providerResult, const Tizen::Base::String* pErrorMsg) = 0;
/**
- * Called when the response is received from key-value structured data control provider. @n
- * The application requesting the data control can get the result for some data controls by implementing this listener. @n
- * This listener must be registered by MapDataControl::SetMapDataControlResponseListener() for receiving the result response.
- * It is called after MapDataControl::RemoveValue().
+ * Called when the response is received from the key-value structured data control provider. @n
+ * The application requesting the data control can get the result by implementing this listener. @n
+ * This listener must be registered by the MapDataControl::SetMapDataControlResponseListener() method for receiving the result response.
+ * It is called after the MapDataControl::RemoveValue() method.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific map to remove from @n
+ * @param[in] dataId The string that identifies the specific map to remove from @n
* The string consists of one or more components, separated by a slash('/').
* @param[in] providerResult Set to @c true if the data control provider successfully processed the request removing a value, @n
* else @c false
/**
* @interface ISqlDataControlProviderEventListener
- * @brief This interface defines a listener for dealing with SQL-friendly interface based data control request.
+ * @brief This interface defines a listener for dealing with an SQL-friendly interface based data control request.
*
* @since 2.0
*
- * The %ISqlDataControlProviderEventListener interface defines a listener for dealing with SQL-friendly interface based data control request.
+ * The %ISqlDataControlProviderEventListener interface defines a listener for dealing with an SQL-friendly interface based data control request.
*
* The following example demonstrates how to use the %ISqlDataControlProviderEventListener interface.
*
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
virtual ~ISqlDataControlProviderEventListener(void) {}
/**
- * Called when a select request is received from an application using SQL-friendly interface based data control. @n
+ * Called when the select request is received from an application using an SQL-friendly interface based data control. @n
* The provider must implement this listener for providing its own data.
*
* @since 2.0
*
* @param[in] reqId The request ID
- * @param[in] providerId The provider ID for identifying the data control
- * @param[in] dataId A string for identifying a specific table to query from @n
- * The string consists of one or more components, separated by a slash('/').
- * If the specified @c pColumnList is @c null, all columns are selected.
- * @param[in] pColumnList A list of column names to query @n
- * The type of objects contained in the specified @c pColumnList is
- * Tizen::Base::String class.
- * @param[in] pWhere A filter to select desired rows to query @n
+ * @param[in] providerId The provider ID that identifies the data control
+ * @param[in] dataId The string that identifies the specific table to query from @n
+ * The string consists of one or more components, separated by a slash('/') @n
+ * If the specified @c pColumnList is @c null, all the columns are selected.
+ * @param[in] pColumnList The list of column names to query @n
+ * The type of objects contained in the specified @c pColumnList are
+ * Tizen::Base::String.
+ * @param[in] pWhere The filter that selects the desired rows to query @n
* It is an SQL 'WHERE' clause excluding the 'WHERE' itself such as
* column1 = 'stringValue' AND column2 = numericValue.
- * @param[in] pOrder The sorting order of rows to query @n
+ * @param[in] pOrder The sorting order of the rows to query @n
* It is an SQL 'ORDER BY' clause excluding the 'ORDER BY' itself.
- * @remarks For replying to the data control request, use DataControlProviderManager::SendSqlDataControlSelectResult()
- * or DataControlProviderManager::SendDataControlError().
+ * @remarks For replying to the data control request, use the DataControlProviderManager::SendSqlDataControlSelectResult() method
+ * or the DataControlProviderManager::SendDataControlError() method.
*/
virtual void OnSqlDataControlSelectRequestReceived(RequestId reqId, const Tizen::Base::String& providerId,
const Tizen::Base::String& dataId, const Tizen::Base::Collection::IList* pColumnList,
const Tizen::Base::String* pWhere, const Tizen::Base::String* pOrder) = 0;
/**
- * Called when an insert request is received from an application using SQL-friendly interface based data control. @n
+ * Called when the insert request is received from an application using an SQL-friendly interface based data control. @n
* The provider must implement this listener for providing its own data.
*
* @since 2.0
*
* @param[in] reqId The request ID
- * @param[in] providerId The provider ID for identifying the data control
- * @param[in] dataId A string for identifying a specific table to insert into @n
+ * @param[in] providerId The provider ID that identifies the data control
+ * @param[in] dataId The string that identifies the specific table to insert into @n
* The string consists of one or more components, separated by a slash('/').
- * @param[in] insertMap The field values in a record to insert @n
- * The type of objects contained in the specified @c insertMap is
- * Tizen::Base::String class.
- * @remarks For replying to the data control request, use DataControlProviderManager::SendSqlDataControlInsertResult()
- * or DataControlProviderManager::SendDataControlError().
+ * @param[in] insertMap The field values to insert in the record @n
+ * The type of objects contained in the specified @c insertMap are
+ * Tizen::Base::String.
+ * @remarks For replying to the data control request, use the DataControlProviderManager::SendSqlDataControlInsertResult() method
+ * or the DataControlProviderManager::SendDataControlError() method.
*/
virtual void OnSqlDataControlInsertRequestReceived(RequestId reqId, const Tizen::Base::String& providerId,
const Tizen::Base::String& dataId, const Tizen::Base::Collection::IMap& insertMap) = 0;
/**
- * Called when an update request is received from an application using SQL-friendly interface based data control. @n
+ * Called when the update request is received from an application using an SQL-friendly interface based data control. @n
* The provider must implement this listener for providing its own data.
*
* @since 2.0
*
* @param[in] reqId The request ID
- * @param[in] providerId The provider ID for identifying the data control
- * @param[in] dataId A string for identifying a specific table to update @n
+ * @param[in] providerId The provider ID that identifies the data control
+ * @param[in] dataId The string that identifies the specific table to update @n
* The string consists of one or more components, separated by a slash('/').
- * @param[in] updateMap The field values in a record to update @n
- * The type of objects contained in the specified @c updateMap is
- * Tizen::Base::String class.
- * @param[in] pWhere A filter to select desired rows to update @n
+ * @param[in] updateMap The field values to update in the record @n
+ * The type of objects contained in the specified @c updateMap are
+ * Tizen::Base::String.
+ * @param[in] pWhere The filter to select the desired rows to update @n
* It is an SQL 'WHERE' clause excluding the 'WHERE' itself such as
* column1 = 'stringValue' AND column2 = numericValue.
- * @remarks For replying to the data control request, use DataControlProviderManager::SendSqlDataControlUpdateDeleteResult()
- * or DataControlProviderManager::SendDataControlError().
+ * @remarks For replying to the data control request, use the DataControlProviderManager::SendSqlDataControlUpdateDeleteResult() method
+ * or the DataControlProviderManager::SendDataControlError() method.
*/
virtual void OnSqlDataControlUpdateRequestReceived(RequestId reqId, const Tizen::Base::String& providerId,
const Tizen::Base::String& dataId, const Tizen::Base::Collection::IMap& updateMap,
const Tizen::Base::String* pWhere) = 0;
/**
- * Called when a delete request is received from an application using SQL-friendly interface based data control. @n
+ * Called when the delete request is received from an application using an SQL-friendly interface based data control. @n
* The provider must implement this listener for providing its own data.
*
* @since 2.0
*
* @param[in] reqId The request ID
- * @param[in] providerId The provider ID for identifying the data control
- * @param[in] dataId A string for identifying a specific table to delete from @n
+ * @param[in] providerId The provider ID that identifies the data control
+ * @param[in] dataId The string that identifies the specific table to delete from @n
* The string consists of one or more components, separated by a slash('/').
- * @param[in] pWhere A filter to select desired rows to delete @n
+ * @param[in] pWhere The filter to select the desired rows to delete @n
* It is an SQL 'WHERE' clause excluding the 'WHERE' itself such as
* column1 = 'stringValue' AND column2 = numericValue.
- * @remarks For replying to the data control request, use DataControlProviderManager::SendSqlDataControlUpdateDeleteResult()
- * or DataControlProviderManager::SendDataControlError().
+ * @remarks For replying to the data control request, use the DataControlProviderManager::SendSqlDataControlUpdateDeleteResult() method
+ * or the DataControlProviderManager::SendDataControlError() method.
*/
virtual void OnSqlDataControlDeleteRequestReceived(RequestId reqId, const Tizen::Base::String& providerId,
const Tizen::Base::String& dataId, const Tizen::Base::String* pWhere) = 0;
/**
* @interface ISqlDataControlResponseListener
-* @brief This interface defines a listener for the SQL-friendly interface based data control response.
+* @brief This interface defines a listener for an SQL-friendly interface based data control response.
*
* @since 2.0
*
-* The %ISqlDataControlResponseListener interface defines a listener for the SQL-friendly interface based data control response.
+* The %ISqlDataControlResponseListener interface defines a listener for an SQL-friendly interface based data control response.
*/
class _OSP_EXPORT_ ISqlDataControlResponseListener
: virtual public Tizen::Base::Runtime::IEventListener
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
virtual ~ISqlDataControlResponseListener(void) {}
/**
- * Called when the result set is received from SQL-friendly interface based data control provider. @n
+ * Called when the result set is received from an SQL-friendly interface based data control provider. @n
* The application requesting the data control can get the query result by implementing this listener. @n
- * This listener must be registered by SqlDataControl::SetSqlDataControlResponseListener() for receiving the result set.
- * It is called after SqlDataControl::Select().
+ * This listener must be registered by the SqlDataControl::SetSqlDataControlResponseListener() method for receiving the result set.
+ * It is called after the SqlDataControl::Select() method.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific table to query from @n
+ * @param[in] dataId The string that identifies the specific table to query from @n
* The string consists of one or more components, separated by a slash('/').
- * @param[in] resultSetEnumerator Navigates the result of data control select request
+ * @param[in] resultSetEnumerator Navigates the result of the data control select request
* @param[in] providerResult Set to @c true if the data control provider successfully processed the query request, @n
* else @c false
* @param[in] pErrorMsg The error message from the data control provider
const Tizen::Base::String& dataId, Tizen::Io::IDbEnumerator& resultSetEnumerator, bool providerResult, const Tizen::Base::String* pErrorMsg) = 0;
/**
- * Called when the response is received from SQL-friendly interface based data control provider. @n
- * The application requesting the data control can get insert result by implementing this listener. @n
- * This listener must be registered by SqlDataControl::SetSqlDataControlResponseListener() for receiving the result response.
- * It is called after SqlDataControl::Insert().
+ * Called when the response is received from an SQL-friendly interface based data control provider. @n
+ * The application requesting the data control can get the insert result by implementing this listener. @n
+ * This listener must be registered by the SqlDataControl::SetSqlDataControlResponseListener() method for receiving the result response.
+ * It is called after the SqlDataControl::Insert() method.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific table to insert into @n
+ * @param[in] dataId The string that identifies the specific table to insert into @n
* The string consists of one or more components, separated by a slash('/').
* @param[in] insertRowId The inserted row ID set by the data control provider if the specified @c providerResult is @c true, @n
- * else @c -1
+ * else @c -1 if it fails
* @param[in] providerResult Set to @c true if the data control provider successfully processed the insert request, @n
* else @c false
* @param[in] pErrorMsg The error message from the data control provider
const Tizen::Base::String& dataId, long long insertRowId, bool providerResult, const Tizen::Base::String* pErrorMsg) = 0;
/**
- * Called when the response is received from SQL-friendly interface based data control provider. @n
- * The application requesting the data control can get update result implementing this listener. @n
- * This listener must be registered by SqlDataControl::SetSqlDataControlResponseListener() for receiving the result response.
- * It is called after SqlDataControl::Update().
+ * Called when the response is received from an SQL-friendly interface based data control provider. @n
+ * The application requesting the data control can get the update result implementing this listener. @n
+ * This listener must be registered by the SqlDataControl::SetSqlDataControlResponseListener() method for receiving the result response.
+ * It is called after the SqlDataControl::Update() method.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific table to update @n
+ * @param[in] dataId The string that identifies the specific table to update @n
* The string consists of one or more components, separated by a slash('/').
* @param[in] providerResult Set to @c true if the data control provider successfully processed the update request, @n
* else @c false
const Tizen::Base::String& dataId, bool providerResult, const Tizen::Base::String* pErrorMsg) = 0;
/**
- * Called when the response is received from SQL-friendly interface based data control provider. @n
- * The application requesting the data control can get delete result by implementing this listener. @n
- * This listener must be registered by SqlDataControl::SetSqlDataControlResponseListener() for receiving the result response.
- * It is called after SqlDataControl::Delete().
+ * Called when the response is received from an SQL-friendly interface based data control provider. @n
+ * The application requesting the data control can get the delete result by implementing this listener. @n
+ * This listener must be registered by the SqlDataControl::SetSqlDataControlResponseListener() method for receiving the result response.
+ * It is called after the SqlDataControl::Delete() method.
*
* @since 2.0
*
* @param[in] reqId The request ID
* @param[in] providerId The data control provider ID
- * @param[in] dataId A string for identifying a specific table to delete from @n
+ * @param[in] dataId The string that identifies the specific table to delete from @n
* The string consists of one or more components, separated by a slash('/').
* @param[in] providerResult Set to @c true if the data control provider successfully processed the delete request, @n
* else @c false
*
* The %MapDataControl class represents the key-value structured data control behavior, that provides a standard mechanism
* for accessing specific data exported by other applications.
- * Data control provider can share its own data to data control consumers.
+ * A data control provider can share its data with data control consumers.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/data_controls.htm">Data Controls</a>.
*
virtual ~MapDataControl(void);
/**
- * Gets the value list associated with the specified @c key, from a key-values map owned by key-value structured data control provider. @n
+ * Gets the value list associated with the specified @c key, from the key-values map owned by the key-value structured data control provider. @n
* The %GetValue() method is asynchronous.
- * For receiving the response from data control provider, set the listener
- * with MapDataControl::SetMapDataControlResponseListener(). @n
- * When the requested value list has been received from data control provider,
+ * For receiving the response from the data control provider, set the listener
+ * using the MapDataControl::SetMapDataControlResponseListener() method. @n
+ * When the requested value list has been received from the data control provider,
* the IMapDataControlResponseListener::OnMapDataControlGetValueResponseReceived() method is called.
*
* @since 2.0
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/datacontrol.consumer
*
* @return An error code
- * @param[in] dataId A string for identifying specific data, usually a registry section to get from @n
- * The string consists of one or more components, separated by a slash('/').
- * @param[in] key A key of the value list to obtain
- * @param[out] reqId The ID of the request
- * @param[in] pageNo The page number of the value set @n
- * It starts from @c 1.
- * @param[in] countPerPage The desired maximum count of the data item on the page
+ * @param[in] dataId The string that identifies the specific data, usually a registry section to get from @n
+ * The string consists of one or more components, separated by a slash('/').
+ * @param[in] key The key of the value list to obtain
+ * @param[out] reqId The ID of the request
+ * @param[in] pageNo The page number of the value set @n
+ * It starts from @c 1.
+ * @param[in] countPerPage The desired maximum count of the data items per page
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance has not been properly constructed as yet.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c pageNo parameter is less than @c 1.
- * - The specified @c countPerPage parameter is less than @c 1.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - Access is denied due to insufficient permission.
- * - The application using this method is not signed with the same certificate of provider application. @b Since: @b 2.1
- * @exception E_MAX_EXCEEDED Either of the following conditions has occurred: @n
- * - The total size of method arguments has exceeded the maximum limit.
- * - The number of requests sent has exceeded the maximum limit.
+ * @exception E_INVALID_STATE This instance has not been constructed properly as yet.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c pageNo is less than @c 1.
+ * - The specified @c countPerPage is less than @c 1.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The access is denied due to insufficient permission.
+ * - The application using this method is not signed with the same certificate as that of the provider application. @b Since: @b 2.1
+ * @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
+ * - The total size of the method arguments has exceeded the maximum limit.
+ * - The number of requests sent have exceeded the maximum limit.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The total size of method arguments is under 16KB because severe system performance degradation may occur for large messages. @c E_MAX_EXCEEDED may be returned for messages over 16KB size.
+ * @remarks The total size of the method arguments is under 16KB because a severe system performance degradation may occur for larger messages. @n
+ * @c E_MAX_EXCEEDED may be returned for messages over 16KB.
*/
result GetValue(const Tizen::Base::String& dataId, const Tizen::Base::String& key, RequestId& reqId, int pageNo = 1, int countPerPage = 20);
/**
- * Adds the value associated with the specified @c key, to a key-values map owned by key-value structured data control provider. @n
+ * Adds the value associated with the specified @c key, to the key-values map owned by the key-value structured data control provider. @n
* The %AddValue() method is asynchronous.
- * For receiving the response from data control provider, set the listener
- * with MapDataControl::SetMapDataControlResponseListener(). @n
+ * For receiving the response from the data control provider, set the listener
+ * using the MapDataControl::SetMapDataControlResponseListener() method. @n
* When the response has been received from the data control provider,
* the IMapDataControlResponseListener::OnMapDataControlAddValueResponseReceived() method is called.
*
* @since 2.0
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/datacontrol.consumer
*
* @return An error code
- * @param[in] dataId A string for identifying specific data, usually a registry section to add to @n
- * The string consists of one or more components, separated by a slash('/').
- * @param[in] key A key of the value list to add
- * @param[in] value A value to add
- * @param[out] reqId The ID of the request
+ * @param[in] dataId The string that identifies the specific data, usually a registry section to add to @n
+ * The string consists of one or more components, separated by a slash('/').
+ * @param[in] key The key of the value list to add
+ * @param[in] value The value to add
+ * @param[out] reqId The ID of the request
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance has not been properly constructed as yet.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - Access is denied due to insufficient permission.
- * - The application using this method is not signed with the same certificate of provider application. @b Since: @b 2.1
- * @exception E_MAX_EXCEEDED Either of the following conditions has occurred: @n
- * - The total size of method arguments has exceeded the maximum limit.
- * - The number of requests sent has exceeded the maximum limit.
+ * @exception E_INVALID_STATE This instance has not been constructed properly as yet.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The access is denied due to insufficient permission.
+ * - The application using this method is not signed with the same certificate as that of the provider application. @b Since: @b 2.1
+ * @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
+ * - The total size of the method arguments has exceeded the maximum limit.
+ * - The number of requests sent have exceeded the maximum limit.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The total size of method arguments is under 16KB because severe system performance degradation may occur for large messages. @c E_MAX_EXCEEDED may be returned for messages over 16KB size.
+ * @remarks The total size of the method arguments is under 16KB because a severe system performance degradation may occur for larger messages. @n
+ * @c E_MAX_EXCEEDED may be returned for messages over 16KB.
*/
result AddValue(const Tizen::Base::String& dataId, const Tizen::Base::String& key, const Tizen::Base::String& value, RequestId& reqId);
/**
- * Sets the value associated with the specified @c key with a new value. @n
- * The key-values map is owned by key-value structured data control provider. @n
+ * Sets the value associated with the specified @c key to a new value. @n
+ * The key-values map is owned by the key-value structured data control provider. @n
* The %SetValue() method is asynchronous.
- * For receiving the response from data control provider, set the listener
- * with MapDataControl::SetMapDataControlResponseListener(). @n
+ * For receiving the response from the data control provider, set the listener
+ * using the MapDataControl::SetMapDataControlResponseListener() method. @n
* When the response has been received from the data control provider,
* the IMapDataControlResponseListener::OnMapDataControlSetValueResponseReceived() method is called.
*
* @since 2.0
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/datacontrol.consumer
*
* @return An error code
- * @param[in] dataId A string for identifying specific data, usually a registry section to update @n
- * The string consists of one or more components, separated by a slash('/').
- * @param[in] key A key of the value to replace
- * @param[in] oldValue A value to replace
- * @param[in] newValue A new value to replace the existing value
- * @param[out] reqId The ID of the request
+ * @param[in] dataId The string that identifies the specific data, usually a registry section to update @n
+ * The string consists of one or more components, separated by a slash('/').
+ * @param[in] key The key of the value to replace
+ * @param[in] oldValue The value to replace
+ * @param[in] newValue The new value that replaces the existing value
+ * @param[out] reqId The ID of the request
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance has not been properly constructed as yet.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - Access is denied due to insufficient permission.
- * - The application using this method is not signed with the same certificate of provider application. @b Since: @b 2.1
- * @exception E_MAX_EXCEEDED Either of the following conditions has occurred: @n
- * - The total size of method arguments has exceeded the maximum limit.
- * - The number of requests sent has exceeded the maximum limit.
+ * @exception E_INVALID_STATE This instance has not been constructed properly as yet.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The access is denied due to insufficient permission.
+ * - The application using this method is not signed with the same certificate as that of the provider application. @b Since: @b 2.1
+ * @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
+ * - The total size of the method arguments has exceeded the maximum limit.
+ * - The number of requests sent have exceeded the maximum limit.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The total size of method arguments is under 16KB because severe system performance degradation may occur for large messages. @c E_MAX_EXCEEDED may be returned for messages over 16KB size.
+ * @remarks The total size of the method arguments is under 16KB because a severe system performance degradation may occur for larger messages. @n
+ * @c E_MAX_EXCEEDED may be returned for messages over 16KB.
*/
result SetValue(const Tizen::Base::String& dataId, const Tizen::Base::String& key, const Tizen::Base::String& oldValue, const Tizen::Base::String& newValue, RequestId& reqId);
/**
- * Removes the value associated with the specified @c key, from a key-values map owned by key-value structured data control provider. @n
+ * Removes the value associated with the specified @c key, from the key-values map owned by the key-value structured data control provider. @n
* The %RemoveValue() method is asynchronous.
- * For receiving the response from data control provider, set the listener
- * with MapDataControl::SetMapDataControlResponseListener(). @n
+ * For receiving the response from the data control provider, set the listener
+ * using the MapDataControl::SetMapDataControlResponseListener() method. @n
* When the response has been received from the data control provider,
* the IMapDataControlResponseListener::OnMapDataControlRemoveValueResponseReceived() method is called.
*
* @since 2.0
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/datacontrol.consumer
*
* @return An error code
- * @param[in] dataId A string for identifying specific data, usually a registry section to remove from @n
- * The string consists of one or more components, separated by a slash('/').
- * @param[in] key A key of the value to remove
- * @param[in] value A value to remove
- * @param[out] reqId The ID of the request
+ * @param[in] dataId The string that identifies the specific data, usually a registry section to remove from @n
+ * The string consists of one or more components, separated by a slash('/').
+ * @param[in] key The key of the value to remove
+ * @param[in] value The value to remove
+ * @param[out] reqId The ID of the request
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance has not been properly constructed as yet.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - Access is denied due to insufficient permission.
- * - The application using this method is not signed with the same certificate of provider application. @b Since: @b 2.1
- * @exception E_MAX_EXCEEDED Either of the following conditions has occurred: @n
- * - The total size of method arguments has exceeded the maximum limit.
- * - The number of requests sent has exceeded the maximum limit.
+ * @exception E_INVALID_STATE This instance has not been constructed properly as yet.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The access is denied due to insufficient permission.
+ * - The application using this method is not signed with the same certificate as that of the provider application. @b Since: @b 2.1
+ * @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
+ * - The total size of the method arguments has exceeded the maximum limit.
+ * - The number of requests sent have exceeded the maximum limit.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The total size of method arguments is under 16KB because severe system performance degradation may occur for large messages. @c E_MAX_EXCEEDED may be returned for messages over 16KB size.
+ * @remarks The total size of the method arguments is under 16KB because a severe system performance degradation may occur for larger messages. @n
+ * @c E_MAX_EXCEEDED may be returned for messages over 16KB.
*/
result RemoveValue(const Tizen::Base::String& dataId, const Tizen::Base::String& key, const Tizen::Base::String& value, RequestId& reqId);
/**
- * Sets the MAP-based data control listener to this instance.
+ * Sets the MAP-based data control listener for this instance.
*
* @since 2.0
*
* Some data controls need to get the callback result by implementing
* the IMapDataControlResponseListener interface.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance has not been properly constructed.
+ * @exception E_INVALID_STATE This instance has not been constructed properly as yet.
* @exception E_SYSTEM A system error has occurred.
*/
result SetMapDataControlResponseListener(IMapDataControlResponseListener* pListener);
* @final This class is not intended for extension.
*
* The %NotificationManager class provides methods to alert the user about a notification.
- * @n
- * For more information about the class features, see <a href="../org.tizen.native.appprogramming/html/guide/shell/notifications.htm">Notifications</a>.
+ *
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/shell/notifications.htm">Notifications</a>.
*
* The following example demonstrates how to use the %NotificationManager class.
*
* @since 2.0
* @privilege %http://tizen.org/privilege/notification
*
- * @return The current badge number
+ * @return The current badge number, @n
+ * else @c -1 if it fails
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_OBJ_NOT_FOUND The application is not installed.
+ * @exception E_OBJ_NOT_FOUND The application has not been installed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The specific error code can be accessed using the GetLastResult() method. @n
- * In case of failure, this method returns @c -1.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
* @endif
*/
int GetBadgeNumber(void);
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
* @privilege %http://tizen.org/privilege/notification
*
* @return An error code
* @param[in] badgeNumber The badge number
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid, or
- * the specified @c badgeNumber is less than @c 0.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified input parameter is invalid.
+ * - The specified @c badgeNumber is less than @c 0.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the %Tizen platform policy.
+ * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the Tizen platform policy.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @endif
*/
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
* @privilege %http://tizen.org/privilege/notification
*
* @return An error code
* @param[in] messageText The notification message
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid, or
- * the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified input parameter is invalid.
+ * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the %Tizen platform policy.
+ * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the Tizen platform policy.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @endif
*/
/**
* @if OSPDEPREC
- * Notifies the user using a message and badge number.
+ * Notifies the user using a message and a badge number.
*
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
* @privilege %http://tizen.org/privilege/notification
*
* @return An error code
* @param[in] messageText The notification message
* @param[in] badgeNumber The badge number
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c badgeNumber is less than @c 0, or
- * the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c badgeNumber is less than @c 0.
+ * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the %Tizen platform policy.
+ * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the Tizen platform policy.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @endif
*/
/**
* @if OSPDEPREC
- * Notifies the user using a message and badge number. @n
+ * Notifies the user using a message and a badge number. @n
* If the user checks the message, @c launchArguments is delivered to the application. @n
* @c launchArguments is delivered as the value of the %http://tizen.org/appcontrol/data/notification key
- * for IAppControlProviderEventListener::OnAppControlRequestReceived().
+ * for the IAppControlProviderEventListener::OnAppControlRequestReceived() method.
*
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
* @privilege %http://tizen.org/privilege/notification
*
* @return An error code
* @param[in] messageText The notification message
* @param[in] badgeNumber The badge number
- * @param[in] launchArguments The message for application
+ * @param[in] launchArguments The message for the application
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - A specified input parameter is invalid. @n
- * - The specified @c badgeNumber is less than @c 0. @n
- * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c badgeNumber is less than @c 0.
+ * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
* - The length of the specified @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the %Tizen platform policy.
+ * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the Tizen platform policy.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @see IAppControlProviderEventListener::OnAppControlRequestReceived()
* @endif
*/
result Notify(const Tizen::Base::String& messageText, int badgeNumber, const Tizen::Base::String& launchArguments);
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
* @privilege %http://tizen.org/privilege/notification
*
* @return An error code
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @remarks This method returns @c E_SUCCESS when there is no outstanding notification.
* @endif
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
* @privilege %http://tizen.org/privilege/notification
*
* @return An error code
* @param[in] messageText The notification message
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid, or
- * the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified input parameter is invalid.
+ * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the %Tizen platform policy.
+ * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the Tizen platform policy.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @endif
*/
* @if OSPDEPREC
* Notifies the user about the ongoing activity using a message. @n
* @c launchArguments is delivered as the value of the %http://tizen.org/appcontrol/data/notification key
- * for IAppControlProviderEventListener::OnAppControlRequestReceived().
+ * for the IAppControlProviderEventListener::OnAppControlRequestReceived() method.
*
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
* @privilege %http://tizen.org/privilege/notification
*
* @return An error code
* @param[in] messageText The notification message
- * @param[in] launchArguments The launch arguments for the application
+ * @param[in] launchArguments The launch arguments for the application
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - A specified input parameter is invalid. @n
- * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
* - The length of the specified @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the %Tizen platform policy.
+ * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the Tizen platform policy.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @endif
*/
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
* @privilege %http://tizen.org/privilege/notification
*
* @return An error code
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
* @privilege %http://tizen.org/privilege/notification
*
- * @return The current badge number
+ * @return The current badge number, @n
+ * else @c -1 if it fails
* @param[in] appId The application ID
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_OBJ_NOT_FOUND The application is not installed.
+ * @exception E_OBJ_NOT_FOUND The application has not been installed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The specific error code can be accessed using the GetLastResult() method. @n
- * In case of failure, this method returns @c -1.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
* @endif
*/
int GetBadgeNumber(const AppId& appId);
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/notification @n
* @param[in] appId The application ID
* @param[in] badgeNumber The badge number
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c badgeNumber is less than @c 0.
- * @exception E_APP_NOT_INSTALLED The application is not installed.
- * @exception E_INVALID_OPERATION The target application with the specified application ID is not permitted to receive any notification as per the %Tizen platform policy.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c badgeNumber is less than @c 0.
+ * @exception E_APP_NOT_INSTALLED The application has not been installed.
+ * @exception E_INVALID_OPERATION The target application with the specified @c appId is not permitted to receive any notification as per the Tizen platform policy.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @endif
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/notification @n
* @param[in] appId The application ID
* @param[in] messageText The notification message
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
- * @exception E_APP_NOT_INSTALLED The application is not installed.
- * @exception E_INVALID_OPERATION The target application with the specified application ID is not permitted to receive any notification as per the %Tizen platform policy.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
+ * @exception E_APP_NOT_INSTALLED The application has not been installed.
+ * @exception E_INVALID_OPERATION The target application with the specified @c appId is not permitted to receive any notification as per the Tizen platform policy.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @endif
/**
* @if OSPDEPREC
- * Notifies the user using a message and badge number on behalf of the specified application.
+ * Notifies the user using a message and a badge number on behalf of the specified application.
*
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/notification @n
* @param[in] messageText The notification message
* @param[in] badgeNumber The badge number
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - A specified input parameter is invalid. @n
- * - The specified @c badgeNumber is less than @c 0. @n
- * - The length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
- * @exception E_APP_NOT_INSTALLED The application is not installed.
- * @exception E_INVALID_OPERATION The target application with the specified application ID is not permitted to receive any notification as per the %Tizen platform policy.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c badgeNumber is less than @c 0.
+ * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
+ * @exception E_APP_NOT_INSTALLED The application has not been installed.
+ * @exception E_INVALID_OPERATION The target application with the specified @c appId is not permitted to receive any notification as per the Tizen platform policy.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @endif
/**
* @if OSPDEPREC
- * Notifies the user using a message and badge number on behalf of the specified application. @n
- * If the user checks the message, the @c launchArguments is delivered to the application.
+ * Notifies the user using a message and a badge number on behalf of the specified application. @n
+ * If the user checks the message, @c launchArguments is delivered to the application.
*
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/notification @n
* (%http://tizen.org/privilege/notificationmanager is deprecated.)
*
- * @return An error code
+ * @return An error code
* @param[in] appId The application ID
- * @param[in] messageText The notification message
- * @param[in] launchArguments The launch arguments for the application
+ * @param[in] messageText The notification message
+ * @param[in] launchArguments The launch arguments for the application
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - A specified input parameter is invalid. @n
- * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
- * - The length of the specified @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
- * @exception E_APP_NOT_INSTALLED The application is not installed.
- * @exception E_INVALID_OPERATION The target application with the specified application ID is not permitted to receive any notification as per the %Tizen platform policy.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
+ * - The length of the specified @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
+ * @exception E_APP_NOT_INSTALLED The application has not been installed.
+ * @exception E_INVALID_OPERATION The target application with the specified @c appId is not permitted to receive any notification as per the Tizen platform policy.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @endif
*/
result NotifyOnBehalf(const AppId& appId, const Tizen::Base::String& messageText, const Tizen::Base::String& launchArguments);
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/notification @n
* @param[in] appId The application ID
* @param[in] messageText The notification message
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid, or
- * the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
- * @exception E_APP_NOT_INSTALLED The application is not installed.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified input parameter is invalid.
+ * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
+ * @exception E_APP_NOT_INSTALLED The application has not been installed.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the %Tizen platform policy.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the Tizen platform policy.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @endif
*/
result NotifyOngoingActivityOnBehalf(const AppId& appId, const Tizen::Base::String& messageText);
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/notification @n
* @return An error code
* @param[in] appId The application ID
* @param[in] messageText The notification message
- * @param[in] launchArguments The launch arguments for application
+ * @param[in] launchArguments The launch arguments for the application
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - A specified input parameter is invalid. @n
- * - The length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
- * - The length of @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
- * @exception E_APP_NOT_INSTALLED The application is not installed.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
+ * - The length of the specified @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
+ * @exception E_APP_NOT_INSTALLED The application has not been installed.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the %Tizen platform policy.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the Tizen platform policy.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @endif
*/
result NotifyOngoingActivityOnBehalf(const AppId& appId, const Tizen::Base::String& messageText, const Tizen::Base::String& launchArguments);
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/notification @n
* @return An error code
* @param[in] appId The application ID
* @exception E_SUCCESS The method is successful.
- * @exception E_APP_NOT_INSTALLED The application is not installed.
+ * @exception E_APP_NOT_INSTALLED The application has not been installed.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks Although there is no outstanding notification for the calling application, this method returns @c E_SUCCESS.
+ * @remarks Even if there is no outstanding notification for the calling application, this method returns @c E_SUCCESS.
* @endif
*/
result RemoveOngoingActivityNotificationOnBehalf(const AppId& appId);
* @brief <i> [Deprecated] </i>
*
* @deprecated This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/notification @n
* @return An error code
* @param[in] appId The application ID
* @exception E_SUCCESS The method is successful.
- * @exception E_APP_NOT_INSTALLED The application is not installed.
+ * @exception E_APP_NOT_INSTALLED The application has not been installed.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks Although there is no outstanding notification for the calling application, this method returns @c E_SUCCESS.
+ * @remarks Even if there is no outstanding notification for the calling application, this method returns @c E_SUCCESS.
* @endif
*/
result RemoveNotificationOnBehalf(const AppId& appId);
* @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FApp.h> @n
- * @b Library : @b osp-appfw
+ * @b Library: @b osp-appfw
*
- * The %Package namespace contains classes and interfaces for information of packages and management of its installation or uninstallation.
+ * The %Package namespace contains classes and interfaces for obtaining the information and managing the installation or uninstallation of a package.
*
* The following diagram illustrates the relationships between the classes belonging to the %Package namespace.
* @image html app_package_namespace_classdiagram.png
/**
* @enum PackageInstallationResult
*
- * Defines the result of package installation.
+ * Defines the result of a package installation.
*
* @since 2.0
*/
{
PACKAGE_INSTALLATION_RESULT_SUCCESS = 0, /**< Success */
PACKAGE_INSTALLATION_RESULT_INVALID_PACKAGE, /**< An invalid package */
- PACKAGE_INSTALLATION_RESULT_STORAGE_FULL, /**< The installation target storage is full. */
+ PACKAGE_INSTALLATION_RESULT_STORAGE_FULL, /**< The installation's target storage is full */
};
/**
* @interface IPackageInstallationEventListener
-* @brief This interface defines a listener for a package installation and uninstallation.
+* @brief This interface defines a listener for a package's installation and uninstallation.
*
* @since 2.0
*
-* The %IPackageInstallationEventListener interface defines a listener that is notified for events related to installation or uninstallation of packages on a device.
+* The %IPackageInstallationEventListener interface defines a listener that is notified about events related to the installation or uninstallation of a package on a device.
* The events include installation completion, uninstallation completion, and installation progress.
-* This listener is registered with the PackageManager::AddPackageInstallationEventListener() method and unregistered with the PackageManager::RemovePackageInstallationEventListener() method.
-* Generally, this listener is used in system applications such as application service that utilizes packages' (un)installation information in a system.
+* This listener is registered using the PackageManager::AddPackageInstallationEventListener() method and unregistered using the PackageManager::RemovePackageInstallationEventListener() method.
+* Generally, this listener is used in system applications such as an application service that utilizes a package's (un)installation information that is present in the system.
*/
class _OSP_EXPORT_ IPackageInstallationEventListener
: virtual public Tizen::Base::Runtime::IEventListener
{
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
/**
* Called when a package uninstallation is completed. @n
- * The value of @c uninstallationResult is @c true if the uninstallation is successful, else @c false.
+ * The value of @c uninstallationResult is @c true if the uninstallation is successful, otherwise it is @c false.
*
* @since 2.0
*
- * @param[in] packageId The package ID
+ * @param[in] packageId The package ID
* @param[in] uninstallationResult Set to @c true if the uninstallation is successful, @n
- * else @c false
+ * else @c false
*/
virtual void OnPackageUninstallationCompleted(const PackageId& packageId, bool uninstallationResult) = 0;
* @since 2.0
*
* @param[in] packageId The package ID
- * @param[in] progress The progress of an installation in percentage
+ * @param[in] progress The progress of the installation in percentage
*/
virtual void OnPackageInstallationInProgress(const PackageId& packageId, int progress) = 0;
*
* @since 2.0
*
- * The %IPackageInstallationResponseListener interface defines a listener that is notified for events related to installation of a target package.
- * The events include installation result and installation progress information.
- * Generally, applications such as %Tizen Store use this listener in a package installation step.
+ * The %IPackageInstallationResponseListener interface defines a listener that is notified about events related to the installation of a target package.
+ * The events include the installation result and the installation progress information.
+ * Generally, applications such as the Tizen Store use this listener in a package installation step.
* @see PackageManager::InstallPackage()
*/
class _OSP_EXPORT_ IPackageInstallationResponseListener
{
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*
* @since 2.0
*
- * @param[in] packageId The package ID
+ * @param[in] packageId The package ID
* @param[in] installationResult The installation result
*
*/
* @since 2.0
*
* @param[in] packageId The package ID
- * @param[in] progress The progress of an installation in percentage
+ * @param[in] progress The progress of the installation in percentage
*
*/
virtual void OnPackageInstallationInProgressResponseReceived(const PackageId& packageId, int progress) = 0;
*
* @since 2.0
*
- * The %IPackageUninstallationResponseListener interface defines a listener that is notified for events related to uninstallation of a target package.
- * The events include uninstallation result.
- * Generally, applications such as %Tizen Store use this listener in a package uninstallation step.
+ * The %IPackageUninstallationResponseListener interface defines a listener that is notified about events related to the uninstallation of a target package.
+ * The events include the uninstallation result.
+ * Generally, applications such as the %Tizen Store use this listener in a package uninstallation step.
* @see PackageManager::UninstallPackage()
*
*/
{
public:
/**
- * This polymorphic destructor should be overridden if required.
+ * This polymorphic destructor should be overridden if required. @n
* This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
/**
* Called when a package uninstallation is completed. @n
- * The value of @c uninstallationResult is @c true if the uninstallation is successful, else @c false.
+ * The value of @c uninstallationResult is @c true if the uninstallation is successful, otherwise it is @c false.
*
* @since 2.0
*
* @param[in] packageId The package ID
* @param[in] uninstallationResult Set to @c true if the uninstallation is successful, @n
- * else @c false
+ * else @c false
*
*/
virtual void OnPackageUninstallationResponseReceived(const PackageId& packageId, bool uninstallationResult) = 0;
/**
* @class PackageAppInfo
- * @brief This class represents the information of the application in package.
+ * @brief This class represents the information of an application in a package.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %PackageAppInfo class provides the information of the application in package.
+ * The %PackageAppInfo class provides the information of an application in a package.
*
*/
class _OSP_EXPORT_ PackageAppInfo
virtual ~PackageAppInfo(void);
/**
- * Gets an application ID.
+ * Gets the application ID.
*
* @since 2.0
*
- * @return An application ID
+ * @return The application ID
*/
AppId GetAppId(void) const;
*
* @since 2.0
*
- * @return The name of an application
+ * @return The name of the application
*/
Tizen::Base::String GetAppName(void) const;
*
* @since 2.0
*
- * @return The display name of an application
+ * @return The display name of the application
*/
Tizen::Base::String GetAppDisplayName(void) const;
*
* @since 2.1
*
- * @return The menu icon path of an application, @n
+ * @return The menu icon path of the application, @n
* else an empty string is returned if there is no value
*/
Tizen::Base::String GetAppMenuIconPath(void) const;
*
* @since 2.1
*
- * @return The setting icon path of an application, @n
- * else an empty string is returned if there is no value
+ * @return The setting icon path of the application, @n
+ * else an empty string is returned if there is no value
*/
Tizen::Base::String GetAppSettingIconPath(void) const;
*
* @since 2.1
*
- * @return The notification icon path of an application, @n
+ * @return The notification icon path of the application, @n
* else an empty string is returned if there is no value
*/
Tizen::Base::String GetAppNotificationIconPath(void) const;
/**
* Gets the menu icon of an application.
*
- * @since 2.1
+ * @since 2.1
*
- * @return A pointer to the menu icon of an application, @n
- * else @c null if it fails
+ * @return A pointer to the menu icon of the application, @n
+ * else @c null if it fails
* @exception E_SUCCESS The method is successful.
* @exception E_FILE_NOT_FOUND The menu icon does not exist.
* @exception E_UNSUPPORTED_FORMAT The image file format is not supported.
*
* @since 2.1
*
- * @return A pointer to a map of key(Tizen::Base::String) and value(Tizen::Base::String) pairs of the metadata, @n
+ * @return A pointer to the map of the key(Tizen::Base::String) and value(%Tizen::Base::String) pairs of the metadata, @n
* else @c null if it fails
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks
- * - The specific error code can be accessed using the GetLastResult() method.
- * - Application can use the metadata to set app-wide information.
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - An application can use the metadata to set the app-wide information.
*/
Tizen::Base::Collection::IMap* GetAppMetadataListN(void) const;
Tizen::Base::Collection::IList* GetAppCategoryListN(void) const;
/**
- * Checks whether an application is visible on the menu.
+ * Checks if an application is visible on the menu.
*
* @since 2.0
*
- * @return @c true if an application is visible on the menu, @n
+ * @return @c true if the application is visible on the menu, @n
* else @c false
- * @remarks If the return value is @c false, it is recommended not to display the application on the menu.
+ * @remarks If the return value is @c false, it is not recommended to display the application on the menu.
*/
bool IsMenuIconVisible(void) const;
/**
- * Checks whether an application is the main application of the package.
+ * Checks if an application is the main application of the package.
*
* @since 2.0
*
- * @return @c true if an application is the main application of the package, @n
+ * @return @c true if the application is the main application of the package, @n
* else @c false
*/
bool IsMainApp(void) const;
virtual ~PackageInfo(void);
/**
- * Gets a package ID.
+ * Gets the package ID.
*
* @since 2.0
*
- * @return A package ID
+ * @return The package ID
*/
PackageId GetId(void) const;
*
* @since 2.0
*
- * @return The version of a package
+ * @return The version of the package
*/
Tizen::Base::String GetVersion(void) const;
*
* @since 2.0
*
- * @return The display name of a package
+ * @return The display name of the package
*/
Tizen::Base::String GetDisplayName(void) const;
*
* @since 2.0
*
- * @return The description of a package, @n
+ * @return The description of the package, @n
* else an empty string is returned if there is no value
*/
Tizen::Base::String GetDescription(void) const;
*
* @since 2.0
*
- * @return The author of a package, @n
+ * @return The author of the package, @n
* else an empty string is returned if there is no value
*/
Tizen::Base::String GetAuthor(void) const;
*
* @since 2.0
*
- * @return The URL of a package, @n
+ * @return The URL of the package, @n
* else an empty string is returned if there is no value
*/
Tizen::Base::String GetUrl(void) const;
/**
- * Gets the date and time when a package is installed.
+ * Gets the date and the time when a package is installed.
*
* @since 2.0
*
- * @return An instance of Tizen::Base::DateTime when a package is installed
+ * @return An instance of Tizen::Base::DateTime which contains the package installation details
*/
Tizen::Base::DateTime GetInstallationTime(void) const;
/**
- * Checks whether a package is installed in the external storage.
+ * Checks if a package is installed in the external storage.
*
* @since 2.0
*
- * @return @c true if a package is installed in the external storage, @n
+ * @return @c true if the package is installed in the external storage, @n
* else @c false
*/
bool IsInstalledInExternalStorage(void) const;
/**
- * Checks whether it is possible to uninstall a package.
+ * Checks if it is possible to uninstall a package.
*
* @since 2.0
*
- * @return @c true if it is possible to uninstall a package, @n
+ * @return @c true if it is possible to uninstall the package, @n
* else @c false
*/
bool IsUninstallable(void) const;
/**
- * Checks whether it is possible to move a package to either internal or external storage.
+ * Checks if it is possible to move a package to either the internal or the external storage.
*
* @since 2.0
*
- * @return @c true if it is possible to move a package to either internal or external storage, @n
+ * @return @c true if it is possible to move the package to either the internal or the external storage, @n
* else @c false
*/
bool IsMovable(void) const;
/**
- * Checks whether a package is downloaded.
+ * Checks if a package is downloaded.
*
* @since 2.0
*
- * @return @c true if a package is downloaded, @n
+ * @return @c true if the package is downloaded, @n
* else @c false
*/
bool IsDownloaded(void) const;
*
* @since 2.0
*
- * @return The size of a package
+ * @return The size of the package
*/
long long GetSize(void) const;
*
* @since 2.0
*
- * @return The data size of a package
+ * @return The data size of the package
*/
long long GetDataSize(void) const;
*
* @since 2.0
*
- * @return A pointer to PackageAppInfo
+ * @return A pointer to the PackageAppInfo instance
* @param[in] appId The application ID
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_OBJ_NOT_FOUND The application information is not found.
+ * @exception E_OBJ_NOT_FOUND The application information has not been found.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
/**
* Gets the type of a package.
*
- * @since 2.0
+ * @since 2.0
* @privlevel platform
* @privilege %http://tizen.org/privilege/packagemanager.setting @n
- * (%http://tizen.org/privilege/packagesetting is deprecated.)
+ * (%http://tizen.org/privilege/packagesetting is deprecated.)
*
- * @return The package type
+ * @return The package type
*/
PackageType GetType(void) const;
*
* @since 2.1
*
- * @return A pointer to the list of Tizen::Security::PrivilegeInfo instances, @n
+ * @return A pointer to the list of the Tizen::Security::PrivilegeInfo instances, @n
* else @c null if it fails
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::Collection::IList* GetPrivilegeListN(void) const;
*/
enum PackageType
{
- PACKAGE_TYPE_TPK, /**< TIZEN Native package */
- PACKAGE_TYPE_WGT, /**< TIZEN %Web package */
- PACKAGE_TYPE_RPM, /**< TIZEN Core package */
+ PACKAGE_TYPE_TPK, /**< %Tizen native package */
+ PACKAGE_TYPE_WGT, /**< %Tizen Web package */
+ PACKAGE_TYPE_RPM, /**< %Tizen Core package */
};
/**
* @class PackageManager
- * @brief This class gets the information of packages and manages package installation or uninstallation.
+ * @brief This class gets the information of a package and manages the package's installation or uninstallation.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %PackageManager class provides methods to install or uninstall the packages, retrieves the information of the packages that are installed on the device.
+ * The %PackageManager class provides methods to install or uninstall a package and retrieve the information of a package that is installed on the device.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/package_namespace.htm">Package Management</a>.
*
* @since 2.0
*
* @return The package ID, @n
- * else @c packageId.IsEmtpy() == true is returned if an error occurs
+ * else an empty package ID if an error occurs @n
+ * Checks with packageId.IsEmpty() whether the package ID is empty.
* @param[in] appId The application ID
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
/**
* Adds a package installation event listener.
*
- * @since 2.0
+ * @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/package.info @n
- * (%http://tizen.org/privilege/packageinfo is deprecated.)
+ * (%http://tizen.org/privilege/packageinfo is deprecated.)
*
* @return An error code
* @param[in] listener The package installation event listener
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/package.info @n
- * (%http://tizen.org/privilege/packageinfo is deprecated.)
+ * (%http://tizen.org/privilege/packageinfo is deprecated.)
*
* @return An error code
* @param[in] listener The package installation event listener
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The listener is not added or is already removed.
+ * @exception E_OBJ_NOT_FOUND Either of the following conditions has occurred:
+ * - The listener is not added.
+ * - The listener is already removed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
result RemovePackageInstallationEventListener(IPackageInstallationEventListener& listener);
/**
- * Gets a package information with the specific package ID.
+ * Gets the package information with the specific package ID.
*
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/package.info @n
- * (%http://tizen.org/privilege/packageinfo is deprecated.)
+ * (%http://tizen.org/privilege/packageinfo is deprecated.)
*
- * @return A pointer to PackageInfo
+ * @return A pointer to the PackageInfo instance
* @param[in] packageId The package ID
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_PKG_NOT_INSTALLED The package is not installed.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_PKG_NOT_INSTALLED The package has not been installed.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
PackageInfo* GetPackageInfoN(const PackageId& packageId) const;
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/package.info @n
- * (%http://tizen.org/privilege/packageinfo is deprecated.)
+ * (%http://tizen.org/privilege/packageinfo is deprecated.)
*
- * @return A pointer to PackageAppInfo
+ * @return A pointer to the PackageAppInfo instance
* @param[in] appId The application ID
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/package.info @n
- * (%http://tizen.org/privilege/packageinfo is deprecated.)
+ * (%http://tizen.org/privilege/packageinfo is deprecated.)
*
* @return A pointer to the list of the PackageInfo instances, @n
* else @c null if it fails
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/package.info @n
- * (%http://tizen.org/privilege/packageinfo is deprecated.)
+ * (%http://tizen.org/privilege/packageinfo is deprecated.)
*
- * @return @c true if a package is installed, @n
- * else @c false
- * @param[in] packageId The package ID
+ * @return @c true if the package is installed, @n
+ * else @c false
+ * @param[in] packageId The package ID
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
/**
* Installs a package. @n
- * The %InstallPackage() method operates asynchronously, that is, it ends immediately without an installation response. The application is notified when the installation is completed, so the response is available through the IPackageInstallationResponseListener::OnPackageInstallationCompleted() method, if this method returns @c E_SUCCESS.
+ * The %InstallPackage() method operates asynchronously, that is, it ends immediately without an installation response.
+ * The application is notified when the installation is completed, so the response is available through the IPackageInstallationResponseListener::OnPackageInstallationCompleted() method, if this method returns @c E_SUCCESS.
*
* @since 2.0
* @privlevel platform
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks A listener instance ownership is transferred to the platform. After notifying result, the listener instance is removed automatically. A reuse of the listener instance is not allowed.
+ * @remarks
+ * - A listener instance ownership is transferred to the platform.
+ * - After notifying the result, the listener instance is removed automatically.
+ * - A reuse of the listener instance is not allowed.
*/
result InstallPackage(const PackageId& packageId, const Tizen::Base::String& packagePath, IPackageInstallationResponseListener* pListener);
/**
* Uninstalls a package with the specified package ID. @n
- * The %UninstallPackage() method operates asynchronously, that is, it ends immediately without an uninstallation response. The application is notified when the uninstallation is completed, so the response is available through the IPackageUninstallationResponseListener::OnPackageUninstallationCompleted() method, if this method returns @c true.
+ * The %UninstallPackage() method operates asynchronously, that is, it ends immediately without an uninstallation response.
+ * The application is notified when the uninstallation is completed, so the response is available through the IPackageUninstallationResponseListener::OnPackageUninstallationCompleted() method, if this method returns @c true.
*
* @since 2.0
* @privlevel platform
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_PKG_NOT_INSTALLED The package is not installed.
+ * @exception E_PKG_NOT_INSTALLED The package has not been installed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks A listener instance ownership is transferred to the platform. After notifying result, the listener instance is removed automatically. A reuse of the listener instance is not allowed.
+ * @remarks
+ * - A listener instance ownership is transferred to the platform.
+ * - After notifying the result, the listener instance is removed automatically.
+ * - A reuse of the listener instance is not allowed.
*/
result UninstallPackage(const PackageId& packageId, IPackageUninstallationResponseListener* pListener);
/**
- * Moves a package with the specified package ID to an external storage.
+ * Moves a package with the specified package ID to the external storage.
*
- * @since 2.0
+ * @since 2.0
* @privlevel platform
* @privilege %http://tizen.org/privilege/packagemanager.setting @n
- * (%http://tizen.org/privilege/packagesetting is deprecated.)
+ * (%http://tizen.org/privilege/packagesetting is deprecated.)
*
* @return An error code
* @param[in] packageId The package ID
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_INVALID_OPERATION The package is already installed in an external storage.
+ * @exception E_INVALID_OPERATION The package is already installed in the external storage.
* @exception E_STORAGE_FULL The storage is full.
- * @exception E_PKG_NOT_INSTALLED The package is not installed.
+ * @exception E_PKG_NOT_INSTALLED The package has not been installed.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
result MoveToExternalStorage(const PackageId& packageId);
/**
- * Moves a package with the specified package ID to an internal storage.
+ * Moves a package with the specified package ID to the internal storage.
*
- * @since 2.0
+ * @since 2.0
* @privlevel platform
* @privilege %http://tizen.org/privilege/packagemanager.setting @n
- * (%http://tizen.org/privilege/packagesetting is deprecated.)
+ * (%http://tizen.org/privilege/packagesetting is deprecated.)
*
* @return An error code
* @param[in] packageId The package ID
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_INVALID_OPERATION The package is already installed in an internal storage.
+ * @exception E_INVALID_OPERATION The package is already installed in the internal storage.
* @exception E_STORAGE_FULL The storage is full.
- * @exception E_PKG_NOT_INSTALLED The package is not installed.
+ * @exception E_PKG_NOT_INSTALLED The package has not been installed.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
result MoveToInternalStorage(const PackageId& packageId);
/**
- * Gets a package information from a specific file. @n The supported file extensions are tpk and wgt.
+ * Gets the package information from a specific file. @n
+ * The supported file extensions are tpk and wgt.
*
* @since 2.1
* @privlevel platform
* @privilege %http://tizen.org/privilege/packagemanager.info
*
* @return A pointer to the PackageInfo instance, @n
- * else @c null if it fails
- * @param[in] filePath The package file path
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_FILE_NOT_FOUND The specified file cannot be found or accessed.
- * @exception E_UNSUPPORTED_FORMAT The specified format is invalid or not supported.
- * @exception E_PARSING_FAILED The method has failed to parse the package file or xml file(s) inside the package.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * else @c null if it fails
+ * @param[in] filePath The package file path
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_FILE_NOT_FOUND The specified file cannot be found or accessed.
+ * @exception E_UNSUPPORTED_FORMAT The specified format is invalid or not supported.
+ * @exception E_PARSING_FAILED The method has failed to parse the package file or xml file(s) inside the package.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
PackageInfo* GetPackageInfoFromFileN(const Tizen::Base::String& filePath) const;
/**
- * Gets the package information list with the package filter.
+ * Gets the package information list using the package filter.
*
* @since 2.1
* @privlevel public
* @return A pointer to the list of the PackageInfo instances, @n
* else @c null if it fails
* @param[in] packageFilterMap The predefined key(Tizen::Base::String)-value(Tizen::Base::Boolean) pairs for the package filter @n
- * For more information on the predefined key-value pairs for package filter,
- * see <a href="../org.tizen.native.appprogramming/html/guide/app/package_app_filter.htm">the predefined key-value pairs for package filter</a>.
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * For more information on the predefined key-value pairs for the package filter,
+ * see <a href="../org.tizen.native.appprogramming/html/guide/app/package_app_filter.htm">the predefined key-value pairs for the package filter</a>.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::Collection::IList* GetPackageInfoListN(const Tizen::Base::Collection::IMap& packageFilterMap) const;
/**
- * Gets the application information list with the package app filter.
+ * Gets the application information list using the package application filter.
*
* @since 2.1
* @privlevel public
*
* @return A pointer to the list of the PackageAppInfo instances, @n
* else @c null if it fails
- * @param[in] packageAppFilterMap The predefined key(Tizen::Base::String)-value(Tizen::Base::String or Tizen::Base::Boolean) pairs for the package app filter @n
- * For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/package_app_filter.htm">
- * the predefined key-value pairs for package app filter</a>.
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @param[in] packageAppFilterMap The predefined key(Tizen::Base::String)-value(Tizen::Base::String or Tizen::Base::Boolean) pairs for the package application filter @n
+ * For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/package_app_filter.htm">
+ * the predefined key-value pairs for the package application filter</a>.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::Collection::IList* GetPackageAppInfoListN(const Tizen::Base::Collection::IMap& packageAppFilterMap) const;
/**
- * Gets the application information list with the package filter and package app filter.
+ * Gets the application information list using the package filter and the package application filter.
*
* @since 2.1
* @privlevel public
* @privilege %http://tizen.org/privilege/package.info
*
* @return A pointer to the list of the PackageAppInfo instances, @n
- * else @c null if it fails
+ * else @c null if it fails
* @param[in] packageFilterMap The predefined key(Tizen::Base::String)-value(Tizen::Base::Boolean) pairs for the package filter @n
- * @param[in] packageAppFilterMap The predefined and user defined key(Tizen::Base::String)-value(Tizen::Base::String or Tizen::Base::Boolean) pairs for the package app filter @n
- * The user defined key-value pairs can be added in <Metadata> of manifest.xml. @n For more information,
- * see <a href="../org.tizen.native.appprogramming/html/guide/app/package_filter.htm">the predefined key-value pairs
- * for package filter</a> and <a href="../org.tizen.native.appprogramming/html/guide/app/package_app_filter.htm">the
- * predefined key-value pairs for package app filter</a>.
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @param[in] packageAppFilterMap The predefined and user defined key(Tizen::Base::String)-value(%Tizen::Base::String or Tizen::Base::Boolean) pairs for the package application filter @n
+ * The user defined key-value pairs can be added in the <Metadata> of the manifest.xml. @n For more information,
+ * see <a href="../org.tizen.native.appprogramming/html/guide/app/package_filter.htm">the predefined key-value pairs
+ * for the package filter</a>, and <a href="../org.tizen.native.appprogramming/html/guide/app/package_app_filter.htm">the
+ * predefined key-value pairs for the package application filter</a>.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::Collection::IList* GetPackageAppInfoListN(const Tizen::Base::Collection::IMap& packageFilterMap, const Tizen::Base::Collection::IMap& packageAppFilterMap) const;
/**
- * Gets the package manager instance.
+ * Gets a pointer to the %PackageManager instance.
*
* @since 2.0
*
* @return A pointer to the %PackageManager instance, @n
- * else @c null
+ * else @c null if it fails
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static PackageManager* GetInstance(void);
/**
* @class ServiceApp
- * @brief This class is the base class of a %Tizen native service application.
+ * @brief This class is the base class of the %Tizen native service application.
*
* @since 2.0
*
- * The %ServiceApp class is the base class of a %Tizen native service application which has no UI.
+ * The %ServiceApp class is the base class of the %Tizen native service application which has no UI.
* A %Tizen native service application must inherit from the %ServiceApp class. This class provides the basic features necessary to define the
* %Tizen native service application.
- * @n
+ *
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/app_namespace.htm">App Guide</a> and <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/tizen_app_model/application_model.htm">Native Application Model</a>.
*
*/
virtual ~ServiceApp(void);
/**
- * Gets the %ServiceApp instance's pointer.
+ * Gets a pointer to the %ServiceApp instance.
*
* @since 2.0
*
/**
* Executes an application implemented by inheriting this class. @n
- * The %Execute() method must be called from the entry method - OspMain(), which is generated by IDE.
+ * The %Execute() method must be called from the entry method, that is, OspMain(), which is generated by IDE.
*
* @since 2.0
*
* @return An error code
- * @param[in] pServiceAppFactory The factory method that creates this %ServiceApp's instance
- * @param[in] pArguments The launch arguments for %App
+ * @param[in] pServiceAppFactory The factory method that creates this %ServiceApp instance
+ * @param[in] pArguments The launch arguments for the application
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INIT_FAILED The initialization failure during OnAppInitializing().
+ * @exception E_INIT_FAILED The initialization using the OnAppInitializing() method has failed.
* @exception E_SYSTEM A system error has occurred.
*/
static result Execute(ServiceAppInstanceFactory pServiceAppFactory, const Tizen::Base::Collection::IList* pArguments);
/**
* @class SqlDataControl
- * @brief This class represents the SQL-friendly interface based data control behavior.
+ * @brief This class represents the SQL-friendly interface based data control's behavior.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %SqlDataControl class represents the data control behavior, that provides a standard mechanism
- * for accessing specific data exported by other applications.
- * Data control provider can share its own data to data control consumers.
+ * The %SqlDataControl class represents the data control's behavior that provides a standard mechanism
+ * for accessing the specific data exported by other applications.
+ * A data control provider can share its data with data control consumers.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/data_controls.htm">Data Controls</a>.
*
/**
* Selects the specified columns to be queried. @n
- * The result set of the specified columns is retrieved from a table owned by an SQL-friendly interface based data control provider. @n
+ * The result set of the specified columns is retrieved from a table owned by the SQL-friendly interface based data control provider. @n
* The %Select() method is asynchronous.
- * For receiving the response from the data control provider, set the listener with
- * SqlDataControl::SetSqlDataControlResponseListener(). @n
+ * For receiving the response from the data control provider, set the listener using
+ * the SqlDataControl::SetSqlDataControlResponseListener() method. @n
* When the requested result set has been received from the data control provider,
* the ISqlDataControlResponseListener::OnSqlDataControlSelectResponseReceived() method is called.
*
* @since 2.0
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/datacontrol.consumer
*
* @return An error code
- * @param[in] dataId A string for identifying specific data, usually a database table to query from @n
+ * @param[in] dataId The string that identifies the specific data, usually a database table to query from @n
* The string consists of one or more components, separated by a slash('/').
- * @param[in] pColumnList A list of column names to query @n
+ * @param[in] pColumnList The list of column names to query @n
* The type of objects contained in the specified @c pColumnList must be
- * Tizen::Base::String class.
- * If the specified @c pColumnList is @c null, all columns are selected.
- * @param[in] pWhere A filter to select desired rows to query @n
+ * Tizen::Base::String @n
+ * If the specified @c pColumnList is @c null, all the columns are selected.
+ * @param[in] pWhere The filter to select the desired rows to query @n
* It is an SQL 'WHERE' clause excluding the 'WHERE' itself such as
- * column1 = 'stringValue' AND column2 = numericValue. @n\r
- * If the value is string, the value must be wrapped in single quotes.\r
- * Otherwise it is not needed to wrap the numeric value in single quotes.\r
- * For more information on the SQL statement, see SQLite SQL documents.\r
- * @param[in] pOrder The sorting order of rows to query @n
+ * column1 = 'stringValue' AND column2 = numericValue @n
+ * If the value is a string, the value must be wrapped in single quotes,
+ * otherwise it need not be wrapped in single quotes @n
+ * For more information on the SQL statement, see SQLite SQL documents.
+ * @param[in] pOrder The sorting order of the rows to query @n
* It is an SQL 'ORDER BY' clause excluding the 'ORDER BY' itself.
* @param[out] reqId The request ID
- * @param[in] pageNo The page number of the result set @n It starts from @c 1.
- * @param[in] countPerPage The desired maximum count of rows on a page
+ * @param[in] pageNo The page number of the result set @n
+ * It starts from @c 1.
+ * @param[in] countPerPage The desired maximum count of the rows per page
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance has not been properly constructed.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_STATE This instance has not been constructed properly.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The specified @c pColumnList is empty.
- * - The specified @c pageNo parameter is less than @c 1.
- * - The specified @c countPerPage parameter is less than @c 1.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - Access is denied due to insufficient permission.
- * - The application using this method is not signed with the same certificate of provider application. @b Since: @b 2.1
+ * - The specified @c pageNo is less than @c 1.
+ * - The specified @c countPerPage is less than @c 1.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The access is denied due to insufficient permission.
+ * - The application using this method is not signed with the same certificate as that of the provider application. @b Since: @b 2.1
* @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
- * - The size of sending buffer has exceeded the maximum limit.
- * - The number of sending requests has exceeded the maximum limit.
+ * - The size of the sending buffer has exceeded the maximum limit.
+ * - The number of sending requests have exceeded the maximum limit.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The recommended data size is under 16KB because severe system performance degradation may occur for large messages. @c E_MAX_EXCEEDED may be returned for messages over 16KB size.\r
+ * @remarks The recommended data size is under 16KB because a severe system performance degradation may occur for larger messages. @n
+ * @c E_MAX_EXCEEDED may be returned for messages over 16KB.
*/
result Select(const Tizen::Base::String& dataId, const Tizen::Base::Collection::IList* pColumnList,
const Tizen::Base::String* pWhere, const Tizen::Base::String *pOrder, RequestId& reqId,
int pageNo = 1, int countPerPage = 20);
/**
- * Inserts new rows into a table owned by an SQL-friendly interface based data control provider. @n
+ * Inserts new rows into a table owned by the SQL-friendly interface based data control provider. @n
* The %Insert() method is asynchronous.
- * For receiving the response from the data control provider, set the listener with
- * SqlDataControl::SetSqlDataControlResponseListener(). @n
+ * For receiving the response from the data control provider, set the listener using
+ * the SqlDataControl::SetSqlDataControlResponseListener() method. @n
* When the response has been received from the data control provider,
* the ISqlDataControlResponseListener::OnSqlDataControlInsertResponseReceived() method is called.
*
* @since 2.0
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/datacontrol.consumer
*
* @return An error code
- * @param[in] dataId A string for identifying specific data, usually a database table to insert into @n
+ * @param[in] dataId The string that identifies the specific data, usually a database table to insert into @n
* The string consists of one or more components, separated by a slash('/').
* @param[in] insertMap The column-value pairs to insert @n
- * The type of objects must be Tizen::Base::String class. @n\r
- * If the value is string, the value must be wrapped in\r
- * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.\r
- * For more information on the SQL statement, see SQLite SQL documents.\r
+ * The type of objects must be Tizen::Base::String @n
+ * If the value is a string, the value must be wrapped in single quotes,
+ * else it need not be wrapped in single quotes @n
+ * For more information on the SQL statement, see SQLite SQL documents.
* @param[out] reqId The request ID
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance has not been properly constructed.
+ * @exception E_INVALID_STATE This instance has not been constructed properly.
* @exception E_INVALID_ARG The specified @c insertMap is empty.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - Access is denied due to insufficient permission.
- * - The application using this method is not signed with the same certificate of provider application. @b Since: @b 2.1
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The access is denied due to insufficient permission.
+ * - The application using this method is not signed with the same certificate as that of the provider application. @b Since: @b 2.1
* @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
- * - The size of sending buffer has exceeded the maximum limit.
- * - The number of sending requests has exceeded the maximum limit.
+ * - The size of the sending buffer has exceeded the maximum limit.
+ * - The number of sending requests have exceeded the maximum limit.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The recommended data size is under 1MB because severe system performance degradation may occur for large messages. @c E_MAX_EXCEEDED may be returned for messages over 1MB size.\r
+ * @remarks The recommended data size is under 1MB because a severe system performance degradation may occur for larger messages. @n
+ * @c E_MAX_EXCEEDED may be returned for messages over 1MB.
*/
result Insert(const Tizen::Base::String& dataId, const Tizen::Base::Collection::IMap& insertMap, RequestId& reqId);
/**
- * Updates values of a table owned by an SQL-friendly interface based data control provider. @n
+ * Updates values of a table owned by the SQL-friendly interface based data control provider. @n
* The %Update() method is asynchronous.
- * For receiving the response from the data control provider, set the listener with
- * SqlDataControl::SetSqlDataControlResponseListener(). @n
+ * For receiving the response from the data control provider, set the listener using
+ * the SqlDataControl::SetSqlDataControlResponseListener() method. @n
* When the response has been received from the data control provider,
* the ISqlDataControlResponseListener::OnSqlDataControlUpdateResponseReceived() method is called.
*
* @since 2.0
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/datacontrol.consumer
*
* @return An error code
- * @param[in] dataId A string for identifying specific data, usually a database table to update @n
+ * @param[in] dataId The string that identifies the specific data, usually a database table to update @n
* The string consists of one or more components, separated by a slash('/').
* @param[in] updateMap The column-value pairs to update @n
- * The type of objects must be Tizen::Base::String class. @n\r
- * If the value is string, the value must be wrapped in\r
- * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.\r
- * For more information on the SQL statement, see SQLITE SQL documents.\r
- * @param[in] pWhere A filter to select desired rows to update @n
+ * The type of objects must be Tizen::Base::String @n
+ * If the value is a string, the value must be wrapped in single quotes,
+ * else it need not be wrapped in single quotes @n
+ * For more information on the SQL statement, see SQLITE SQL documents.
+ * @param[in] pWhere The filter to select the desired rows to update @n
* It is an SQL 'WHERE' clause excluding the 'WHERE' itself such as
- * column1 = 'stringValue' AND column2 = numericValue. @n\r
- * If the value is string, the value must be wrapped in\r
- * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.\r
- * For more information on the SQL statement, see SQLITE SQL documents.\r
+ * column1 = 'stringValue' AND column2 = numericValue @n
+ * If the value is a string, the value must be wrapped in single quotes,
+ * else it is not wrapped in single quotes @n
+ * For more information on the SQL statement, see SQLITE SQL documents.
* @param[out] reqId The request ID
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance has not been properly constructed.
+ * @exception E_INVALID_STATE This instance has not been constructed properly.
* @exception E_INVALID_ARG The specified @c updateMap is empty.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - Access is denied due to insufficient permission.
- * - The application using this method is not signed with the same certificate of provider application. @b Since: @b 2.1
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The access is denied due to insufficient permission.
+ * - The application using this method is not signed with the same certificate as that of the provider application. @b Since: @b 2.1
* @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
- * - The size of sending buffer has exceeded the maximum limit.
- * - The number of sending requests has exceeded the maximum limit.
+ * - The size of the sending buffer has exceeded the maximum limit.
+ * - The number of sending requests have exceeded the maximum limit.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The recommended data size is under 1MB because severe system performance degradation may occur for large messages. @c E_MAX_EXCEEDED may be returned for messages over 1MB size.\r
+ * @remarks The recommended data size is under 1MB because a severe system performance degradation may occur for larger messages. @n
+ * @c E_MAX_EXCEEDED may be returned for messages over 1MB.
*/
result Update(const Tizen::Base::String& dataId, const Tizen::Base::Collection::IMap& updateMap,
const Tizen::Base::String* pWhere, RequestId& reqId);
/**
- * Deletes rows of a table owned by an SQL-friendly interface based data control provider. @n
+ * Deletes rows of a table owned by the SQL-friendly interface based data control provider. @n
* The %Delete() method is asynchronous.
- * For receiving the response from the data control provider, set the listener with
- * SqlDataControl::SetSqlDataControlResponseListener(). @n
+ * For receiving the response from the data control provider, set the listener using
+ * the SqlDataControl::SetSqlDataControlResponseListener() method. @n
* When the response has been received from the data control provider,
* the ISqlDataControlResponseListener::OnSqlDataControlDeleteResponseReceived() method is called.
*
* @since 2.0
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/datacontrol.consumer
*
* @return An error code
- * @param[in] dataId A string for identifying specific data, usually a database table to delete from @n
+ * @param[in] dataId The string that identifies the specific data, usually a database table to delete from @n
* The string consists of one or more components, separated by a slash('/').
- * @param[in] pWhere A filter to select desired rows to delete @n
+ * @param[in] pWhere The filter to select the desired rows to delete @n
* It is an SQL 'WHERE' clause excluding the 'WHERE' itself such as
- * column1 = 'stringValue' AND column2 = numericValue.
- * If it is @c null, all rows are deleted. @n\r
- * If the value is string, the value must be wrapped in\r
- * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.\r
- * For more information on the SQL statement, see SQLITE SQL documents.\r
+ * column1 = 'stringValue' AND column2 = numericValue @n
+ * If it is @c null, all the rows are deleted @n
+ * If the value is a string, the value must be wrapped in single quotes,
+ * else it need not be wrapped in single quotes @n
+ * For more information on the SQL statement, see SQLITE SQL documents.
* @param[out] reqId The request ID
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance has not been properly constructed.
- * @exception E_INVALID_ARG A specified parameter is invalid.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - Access is denied due to insufficient permission.
- * - The application using this method is not signed with the same certificate of provider application. @b Since: @b 2.1
+ * @exception E_INVALID_STATE This instance has not been constructed properly.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The access is denied due to insufficient permission.
+ * - The application using this method is not signed with the same certificate as that of the provider application. @b Since: @b 2.1
* @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
- * - The size of sending buffer has exceeded the maximum limit.
- * - The number of sending requests has exceeded the maximum limit.
+ * - The size of the sending buffer has exceeded the maximum limit.
+ * - The number of sending requests have exceeded the maximum limit.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The recommended data size is under 16KB because severe system performance degradation may occur for large messages. @c E_MAX_EXCEEDED may be returned for messages over 16KB size.\r
+ * @remarks The recommended data size is under 16KB because a severe system performance degradation may occur for larger messages. @n
+ * @c E_MAX_EXCEEDED may be returned for messages over 16KB.
*/
result Delete(const Tizen::Base::String& dataId, const Tizen::Base::String* pWhere, RequestId& reqId);
*
* @return An error code
* @param[in] pListener The data control callback listener @n
- * Some data controls need to get the callback result by implementing
+ * Some data controls get the callback result by implementing
* the ISqlDataControlResponseListener interface.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance has not been properly constructed.
+ * @exception E_INVALID_STATE This instance has not been constructed properly.
* @exception E_SYSTEM A system error has occurred.
*/
result SetSqlDataControlResponseListener(ISqlDataControlResponseListener* pListener);
/**
* @file FAppTypes.h
- * @brief This is the header file for the enumerations of the App class.
+ * @brief This is the header file for the enumerations of the %App class.
*
- * This header file contains the declarations of the enumerations of the App class.
- * @see Application
+ * This header file contains the declarations of the enumerations of the App class.
*/
#ifndef _FAPP_TYPES_H_
/**
* @if OSPDEPREC
* The application secret
- * @brief <i> [Deprecated] </i>
+ * @brief <i> [Deprecated] </i>
* @deprecated This type is deprecated because the associated App::GetAppSecret() method is deprecated.
*
- * @since 2.0
+ * @since 2.0
* @endif
*/
typedef Tizen::Base::String AppSecret;
{
INITIALIZING, /**< The application has been launched */
RUNNING, /**< The application has been initialized and is currently being executed */
- TERMINATING, /**< The application is about to exit and releases its resources and saves its preferences */
- TERMINATED /**< The application has been destroyed */
+ TERMINATING, /**< The application is about to exit, release its resources, and save its preferences */
+ TERMINATED /**< The application has been destroyed */
};
/**
*/
enum AppUiState
{
- APP_UI_STATE_FOREGROUND = 0x01, /**< The application is completely visible on foreground */
+ APP_UI_STATE_FOREGROUND = 0x01, /**< The application is completely visible in the foreground */
APP_UI_STATE_PARTIAL_BACKGROUND = 0x02, /**< The application is partially hidden by another window, such as a system pop-up */
- APP_UI_STATE_BACKGROUND = 0x04 /**< The application is completely hidden by a full-screen window, usually by another application or an application control */
+ APP_UI_STATE_BACKGROUND = 0x04 /**< The application is completely hidden by a full-screen window, usually by another application, or an application control */
};
/**
{
APP_CTRL_RESULT_SUCCEEDED = 0x00, /**< The application operation is successful */
APP_CTRL_RESULT_FAILED = 0x01, /**< The application operation has failed */
- APP_CTRL_RESULT_CANCELED = 0x02, /**< The application operation is canceled by the callee application */
- APP_CTRL_RESULT_TERMINATED = 0x04, /**< The callee application is terminated without sending the result */
+ APP_CTRL_RESULT_CANCELED = 0x02, /**< The application operation is cancelled by the calling application */
+ APP_CTRL_RESULT_TERMINATED = 0x04, /**< The calling application is terminated without sending the result */
APP_CTRL_RESULT_ABORTED = 0x08, /**< The application operation is aborted by the platform */
};
/**
* @if OSPDEPREC
* The application launch request ID. @n
- * Represents the application launch arguments in App::App::OnUserEventReceivedN().
+ * Represents the application launch arguments in the App::App::OnUserEventReceivedN() method.
*
* @brief <i> [Deprecated] </i>
- * @deprecated This variable is deprecated. From %Tizen API version 2.1, App::App::OnUserEventReceivedN()
- * is not invoked for the request from application and %AppLaunchRequestId is not used anymore.
+ * @deprecated This variable is deprecated. From Tizen API version 2.1, the App::App::OnUserEventReceivedN()
+ * method is not invoked for the request from the application and the %AppLaunchRequestId() method is not used anymore.
* Instead, use IAppControlProviderEventListener.
- * @since 2.0
+ * @since 2.0
*
- * @see App::App::OnUserEventReceivedN()
* @endif
*/
const long AppLaunchRequestId = (-0xFFFF);
/**
* @if OSPDEPREC
- * Defines the launch type - normal launch.
+ * Defines the launch type, for example, normal launch.
*
- * @brief <i> [Deprecated] </i>
+ * @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* Instead of using this variable, it is recommended to use IAppControlProviderEventListener to acquire the launch information.
- * @since 2.0
+ * @since 2.0
* @endif
*/
_OSP_EXPORT_ extern const Tizen::Base::String APP_LAUNCH_NORMAL;
/**
* @if OSPDEPREC
- * Defines the launch type - conditional launch.
+ * Defines the launch type, for example, conditional launch.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
*
* @since 2.0
*
- * The %UiApp class is the base class of a %Tizen native UI application.
+ * The %UiApp class is the base class of a %Tizen native UI application.@n
* A %Tizen native UI application must inherit from the %UiApp class. This class provides the basic features necessary to define the
* %Tizen native UI application.
- * @n
+ *
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/app_namespace.htm">App Guide</a> and <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/tizen_app_model/application_model.htm">Native Application Model</a>.
*
*/
virtual ~UiApp(void);
/**
- * Gets the first frame in the frame list of the UI application.
+ * Gets the first frame to the frame list of the UI application.
*
- * @since 2.0
+ * @since 2.0
*
- * @return A pointer to the IAppFrame interface of the frame, @n
- * else @c null if it fails
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The frame has not been properly initialized.
- * @exception E_OBJ_NOT_FOUND The frame is not found.
+ * @return A pointer to the IAppFrame instance of the frame, @n
+ * else @c null if it fails
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE The frame has not been initialized properly.
+ * @exception E_OBJ_NOT_FOUND The frame has not been found.
*/
IAppFrame* GetAppFrame(void) const;
/**
- * Adds the frame to the end of the list that is maintained by the UI application.
+ * Adds a frame to the end of the list that is maintained by the UI application.
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] frame The frame that is added to the UI application
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] frame The frame to remove
* @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c frame cannot be found.
/**
* Gets the list of the frames of the UI application.
*
- * @since 2.0
+ * @since 2.0
*
- * @return A pointer to Tizen::Base::Collection::IList that contains Tizen::Ui::Frame instances, @n
- * else @c null if it fails
+ * @return A pointer to the Tizen::Base::Collection::IList that contains the Tizen::Ui::Frame instances, @n
+ * else @c null if it fails
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The application is in an invalid state.
* @remarks The specific error code can be accessed using the GetLastResult() method.
/**
* Gets the frame with the specified @c name.
*
- * @since 2.0
+ * @since 2.0
*
- * @return A pointer to the frame having the specified @c name, @n
- * else @c null if it fails
+ * @return A pointer to the frame that contains the specified @c name, @n
+ * else @c null if it fails
* @param[in] name The name of the frame
* @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c frame cannot be found.
Tizen::Ui::Controls::Frame* GetFrame(const Tizen::Base::String& name) const;
/**
- * Gets the frame at the specified @c index of the list.
+ * Gets the frame at the specified @c index in the list.
*
- * @since 2.0
+ * @since 2.0
*
- * @return A pointer to the frame at the specified @c index, @n
- * else @c null if it fails
+ * @return A pointer to the frame at the specified @c index, @n
+ * else @c null if it fails
* @param[in] index The index of the frame
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_RANGE The specified @c index is outside the bounds of the frame list.
* @since 2.0
*
* @return The UI state of the UI application
- * @remarks Note that UiApp::OnBackground() is invoked when the UI state of a UI application changes
- * from App::APP_UI_STATE_FOREGROUND to App::APP_UI_STATE_PARTIAL_BACKGROUND or App::APP_UI_STATE_BACKGROUND.
+ * @remarks Note that the UiApp::OnBackground() method is invoked when the UI state of the UI application changes
+ * from App::APP_UI_STATE_FOREGROUND to App::APP_UI_STATE_PARTIAL_BACKGROUND, or App::APP_UI_STATE_BACKGROUND.
*/
AppUiState GetAppUiState(void) const;
/**
- * Called when a UI application moves to the foreground. @n
+ * Called when the UI application moves to the foreground. @n
* User interaction is enabled when the UI application moves to the foreground. @n
* A UI application moves to the foreground when:
*
- * - A UI application is selected from the Task Switcher.
- * - A UI application icon in the Launcher application is pressed when it is running in the background.
- * - A UI application is to be launched while it is running in the background.
- * - A system pop-up, such as an incoming call, notification (for example, SMS), or a low battery warning
- * pop-up disappears.
+ * - The UI application is selected from the Task Switcher.
+ * - The UI application icon in the Launcher application is pressed when it is running in the background.
+ * - The UI application is to be launched while it is running in the background.
+ * - A system pop-up, such as an incoming call, a notification (for example, an SMS), or a low battery warning
+ * pop-up disappears.
*
- * When this method is invoked, the following actions are recommended:
+ * When the %OnForeground() method is invoked, the following actions are recommended:
*
* - Resume the graphic processing, such as 3D or animation, as the UI application now has the focus.
* - Resume the operations that stopped when the UI application is last moved to the background.
* A UI application moves to the background when:
*
* - A system pop-up, such as an incoming call or a low battery warning pop-up is displayed.
- * - A device is locked.
+ * - The device is locked.
* - The Home key is pressed.
*
- * Whenever this method is invoked, the following actions are recommended:
+ * When the %OnBackground() method is invoked, the following actions are recommended:
*
* - Stop the graphic processing, such as 3D or animation, as they will not be displayed.
* - Release unnecessary resources.
*
* @since 2.0
*
- * @remarks When notification (for example, SMS) pops up, this method is not called.
- * When a system pop-up is displayed, a UI application becomes partially hidden
- * (App::APP_UI_STATE_PARTIAL_BACKGROUND).
- * If a UI application is partially hidden, it is recommended to hold the activated
- * tasks or resources instead of stopping or releasing them.
+ * @remarks
+ * - When a notification (for example, an SMS) pops up, this method is not called.
+ * - When a system pop-up is displayed, the UI application becomes partially hidden (App::APP_UI_STATE_PARTIAL_BACKGROUND).
+ * - If the UI application is partially hidden, it is recommended to hold the activated tasks or resources instead of stopping or releasing them.
* @see GetAppUiState()
*/
virtual void OnBackground(void);
/**
- * Gets the %UiApp instance's pointer.
+ * Gets a pointer to the %UiApp instance.
*
* @since 2.0
*
/**
* Executes an application implemented by inheriting this class.
- * The %Execute() method must be called from the entry method - OspMain(), which is generated by IDE.
+ * The %Execute() method must be called from the entry method, that is, OspMain(), which is generated by IDE.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] pUiAppFactory The factory method that creates this UiApp's instance
- * @param[in] pArguments The launch arguments for %App
+ * @return An error code
+ * @param[in] pUiAppFactory The factory method that creates this UiApp instance
+ * @param[in] pArguments The launch arguments for the application
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INIT_FAILED The initialization failure during OnAppInitializing().
+ * @exception E_INIT_FAILED A failure occurred while initializing using the OnAppInitializing() method.
* @exception E_SYSTEM A system error has occurred.
*/
static result Execute(UiAppInstanceFactory pUiAppFactory, const Tizen::Base::Collection::IList* pArguments);
//
/**
- * @file FBase.h
- * @brief This is the header file for the %Base namespace.
+ * @file FBase.h
+ * @brief This is the header file for the %Base namespace.
*
* This header file contains the declarations and descriptions of the %Base namespace.
*/
* @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FBase.h> @n
- * @b Library : @b osp-appfw
+ * @b Library: @b osp-appfw
*
* The %Base namespace contains classes and interfaces around which the entire %Tizen platform is built.
* The main features of the namespace include basic data types, collections, runtime libraries, and various utilities.
*
* For more information on the %Base namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/base/base_namespace.htm">Base Guide</a>.
*
- * The following diagram illustrates the relationships between the classes belonging to the %Base namespace.
- * @image html base_namespace_classdiagram.png
+ * The following diagram illustrates the relationships between the classes belonging to the %Base namespace.
+ * @image html base_namespace_classdiagram.png
*
*
*
* @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FBase.h> @n
- * @b Library : @b osp-appfw
+ * @b Library: @b osp-appfw
*
* The %Collection namespace contains classes and interfaces for various collections
* (such as lists, maps, stacks, and queues), which are an aggregation of similar objects.
*
- * For more information on the %Base::Collection namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/base/collection_namespace.htm">Collection</a>.
+ * For more information on the %Collection namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/base/collection_namespace.htm">Collection</a>.
*
* The following diagrams illustrate the relationships between the classes belonging to the %Collection namespace.
*
*
* @since 2.0
*
- * @remarks
- * An enumerator remains valid as long as the collection remains unchanged.
- * If changes are made to the collection, such as adding, modifying, or
- * deleting elements, the enumerator is irrecoverably invalidated. The next call to GetCurrent(), MoveNext(), MovePrevious(), Reset(), or ResetLast() fails (E_INVALID_OPERATION).
+ * @remarks An enumerator remains valid as long as the collection remains unchanged.@n
+ * If changes are made to the collection, such as adding, modifying, or
+ * deleting elements, the enumerator is irrecoverably invalidated. @n
+ * The next call to GetCurrent(), MoveNext(), MovePrevious(), Reset(), or ResetLast() fails (@c E_INVALID_OPERATION).
*
* The %IBidirectionalEnumeratorT interface supports a bidirectional iteration over a collection.
* One can only access the elements in a collection through %IBidirectionalEnumeratorT. The elements cannot be modified through this interface.
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_RANGE The enumerator has passed the front of the collection.
- * @exception E_INVALID_OPERATION The current state of the instance prohibits the execution of the specified operation, or
- * the collection is modified after the enumerator is created.
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The current state of the instance prohibits the execution of the specified operation, or
+ * - The collection is modified after the enumerator is created.
* @see Tizen::Base::Collection::IEnumeratorT< Type >::MoveNext()
- * @see ResetLast()
*/
virtual result MovePrevious(void) = 0;
*
* @return An error code
* @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 collection is modified after the enumerator is created.
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The current state of the instance prohibits the execution of the specified operation.
+ * - The collection is modified after the enumerator is created.
* @see Tizen::Base::Collection::IEnumeratorT< Type >::Reset()
* @see MovePrevious()
*/
{
/**
* @interface IComparerT
- * @brief This interface allows derived classes to compare 2 template-based objects of the same type.
+ * @brief This interface allows derived classes to compare two template-based objects of the same type.
*
* @since 2.0
*
- * The %IComparerT interface allows derived classes to compare 2 template-based objects of the
+ * The %IComparerT interface allows derived classes to compare two template-based objects of the
* same type.
*/
template< class Type >
* @return An error code
* @param[in] obj1 The first object to compare
* @param[in] obj2 The second object to compare
- * @param[out] cmp The result of comparison
+ * @param[out] cmp The result of the comparison
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified object instances are not of the expected type.
* @remarks The value of @c cmp can be:
*
* @code
- * < 0 if the value of @c obj1 is less than the value of @c obj2
- * == 0 if the value of @c obj1 is equal to the value of @c obj2
- * > 0 if the value of @c obj1 is greater than the value of @c obj2
+ * < 0 if the value of obj1 is less than the value of obj2
+ * == 0 if the value of obj1 is equal to the value of obj2
+ * > 0 if the value of obj1 is greater than the value of obj2
* @endcode
*/
virtual result Compare(const Type& obj1, const Type& obj2, int& cmp) const = 0;
*
* @since 2.0
*
- * @remarks
- * An enumerator remains valid as long as the collection remains unchanged.
- * If changes are made to the collection, such as adding, modifying, or
- * deleting elements, the enumerator is irrecoverably invalidated. The next call to GetCurrent(), MoveNext(), or Reset() fails and returns
- * E_INVALID_OPERATION.
+ * @remarks An enumerator remains valid as long as the collection remains unchanged. @n
+ * If changes are made to the collection, such as adding, modifying, or
+ * deleting elements, the enumerator is irrecoverably invalidated. @n
+ * The next call to GetCurrent(), MoveNext(), or Reset() fails and returns
+ * @c E_INVALID_OPERATION.
*
* The %IEnumerator interface supports simple iteration over a collection.
* One can only access the elements in a collection through %IEnumerator. The elements cannot be modified through this interface.
* @return The current object in the collection, @n
* else @c null if an exception occurs
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_OPERATION Either of the following conditions has occurred: @n
- * - The current state of the instance prohibits the execution of the specified operation. @n
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The current state of the instance prohibits the execution of the specified operation.
* - The enumerator is currently positioned before the first element
- * or after the last element. @n
+ * or after the last element.
* - The collection is modified after the enumerator is created.
* @remarks The specific error code can be accessed using the GetLastResult() method.
- * @see GetLastResult()
*/
virtual Tizen::Base::Object* GetCurrent(void) const = 0;
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_RANGE The enumerator has passed the end of the collection.
- * @exception E_INVALID_OPERATION The current state of the instance prohibits the execution of the specified operation, or
- * the collection is modified after the enumerator is created.
- * @see Reset()
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The current state of the instance prohibits the execution of the specified operation.
+ * - The collection is modified after the enumerator is created.
*/
virtual result MoveNext(void) = 0;
*
* @return An error code
* @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 collection is modified after the enumerator is created.
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The current state of the instance prohibits the execution of the specified operation.
+ * - The collection is modified after the enumerator is created.
*/
virtual result Reset(void) = 0;
*
* @since 2.0
*
- * @remarks
- * An enumerator remains valid as long as the collection remains unchanged.
- * If changes are made to the collection, such as adding, modifying, or
- * deleting elements, the enumerator is irrecoverably invalidated. The next call to GetCurrent(), MoveNext(), or Reset() fails and returns
- * E_INVALID_OPERATION.
+ * @remarks An enumerator remains valid as long as the collection remains unchanged. @n
+ * If changes are made to the collection, such as adding, modifying, or
+ * deleting elements, the enumerator is irrecoverably invalidated. @n
+ * The next call to GetCurrent(), MoveNext(), or Reset() fails and returns
+ * @c E_INVALID_OPERATION.
*
* The %IEnumeratorT interface supports simple iteration over a template-based collection.
* One can only access the elements in a collection through %IEnumeratorT. The elements cannot be modified through this interface.
* @since 2.0
*
* @return An error code
- * @param[out] obj A pointer to the current object
+ * @param[out] obj A pointer to the current object
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_OPERATION The current state of the instance prohibits the execution of the specified operation. @n
- * The enumerator is currently positioned before the first element or
- * after the last element or the collection is modified after the enumerator is created.
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The current state of the instance prohibits the execution of the specified operation.
+ * - The enumerator is currently positioned before the first element or
+ * after the last element.
+ * - The collection is modified after the enumerator is created.
*/
virtual result GetCurrent(Type& obj) const = 0;
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_RANGE The enumerator has passed the end of the collection.
- * @exception E_INVALID_OPERATION The current state of the instance prohibits the execution of the specified operation, or
- * the collection is modified after the enumerator is created.
- * @see Reset()
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The current state of the instance prohibits the execution of the specified operation.
+ * - The collection is modified after the enumerator is created.
*/
virtual result MoveNext(void) = 0;
*
* @return An error code
* @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 collection is modified after the enumerator is created.
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The current state of the instance prohibits the execution of the specified operation.
+ * - The collection is modified after the enumerator is created.
*/
virtual result Reset(void) = 0;
/**
* @interface IHashCodeProviderT
- * @brief This interface represents classes that can provide the hash code of a specific type of template-based object.
+ * @brief This interface represents classes that provide the hash code of a specific type of template-based object.
*
* @since 2.0
*
- * The %IHashCodeProviderT interface represents classes that can provide the hash code of a specific type of template-based object.
+ * The %IHashCodeProviderT interface represents classes that provide the hash code of a specific type of template-based object.
*
*/
template< class Type >
* @since 2.0
*
* @return The hash code of the specified object
- * @param[in] obj A pointer to the object for which the hash code is required
- * @remarks The hash algorithm is usually specific to a type. @n
- * Two equal instances must return the same hash value.
- * For better performance, the used hash function must generate a random distribution for all inputs.
+ * @param[in] obj A pointer to the object whose hash code is required
+ * @remarks
+ * - The hash algorithm is usually of a specific type.
+ * - Two equal instances must return the same hash value. @n
+ * For better performance, the used hash function must generate a random distribution for all the inputs.
*/
virtual int GetHashCode(const Type& obj) const = 0;
*
* @since 2.0
*
- * @param[in] key The key
+ * @param[in] key The key
* @param[in] value The value
*/
MapEntry(const Object& key, const Object& value);
virtual Object* GetValue(void);
/**
- * Compares the value of the given Object to the
+ * Compares the value of the given Tizen::Base::Object to the
* value of the calling object.
*
* @since 2.0
* @return @c true if the values are equal, @n
* else @c false
* @param[in] obj The object to compare with the calling object
- * @remarks Returns @c false if the given object is not a %MapEntry object.
+ * @remarks This method returns @c false if the given object is not a %MapEntry object.
*/
virtual bool Equals(const Object& obj) const;
* @since 2.0
*
* @return The hash value of the current instance
- * @remarks The two Tizen::Base::Object::Equals() instances must return the same hash value. For better performance, @n
- * the used hash function must generate a random distribution for all inputs.
+ * @remarks The two Tizen::Base::Object::Equals() instances must return the same hash value. @n
+ * For better performance, the used hash function must generate a random distribution for all the inputs.
*/
virtual int GetHashCode(void) const;
* @since 2.0
*
* @return The hash value of the current instance
- * @remarks The two Tizen::Base::Object::Equals() instances must return the same hash value. For better performance, @n
- * the used hash function must generate a random distribution for all inputs.
+ * @remarks The two Tizen::Base::Object::Equals() instances must return the same hash value. @n
+ * For better performance, the used hash function must generate a random distribution for all the inputs.
*/
virtual int GetHashCode(void) const
{
}
/**
- * Gets an ArrayList instance from the begin and end iterators of STL container.
+ * Gets an ArrayList instance from the begin and end iterators of the STL container.
*
* @since 2.1
*
* @return A std::unique_ptr to the ArrayList instance, @n
- * else @c std::unique_ptr< ArrayList >() if error occurs
- * @param[in] begin begin() of STL container
- * @param[in] end end() of STL container
- * @param[in] deleter The function pointer to type of the element deleter
+ * else @c std::unique_ptr< ArrayList >() if an error occurs
+ * @param[in] begin begin() of the STL container
+ * @param[in] end end() of the STL container
+ * @param[in] deleter A function pointer to the type of the element deleter
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @remarks To create an owning collection, set the element deleter value as @c SingleObjectDeleter.
- * This gives the collection the ownership of elements and the collection can destroy elements. @n
- * On the other hand, to create a non-owning collection, you don't need to set the element deleter value,
- * as @c NoOpDeleter is the default element deleter.
- * That implies transfer of the ownership of elements to the collection is not required.
- * @remarks The specific error code can be accessed using GetLastResult() method.
+ * @remarks
+ * - To create an owning collection, set the element deleter value as @c SingleObjectDeleter. @n
+ * This gives the collection the ownership of the elements and the collection can destroy the elements. @n
+ * On the other hand, to create a non-owning collection, do not set the element deleter value,
+ * as @c NoOpDeleter is the default element deleter. @n
+ * This implies that the transfer of the ownership of the elements to the collection is not required.
+ * - The specific error code can be accessed using GetLastResult() method.
* @see NoOpDeleter()
* @see SingleObjectDeleter()
* @see ArrayDeleter()
}
/**
- * Gets a LinkedList instance from the begin and end iterators of STL container.
+ * Gets a LinkedList instance from the begin and end iterators of the STL container.
*
* @since 2.1
*
* @return A std::unique_ptr to the LinkedList instance @n
- * else @c std::unique_ptr< LinkedList >() if error occurs
- * @param[in] begin begin() of STL container
- * @param[in] end end() of STL container
- * @param[in] deleter The function pointer to type of the element deleter
+ * else @c std::unique_ptr< LinkedList >() if an error occurs
+ * @param[in] begin begin() of the STL container
+ * @param[in] end end() of the STL container
+ * @param[in] deleter A function pointer to the type of the element deleter
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @remarks To create an owning collection, set the element deleter value as @c SingleObjectDeleter.
- * This gives the collection the ownership of elements and the collection will destroy elements. @n
- * On the other hand, to create a non-owning collection, you don't need to set the element deleter value,
- * as @c NoOpDeleter is the default element deleter.
- * That implies transfer of the ownership of elements to the collection is not required.
- * @remarks The specific error code can be accessed using GetLastResult() method.
+ * @remarks
+ * - To create an owning collection, set the element deleter value as @c SingleObjectDeleter. @n
+ * This gives the collection the ownership of the elements and the collection can destroy the elements. @n
+ * On the other hand, to create a non-owning collection, do not set the element deleter value,
+ * as @c NoOpDeleter is the default element deleter. @n
+ * This implies that the transfer of the ownership of the elements to the collection is not required.
+ * - The specific error code can be accessed using GetLastResult() method.
* @see NoOpDeleter()
* @see SingleObjectDeleter()
* @see ArrayDeleter()
}
/**
- * Gets a HashMap instance from the begin and end iterators of STL container.
+ * Gets a HashMap instance from the begin and end iterators of the STL container.
*
* @since 2.1
*
* @return A std::unique_ptr to the HashMap instance @n
- * else @c std::unique_ptr< HashMap >() if error occurs
- * @param[in] begin begin() of STL container
- * @param[in] end end() of STL container
- * @param[in] deleter The function pointer to type of the element deleter
+ * else @c std::unique_ptr< HashMap >() if an error occurs
+ * @param[in] begin begin() of the STL container
+ * @param[in] end end() of the STL container
+ * @param[in] deleter A function pointer to the type of the element deleter
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @remarks To create an owning collection, set the element deleter value as @c SingleObjectDeleter.
- * This gives the collection the ownership of elements and the collection will destroy elements. @n
- * On the other hand, to create a non-owning collection, you don't need to set the element deleter value,
- * as @c NoOpDeleter is the default element deleter.
- * That implies transfer of the ownership of elements to the collection is not required.
- * @remarks The specific error code can be accessed using GetLastResult() method.
+ * @remarks
+ * - To create an owning collection, set the element deleter value as @c SingleObjectDeleter. @n
+ * This gives the collection the ownership of the elements and the collection can destroy the elements. @n
+ * On the other hand, to create a non-owning collection, do not set the element deleter value,
+ * as @c NoOpDeleter is the default element deleter. @n
+ * This implies that the transfer of the ownership of the elements to the collection is not required.
+ * - The specific error code can be accessed using GetLastResult() method.
* @see NoOpDeleter()
* @see SingleObjectDeleter()
* @see ArrayDeleter()
}
/**
- * Gets a MultiHashMap instance from the begin and end iterators of STL container.
+ * Gets a MultiHashMap instance from the begin and end iterators of the STL container.
*
* @since 2.1
*
* @return A std::unique_ptr to the MultiHashMap instance @n
- * else @c std::unique_ptr< MultiHashMap >() if error occurs
- * @param[in] begin begin() of STL container
- * @param[in] end end() of STL container
- * @param[in] deleter The function pointer to type of the element deleter
+ * else @c std::unique_ptr< MultiHashMap >() if an error occurs
+ * @param[in] begin begin() of the STL container
+ * @param[in] end end() of the STL container
+ * @param[in] deleter A function pointer to the type of the element deleter
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @remarks To create an owning collection, set the element deleter value as @c SingleObjectDeleter.
- * This gives the collection the ownership of elements and the collection will destroy elements. @n
- * On the other hand, to create a non-owning collection, you don't need to set the element deleter value,
- * as @c NoOpDeleter is the default element deleter.
- * That implies transfer of the ownership of elements to the collection is not required.
- * @remarks The specific error code can be accessed using GetLastResult() method.
+ * @remarks
+ * - To create an owning collection, set the element deleter value as @c SingleObjectDeleter. @n
+ * This gives the collection the ownership of the elements and the collection can destroy the elements. @n
+ * On the other hand, to create a non-owning collection, do not set the element deleter value,
+ * as @c NoOpDeleter is the default element deleter. @n
+ * This implies that the transfer of the ownership of the elements to the collection is not required.
+ * - The specific error code can be accessed using GetLastResult() method.
* @see NoOpDeleter()
* @see SingleObjectDeleter()
* @see ArrayDeleter()
* @brief This is the header file for the element deleter.
*
* This header file contains the declarations of the element deleter.
- * Depending on the element deleter, collection decides whether to remove the object or not.
+ * Depending on the element deleter, the collection decides whether to remove the object or not.
*/
#ifndef _FBASE_COL_TYPES_H_
#define _FBASE_COL_TYPES_H_
typedef void (*DeleterFunctionType)(Object* pObj);
/**
- * This function does not remove the object.
+ * Does not remove the object.
*
* @since 2.0
*
- * @param[in] pObj The pointer to the object to remove
+ * @param[in] pObj A pointer to the object to remove
*/
_OSP_EXPORT_ void NoOpDeleter(Object* pObj);
/**
- * This function removes the single object.
+ * Removes the single object.
*
* @since 2.0
*
- * @param[in] pObj The pointer to the object to remove
+ * @param[in] pObj A pointer to the object to remove
*/
_OSP_EXPORT_ void SingleObjectDeleter(Object* pObj);
/**
- * This function removes the array object.
+ * Removes the array object.
*
* @since 2.0
*
- * @param[in] pObj The pointer to the object to remove
+ * @param[in] pObj A pointer to the object to remove
*/
_OSP_EXPORT_ void ArrayDeleter(Object* pObj);
/**
* @class ComparerT
*
- * @brief This class checks for equivalence between 2 values of the same primitive type.
+ * @brief This class checks for equivalence between two values of the same primitive type.
* @since 2.0
*
- * The %ComparerT class checks for equivalence between 2 values of the same primitive type.
+ * The %ComparerT class checks for equivalence between two values of the same primitive type.
*
* The following example demonstrates how to use the %ComparerT class.
*
* @since 2.0
*
* @return An error code
- * @param[in] obj1 The first object to compare
- * @param[in] obj2 The second object to compare
- * @param[out] cmp The result of comparison
+ * @param[in] obj1 The first object to compare
+ * @param[in] obj2 The second object to compare
+ * @param[out] cmp The result of the comparison
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified objects are not of the expected type.
* @remarks @c cmp can take one of the following values:
* @code
- * < 0 if the value of @c obj1 is less than the value of @c obj2
- * == 0 if the value of @c obj1 is equal to the value of @c obj2
- * > 0 if the value of @c obj1 is greater than the value of @c obj2
+ * < 0 if the value of obj1 is less than the value of obj2
+ * == 0 if the value of obj1 is equal to the value of obj2
+ * > 0 if the value of obj1 is greater than the value of obj2
* @endcode
*/
virtual result Compare(const Type& obj1, const Type& obj2, int& cmp) const
virtual ~ComparerT(void) { }
/**
- * Compare two String instances.
+ * Compares two String instances.
*
* @since 2.1
*
- * @return Always returns E_SUCCESS
+ * @return Always returns @c E_SUCCESS
* @param[in] str1 The String instance to compare
* @param[in] str2 The String instance to compare
- * @param[in] cmp An integer value for result
+ * @param[in] cmp The integer value for the result
*/
virtual result Compare(const Tizen::Base::String& str1, const Tizen::Base::String& str2, int& cmp) const
{
/**
* @file FBaseErrorDefine.h
- * @brief This header file defines common error codes.
+ * @brief This header file defines the common error codes.
*
- * This header file contains the definitions of error codes.
+ * This header file contains the definitions of the common error codes.
*/
#ifndef _FBASE_ERROR_DEFINE_H_
#define _FBASE_ERROR_DEFINE_H_
/**
* @defgroup GroupMacros Debugging Macros
*
- * This page describes Tizen debugging macros.
+ * This page describes the Tizen debugging macros.
*
* @since 2.0
*/
* @{
*/
/**
- * This macro allows display of arbitrary messages for future examination.
+ * This macro allows the display of arbitrary messages for future examination.
*
* @since 2.0
*
* @since 2.0
*
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] ... The message to display
*
* The following example demonstrates how to use the Try macro.
* @since 2.0
*
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
/**
* If the condition is @c false, it prints a message, sets the last result, evaluates a cleanup expression
-* and goes to label.
+* and goes to the catch label.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
-* @param[in] expr Expressions that are evaluated before going to catchLabel
-* @param[in] catchLabel The label for goto operation
+* @param[in] expr Expressions that are evaluated before going to the CATCH label
+* @param[in] catchLabel The label for the goto operation
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
else {;}
/**
- * If the condition is @c false, the message is printed and a value is returned.
+ * If the condition is @c false, a message is printed and a value is returned.
*
* @since 2.0
*
else {;}
/**
- * If the condition is @c false, the message is printed, sets the last result and a value is returned.
+ * If the condition is @c false, a message is printed, the last result is set and a value is returned.
*
* @since 2.0
*
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
- * @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] r The last result to set
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryReturnResult(condition, returnValue, r, ...) \
else {;}
/**
- * If the condition is @c false, the message is printed, sets the last result and no value is returned.
+ * If the condition is @c false, a message is printed, the last result is set and no value is returned.
*
* @since 2.0
*
else {;}
/**
- * If the condition is @c false, the message is printed and no value is returned.
+ * If the condition is @c false, a message is printed and no value is returned.
*
* @since 2.0
*
else {;}
/**
- * If the condition is @c false, the message is printed.
+ * If the condition is @c false, a message is printed.
*
* @since 2.0
*
else {;}
/**
-* If the condition is @c false, the informative log message is printed and a value is returned.
+* If the condition is @c false, an informative log message is printed and a value is returned.
*
* @since 2.1
*
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] ... The message to display
* @hideinitializer
*/
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
/**
* If the condition is @c false, it prints a message with a tag, sets the last result, evaluates a cleanup expression
-* and goes to label.
+* and goes to the catch label.
*
* @since 2.1
*
-* @param[in] tag Used to identify the source of a log message
+* @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
-* @param[in] expr Expressions that are evaluated before going to catchLabel
-* @param[in] catchLabel The label for goto operation
+* @param[in] expr Expressions that are evaluated before going to the CATCH label
+* @param[in] catchLabel The label for the goto operation
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
else {;}
/**
- * If the condition is @c false, the message is printed with a tag and a value is returned.
+ * If the condition is @c false, a message is printed with a tag and a value is returned.
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
* @param[in] ... The message to display
else {;}
/**
- * If the condition is @c false, the message is printed with a tag, sets the last result and a value is returned.
+ * If the condition is @c false, it prints a message with a tag, sets the last result and returns a value.
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
* @param[in] r The last result to set
else {;}
/**
- * If the condition is @c false, the message is printed with a tag, sets the last result and no value is returned.
+ * If the condition is @c false, it prints a message with a tag, sets the last result and does not return any value.
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] r The last result to set
* @param[in] ... The message to display
else {;}
/**
- * If the condition is @c false, the message is printed with a tag and no value is returned.
+ * If the condition is @c false, a message is printed with a tag and no value is returned.
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] ... The message to display
* @hideinitializer
else {;}
/**
- * If the condition is @c false, the message is printed with a tag.
+ * If the condition is @c false, a message is printed with a tag.
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] ... The message to display
* @hideinitializer
else {;}
/**
-* If the condition is @c false, the informative log message is printed with a tag and a value is returned.
+* If the condition is @c false, an informative log message is printed with a tag and a value is returned.
*
* @since 2.1
*
-* @param[in] tag Used to identify the source of a log message
+* @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
* @param[in] ... The message to display
#else
/**
- * This macro is to protect informative log messages which needs to keep security.
- * It allows display of informative log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect informative log messages which need security.
+ * It allows the display of informative log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
#define AppSecureLog(...)
/**
- * This macro is to protect debug log messages which needs to keep security.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect debug log messages which need security.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
#define AppSecureLogDebug(...)
/**
- * This macro is to protect exception log messages which needs to keep security.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect exception log messages which need security.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
#define AppSecureLogException(...)
/**
- * This macro is to protect informative log messages which needs to keep security, with a tag.
- * It allows display of informative log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect informative log messages which need security, with a tag.
+ * It allows the display of informative log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
#define AppSecureLogTag(tag, ...)
/**
- * This macro is to protect debug log messages which needs to keep security, with a tag.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect debug log messages which need security, with a tag.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
#define AppSecureLogDebugTag(tag, ...)
/**
- * This macro is to protect exception log messages which needs to keep security, with a tag.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect exception log messages which need security, with a tag.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
/**
* If the condition is @c false, it prints a message, evaluates a cleanup expression,
* and goes to <tt>CATCH</tt>.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] ... The message to display
*
* The following example demonstrates how to use the SecureTry macro.
/**
* If the condition is @c false, it prints a message, sets the last result, evaluates a cleanup expression
* and goes to <tt>CATCH</tt>.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
/**
* If the condition is @c false, it prints a message, sets the last result, evaluates a cleanup expression
- * and goes to label.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * and goes to the catch label.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to catchLabel
- * @param[in] catchLabel The label for goto operation
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] catchLabel The label for the goto operation
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
else {;}
/**
- * If the condition is @c false, the message is printed and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
else {;}
/**
- * If the condition is @c false, the message is printed, sets the last result and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, it prints a message, sets the last result and returns a value.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
else {;}
/**
- * If the condition is @c false, the message is printed, sets the last result and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed, the last result is set and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
else {;}
/**
- * If the condition is @c false, the message is printed and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
else {;}
/**
- * If the condition is @c false, the message is printed.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
else {;}
/**
- * If the condition is @c false, the informative log message is printed and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, an informative log message is printed and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
/**
* If the condition is @c false, it prints a message with a tag, evaluates a cleanup expression
* and goes to <tt>CATCH</tt>.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] ... The message to display
* @hideinitializer
*/
/**
* If the condition is @c false, it prints a message with a tag, sets the last result, evaluates a cleanup expression,
* and goes to <tt>CATCH</tt>.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
/**
* If the condition is @c false, it prints a message with a tag, sets the last result, evaluates a cleanup expression
- * and goes to label.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * and goes to the catch label.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to catchLabel
- * @param[in] catchLabel The label for goto operation
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] catchLabel The label for the goto operation
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
else {;}
/**
- * If the condition is @c false, the message is printed with a tag and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
* @param[in] ... The message to display
else {;}
/**
- * If the condition is @c false, the message is printed with a tag, sets the last result and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag, the last result is set and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
* @param[in] r The last result to set
else {;}
/**
- * If the condition is @c false, the message is printed with a tag, sets the last result and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag, the last result is set and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] r The last result to set
* @param[in] ... The message to display
else {;}
/**
- * If the condition is @c false, the message is printed with a tag and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] ... The message to display
* @hideinitializer
else {;}
/**
- * If the condition is @c false, the message is printed with a tag.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] ... The message to display
* @hideinitializer
else {;}
/**
- * If the condition is @c false, the informative log message is printed with a tag and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, an informative log message is printed with a tag and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
* @param[in] ... The message to display
* @return @c true if the value of the specified instance of %Object is equal to the value of the current instance of %Object, @n
* else @c false
* @param[in] obj An instance of %Object to compare
- * @remarks The default implementation of this method returns @c true
- * if the two instances have the same address. @n
- * The method can be overridden to support value equality. Furthermore, this method must return the same result as the equality operator.
+ * @remarks
+ * - The default implementation of this method returns @c true,
+ * if the two instances have the same address.
+ * - The method can be overridden to support value equality.
+ * Furthermore, this method must return the same result as the equality operator.
*/
virtual bool Equals(const Object& obj) const;
*
* @since 2.0
*
- * @return An integer value indicating the hash value of the current instance of %Object
- * @remarks Two equal instances must return the same hash value. For better performance,
- * the used hash function must generate a random distribution for all inputs. @n
- * The default implementation of this method returns the address of the current instance.
+ * @return The integer value that indicates the hash value of the current instance of %Object
+ * @remarks
+ * - Two equal instances must return the same hash value. @n
+ * For better performance, the used hash function must generate a random distribution for all the inputs.
+ * - The default implementation of this method returns the address of the current instance.
*/
virtual int GetHashCode(void) const;
* @file FBaseResult.h
* @brief This is the header file for the %Result class.
*
- * This header file contains the declaration of the %Result class.
+ * This header file contains the declarations of the %Result class.
*/
#ifndef _FBASE_RESULT_H_
#define _FBASE_RESULT_H_
_OSP_EXPORT_ result TransExceptionsInclusiveInternal(result r, result e, int num, ...);
-#define NUMARGS(...) (sizeof((result[]){0, ## __VA_ARGS__} \
- ) / sizeof(result) - 1)
+#define NUMARGS(...) (sizeof((result[]){0, ##__VA_ARGS__}) / sizeof(result) - 1)
/**
-* This macro returns translated exception when the checked exception doesn't correspond with the conditional exceptions.
-* In contrast, this macro returns the checked exception if it corresponds with the conditional exceptions.
+* This macro returns a translated exception when the checked exception does not correspond to the conditional exceptions.
+* In contrast, this macro returns a checked exception if it corresponds to the conditional exceptions.
*
* @since 2.0
*
* @return The translated exception
-* @param[in] r The result that will be checked
+* @param[in] r The result that is checked
* @param[in] e The translated exception
-* @param[in] ... The list of exceptions that will be excluded in translation process @n
-* All other exceptions than this list will be translated into @c e.
+* @param[in] ... The list of exceptions that are excluded from the translation process @n
+* All the exceptions other than this list are translated into @c e.
*
*
*/
/**
-* This macro returns translated exception when the checked exception corresponds with the conditional exceptions.
-* In contrast, this macro returns the checked exception if it doesn't correspond with the conditional exceptions.
+* This macro returns a translated exception when the checked exception corresponds to the conditional exceptions.
+* In contrast, this macro returns a checked exception if it does not correspond to the conditional exceptions.
*
* @since 2.0
*
* @return The translated exception
-* @param[in] r The result that will be checked
+* @param[in] r The result that is checked
* @param[in] e The translated exception
-* @param[in] ... The list of exceptions that will be included in translation process @n
-* All exceptions in this list will be translated into @c e.
+* @param[in] ... The list of exceptions that are included in the translation process @n
+* All the exceptions in this list are translated into @c e.
*
*/
* @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FBase.h> @n
- * @b Library : @b osp-appfw
+ * @b Library: @b osp-appfw
*
*
* The %Runtime namespace contains classes for running applications.
* The runtime environment includes threading, synchronization objects,
* and timer.
*
- * For more information on the %Base::Runtime namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/base/runtime_namespace.htm">Runtime</a>.
+ * For more information on the %Runtime namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/base/runtime_namespace.htm">Runtime</a>.
*
* The following diagram illustrates the relationships between the classes belonging to the %Runtime namespace.
* @image html base_runtime_namespace_classdiagram.png
* @file FBaseRtEvent.h
* @brief This is the header file for the %Event class.
*
- * This file contains the declarations of the %Event class.
+ * This header file contains the declarations of the %Event class.
*/
#ifndef _FBASE_RT_EVENT_H_
class IEventListener;
/**
* @class Event
-* @brief This class provides methods for notifying events with argument to its listeners.
+* @brief This class provides methods for notifying events with arguments to its listeners.
* @since 2.0
*
* The %Event class provides methods for notifying events with argument to its listeners.
* @since 2.0
*
* @return An error code
- * @param[in] listener Listener to add
- * @param[in] calledByCallerThread true, to call the listener on the caller thread of this method
- * false, to call the listener on the thread in which the event is fired.
- * @exception E_SUCCESS This method is successful.
+ * @param[in] listener The listener to add
+ * @param[in] calledByCallerThread Set to @c true, to call the listener on the caller thread of this method, @n
+ * else @c false, to call the listener on the thread in which the event is fired.
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_ALREADY_EXIST The listener already exists.
- * @exception E_INVALID_OPERATION calledByCallerThread is set to true but the caller thread is a worker thread.
+ * @exception E_INVALID_OPERATION The specified @c calledByCallerThread is @c true but the caller thread is a worker thread.
*/
result AddListener(IEventListener& listener, bool calledByCallerThread = true);
* @since 2.0
*
* @return An error code
- * @param[in] listener Listener to remove
- * @exception E_SUCCESS This method is successful.
- * @exception E_OBJ_NOT_FOUND The listener is not found.
+ * @param[in] listener The listener to remove
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The listener has not been found.
*/
result RemoveListener(IEventListener& listener);
* @since 2.0
*
* @return An error code
- * @param[in] arg The event argument.
- * @exception E_SUCCESS This method is successful.
- * @exception E_INVALID_STATE This event has not been initialized.
+ * @param[in] arg The event argument
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE This event has not been initialized.
*
- * @remarks This takes the ownership of @c arg. So arg should be created on a heap and should not be deleted by caller.
+ * @remarks This takes the ownership of @c arg. @n
+ * So @c arg should be created on a heap and should not be deleted by caller.
*/
result Fire(IEventArg& arg);
/**
* @class EventDrivenThread
- * @brief This class is the fundamental class for the asynchronous execution of a thread.
+ * @brief This class is the fundamental class for the asynchronous execution of a thread.
*
* @since 2.0
*
* @param[in] stackSize The thread stack size
* @param[in] priority The thread priority
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG An invalid argument is passed.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*/
result Construct(long stackSize = DEFAULT_STACK_SIZE, ThreadPriority priority = THREAD_PRIORITY_MID);
* @since 2.0
*
* @return An error code
- * @param[in] name The name of the thread
+ * @param[in] name The name of the thread
* @param[in] stackSize The thread stack size
* @param[in] priority The thread priority
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG An invalid argument is passed.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*/
result Construct(const Tizen::Base::String& name, long stackSize = DEFAULT_STACK_SIZE, ThreadPriority priority = THREAD_PRIORITY_MID);
/**
* Called before the message loop is started. @n
- * If this method returns @c false, the thread is terminated immediately.
+ * If the %OnStart() method returns @c false, the thread is terminated immediately.
*
* @since 2.0
*
- * @return @c true if this thread can be run, @n
- * else @c false
- * @remarks You can initialize the event or event listener in this method for running this thread.
+ * @return @c true if this thread runs, @n
+ * else @c false
+ * @remarks The event or event listener in this method can be initialized for running this thread.
*
*/
virtual bool OnStart(void);
*
* @since 2.0
*
- * @remarks You can finalize the event or event listener in this method for running this thread.
+ * @remarks The event or event listener in this method can be finalized for running this thread.
*
*/
virtual void OnStop(void);
* If overridden, it may not work as expected.
*
* @return An error code
- * @param[in] requestId The user-defined event ID
- * @param[in] pArgs A pointer to a list of arguments
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The thread is in an invalid state.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
+ * @param[in] requestId The user-defined event ID
+ * @param[in] pArgs A pointer to the list of arguments
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE The thread is in an invalid state.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_SYSTEM A system error has occurred.
*
* @see OnUserEventReceivedN()
*/
* @since 2.0
*
* @param[in] requestId The user-defined event ID
- * @param[in] pArgs A pointer to a list of arguments
+ * @param[in] pArgs A pointer to the list of arguments
*
* @see SendUserEvent()
*/
{
/**
* @interface IEventArg
-* @brief This interface is a tagging interface that all event argument must implement.
+* @brief This interface is a tagging interface that all event arguments must implement.
*
-* @since 2.0
+* @since 2.0
*
-* The %IEventArg interface is a tagging interface that all event argument must implement.
+* The %IEventArg interface is a tagging interface that all event arguments must implement.
*/
class IEventArg
{
//
/**
- * @file FBaseRtIEventListener.h
- * @brief This is the header file for the %IEventListener interface.
+ * @file FBaseRtIEventListener.h
+ * @brief This is the header file for the %IEventListener interface.
*
* This header contains the declarations of the %IEventListener interface.
*/
* @since 2.0
*
* The %IEventListener interface is a tagging interface that all event listeners must implement.
- * The event listener can listen when the specific event occurs. The event listener
+ * The event listener can listen when a specific event occurs. The event listener
* has several methods, and each method is called when a specific event occurs.
*
*/
{
/**
* @interface IRunnable
- * @brief This interface is the basic unit of the task. Also, it is the execution unit of
- * the thread. This interface must be inherited by the class whose instances will
+ * @brief This interface is the basic unit of a task. Also, it is the execution unit of
+ * the thread. This interface must be inherited by the class whose instances are
* run on the thread.
*
* @since 2.0
*
* @remarks Classes which inherit the %IRunnable interface must implement the Run() method.
*
- * The %IRunnable interface is the basic unit of the task. Also, it is the execution unit of
- * the thread. This interface must be inherited by the class whose instances will
+ * The %IRunnable interface is the basic unit of a task. Also, it is the execution unit of
+ * the thread. This interface must be inherited by the class whose instances are
* run on the thread.
* @n
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/base/thread_programming.htm">Thread Programming</a>.
/**
* Runs the task. @n
- * This method is an executable body of the task. In many cases, this method is called by the thread.
+ * The %Run() method is an executable body of the task. In many cases, this method is called by the thread.
* Although this method can return the result of the execution, the returned value might be discarded
* by the executor of this task.
*
* @since 2.0
*
* @return A pointer to the result of the task, @n
- * else @c null
+ * else @c null if it fails
*/
virtual Tizen::Base::Object* Run(void) = 0;
}; // IRunnable
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/base/timer.htm">Timer</a>.
*
- * @see Timer()
+ * @see Timer
*/
class _OSP_EXPORT_ ITimerEventListener
: virtual public IEventListener
*
* @since 2.0
*
- * @param[in] timer The timer that has expired
+ * @param[in] timer The expired timer
*/
virtual void OnTimerExpired(Timer& timer) = 0;
* @file FBaseRtIWaitingLoopCondition.h
* @brief This is the header file for the %IWaitingLoopCondition interface.
*
+ * This header file contains the declarations of the %IWaitingLoopCondition interface.
*/
#ifndef _FBASE_RT_WAITING_LOOP_CONDITION_H_
#define _FBASE_RT_WAITING_LOOP_CONDITION_H_
{
/*
* @interface IWaitingLoopCondition
- * @brief This interface provides the method to check whether the WaitingLoopCondition is met.
+ * @brief This interface provides a method to check whether the WaitingLoopCondition is met.
*
* @since 2.0
*/
{
public:
/*
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
virtual ~IWaitingLoopCondition(void) {}
/*
- * Check whether the waiting loop condition is met
+ * Checks whether the waiting loop condition is met.
*
* @since 2.0
*
{
/**
* @class Library
- * @brief This is the class for shared library.
+ * @brief This is the class for the shared library.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
* The %Library class loads the shared library with the given file path.
- * It loads the library in current process' memory space, and application can use this library explicitly.
+ * It loads the library in current process' memory space, and the application can use this library explicitly.
*/
class _OSP_EXPORT_ Library
: public Tizen::Base::Object
*
* @since 2.0
*
- * @return An error code
- * @param[in] libraryPath The path of the library file
+ * @return An error code
+ * @param[in] libraryPath The path of the library file
* @exception E_SUCCESS The method is successful.
* @exception E_LIBRARY_NOT_FOUND The library cannot be found.
* @exception E_INVALID_ARG The specified @c libraryPath is an empty string.
*
* @since 2.0
*
- * @return The address of the specified symbol
- * @param[in] symbol The symbol name
+ * @return The address of the specified symbol
+ * @param[in] symbol The symbol name
* @exception E_SUCCESS The method is successful.
* @exception E_SYMBOL_NOT_FOUND The symbol cannot be found.
* @exception E_INVALID_ARG The specified @c symbol is an empty string.
enum MemoryProtectionMode
{
MEMORY_PROTECTION_MODE_NONE = 0x0, /**< The memory cannot be accessed */
- MEMORY_PROTECTION_MODE_READ = 0x1, /**< The memory can be read */
- MEMORY_PROTECTION_MODE_WRITE = 0x2, /**< The memory can be modified */
- MEMORY_PROTECTION_MODE_EXEC = 0x4, /**< The memory can be executed */
+ MEMORY_PROTECTION_MODE_READ = 0x1, /**< The memory can be read */
+ MEMORY_PROTECTION_MODE_WRITE = 0x2, /**< The memory can be modified */
+ MEMORY_PROTECTION_MODE_EXEC = 0x4, /**< The memory can be executed */
};
/**
- * @class MemoryManager
+ * @class MemoryManager
* @brief This class represents a memory manager for runtime.
*
* @since 2.0
{
public:
/**
- * Changes protection on a memory region.
+ * Changes the protection on a memory region.
*
* @since 2.0
*
* @return An error code
- * @param[in] pAddress The start address of the memory region aligned on a page boundary.
+ * @param[in] pAddress The start address of the memory region aligned on a page boundary
* @param[in] length The length of the memory region in bytes
* @param[in] protection The memory protection @n
* It is either Tizen::Base::Runtime::MEMORY_PROTECTION_MODE_NONE or a bitwise OR of the
* other values in Tizen::Base::Runtime::MemoryProtectionMode.
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred due to an invalid address.
- * @exception E_INVALID_ARG The memory address is not valid, or the length is not a multiple of system page size.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The memory address is invalid.
+ * - The specified @c length is not a multiple of the system page size.
*/
static result ProtectMemory(const void* pAddress, long long length, unsigned long protection);
*
* @final This class is not intended for extension.
*
- * The %Monitor class represents a monitor. %Monitor is a synchronization mechanism that provides acquire/release semantics by Enter() / Exit() as well as wait/notify semantics by Wait() / Notify() / NotifyAll().
+ * The %Monitor class represents a monitor. A %Monitor is a synchronization mechanism that provides acquire and release semantics by Enter() and Exit() as well as wait and notify semantics by Wait(), Notify(), and NotifyAll().
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/base/monitor.htm">Monitor</a>.
*
- * The following examples demonstrates how to use the %Monitor class. In the examples, 2 classes, Consumer and Producer, share a space.
+ * The following examples demonstrates how to use the %Monitor class. In the examples, two classes, Consumer and Producer, share a space.
* Producer writes some data to this space, and Consumer reads it. Consumer and Producer run simultaneously.
* Consumer must not miss the data which Producer writes. In this case, Consumer and Producer share the monitor.
* Producer notifies Consumer that its writing action is done. Consumer waits for this notification, and reads the data after receiving it.
* @since 2.0
*
* @return An error code
- * @exception E_SUCCESS The method is successful.
+ * @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
*/
result Construct(void);
/**
- * Acquires a lock for a monitor. @n
- * Semantically, this method declares the beginning of the critical region for the monitor. This region
+ * Acquires a lock for the monitor. @n
+ * Semantically, the %Enter() method declares the beginning of the critical region for the monitor. This region
* ends with the Exit() method.
*
* @since 2.0
*
* @return An error code
- * @exception E_SUCCESS The method is successful in acquiring the lock.
+ * @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @remarks This method will block if called on already locked monitor object until monitor becomes available.
+ * @remarks This method blocks if called on an already locked monitor object until the monitor becomes available.
* @see Exit()
*/
result Enter(void);
/**
- * Releases a lock for a monitor. @n
+ * Releases the lock for the monitor. @n
* Semantically, it declares the ending of the critical region for the monitor that begins with
* the Enter() method.
*
* @since 2.0
*
* @return An error code
- * @exception E_SUCCESS The method is successful in releasing the lock.
+ * @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @remarks This method should be called only after acquiring lock by Enter() call
+ * @remarks This method should be called only after acquiring the lock by the Enter() call.
* @see Enter()
*/
result Exit(void);
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @remarks This method should be called only after acquiring lock by Enter() call
+ * @remarks This method should be called only after acquiring the lock by the Enter() call.
* @see Notify()
* @see NotifyAll()
*/
/**
- * Notifies all waiting threads.
+ * Notifies all the waiting threads.
*
* @since 2.0
*
/**
* @class MonitorGuard
-* @brief This class is the RAII style class for %Monitor class.
+* @brief This class is the RAII style class for the Monitor class.
*
* @since 2.0
*/
*
* @since 2.0
*
- * @param[in] m The %Monitor instance to be manipulated
+ * @param[in] m A Monitor instance to manipulate
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Monitor::Enter() for detailed exceptions
*/
}
/**
- * Returns whether this instance owns the lock on the given monitor at constructor.
+ * Checks whether this instance owns the lock on the given monitor at constructor.
*
* @since 2.0
*
* @return true if the lock is owned, @n
- * false otherwise.
+ * else @c false
*/
bool IsEntered(void) const
{
}
/**
- * Returns whether this instance owns the lock on the given monitor at constructor. @n
- * Have same effects to calling IsEntered().
+ * Checks whether this instance owns the lock on the given monitor at constructor. @n
+ * This method has the same effects when calling IsEntered().
*
* @since 2.0
*/
/**
* @struct NonRecursiveMutexTag
*
- * This struct is used only for providing the non-recursive type of mutex.
- * A non-recursive mutex is a mutex that can not be acquired multiple times by the locking thread. It returns an exception if the locking thread tries to lock the same mutex.
+ * This struct is used only for providing the non-recursive type of the mutex.
+ * A non-recursive mutex is a mutex that cannot be acquired multiple times by the locking thread. It returns an exception if the locking thread tries to lock the same mutex.
*
* @since 2.1
*
/**
* Creates an unnamed mutex which is a recursive mutex that can be acquired multiple times by the locking thread.
- * It keeps the number of getting locked and you must unlock it the same number of times.
+ * It keeps the number of locks and you must unlock it the same number of times.
*
* @since 2.0
*
- * @return An error code
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
*/
result Create(void);
*
* @since 2.1
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
*/
/**
* Creates a named mutex which is a recursive mutex that can be acquired multiple times by the locking thread.
- * It keeps the number of getting locked and you must unlock it the same number of times. @n
+ * It keeps the number of locks and you must unlock it the same number of times. @n
* If a mutex with the specified name already exists, this creates a mutex which references that particular mutex.
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] name The name of the mutex
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
*/
result Create(const Tizen::Base::String& name);
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks This method should be called only after acquiring lock by Acquire()/ TryToAcquire() call
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks This method should be called only after acquiring a lock by calling Acquire() or TryToAcquire().
*/
result Release(void);
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @remarks This method will block if called on already locked monitor object until mutex becomes available.
+ * @remarks This method blocks if called on an already locked monitor object until the mutex becomes available.
*/
result Acquire(void);
/**
* Tries to acquire the mutex if it is not acquired. @n
- * If the mutex is already acquired by another thread, E_OBJECT_LOCKED is returned.
+ * If the mutex is already acquired by another thread, @c E_OBJECT_LOCKED is returned.
*
* @since 2.0
*
- * @return An error code
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJECT_LOCKED The mutex is already locked.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks This method will block if called on already locked monitor object until mutex becomes available.
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJECT_LOCKED The mutex is already locked.
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks This method blocks if called on an already locked monitor object until the mutex becomes available.
*/
result TryToAcquire(void);
/**
* @class MutexGuard
-* @brief This class is the RAII style class for %Mutex class.
+* @brief This class is the RAII style class for the %Mutex class.
*
* @since 2.0
*
-* The following example demonstrates how to use this %MutexGuard class
+* The following example demonstrates how to use the %MutexGuard class
*
* @code
*
*
* @since 2.0
*
- * @param[in] m The %Mutex instance to be manipulated
+ * @param[in] m A %Mutex instance to manipulate
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Mutex::Acquire() for detailed exceptions
*/
*
* @since 2.0
*
- * @param[in] m The %Mutex instance to be manipulated
+ * @param[in] m A %Mutex instance to be manipulated
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Mutex::TryToAcquire() for detailed exceptions
*/
}
/**
- * This destructor releases the lock if acquired when going out of a scope
+ * This destructor releases the lock if acquired when going out of the scope
*
* @since 2.0
*
}
/**
- * Returns whether this instance owns the lock on the given mutex at constructor.
+ * Checks whether this instance owns the lock on the given mutex at constructor.
*
* @since 2.0
*
- * @return true if the lock is owned, @n
- * false otherwise.
+ * @return @c true if the lock is owned, @n
+ * else @c false
*/
bool IsLocked(void) const
{
}
/**
- * Returns whether this instance owns the lock on the given mutex at constructor. @n
- * Have same effects to calling IsLocked().
+ * Checks whether this instance owns the lock on the given mutex at constructor. @n
+ * Has the same effects as calling IsLocked().
*
* @since 2.0
*/
}
/**
- * Acquires the lock manually on the given mutex at constructor in a blocking way
+ * Acquires the lock manually on the given mutex at constructor in a blocking way.
*
* @since 2.0
*
- * @return An error code.
+ * @return An error code
* @see Mutex::Acquire() for detailed exceptions
*/
result Lock(void)
*
* @since 2.0
*
- * @return An error code.
+ * @return An error code
* @see Mutex::TryToAcquire() for detailed exceptions
*/
result TryToLock(void)
*
* @since 2.0
*
- * @return An error code.
+ * @return An error code
* @see Mutex::Release() for detailed exceptions
*/
result Unlock(void)
{
/**
* @class Semaphore
- * @brief This class represents semaphore, a type of synchronization mechanisms. It can provide the acquiring semantics. @n
+ * @brief This class represents a semaphore, that is, a type of synchronization mechanism. It can provide the acquiring semantics. @n
*
* @since 2.0
*
* @final This class is not intended for extension.
*
* The %Semaphore class represents a semaphore; a type of synchronization mechanism.
- * It can provide the acquiring semantics. The semaphore allows the N threads to acquire the semaphore simultaneously.
+ * It can provide the acquiring semantics. The semaphore allows N threads to acquire the semaphore simultaneously.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/base/mutex_and_semaphore.htm">Mutex and Semaphore</a>.
*
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] count The number of threads that can acquire the semaphore simultaneously @n
* If the count is @c 1, then it is the same as a mutex.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c count is less than @c 0.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
*/
result Create(int count = 1);
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] name The name of the semaphore
* @param[in] count The number of threads that can acquire the semaphore simultaneously
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c count is less than @c 0.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
*/
result Create(const Tizen::Base::String& name, int count = 1);
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] timeout The period during which the thread tries to acquire the semaphore
* @exception E_SUCCESS The method is successful.
- * @exception E_TIMEOUT The operation cannot be completed within the specified time period. @n
- * The method has failed to acquire the semaphore because the given time has elapsed.
+ * @exception E_TIMEOUT Either of the following conditions has occurred:
+ * - The operation cannot be completed within the specified time period.
+ * - The method has failed to acquire the semaphore because the given time has elapsed.
* @exception E_SYSTEM A system error has occurred.
*/
result Acquire(long timeout = INFINITE);
/**
* Tries to acquire the semaphore. @n
- * If the semaphore is already acquired by another thread, E_OBJECT_LOCKED is returned.
+ * If the semaphore is already acquired by another thread, @c E_OBJECT_LOCKED is returned.
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJECT_LOCKED The semaphore is already locked.
+ * @exception E_OBJECT_LOCKED The semaphore is already locked.
* @exception E_SYSTEM A system error has occurred.
*/
result TryToAcquire(void);
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
*/
/**
* @class SemaphoreGuard
-* @brief This class is the RAII style class for %Semaphore class.
+* @brief This class is the RAII style class for the %Semaphore class.
*
* @since 2.0
*/
{
public:
/**
- * This constructor acquires a semaphore count in a blocking way.
- *
- * @since 2.0
- *
- * @param[in] s The %Semaphore instance to be manipulated
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @see Semaphore::Acquire() for detailed exceptions
- */
+ * This constructor acquires a semaphore count in a blocking way.
+ *
+ * @since 2.0
+ *
+ * @param[in] s A Semaphore instance to manipulate
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @see Semaphore::Acquire() for detailed exceptions
+ */
SemaphoreGuard(Semaphore& s)
: __s(s)
, __acquired(false)
}
/**
- * This constructor acquires a semaphore count in a non-blocking way.
- *
- * @since 2.0
- *
- * @param[in] s The %Semaphore instance to be manipulated
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @see Semaphore::TryToAcquire() for detailed exceptions
- */
+ * This constructor acquires a semaphore count in a non-blocking way.
+ *
+ * @since 2.0
+ *
+ * @param[in] s A Semaphore instance to manipulate
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @see Semaphore::TryToAcquire() for detailed exceptions
+ */
SemaphoreGuard(Semaphore& s, TryTag)
: __s(s)
, __acquired(false)
}
/**
- * This destructor releases the acquired semaphore count when going out of a scope
- *
- * @since 2.0
- *
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @see Semaphore::Release() for detailed exceptions
- */
+ * This destructor releases the acquired semaphore count when going out of the scope
+ *
+ * @since 2.0
+ *
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @see Semaphore::Release() for detailed exceptions
+ */
~SemaphoreGuard(void)
{
SetLastResult(Release());
}
/**
- * Returns whether this instance owns a semaphore count on the given semaphore at constructor.
- *
- * @since 2.0
- *
- * @return true if a semaphore is owned, @n
- * false otherwise.
- */
+ * Checks whether this instance owns a semaphore count on the given semaphore at constructor.
+ *
+ * @since 2.0
+ *
+ * @return @c true if a semaphore is owned, @n
+ * else @c false
+ */
bool IsAcquired(void) const
{
return __acquired;
}
/**
- * Returns whether this instance owns a semaphore count on the given semaphore at constructor. @n
- * Have same effects to calling IsAcquired().
- *
- * @since 2.0
- */
+ * Checks whether this instance owns a semaphore count on the given semaphore at constructor. @n
+ * Has the same effects as calling IsAcquired().
+ *
+ * @since 2.0
+ */
operator bool() const
{
return IsAcquired();
}
/**
- * Acquires a semaphore count manually on the given semaphore at constructor in a blocking way
- *
- * @since 2.0
- *
- * @return An error code.
- * @see Semaphore::Acquire() for detailed exceptions
- */
+ * Acquires a semaphore count manually on the given semaphore at constructor in a blocking way.
+ *
+ * @since 2.0
+ *
+ * @return An error code
+ * @see Semaphore::Acquire() for detailed exceptions
+ */
result Acquire(void)
{
return SetAcquiredAndReturn(__s.Acquire());
}
/**
- * Acquires a semaphore count manually on the given semaphore at constructor in a non-blocking way
- *
- * @since 2.0
- *
- * @return An error code.
- * @see Semaphore::TryToAcquire() for detailed exceptions
- */
+ * Acquires a semaphore count manually on the given semaphore at constructor in a non-blocking way.
+ *
+ * @since 2.0
+ *
+ * @return An error code
+ * @see Semaphore::TryToAcquire() for detailed exceptions
+ */
result TryToAcquire(void)
{
return SetAcquiredAndReturn(__s.TryToAcquire());
}
/**
- * Releases the acquired semaphore count manually
- *
- * @since 2.0
- *
- * @return An error code.
- * @see Semaphore::Release() for detailed exceptions
- */
+ * Releases the acquired semaphore count manually
+ *
+ * @since 2.0
+ *
+ * @return An error code
+ * @see Semaphore::Release() for detailed exceptions
+ */
result Release(void)
{
result r = E_SUCCESS;
*/
enum ThreadType
{
- THREAD_TYPE_WORKER = 0, /**< @if OSPDEPREC The worker thread mode @endif */
- THREAD_TYPE_EVENT_DRIVEN, /**< @if OSPDEPREC The event-driven thread mode @endif */
+ THREAD_TYPE_WORKER = 0, /**< @if OSPDEPREC The worker thread mode @endif */
+ THREAD_TYPE_EVENT_DRIVEN, /**< @if OSPDEPREC The event-driven thread mode @endif */
THREAD_TYPE_MAIN // This enum value is for internal use only. Using this enum value can cause behavioral,
// security-related, and consistency-related issues in the application.
// The main thread mode
* @remarks This class supports only worker threads. For event-driven threads, use the EventDrivenThread class.
*
* The %Thread class is the fundamental class for the asynchronous execution of a thread.
- * A Tizen native application can execute several threads during its operation from the multi-threading view.
+ * A %Tizen native application can execute several threads during its operation from the multi-threading view.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/base/thread.htm">Thread</a>.
*
*
* @return An error code
* @param[in] milliSeconds The time, in milliseconds, for which to suspend the execution @n
- * A value of zero causes the thread to relinquish the remainder of its time
- * slice to any other thread that is ready to run. The time cannot be negative.
+ * The value of zero causes the thread to relinquish the remainder of its time
+ * slice to any other thread that is ready to run @n
+ * The time cannot be negative.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A negative time value is passed.
+ * @exception E_INVALID_ARG A negative time value has been passed.
*/
static result Sleep(long milliSeconds);
static result Exit(int exitCode = 0x00);
/**
- * Gets the pointer of the currently running %Thread instance.
+ * Gets a pointer of the currently running %Thread instance.
*
* @since 2.0
*
* Initializes this instance of %Thread with the specified thread type, stack size, and priority.
*
* @brief <i> [Deprecated] </i>
- * @deprecated This method is deprecated because the %Thread class does not support event-driven thread any more. Instead, use the EventDrivenThread class instead.
+ * @deprecated This method is deprecated because the %Thread class does not support event-driven threads any more. Instead, use the EventDrivenThread class.
*
* @since 2.0
*
* @param[in] stackSize The thread stack size
* @param[in] priority The thread priority
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG An invalid argument is passed.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @endif
*/
* Initializes this instance of %Thread with the specified name, thread type, stack size, and priority.
*
* @brief <i> [Deprecated] </i>
- * @deprecated This method is deprecated because the %Thread class does not support event-driven thread any more. Instead, use the EventDrivenThread class instead.
+ * @deprecated This method is deprecated because the %Thread class does not support event-driven threads any more. Instead, use the EventDrivenThread class.
*
* @since 2.0
*
* @param[in] stackSize The thread stack size
* @param[in] priority The thread priority
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG An invalid argument is passed.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @endif
*/
* @param[in] stackSize The thread stack size
* @param[in] priority The thread priority
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG An invalid argument is passed.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*/
result Construct(long stackSize = DEFAULT_STACK_SIZE, ThreadPriority priority = THREAD_PRIORITY_MID);
* @param[in] stackSize The thread stack size
* @param[in] priority The thread priority
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG An invalid argument is passed.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*/
result Construct(const Tizen::Base::String& name,
* @param[in] stackSize The thread stack size
* @param[in] priority The thread priority
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG An invalid argument is passed.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*/
result Construct(IRunnable& target, long stackSize = DEFAULT_STACK_SIZE, ThreadPriority priority = THREAD_PRIORITY_MID);
*
* @since 2.0
*
- * @return An error code
- * @param[in] name The name of the thread
+ * @return An error code
+ * @param[in] name The name of the thread
* @param[in] target An instance of IRunnable
* @param[in] stackSize The thread stack size
* @param[in] priority The thread priority
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG An invalid argument is passed.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*/
result Construct(const Tizen::Base::String& name, IRunnable& target,
virtual ~Thread(void);
/**
- * Waits until the thread execution is terminated.
+ * Joins after the thread execution is terminated.
*
* @since 2.0
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_OPERATION An other thread is calling this method.
+ * @exception E_INVALID_OPERATION Another thread is calling this method.
* @exception E_SYSTEM A system error has occurred.
*/
result Join(void);
* @since 2.0
*
* @return An error code
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
* @remarks This is only available for event-driven threads.
* @endif
*/
/**
* Called when the thread is started without the IRunnable instance. @n
- * The body for thread execution is specified by inheriting the %Thread class and implementing this method.
+ * The body for the thread execution is specified by inheriting the %Thread class and implementing this method.
*
* @since 2.0
*
virtual Tizen::Base::Object* Run(void);
/**
- * Gets an exit code of the thread which is given by calling the Exit() method.
+ * Gets the exit code of the thread which is given by calling the Exit() method.
*
* @since 2.0
*
* @since 2.0
*
* @return The name of the thread
- * @exception E_SUCCESS The method is successful.
+ * @exception E_SUCCESS The method is successful.
*/
const Tizen::Base::String& GetName(void) const;
* @since 2.0
*
* @return @c true if this thread can be run, @n
- * else @c false
- * @remarks You can initialize the event or event listener in this method for running this
+ * else @c false
+ * @remarks The event or event listener in this method can be initialized for running this
* thread in an event-driven mode.
* @endif
*/
* @deprecated This method is deprecated because the %Thread class does not support event-driven threads.
* @since 2.0
*
- * @remarks You can finalize the event or event listener in this method for running this
+ * @remarks The event or event listener in this method can be finalized for running this
* thread in an event-driven mode.
*
* @endif
* @since 2.0
*
* @return An error code
- * @param[in] requestId The user-defined event Id
- * @param[in] pArgs A pointer to a list of arguments
+ * @param[in] requestId The user-defined event ID
+ * @param[in] pArgs A pointer to the list of arguments
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_OPERATION The thread is not an event-driven thread.
*
*
* @since 2.0
*
- * @param[in] requestId The user-defined event Id
- * @param[in] pArgs A pointer to a list of arguments
+ * @param[in] requestId The user-defined event ID
+ * @param[in] pArgs A pointer to the list of arguments
* @see SendUserEvent()
* @endif
*/
* @since 2.0
*
* The %Timer class can activate the timer and notify the listeners.
- * It supports relative time and provides both repeatable and non-repeatable timer.
- * Because Timer is handled by event-driven way, when the main loop gets blocked, even if the time is expired, the listener cannot get notified.
- * Once the target goes into sleep mode, Timer does not work properly because the main loop gets stopped.
- * You can use Alarm on behalf of Timer for sleep mode.
+ * It supports the relative time and provides both repeatable and non-repeatable timers.
+ * Because %Timer is handled in an event-driven way, when the main loop gets blocked, even if the time is expired, the listener cannot get notified.
+ * Once the target goes into the sleep mode, %Timer does not work properly because the main loop gets stopped.
+ * You can use Alarm on behalf of the %Timer for the sleep mode.
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/base/timer.htm">Timer</a>.
* The following example demonstrates how to use the %Timer class.
*
* @since 2.0
*
* @return An error code
- * @param[in] listener The event listener
- * @exception E_SUCCESS The method is successful.
+ * @param[in] listener The event listener
+ * @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
*/
result Construct(ITimerEventListener& listener);
* @since 2.0
*
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with %Tizen API versions @b prior @b to @b 2.1. @n
- * For more information, see @ref CompTimerStartPage "here".
+ * @compatibility This method has compatibility issues with Tizen API versions @b prior @b to @b 2.1. @n
+ * For more information, see @ref CompTimerStartPage "here".
* @endif
*
* @return An error code
- * @param[in] timeout A timeout interval in milliseconds
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_INVALID_STATE The timer is in an invalid state for start.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks Once the timer has been started, it cannot be started again until expired.
+ * @param[in] timeout The timeout interval in milliseconds
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_INVALID_STATE The timer cannot start as it is in an invalid state.
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks Once the timer has been started, it cannot be started again until it has expired.
* @see Cancel()
*/
result Start(int timeout);
/**
- * @page CompTimerStartPage Compatibility for Start(int timeout)
- * @section CompTimerStartPageIssueSection Issues
- * Implementation of this method in %Tizen API versions prior to 2.1 has the following issue: @n
- * -# The method returns E_INVALID_ARG if timeout is equal to zero.
- *
- * @section CompTimerStartPageSolutionSection Resolutions
- * The issue mentioned above is resolved in %Tizen API version 2.1, and it is recommended to use %Tizen API version 2.1 or above.
- * -# In case of zero, Timer sets timeout to the best-effort minimum interval without returning E_INVALID_ARG.
- */
+ * @page CompTimerStartPage Compatibility for Start(int timeout)
+ * @section CompTimerStartPageIssueSection Issues
+ * Implementation of this method in Tizen API versions prior to 2.1 has the following issue: @n
+ * -# The method returns @c E_INVALID_ARG if timeout is equal to zero.
+ *
+ * @section CompTimerStartPageSolutionSection Resolutions
+ * The issue mentioned above is resolved in Tizen API version 2.1, and it is recommended to use Tizen API version 2.1 or above.
+ * -# In case of zero, %Timer sets the timeout to the best possible minimum interval without returning @c E_INVALID_ARG.
+ */
/**
* Starts the timer. @n
- * The timer is expired repeatedly until canceled.
+ * The timer expires repeatedly until it is cancelled.
*
* @since 2.0
*
* @return An error code
- * @param[in] interval A timeout interval in milliseconds
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_INVALID_STATE The timer is in an invalid state for start.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks To stop timer expiration or restart a timer, the timer must be canceled.
+ * @param[in] interval The timeout interval in milliseconds
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_INVALID_STATE The timer cannot start as it is in an invalid state.
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks To stop the timer expiration or restart the timer, the timer must be cancelled.
* @see Cancel()
*/
result StartAsRepeatable(int interval);
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The started timer can be canceled when it does not get expired. If the timer was already expired, this method also returns E_SUCCESS which affects the same manner when canceled normally.
+ * @remarks The started timer can be cancelled when it does not get expired. @n
+ * If the timer has already expired, this method also returns @c E_SUCCESS which causes the same effect as when cancelled normally.
*/
result Cancel(void);
/**
* @file FBaseRtTypes.h
- * @brief This is the header file for the types in the Runtime package.
+ * @brief This is the header file for the types in the %Runtime package.
*
* This header file defines the types in the Runtime package.
*/
/**
* @struct TryTag
-* @brief This struct is used only for supporting non-blocking acquisition of a resource.
+* @brief This struct is used only for supporting the non-blocking acquisition of a resource.
*
-* The %TryTag struct is used for just discriminating between blocking and non-blocking acquisition
+* The %TryTag struct is used for just discriminating between the blocking and non-blocking acquisitions
* of a resource. So, the definition is empty.
*
* @since 2.0
};
/**
-* @brief Used only for just discriminating between blocking and non-blocking acquisition.
+* @brief Used only for discriminating between the blocking and non-blocking acquisitions.
*
* @code
* Mutex m;
class IWaitingLoopCondition;
/*
* @class WaitingLoop
- * @brief This class allows developers to make the current thread wait for callback events. This class should be used only for test codes and don't use this class for commercial applications
+ * @brief This class allows developers to make the current thread wait for callback events. This class should be used only for test codes and not for commercial applications.
* @since 2.0
*
* @final This class is not intended for extension.
{
public:
/*
- * Gets the WaitingLoop instance.
+ * Gets a pointer to the %WaitingLoop instance.
*
* @since 2.0
*
- * @return A pointer to the WaitingLoop instance, @n
+ * @return A pointer to a WaitingLoop instance, @n
* else @c null if it fails
- * @remarks Once the WaitingLoop instance has been created, you must not use the instance between threads. Especially, the methods for waiting should be called on the thread you get the instance at first time.
+ * @remarks Once the WaitingLoop instance has been created, the instance between the threads must not be used. @n
+ * Especially, the methods that are waiting should be called on the thread where the instance is obtained for the first time.
*/
static WaitingLoop* GetInstance(void);
*
* @since 2.0
*
- * @param[in] timeout The timeout period in milliseconds
- * @exception E_SUCCESS The method is successful.
- * @exception E_TIMEOUT The time is expired.
- * @exception E_INVALID_STATE The waiting loop has already been waiting on a callback event. In order to wait again, you must quit the waiting loop.
- * @remarks The timeout set to min(timeout, maximum), where the maximum is set using SetMaxTimeoutForWaiting().
+ * @param[in] timeout The timeout period in milliseconds
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_TIMEOUT The time has expired.
+ * @exception E_INVALID_STATE The waiting loop has already been waiting on a callback event. @n
+ * In order to wait again, quit the waiting loop.
+ * @remarks The timeout is set to min(timeout, maximum), where the maximum is set using SetMaxTimeoutForWaiting().
* @see Notify()
- * @see SetMaxTimoutForWaiting()
*/
result Wait(int timeout);
*
* @since 2.0
*
- * @param[in] condition The expiring condition
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The waiting loop has already been waiting on a callback event. In order to wait again, you must quit the waiting loop.
- * @remarks In order to use this method correctly, you have to implement a class inheriting from %IWaitingLoopCondition.
+ * @param[in] condition The expiring condition
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE The waiting loop has already been waiting on a callback event. @n
+ * In order to wait again, quit the waiting loop.
+ * @remarks In order to use this method correctly, you have to implement a class inheriting from IWaitingLoopCondition.
*/
result Wait(IWaitingLoopCondition& condition);
/*
- * Starts the waiting loop and waits until either the expiring condition occurs or the time is expired.
+ * Starts the waiting loop and waits until either the expiring condition occurs or the time expires.
*
* @since 2.0
*
- * @param[in] timeout The timeout period in milliseconds
- * @param[in] condition The expiring condition
- * @exception E_TIMEOUT The time is expired.
- * @exception E_INVALID_STATE The waiting loop is waiting on a thread. In order to wait again, you must quit the waiting loop.
- * @remarks If the timeout is over the maximum, the expired time goes together with the maximum timeout. In order to use this method correctly, you have to implement a class inheriting from %IWaitingLoopCondition interface
+ * @param[in] timeout The timeout period in milliseconds
+ * @param[in] condition The expiring condition
+ * @exception E_TIMEOUT The time has expired.
+ * @exception E_INVALID_STATE The waiting loop is waiting on a thread. @n
+ * In order to wait again, quit the waiting loop.
+ * @remarks If the timeout has crossed the maximum value, the expired time goes along with the maximum timeout. @n
+ * In order to use this method correctly, implement a class inheriting from the IWaitingLoopCondition interface
*/
result Wait(int timeout, IWaitingLoopCondition& condition);
/*
- * Notify the waiting thread that the related callback has completed the job.
+ * Notifies the waiting thread that the related callback has completed the job.
*
* @since 2.0
*
- * @remarks This method is recommended to use when the waiting condition is not explicitly specified with Wait().
+ * @remarks This method is recommended when the waiting condition is not explicitly specified by Wait().
*/
void Notify(void);
* @since 2.0
*
* @param[in] timeout The timeout period in milliseconds
- * else @c false
- * @remarks If the timeout is considered as a small number, it will be replaced with the specified number provided by platform.
+ * else @c false
+ * @remarks If the timeout is considered as a small number, it is replaced with the specified number provided by the platform.
*/
static void SetMaxTimeoutForWaiting(int timeout);
* @file FBaseShortComparer.h
* @brief This is the header file for the %ShortComparer class.
*
- * @see Short
- * @see Tizen::Base::Collection::IComparer
- *
* This header file contains the declarations of the %ShortComparer class.
+ *
+ * @see Tizen::Base::Short
+ * @see Tizen::Base::Collection::IComparer
*/
#ifndef _FBASE_SHORT_COMPARER_H_
#define _FBASE_SHORT_COMPARER_H_
{
/**
* @class ShortComparer
- * @brief This class compares 2 instances of the %Short type for equivalence.
+ * @brief This class compares two instances of the %Short type for equivalence.
*
* @since 2.0
*
- * The %ShortComparer class compares 2 instances of the Short type for equivalence.
+ * The %ShortComparer class compares two instances of the Short type for equivalence.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/base/collection_comparison.htm">Collection Comparisons</a>.
*
*
* @since 2.0
*
- * @return An error code
- * @param[in] obj1 An object of Short to compare
- * @param[in] obj2 An object of Short to compare
- * @param[out] cmp The result of comparison
+ * @return An error code
+ * @param[in] obj1 The object of Short to compare
+ * @param[in] obj2 The object of Short to compare
+ * @param[out] cmp The result of the comparison
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified object instances are not of the expected type.
- * @remarks The value of @c cmp can be:
+ * @remarks The value of @c cmp can be:
*
* @code
- * < 0 if the value of @c obj1 is less than the value of @c obj2
- * == 0 if the value of @c obj1 is equal to the value of @c obj2
- * > 0 if the value of @c obj1 is greater than the value of @c obj2
+ * < 0 if the value of obj1 is less than the value of obj2
+ * == 0 if the value of obj1 is equal to the value of obj2
+ * > 0 if the value of obj1 is greater than the value of obj2
* @endcode
*/
virtual result Compare(const Tizen::Base::Object& obj1, const Tizen::Base::Object& obj2, int& cmp) const;
*
* @since 2.0
*
- * @param[in] capacity The default capacity of this instance
+ * @param[in] capacity The default capacity of this instance
*/
String(int capacity);
*
* @since 2.0
*
- * @param[in] ch A Unicode character
+ * @param[in] ch The Unicode character
*/
String(wchar_t ch);
*
* @since 2.0
*
- * @param[in] pValue A pointer to an array of Unicode characters
+ * @param[in] pValue A pointer to the array of Unicode characters
*/
String(const wchar_t* pValue);
*
* @since 2.0
*
- * @param[in] pValue A pointer to an array of UTF-8 characters
+ * @param[in] pValue A pointer to the array of UTF-8 characters
*/
String(const char* pValue);
*
* @since 2.0
*
- * @param[in] value An instance of %String
+ * @param[in] value An instance of %String to copy
*/
String(const String& value);
/**
- * TThis destructor overrides Tizen::Base::Object::~Object().
+ * This destructor overrides Tizen::Base::Object::~Object().
*
* @since 2.0
*
- * @remarks The internally allocated memory block is freed when the instance is destroyed.
+ * @remarks The internally allocated memory block is freed when the instance is destroyed.
*/
virtual ~String(void);
/**
- * Returns the Unicode character at the specified @c index.
+ * Gets the Unicode character at the specified index.
*
* @since 2.0
*
- * @return A const reference to the Unicode character
- * @param[in] index An index within the current instance of %String
+ * @return A constant reference to the Unicode character
+ * @param[in] index The index within the current instance of %String
*/
const wchar_t& operator [](int index) const;
/**
- * Returns a reference to the Unicode character at the specified @c index.
+ * Gets a reference to the Unicode character at the specified index.
*
* @since 2.0
*
* @return A reference to the Unicode character
- * @param[in] index An index within the current instance of %String
+ * @param[in] index The index within the current instance of %String
*/
wchar_t& operator [](int index);
* @since 2.0
*
* @return A reference to the %String instance
- * @param[in] pRhs A pointer to an array of Unicode characters
+ * @param[in] pRhs A pointer to the array of Unicode characters
*/
String& operator =(const wchar_t* pRhs);
* @since 2.0
*
* @return A reference to the %String instance
- * @param[in] rhs An instance of %String
+ * @param[in] rhs An instance of %String to copy
*/
String& operator =(const String& rhs);
* @since 2.0
*
* @return A reference to the %String instance
- * @param[in] pRhs A pointer to an array of Unicode characters
+ * @param[in] pRhs A pointer to the array of Unicode characters
*/
String& operator +=(const wchar_t* pRhs);
*
* @since 2.0
*
- * @return The concatenated %String instance
+ * @return The concatenated %String instance
* @param[in] lhs A reference to the %String instance on the left-hand side of the operator
* @param[in] rhs A reference to the %String instance on the right-hand side of the operator
*/
*
* @since 2.0
*
- * @return @c true if the text of the specified %String instance equals the calling instance's text, @n
+ * @return @c true if the text of the specified %String instance equals the calling instance's text, @n
* else @c false
- * @param[in] rhs A reference to the %String instance on the right-hand side of the operator
- * @remarks The operator performs an ordinal comparison of each Unicode character.
+ * @param[in] rhs A reference to the %String instance on the right-hand side of the operator
+ * @remarks The operator performs an ordinal comparison of each Unicode character.
*/
bool operator ==(const String& rhs) const;
*
* @since 2.0
*
- * @return @c true if the text of the specified %String instance is not equal to the calling instance's text, @n
+ * @return @c true if the text of the specified %String instance is not equal to the calling instance's text, @n
* else @c false
* @param[in] rhs A reference to the %String instance on the right-hand side of the operator
- * @remarks The operator performs an ordinal comparison of each Unicode character.
+ * @remarks The operator performs an ordinal comparison of each Unicode character.
*/
bool operator !=(const String& rhs) const;
* @since 2.0
*
* @return An error code
- * @param[in] ch A @c wchar_t value to insert
+ * @param[in] ch The @c wchar_t value to insert
* @exception E_SUCCESS The method is successful.
*/
result Append(wchar_t ch);
* @since 2.0
*
* @return An error code
- * @param[in] ch A @c char value to insert
+ * @param[in] ch The @c char value to insert
* @exception E_SUCCESS The method is successful.
*/
result Append(char ch);
/**
- * Appends the string representing the specified 32-bit @c int value to this
+ * Appends the string that represents the specified 32-bit @c int value to this
* instance of %String.
*
* @since 2.0
*
* @return An error code
- * @param[in] i A 32-bit integer value to insert
+ * @param[in] i The 32-bit integer value to insert
* @exception E_SUCCESS The method is successful.
*/
result Append(int i);
/**
- * Appends the string representing the specified @c short value to this
+ * Appends the string that represents the specified @c short value to this
* instance of %String.
*
* @since 2.0
*
* @return An error code
- * @param[in] s A @c short value to insert
+ * @param[in] s The @c short value to insert
* @exception E_SUCCESS The method is successful.
*/
result Append(short s);
/**
- * Appends the string representing the specified @c long value to this
+ * Appends the string that represents the specified @c long value to this
* instance of %String.
*
* @since 2.0
*
* @return An error code
- * @param[in] l A @c long value to insert
+ * @param[in] l The @c long value to insert
* @exception E_SUCCESS The method is successful.
*/
result Append(long l);
/**
- * Appends the string representing the specified @c long @c long value to this
+ * Appends the string that represents the specified @c long @c long value to this
* instance of %String.
*
* @since 2.0
*
* @return An error code
- * @param[in] ll A @c long @c long value to insert
+ * @param[in] ll The @c long @c long value to insert
* @exception E_SUCCESS The method is successful.
*/
result Append(long long ll);
/**
- * Appends the string representing the specified @c float value to this
+ * Appends the string that represents the specified @c float value to this
* instance of %String.
*
* @since 2.0
*
* @return An error code
- * @param[in] f A @c float value to insert
+ * @param[in] f The @c float value to insert
* @exception E_SUCCESS The method is successful.
*/
result Append(float f);
/**
- * Appends the string representing the specified @c double value to this
+ * Appends the string that represents the specified @c double value to this
* instance of %String.
*
* @since 2.0
*
* @return An error code
- * @param[in] d A @c double value to insert
+ * @param[in] d The @c double value to insert
* @exception E_SUCCESS The method is successful.
*/
result Append(double d);
* @since 2.0
*
* @return An error code
- * @param[in] p A pointer to a Unicode character array
+ * @param[in] p A pointer to the Unicode character array
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A @c null pointer is passed.
*/
* @since 2.0
*
* @return An error code
- * @param[in] str An instance of %String to append
+ * @param[in] str An instance of %String to append
* @exception E_SUCCESS The method is successful.
*/
result Append(const String& str);
*
* @since 2.0
*
- * @return A 32-bit @c signed integer value
+ * @return The 32-bit @c signed integer value
* @param[in] str0 The first %String instance to compare
* @param[in] str1 The second %String instance to compare
- * @remarks This method performs an ordinal comparison of each Unicode
- * character contained in the two given %String instances.
+ * @remarks This method performs an ordinal comparison of each Unicode
+ * character contained in the two given %String instances. @n
* For instance, "U+xxx" is greater than "U+XXX", but smaller than "U+yyy".
*
* @code
*
* @since 2.0
*
- * @return A 32-bit @c signed integer value
- *@code
+ * @return The 32-bit @c signed integer value
+ * @code
* < 0 if the value of the current instance is less than the value of the specified %String instance
* == 0 if the value of the current instance is equal to the value of the specified %String instance
* > 0 if the value of the current instance is greater than the value of the specified %String instance
- *@endcode
+ * @endcode
* @param[in] str An instance of %String to compare
- * @remarks This method performs an ordinal comparison of each Unicode character. For instance,
- * L"U+xxx" is greater than L"U+XXX", but smaller than L"U+yyy".
+ * @remarks This method performs an ordinal comparison of each Unicode character. @n
+ * For instance, L"U+xxx" is greater than L"U+XXX", but smaller than L"U+yyy".
*/
int CompareTo(const String& str) const;
* @since 2.0
*
* @return An error code
- * @param[in] minLength A minimum length to ensure
+ * @param[in] minLength The minimum length to ensure
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c minLength is negative.
*/
* else @c false
*
* @remarks This method performs an ordinal comparison of each Unicode
- * character contained in the two given %String instances.
+ * character contained in the two given %String instances.
*/
bool Equals(const String& str, bool caseSensitive) const;
* @param[in] length The maximum number of wide characters to write, including the terminating @c null character
* @param[in] pFormat The wide character format specifier
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c length is negative or @c pFormat is @c null.
- * @remarks If an "l" modifier is present in @c pFormat (for example, L"@%ls"), it is a pointer to an array of wide characters. @n
- * @remarks A pointer to an array of UTF-8 characters is not allowed in the Format() method (for example, Format(20, L"@%s", pUTF8Str)).
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c length is negative.
+ * - The specified @c pFormat is @c null.
+ * @remarks
+ * - If an "l" modifier is present in @c pFormat (for example, L"@%ls"), it is a pointer to an array of wide characters.
+ * - A pointer to an array of UTF-8 characters is not allowed in the Format() method (for example, Format(20, L"@%s", pUTF8Str)).
* The following format specifiers are supported in this method:
* @code
* specifier Output
*
* @since 2.0
*
- * @return The hash value of the current instance
- * @remarks Two equal instances must return the same hash value. For better performance,
- * the hash function used must generate a random distribution
- * for all inputs.
+ * @return The hash value of the current instance
+ * @remarks Two equal instances must return the same hash value. @n
+ * For better performance, the hash function used must generate a random distribution for all the inputs.
*/
virtual int GetHashCode(void) const;
* @param[in] indexAt The position of the character
* @param[out] ch The character at the specified index
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
*/
result GetCharAt(int indexAt, wchar_t& ch) const;
/**
* Searches for a character in the calling instance. @n
- * Gets the index of the first character that matches to
+ * Gets the index of the first character that matches
* the specified character in this instance.
*
* @since 2.0
*
* @return An error code
* @param[in] ch The Unicode character to locate
- * @param[in] startIndex The starting position of search
+ * @param[in] startIndex The starting position of the search
* @param[out] indexOf The index of the character
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified character is not found.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c startIndex is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The specified character is not found.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c startIndex is either greater than or equal to the length of the current instance.
+ * - The specified @c startIndex is less than @c 0.
*/
result IndexOf(wchar_t ch, int startIndex, int& indexOf) const;
* @param[out] indexOf The index of the substring
* @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified string is not found.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c startIndex is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c startIndex is either greater than or equal to the length of the current instance.
+ * - The specified @c startIndex is less than @c 0.
*/
result IndexOf(const String& str, int startIndex, int& indexOf) const;
/**
- * Inserts the string representing the specified Unicode character
+ * Inserts the string that represents the specified Unicode character
* at the specified position in the calling instance.
*
* @since 2.0
*
* @return An error code
*
- * @param[in] ch A Unicode character to insert
+ * @param[in] ch The Unicode character to insert
* @param[in] indexAt The position of the character
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
*/
result Insert(wchar_t ch, int indexAt);
/**
- * Inserts the string representing the specified @c char value
+ * Inserts the string that represents the specified @c char value
* at the specified position in the calling instance.
*
* @since 2.0
*
* @return An error code
*
- * @param[in] ch A @c char value to insert
+ * @param[in] ch The @c char value to insert
* @param[in] indexAt The position of the character
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
*/
result Insert(char ch, int indexAt);
/**
- * Inserts the string representing the specified 16-bit integer
+ * Inserts the string that represents the specified 16-bit integer
* at the specified position in the calling instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] s A 16-bit integer value to insert
+ * @param[in] s The 16-bit integer value to insert
* @param[in] indexAt The position of the character
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
*/
result Insert(short s, int indexAt);
/**
- * Inserts the string representing the specified 32-bit integer
+ * Inserts the string that represents the specified 32-bit integer
* at the specified position in the calling instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] i A 32-bit integer value to insert
+ * @param[in] i The 32-bit integer value to insert
* @param[in] indexAt The position of the character
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
*/
result Insert(int i, int indexAt);
/**
- * Inserts the string representing the specified @c long value
+ * Inserts the string that represents the specified @c long value
* at the specified position in the calling instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] l A @c long value to insert
+ * @param[in] l The @c long value to insert
* @param[in] indexAt The position of the character
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
*/
result Insert(long l, int indexAt);
/**
- * Inserts the string representing the specified @c long @c long value
+ * Inserts the string that represents the specified @c long @c long value
* at the specified position in the calling instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] ll A @c long @c long value to insert
+ * @param[in] ll The @c long @c long value to insert
* @param[in] indexAt The position of the character
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
*/
result Insert(long long ll, int indexAt);
/**
- * Inserts the string representing the specified @c float value
+ * Inserts the string that represents the specified @c float value
* at the specified position in the calling instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] f A @c float value to insert
+ * @param[in] f The @c float value to insert
* @param[in] indexAt The position of the character
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
*/
result Insert(float f, int indexAt);
/**
- * Inserts the string representing the specified @c double value
+ * Inserts the string that represents the specified @c double value
* at the specified position in the calling instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] d A @c double value to insert
+ * @param[in] d The @c double value to insert
* @param[in] indexAt The position of the character
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
*/
result Insert(double d, int indexAt);
/**
- * Inserts the string representing the specified @c null-terminated
+ * Inserts the string that represents the specified @c null-terminated
* string at the specified position in the calling instance.
*
* @since 2.0
* @param[in] p An instance of %String to insert
* @param[in] indexAt The position of the character
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
* @exception E_INVALID_ARG A @c null pointer is passed.
*/
result Insert(const wchar_t* p, int indexAt);
/**
- * Inserts the string representing the specified instance of %String
+ * Inserts the string that represents the specified instance of %String
* at the specified position in the calling instance.
*
* @since 2.0
* @param[in] str An instance of %String to insert
* @param[in] indexAt The position of the character
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
*/
result Insert(const String& str, int indexAt);
*
* @return An error code
* @param[in] ch The Unicode character to locate
- * @param[in] startIndex The starting position of search
+ * @param[in] startIndex The starting position of the search
* @param[out] indexOf The index of character
* @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified character is not found.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c startIndex is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c startIndex is either greater than or equal to the length of the current instance.
+ * - The specified @c startIndex is less than @c 0.
*/
result LastIndexOf(wchar_t ch, int startIndex, int& indexOf) const;
*
* @return An error code
* @param[in] str An instance of %String to locate
- * @param[in] startIndex The starting position of search
+ * @param[in] startIndex The starting position of the search
* @param[out] indexOf The index of the substring
* @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified character is not found.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c startIndex is either greater than or equal to the length of the current instance or less than @c 0.
- * @remarks If the substring is empty, E_SUCCESS is returned and the value of @c indexOf is set to @c startIndex.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c startIndex is either greater than or equal to the length of the current instance.
+ * - The specified @c startIndex is less than @c 0.
+ * @remarks If the substring is empty, @c E_SUCCESS is returned and the value of @c indexOf is set to @c startIndex.
*/
result LastIndexOf(const String& str, int startIndex, int& indexOf) const;
* @param[in] startIndex The position where the removal begins
* @param[in] length The number of characters to remove
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE Either of the following conditions has occurred: @n
- * - The specified index is out of range. @n
- * - The specified @c startIndex is either greater than or equal to the length of the current instance or less than @c 0. @n
- * - The specified @c count is either greater than the length of substring starting from @c startIndex or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c startIndex is either greater than or equal to the length of the current instance.
+ * - The specified @c startIndex is less than @c 0.
+ * - The specified @c count is either greater than the length of the substring starting from @c startIndex.
+ * - The specified @c count is less than @c 0.
*/
result Remove(int startIndex, int length);
/**
- * Replaces all occurrences of the specified characters.
+ * Replaces all the occurrences of the specified characters.
*
* @since 2.0
*
- * @param[in] original The character to replace
- * @param[in] replace The character to replace all occurrences of @c original
+ * @param[in] original The character to replace
+ * @param[in] replace The character to replace all the occurrences of @c original
*/
void Replace(wchar_t original, wchar_t replace);
/**
- * Replaces all occurrences of the specified string.
+ * Replaces all the occurrences of the specified string.
*
* @since 2.0
*
* @return An error code
* @param[in] original An instance of %String to replace
- * @param[in] replace An instance of %String to replace all occurrences of @c original
+ * @param[in] replace An instance of %String to replace all the occurrences of @c original
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c original is an empty string.
*/
result Replace(const String& original, const String& replace);
/**
- * Replaces all occurrences of the specified string within the substring
+ * Replaces all the occurrences of the specified string within the substring
* of this instance of %String.
*
* @since 2.0
*
* @return An error code
* @param[in] original An instance of %String to replace
- * @param[in] replace An instance of %String to replace all occurrences of @c original
+ * @param[in] replace An instance of %String to replace all the occurrences of @c original
* @param[in] startIndex The starting position of the substring
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c original is an empty string.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c startIndex is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c startIndex is either greater than or equal to the length of the current instance.
+ * - The specified @c startIndex is less than @c 0.
*/
result Replace(const String& original, const String& replace, int startIndex);
/**
- * Reverses the sequence of characters in the calling instance.
+ * Reverses the sequence of the characters in the calling instance.
*
* @since 2.0
*
* @since 2.0
*
* @return An error code
- * @param[in] ch A new character
+ * @param[in] ch The new character
* @param[in] indexAt The position of the character
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c indexAt is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c indexAt is either greater than or equal to the length of the current instance.
+ * - The specified @c indexAt is less than @c 0.
*/
result SetCharAt(wchar_t ch, int indexAt);
* @param[in] newLength The new length
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c newLength is negative.
- * @remarks If the new length is greater than the current length, the
- * string is padded with spaces. On the other hand,
- * if the new length is smaller than the current length, then
- * the text contained in this instance is truncated.
+ * @remarks If the new length is greater than the current length, the
+ * string is padded with spaces. @n
+ * On the other hand, if the new length is smaller than the current length, then
+ * the text contained in this instance is truncated.
*/
result SetLength(int newLength);
* @param[in] startIndex The starting index of the substring
* @param[out] out The substring
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The specified index is out of range, or
- * the specified @c startIndex is either greater than or equal to the length of the current instance or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c startIndex is either greater than or equal to the length of the current instance.
+ * - The specified @c startIndex is less than @c 0.
*/
result SubString(int startIndex, String& out) const;
* @param[in] length The length of the substring
* @param[out] out The substring
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE Either of the following conditions has occurred: @n
- * - The specified index is out of range. @n
- * - The specified @c startIndex is either greater than or equal to the length of the current instance or less than @c 0. @n
- * - The specified @c length is either greater than the length of substring starting from @c startIndex or less than @c 0.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - The specified @c index is out of the valid range.
+ * - The specified @c startIndex is either greater than or equal to the length of the current instance.
+ * - The specified @c startIndex is less than @c 0.
+ * - The specified @c length is either greater than the length of the substring starting from @c startIndex.
+ * - The specified @c length is less than @c 0.
*/
result SubString(int startIndex, int length, String& out) const;
*
* @since 2.0
*
- * @return @c true if this instance starts with the specified text, @n
+ * @return @c true if this instance starts with the specified text, @n
* else @c false
* @param[in] str The string to match
* @param[in] startIndex The start position of the string
*
* @since 2.0
*
- * @return @c true if this instance ends with the specified text, @n
+ * @return @c true if this instance ends with the specified text, @n
* else @c false
* @param[in] str An instance of %String to match
*/
* Gets the lowercase form of the string in the calling instance. @n
* Unicode characters other than the English alphabets are not changed.
*
- * @brief <i> [Deprecated] </i>
- * @deprecated This method is deprecated as a new method has been introduced.
- * Instead of using this method, use the ToLowerCase(%String& out) method that supports Unicode characters other than the English alphabets.
- * @since 2.0
+ * @brief <i> [Deprecated] </i>
+ * @deprecated This method is deprecated as a new method has been introduced.
+ * Instead of using this method, use the ToLowerCase(%String& out) method that supports Unicode characters other than the English alphabets.
+ * @since 2.0
*
* @return An error code
- * @param[out] out An instance of %String that contains the modified value of the calling instance
+ * @param[out] out An instance of %String that contains the modified value of the calling instance
* @exception E_SUCCESS The method is successful.
* @endif
*/
*
* @brief <i> [Deprecated] </i>
* @deprecated This method is deprecated as a new method has been introduced.
- * Instead of using this method, use the ToUpperCase(%String& out) method that supports Unicode characters other than the English alphabets.
+ * Instead of using this method, use the ToUpperCase(%String& out) method that supports Unicode characters other than the English alphabets.
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[out] out An instance of %String that contains the modified value of the calling instance
* @exception E_SUCCESS The method is successful.
* @endif
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[out] out An instance of %String that contains the modified value of the calling instance
* @exception E_SUCCESS The method is successful.
*/
*
* @brief <i> [Deprecated] </i>
* @deprecated This method is deprecated as a new method has been introduced.
- * Instead of using this method, use the ToLowerCase() method that supports Unicode characters other than the English alphabets.
+ * Instead of using this method, use the ToLowerCase() method that supports Unicode characters other than the English alphabets.
*
* @since 2.0
* @endif
*
* @brief <i> [Deprecated] </i>
* @deprecated This method is deprecated as a new method has been introduced.
- * Instead of using this method, use the ToUpperCase() method that supports Unicode characters other than the English alphabets.
+ * Instead of using this method, use the ToUpperCase() method that supports Unicode characters other than the English alphabets.
*
* @since 2.0
* @endif
* @since 2.0
*
* @return A Unicode pointer to the calling instance's internal buffer
- * @remarks GetPointer() does not guarantee that every call to this function returns same address.
+ * @remarks GetPointer() does not guarantee that every call to this method returns the same address.
*/
const wchar_t* GetPointer(void) const;
*
* @since 2.0
*
- * @return @c true if this instance contains the specified substring, @n
- * else @c false
+ * @return @c true if this instance contains the specified substring, @n
+ * else @c false
* @param[in] str The string to match
*/
bool Contains(const String& str) const;
/**
- * A constant holding the default capacity of %String.
+ * The constant holding the default capacity of %String.
*
* @since 2.0
*/
//
/**
- * @file FBaseStringComparer.h
+ * @file FBaseStringComparer.h
* @brief This is the header file for the %StringComparer class.
*
- * @see String and Tizen::Base::Collection::IComparer
- *
* This header file contains the declarations of the %StringComparer class.
+ *
+ * @see Tizen::Base::String
+ * @see Tizen::Base::Collection::IComparer
*/
#ifndef _FBASE_STRING_COMPARER_H_
#define _FBASE_STRING_COMPARER_H_
{
/**
* @class StringComparer
- * @brief This class checks for equivalence between 2 instances of the %String type.
+ * @brief This class checks for equivalence between two instances of the %String type.
*
* @since 2.0
*
- * The %StringComparer class checks for equivalence between 2 instances of the String type.
+ * The %StringComparer class checks for equivalence between two instances of the String type.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/base/collection_comparison.htm">Collection Comparisons</a>.
*
* @since 2.0
*
* @return An error code
- * @param[in] obj1 An object of String to compare
- * @param[in] obj2 An object of String to compare
- * @param[out] cmp The result of comparison
+ * @param[in] obj1 The object of String to compare
+ * @param[in] obj2 The object of String to compare
+ * @param[out] cmp The result of the comparison
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified object instances are not of the expected type.
* @remarks The value of @c cmp can be:
*
* @code
- * < 0 if the value of @c obj1 is less than the value of @c obj2
- * == 0 if the value of @c obj1 is equal to the value of @c obj2
- * > 0 if the value of @c obj1 is greater than the value of @c obj2
+ * < 0 if the value of obj1 is less than the value of obj2
+ * == 0 if the value of obj1 is equal to the value of obj2
+ * > 0 if the value of obj1 is greater than the value of obj2
* @endcode
*/
virtual result Compare(const Tizen::Base::Object& obj1, const Tizen::Base::Object& obj2, int& cmp) const;
*
* @since 2.1
*
- * @return The hash code of an instance of type String
+ * @return The hash code of the instance of type String
* @param[in] str The String instance whose hash code is requested
- * @remarks The hash algorithm is usually specific to a type.
- * Two equal instances must return the same hash value.
- * For better performance, the used hash function must generate a random distribution for all inputs.
+ * @remarks
+ * - The hash algorithm is usually specific to a type.
+ * - Two equal instances must return the same hash value.@n
+ * For better performance, the used hash function must generate a random distribution for all the inputs.
*/
virtual int GetHashCode(const Tizen::Base::String& str) const;
*
* @return The hash code of the specified object
* @param[in] obj The Object whose hash code is requested
- * @remarks The hash algorithm is usually specific to a type.
- * Two equal instances must return the same hash value.
- * For better performance, the used hash function must generate a random distribution for all inputs.
+ * @remarks
+ * - The hash algorithm is usually specific to a type.
+ * - Two equal instances must return the same hash value. @n
+ * For better performance, the used hash function must generate a random distribution for all the inputs.
*/
virtual int GetHashCode(const Tizen::Base::Object& obj) const;
* @file FBaseSysLog.h
* @brief This is the header file for the %Log macros.
*
- * This header file defines the %Log macros.
+ * This header file defines the Log macros.
*/
#ifndef _FBASE_SYS_LOG_H_
/**
* @mainpage Tizen Platform API Reference
*
- * The Tizen platform API Reference provides descriptions of APIs for the platform developers.
+ * The Tizen platform API Reference provides the description of APIs for the platform developers.
*/
/**
* @defgroup GroupMacros Debugging Macros
*
- * This page describes Tizen debugging macros used by the Tizen modules.
- * These debugging macros should use specific NID ( Namespace ID ) to distinguish each Tizen modules.
+ * This page describes the Tizen debugging macros used by the Tizen modules.
+ * These debugging macros should use specific NIDs ( Namespace ID ) to distinguish each Tizen module.
*
* @since 2.0
*/
*/
/**
- * This macro allows display of informative log messages.
+ * This macro allows the display of informative log messages.
* This system log macro is for the platform modules.
*
* @since 2.0
*
* @param[in] NID The Tizen namespace
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
*
- * The following example demonstrates how to use the SysLog macro.
+ * The following example demonstrates how to use the %SysLog macro.
*
* @code
* bool
#define SysLog(NID, ...) SysLogInternal(NID, __PRETTY_FUNCTION__, __LINE__, __VA_ARGS__)
/**
- * This macro allows display of exception log messages with a tag and sets the last result.
+ * This macro allows the display of exception log messages with a tag and sets the last result.
* This system log macro is for the platform modules.
*
* @since 2.0
#define SysLogException(NID, r, ...) SysLogExceptionInternal(NID, r, __PRETTY_FUNCTION__, __LINE__, __VA_ARGS__)
/**
- * This macro allows display of informative log messages with a tag.
+ * This macro allows the display of informative log messages with a tag.
* This system log macro is for the platform modules.
*
* @since 2.0
*
* @param[in] NID The Tizen namespace
* @param[in] tag The user defined tag
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
*
* The following example demonstrates how to use the SysLogTag macro.
*
#define SysLogTag(NID, tag, ...) SysLogTagInternal(NID, tag, __PRETTY_FUNCTION__, __LINE__, __VA_ARGS__)
/**
- * This macro allows display of exception log messages with a tag and sets the last result.
+ * This macro allows the display of exception log messages with a tag and sets the last result.
* This system log macro is for the platform modules.
*
* @since 2.0
* @param[in] NID The Tizen namespace
* @param[in] tag The user defined tag
* @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
*
* The following example demonstrates how to use the SysLogTagException macro.
*
/**
- * This macro allows display of informative log message with a tag, when the condition is @c false.
+ * This macro allows the display of informative log messages with a tag, when the condition is @c false.
* This system log macro is for the platform modules.
*
* @since 2.0
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
+ * @param[in] condition The condition that is expected to be true
* @param[in] ... The message to display
*
* The following example demonstrates how to use the SysTryLog macro.
} while (0);
/**
- * This macro allows display of informative log message, when the condition is @c false.
- * Executes statements and goes to label.
+ * This macro allows the display of informative log messages, when the condition is @c false.
+ * Executes statements and goes to the catch label.
* This system log macro is for the platform modules.
*
* @since 2.0
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] condition The condition that is expected to be true
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] ... The message to display
*
* The following example demonstrates how to use the SysTryLogCatch macro.
} while (0);
/**
- * This macro allows display of informative log message and returns returnValue, when the condition is @c false.
+ * This macro allows the display of informative log messages and returns @c returnValue, when the condition is @c false.
* This system log macro is for the platform modules.
*
* @since 2.0
*
- * @param[in] NID The Tizen namespace
+ * @param[in] NID The Tizen namespace
* @param[in] condition The condition that is expected to be true
- * @param[in] returnValue The value to return when the condition is @c false
- * @param[in] ... The message to display
+ * @param[in] returnValue The value to return when the condition is @c false
+ * @param[in] ... The message to display
*
* The following example demonstrates how to use the SysTryLogReturn macro.
*
/**
- * This macro allows display of exception log message with a tag and sets the last result, when the condition is @c false.
+ * This macro allows the display of exception log messages with a tag and sets the last result, when the condition is @c false.
* This system log macro is for the platform modules.
*
* @since 2.0
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
- * @param[in] returnValue The value to return when the condition is @c false
+ * @param[in] condition The condition that is expected to be true
+ * @param[in] returnValue The value to return when the condition is @c false
* @param[in] r The last result to set
* @param[in] ... The message to display
*
} while (0);
/**
- * This macro allows display of exception log message with a tag and sets the last result, when the condition is @c false.
+ * This macro allows the display of exception log messages with a tag and sets the last result, when the condition is @c false.
* This is a shorthand macro for SysTryReturn(NID, condition, r, r, "[" # r "] " ...).
* This system log macro is for the platform modules.
*
* @since 2.0
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
+ * @param[in] condition The condition that is expected to be true
* @param[in] r The last result to set
* @param[in] ... The message to display
*
} while (0);
/**
- * This macro allows display of exception log message with a tag and sets the last result, when the condition is @c false.
+ * This macro allows the display of exception log messages with a tag and sets the last result, when the condition is @c false.
* This system log macro is for the platform modules.
*
* @since 2.0
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
+ * @param[in] condition The condition that is expected to be true
* @param[in] r The last result to set
* @param[in] ... The message to display
*
} while (0);
/**
- * This macro allows display of exception log message with a tag, when the condition is @c false.
- * Executes statements, sets the last result and goes to label.
+ * This macro allows the display of exception log messages with a tag, when the condition is @c false.
+ * Executes statements, sets the last result and goes to the catch label.
* This system log macro is for the platform modules.
*
* @since 2.0
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] condition The condition that is expected to be true
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] r The last result to set
* @param[in] ... The message to display
*
} while (0);
/**
- * This macro allows display of exception log message with a tag, when the condition is @c false.
- * Executes statements, sets the last result and goes to label.
+ * This macro allows the display of exception log messages with a tag, when the condition is @c false.
+ * Executes statements, sets the last result and goes to the catch label.
* This system log macro is for the platform modules.
*
* @since 2.0
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to catchLabel label
- * @param[in] catchLabel The label for goto operation
+ * @param[in] condition The condition that is expected to be true
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] catchLabel The label for the goto operation
* @param[in] r The last result to set
* @param[in] ... The message to display
*
/**
- * This macro allows display of exception log message and the program will expire, when the condition is @c false.
+ * This macro allows the display of exception log messages and the program expires, when the condition is @c false.
* This system log macro is for the platform modules.
*
* @since 2.0
} while (0);
/**
- * This macro allows display of exception log message with a tag and the program will expire, when the condition is @c false.
+ * This macro allows the display of exception log messages with a tag and the program expires, when the condition is @c false.
* This system log macro is for the platform modules.
*
* @since 2.0
*
- * @param[in] condition The condition that is expected to be true
+ * @param[in] condition The condition that is expected to be true
* @param[in] ... The message to display
*
* The following example demonstrates how to use the SysAssertf macro.
/**
- * This macro generates an error message during compile time, when the condition is @c false.
+ * This macro generates an error message during the compile time, when the condition is @c false.
* This system log macro is for the platform modules.
*
* @since 2.0
/**
- * This macro allows display of exception log messages.
+ * This macro allows the display of exception log messages.
* This system log macro is for the platform modules.
*
* @since 2.0
#else
/**
- * This macro is to protect informative log messages which needs to keep security.
- * It allows display of informative log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect informative log messages which need security.
+ * It allows the display of informative log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
#define SysSecureLog(NID, ...)
/**
- * This macro is to protect exception log messages which needs to keep security, and sets the last result.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * This macro is used to protect exception log messages which needs security, and sets the last result.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
#define SysSecureLogException(NID, r,...) SetLastResult(r);
/**
- * This macro is to protect informative log messages which needs to keep security, with a tag.
- * It allows display of informative log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect informative log messages which need security, with a tag.
+ * It allows the display of informative log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
#define SysSecureLogTag(NID, tag, ...)
/**
- * This macro is to protect exception log messages which needs to keep security, with a tag and sets the last result.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * This macro is used to protect exception log messages which need security, with a tag and sets the last result.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
#endif
/**
- * This macro allows display of informative log message with a tag, when the condition is @c false.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * This macro allows the display of informative log messages with a tag, when the condition is @c false.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
+ * @param[in] condition The condition that is expected to be true
* @param[in] ... The message to display
*
* The following example demonstrates how to use the SysSecureTry macro.
} while (0);
/**
- * This macro allows display of informative log message, when the condition is @c false.
- * Executes statements and goes to label.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * This macro allows the display of informative log messages, when the condition is @c false.
+ * Executes statements and goes to the catch label.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] condition The condition that is expected to be true
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] ... The message to display
* @hideinitializer
*/
} while (0);
/**
- * This macro allows display of informative log message and returns returnValue, when the condition is @c false.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * This macro allows the display of informative log messages and returns @c returnValue, when the condition is @c false.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
- * @param[in] returnValue The value to return when the condition is @c false
+ * @param[in] condition The condition that is expected to be true
+ * @param[in] returnValue The value to return when the condition is @c false
* @param[in] ... The message to display
* @hideinitializer
*/
} while (0);
/**
- * This macro allows display of exception log message with a tag and sets the last result, when the condition is @c false.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * This macro allows the display of exception log messages with a tag and sets the last result, when the condition is @c false.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
- * @param[in] returnValue The value to return when the condition is @c false
+ * @param[in] condition The condition that is expected to be true
+ * @param[in] returnValue The value to return when the condition is @c false
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
#if defined(_SECURE_LOG)
/**
- * This macro allows display of exception log message with a tag and sets the last result, when the condition is @c false.
+ * This macro allows the display of exception log messages with a tag and sets the last result, when the condition is @c false.
* This is a shorthand macro for SysSecureTryReturn(NID, condition, r, r, "[" # r "] " ...).
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
+ * @param[in] condition The condition that is expected to be true
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
#endif
/**
- * This macro allows display of exception log message with a tag and sets the last result, when the condition is @c false.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * This macro allows the display of exception log messages with a tag and sets the last result, when the condition is @c false.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
+ * @param[in] condition The condition that is expected to be true
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
} while (0);
/**
- * This macro allows display of exception log message with a tag, when the condition is @c false.
- * Executes statements, sets the last result and goes to label.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * This macro allows the display of exception log messages with a tag, when the condition is @c false.
+ * Executes statements, sets the last result and goes to the catch label.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
+ * @param[in] condition The condition that is expected to be true
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
} while (0);
/**
- * This macro allows display of exception log message with a tag, when the condition is @c false.
- * Executes statements, sets the last result and goes to label.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * This macro allows the display of exception log messages with a tag, when the condition is @c false.
+ * Executes statements, sets the last result and goes to the catch label.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
* This system log macro is for the platform modules.
*
* @since 2.1
*
* @param[in] NID The Tizen namespace
- * @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to catchLabel label
- * @param[in] catchLabel The label for goto operation
+ * @param[in] condition The condition that is expected to be true
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] catchLabel The label for the goto operation
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
bool operator !=(const TimeSpan& rhs) const;
/**
- * Checks whether the value of the calling instance is less than that of
- * the specified instance of %TimeSpan.
+ * Checks whether the value of the calling instance is less than
+ * the value of the specified instance of %TimeSpan.
*
* @since 2.0
*
- * @return @c true if the value of the calling instance is less than that of the specified instance of %TimeSpan, @n
+ * @return @c true if the value of the calling instance is less than the value of the specified instance of %TimeSpan, @n
* else @c false
* @param[in] rhs An instance of %TimeSpan to compare
*/
bool operator <(const TimeSpan& rhs) const;
/**
- * Checks whether the value of the calling instance is greater than that of
- * the specified instance of %TimeSpan.
+ * Checks whether the value of the calling instance is greater than
+ * the value of the specified instance of %TimeSpan.
*
* @since 2.0
*
- * @return @c true if the value of the calling instance is greater than that of the specified instance of %TimeSpan, @n
+ * @return @c true if the value of the calling instance is greater than the value of the specified instance of %TimeSpan, @n
* else @c false
* @param[in] rhs An instance of %TimeSpan to compare
*/
*
* @since 2.0
*
- * @return A 32-bit @c signed integer value
+ * @return The 32-bit @c signed integer value
* @param[in] t1 An instance of %TimeSpan to compare
* @param[in] t2 An instance of %TimeSpan to compare
*
* @code
- * < 0 if the value of @c t1 is less than the value of @c t2
- * == 0 if the value of @c t1 is equal to the value of @c t2
- * > 0 if the value of @c t1 is greater than the value of @c t2
+ * < 0 if the value of t1 is less than the value of t2
+ * == 0 if the value of t1 is equal to the value of t2
+ * > 0 if the value of t1 is greater than the value of t2
* @endcode
*/
static int Compare(const TimeSpan& t1, const TimeSpan& t2);
*
* @since 2.0
*
- * @return A 32-bit @c signed integer value
+ * @return The 32-bit @c signed integer value
* @param[in] value An instance of %TimeSpan to compare
*
* @code
- * < 0 if the value of the current instance is less than the value of @c obj
- * == 0 if the value of the current instance is equal to the value of @c obj
- * > 0 if the value of the current instance is greater than the value of @c obj
+ * < 0 if the value of the current instance is less than the value of obj
+ * == 0 if the value of the current instance is equal to the value of obj
+ * > 0 if the value of the current instance is greater than the value of obj
* @endcode
*/
int CompareTo(const TimeSpan& value) const;
*
* @since 2.0
*
- * @return An instance of %TimeSpan containing the absolute value
- * @remarks This method is used to get absolute difference between two %TimeSpan instances.
+ * @return An instance of %TimeSpan that contains the absolute value
+ * @remarks This method is used to get the absolute difference between two %TimeSpan instances.
*
* @code
* TimeSpan t1(1000); // 1000 milliseconds
*
* @since 2.0
*
- * @return An instance of %Timespan containing the negative value of the calling instance
+ * @return An instance of %Timespan that contains the negative value of the calling instance
*/
TimeSpan Negate(void) const;
long long GetTicks(void) const;
/**
- * A constant holding the number of ticks in a day.
+ * The constant holding the number of ticks in a day.
*
* @since 2.0
*/
static const long long NUM_OF_TICKS_IN_DAY = 86400000LL;
/**
- * A constant holding the number of ticks in an hour.
+ * The constant holding the number of ticks in an hour.
*
* @since 2.0
*/
static const long long NUM_OF_TICKS_IN_HOUR = 3600000LL;
/**
- * A constant holding the number of ticks in a minute.
+ * The constant holding the number of ticks in a minute.
*
* @since 2.0
*/
static const long long NUM_OF_TICKS_IN_MINUTE = 60000LL;
/**
- * A constant holding the number of ticks in a second.
+ * The constant holding the number of ticks in a second.
*
* @since 2.0
*/
*/
enum SortOrder
{
- SORT_ORDER_ASCENDING = 0, /**< A constant for sorting the results in ascending order */
- SORT_ORDER_DESCENDING, /**< A constant for sorting the results in descending order */
- SORT_ORDER_NONE /**< A constant for indicating the results are not sorted */
+ SORT_ORDER_ASCENDING = 0, /**< A constant for sorting the results in the ascending order */
+ SORT_ORDER_DESCENDING, /**< A constant for sorting the results in the descending order */
+ SORT_ORDER_NONE /**< A constant for indicating that the results are not sorted */
};
*/
enum ComparisonOperator
{
- COMPARISON_OP_EQUAL = 0, /**< A comparison operator that checks the value equality */
- COMPARISON_OP_NOT_EQUAL, /**< A comparison operator that checks the value inequality */
+ COMPARISON_OP_EQUAL = 0, /**< A comparison operator that checks the value's equality */
+ COMPARISON_OP_NOT_EQUAL, /**< A comparison operator that checks the value's inequality */
COMPARISON_OP_GREATER_THAN, /**< A comparison operator that checks whether a value is greater than the other */
COMPARISON_OP_LESS_THAN, /**< A comparison operator that checks whether a value is less than the other */
COMPARISON_OP_GREATER_THAN_EQUAL_TO, /**< A comparison operator that checks whether a value is greater than or equal to the other */
#include <FBaseUtilScanner.h>
/**
- * @namespace Tizen::Base::Utility
- * @brief This namespace contains classes for various utilities.
+ * @namespace Tizen::Base::Utility
+ * @brief This namespace contains classes for various utilities.
* @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FBase.h> @n
- * @b Library : @b osp-appfw
+ * @b Library: @b osp-appfw
*
* The %Utility namespace contains interfaces and classes that
* define various utilities of an object, such as Math and StringTokenizer.
- * It also contains methods to perform some common functions needed by the applications, such as file zipping and URL encoding and decoding.
+ * It also contains methods to perform some common functions needed by applications, such as file zipping, and URL encoding and decoding.
*
- * For more information on the %Base::Utility namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/base/utility_namespace.htm">Utility</a>.
+ * For more information on the %Utility namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/base/utility_namespace.htm">Utility</a>.
*
* The following diagram illustrates the relationships between the classes belonging to the %Utility namespace.
* @image html base_utility_namespace_classdiagram.png
* @return A pointer to the ByteBuffer instance with the deflated equivalent of the source buffer @n
* The buffer's limit is the length of the deflated data, @n
* else @c null if an exception occurs.
- * @param[in] src The buffer to deflate
- * @param[in] byteCount The number of bytes to deflate from the source buffer
- * @param[in] level Set to @c BEST_SPEED or @c BEST_COMPRESSION @n
- * By default, it is set to @c DEFAULT_COMPRESSION.
- * @exception E_SUCCESS The method is successful.
+ * @param[in] src The buffer to deflate
+ * @param[in] byteCount The number of bytes to deflate from the source buffer
+ * @param[in] level Set to @c BEST_SPEED or @c BEST_COMPRESSION @n
+ * By default, it is set to @c DEFAULT_COMPRESSION.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @return A pointer to the ByteBuffer instance with the deflated equivalent of the source buffer @n
* The buffer's limit is the length of the deflated data, @n
* else @c null if an exception occurs.
- * @param[in] src The buffer to deflate
- * @param[in] level Set to @c BEST_SPEED or @c BEST_COMPRESSION @n
- * By default, it is set to @c DEFAULT_COMPRESSION.
- * @exception E_SUCCESS The method is successful.
+ * @param[in] src The buffer to deflate
+ * @param[in] level Set to @c BEST_SPEED or @c BEST_COMPRESSION @n
+ * By default, it is set to @c DEFAULT_COMPRESSION.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Tizen::Base::Utility::Inflator
*/
/**
* Initializes this instance of %FileUnzipper with the specified filepath. @n
- * This method opens a zip file in the read mode.
+ * The %Construct() method opens a zip file in the read mode.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
* @endif
*
* @return An error code
- * @param [in] filePath The path of the file to open or create
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified path is @c 0 or exceeds system limitations. @n
- * - The specified path contains prohibited character(s). @n
+ * @param [in] filePath The path of the file to open or create
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified path is either @c 0 or exceeds system limitations.
+ * - The specified path contains prohibited character(s).
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS The specified file path is inaccessible as per the %Tizen platform policy.
+ * @exception E_ILLEGAL_ACCESS The specified @c filePath is inaccessible as per the Tizen platform policy.
* @exception E_FILE_NOT_FOUND The specified file cannot be found or accessed.
- * @exception E_IO An unexpected device failure has occurred.
+ * @exception E_IO An unexpected device failure has occurred.
* @remarks The paths for @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"data" and @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"trusted" are not supported.
* @see Tizen::Io::File
*/
* Unzips a zip file at the specified path or destination.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
* @endif
*
* @return An error code
- * @param [in] dirPath A directory path to unzip
+ * @param [in] dirPath The directory path to unzip
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified path is @c 0 or exceeds system limitations. @n
- * - The specified path contains prohibited character(s). @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified path is either @c 0 or exceeds system limitations.
+ * - The specified path contains prohibited character(s).
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS The specified path is not permitted, or
- * access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The specified path is not permitted.
+ * - The access is denied due to insufficient permission.
* @exception E_IO An unexpected device failure has occurred.
- * @remarks The paths for @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"data" and @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"trusted" are not supported.
- * @remarks This operation consumes a lot of time if the zip-archive contains large number of files or
- * directories.
- * In such cases, it is recommended to call this method in a separate thread.
+ * @remarks
+ * - The paths for @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"data" and @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"trusted" are not supported.
+ * - This operation consumes a lot of time if the zip-archive contains large number of files or
+ * directories. @n
+ * In such cases, it is recommended to call this method in a separate thread.
* @see Tizen::Io::File
*/
result UnzipTo(const String& dirPath) const;
* Unzips a zip entry from a zip-archive to the specified path.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
* @endif
*
* @return An error code
- * @param [in] dirPath A directory path to unzip
- * @param [in] zipEntryName A zip entry name that could be a file or directory name
+ * @param [in] dirPath The directory path to unzip
+ * @param [in] zipEntryName The zip entry name that could be a file or a directory name
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified path is @c 0 or exceeds system limitations. @n
- * - The specified path contains prohibited character(s). @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified path is either @c 0 or exceeds system limitations. @n
+ * - The specified path contains prohibited character(s).
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS The specified path is not permitted, or
- * access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The specified path is not permitted.
+ * - The access is denied due to insufficient permission.
* @exception E_FILE_NOT_FOUND The entry of the specified file or path cannot be found in the archive.
* @exception E_IO An unexpected device failure has occurred.
- * @remarks The paths for @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"data" and @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"trusted" are not supported.
- * @remarks If the value of @c zipEntryName is a directory name present in the archive, this method
+ * @remarks
+ * - The paths for @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"data" and @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"trusted" are not supported.
+ * - If the value of @c zipEntryName is a directory name present in the archive, this method
* creates an empty directory. @n
* For example, UnzipTo(Tizen::App::App::GetInstance()->GetAppDataPath() + L"Test/", L"/someDir/") will create @b '[AppDataPath]/Test/someDir'
- * directory only, and the files or subdirectories under @b 'someDir' will not be extracted.
+ * directory only, and the files or subdirectories under @b 'someDir' are not extracted.
* @see Tizen::Io::File
*/
result UnzipTo(const String& dirPath, const String& zipEntryName) const;
int GetDirectoryCount(void) const;
/**
- * Gets a zip entry associated with the file or directory name passed as parameter.
+ * Gets a zip entry associated with the file or directory name passed as a parameter.
*
* @since 2.0
*
* @return An error code
- * @param [in] zipEntryName A zip entry name that could be a file or directory name
+ * @param [in] zipEntryName The zip entry name that could be a file or directory name
* @param [out] entry A reference to the ZipEntry
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified path is @c 0 or exceeds system limitations. @n
- * - The specified path contains prohibited character(s). @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified path is either @c 0 or exceeds system limitations.
+ * - The specified path contains prohibited character(s).
* - The specified path is invalid.
* @exception E_FILE_NOT_FOUND The entry of the specified file or path cannot be found in the archive.
* @exception E_IO An unexpected device failure has occurred.
- * @remarks If the value of @c zipEntryName is a directory name, it must have a suffix '/'.
- * For example, @b Tizen::App::App::GetInstance()->GetAppDataPath() + L"Test/" or @b Tizen::App::App::GetInstance()->GetAppDataPath() + L"Test/DATA/".
+ * @remarks If the value of @c zipEntryName is a directory name, it must have a suffix '/'. @n
+ * For example, @b Tizen::App::App::GetInstance()->GetAppDataPath() + L"Test/" or @b Tizen::App::App::GetInstance()->GetAppDataPath() + L"Test/DATA/".
*/
result GetEntry(const String& zipEntryName, ZipEntry& entry) const;
* @since 2.0
*
* @return An error code
- * @param [in] index An index of the zip entry to access @n
+ * @param [in] index The index of the zip entry to access @n
* The index starts from @c 0.
* @param [out] entry A reference to the ZipEntry
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified index is out of range, or an invalid index is passed.
+ * @exception E_INVALID_ARG The specified index is either invalid or out of the valid range.
* @exception E_IO An unexpected device failure has occurred.
*/
result GetEntry(int index, ZipEntry& entry) const;
/**
* Initializes this instance of %FileZipper with the specified filepath. @n
- * This method opens an existing zip file in append mode. If the file does not exist, it creates and opens the file in
+ * This method opens an existing zip file in the append mode. If the file does not exist, it creates and opens the file in the
* append mode.
*
* @if OSPCOMPAT
* @endif
*
* @return An error code
- * @param [in] filePath The path of the zip file to open or create
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified path is @c 0 or exceeds system limitations. @n
- * - The specified path contains prohibited character(s). @n
+ * @param [in] filePath The path of the zip file to open or create
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified path is either @c 0 or exceeds system limitations.
+ * - The specified path contains prohibited character(s).
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS The specified path is not permitted, or
- * access is denied due to insufficient permission.
- * @exception E_IO An unexpected device failure has occurred.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The specified path is not permitted.
+ * - The access is denied due to insufficient permission.
+ * @exception E_IO An unexpected device failure has occurred.
* @remarks The paths for @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"data" and @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"trusted" are not supported.
* @see Tizen::Io::File
*/
* @endif
*
* @return An error code
- * @param [in] filePath The path of the file to add to the zip file
- * @param [in] excludePath Set to @c true to exclude the path and to store only the file name, @n
- * else @c false to insert the entire path name in the zip-archive
- * @param [in] level Set to @c BEST_SPEED or @c BEST_COMPRESSION @n
- * By default, it is set to @c DEFAULT_COMPRESSION.
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified path is @c 0 or exceeds system limitations. @n
- * - The specified path contains prohibited character(s). @n
- * - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS The specified path is not permitted, or
- * access is denied due to insufficient permission.
- * @exception E_FILE_NOT_FOUND The specified file cannot be found.
+ * @param [in] filePath The path of the file to add to the zip file
+ * @param [in] excludePath Set to @c true to exclude the path and to store only the file name, @n
+ * else @c false to insert the entire path name in the zip-archive
+ * @param [in] level Set to @c BEST_SPEED or @c BEST_COMPRESSION @n
+ * By default, it is set to @c DEFAULT_COMPRESSION.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified path is either @c 0 or exceeds system limitations.
+ * - The specified path contains prohibited character(s).
+ * - The specified path is invalid.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The specified path is not permitted.
+ * - The access is denied due to insufficient permission.
+ * @exception E_FILE_NOT_FOUND The specified file cannot be found.
* @exception E_FILE_ALREADY_EXIST The specified file already exists in the zip-archive, but the
* flag for overwriting the file is not set.
- * @exception E_IO An unexpected device failure has occurred.
- * @remarks The paths for @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"data" and @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"trusted" are not supported.
- * @remarks If the value of @c excludePath is set to @c false, full path name is inserted to the zip-
+ * @exception E_IO An unexpected device failure has occurred.
+ * @remarks
+ * - The paths for @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"data" and @b Tizen::App::AppManager::GetAppSharedPath(appId) + L"trusted" are not supported.
+ * - If the value of @c excludePath is set to @c false, the full path name is inserted to the zip-
* archive. Therefore, developers should handle the path name carefully. @n
- * For example, if you add @b '/Test/data.txt' file to the zip-archive, and if the
- * @c excludePath parameter is set to @c false, while unzipping the file in @b '/Test'
+ * For example, if you add @b '/Test/data.txt' file to the zip-archive, and if
+ * @c excludePath is set to @c false, while unzipping the file in @b '/Test'
* directory, then the file is extracted in @b '/Test/Test/data.txt'.
* @see Tizen::Io::File
*/
* @return A pointer to the ByteBuffer instance with the inflated equivalent of the source buffer @n
* The buffer's limit is the length of the inflated data, @n
* else @c null if an exception occurs.
- * @param[in] src The buffer to inflate
- * @param[in] byteCount The number of bytes to inflate from the source buffer
- * @exception E_SUCCESS The method is successful.
+ * @param[in] src The buffer to inflate
+ * @param[in] byteCount The number of bytes to inflate from the source buffer
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Tizen::Base::Utility::Deflator
*/
* @return A pointer to the ByteBuffer instance with the inflated equivalent of the source buffer @n
* The buffer's limit is the length of the inflated data, @n
* else @c null if an exception occurs.
- * @param[in] src The buffer to inflate
- * @exception E_SUCCESS The method is successful.
+ * @param[in] src The buffer to inflate
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Tizen::Base::Utility::Deflator
*/
* @param[in] linkType The link type
* @param[in] link The link
* @remarks The link's @c text is set to the same string as @c link.
- * @see Tizen::Base::Utility::LinkType
*/
LinkInfo(LinkType linkType, const Tizen::Base::String& link);
*
* @param[in] linkType The link type
* @param[in] link The link
- * @param[in] text A string that represents the link
- * @see Tizen::Base::Utility::LinkType
+ * @param[in] text The string that represents the link
*/
LinkInfo(LinkType linkType, const Tizen::Base::String& link, const Tizen::Base::String& text);
* @since 2.0
*
* @return A reference to the calling instance
- * @param[in] rhs An instance of %LinkInfo
+ * @param[in] rhs An instance of %LinkInfo to copy
*/
LinkInfo& operator =(const LinkInfo& rhs);
*
* @return The link type
* @see SetLinkType()
- * @see Tizen::Base::Utility::LinkType
*/
LinkType GetLinkType(void) const;
*
* @param[in] linkType The link type
* @see GetLinkType()
- * @see Tizen::Base::Utility::LinkType
*/
void SetLinkType(LinkType linkType);
{
/**
* @class Math
- * @brief This class is the wrapper class for %Math Library.
+ * @brief This class is the wrapper class for the %Math Library.
*
* @since 2.0
*
static int Abs(int x);
/**
- * Gets the arc sine of the specified @c double integer. @n
+ * Gets the arc sine of the specified @c double integer. @n
* Returns a value between @c -PI/2 and @c PI/2.
*
* @since 2.0
*
* @return The arc sine of the input, @n
- * else Not-a-Number if @c x is out of range
+ * else Not-a-Number if @c x is out of the valid range
* @param[in] x A radian angle @n
- * It must be within the range @c -1 to @c 1 (inclusive).
+ * It must be within the range @c -1 to @c 1 (inclusive).
* @see Acos()
* @see Atan()
*/
static double Asin(double x);
/**
- * Gets the arc cosine of the specified double integer. @n
+ * Gets the arc cosine of the specified double integer. @n
* Returns a value between @c 0 and @c PI.
*
* @since 2.0
*
* @return The arc cosine of the input, @n
- * else Not-a-Number if @c x is out of range
+ * else Not-a-Number if @c x is out of the valid range
* @param[in] x A radian angle @n
- * It must be within the range @c -1 to @c 1 (inclusive).
+ * It must be within the range @c -1 to @c 1 (inclusive).
* @see Asin()
* @see Atan()
*/
static double Acos(double x);
/**
- * Gets the arc tangent of the specified @c double integer. @n
+ * Gets the arc tangent of the specified @c double integer. @n
* Returns a value between @c -PI/2 and @c PI/2.
*
* @since 2.0
*
* @return The arc tangent of the input
- * @param[in] x A radian angle
+ * @param[in] x A radian angle
* @see Asin()
* @see Acos()
*/
* @since 2.0
*
* @return The smallest integer that is greater than or equal to the input
- * @param[in] x A floating point value
+ * @param[in] x A floating point value
*/
static double Ceiling(double x);
/**
- * Gets the cosine of the specified @c double integer. @n
+ * Gets the cosine of the specified @c double integer. @n
* Returns a value between @c -1 and @c 1.
*
* @since 2.0
*
- * @return The cosine of the input
+ * @return The cosine of the input
* @param[in] x A radian angle
* @see Sin()
* @see Tan()
static double Cos(double x);
/**
- * Gets the hyperbolic cosine of the specified @c double integer.
+ * Gets the hyperbolic cosine of the specified @c double integer.
*
* @since 2.0
*
static double Cosh(double x);
/**
- * Gets the exponential value of the specified @c double integer.
+ * Gets the exponential value of the specified @c double integer.
*
* @since 2.0
*
* @return The exponential value of the input
- * @param[in] x A floating point value
+ * @param[in] x A floating point value
*/
static double Exp(double x);
* @since 2.0
*
* @return The largest @c double integer that is less than or equal to the input
- * @param[in] x A floating point value
+ * @param[in] x A floating point value
*/
static double Floor(double x);
* @since 2.0
*
* @return The natural logarithm of the input
- * @param[in] x A floating point value
+ * @param[in] x A floating point value
*/
static double Log(double x);
* @since 2.0
*
* @return The logarithm to the base 10 of the input
- * @param[in] x A floating point value
+ * @param[in] x A floating point value
*/
static double Log10(double x);
* @since 2.0
*
* @return The greater of the two integer values
- * @param[in] x An integer value
- * @param[in] y An integer value
+ * @param[in] x An integer value
+ * @param[in] y An integer value
* @see Min()
*/
static int Max(int x, int y);
* @since 2.0
*
* @return The greater of the two floating point values
- * @param[in] x A floating point value
- * @param[in] y A floating point value
- * @see Min()
+ * @param[in] x A floating point value
+ * @param[in] y A floating point value
+ * @see Min()
*/
static double Max(double x, double y);
* @since 2.0
*
* @return The smaller of the two integer values
- * @param[in] x An integer value
- * @param[in] y An integer value
+ * @param[in] x An integer value
+ * @param[in] y An integer value
* @see Max()
*/
static int Min(int x, int y);
* @since 2.0
*
* @return The smaller of the two @c double values
- * @param[in] x A floating point value
- * @param[in] y A floating point value
+ * @param[in] x A floating point value
+ * @param[in] y A floating point value
* @see Max()
*/
static double Min(double x, double y);
* @since 2.0
*
* @return @c x raised to the power of @c y, @n
- * else Not-a-Number if @c x and @c y do not satisfy the conditions described below
- * @param[in] x A floating point value
- * @param[in] y A floating point value
- * @remarks @li @c x cannot be negative if @c y is a fractional value.
- * @li @c x cannot be @c 0 if @c y is less than or equal to @c 0.
+ * else Not-a-Number if @c x and @c y do not satisfy the conditions described below
+ * @param[in] x A floating point value
+ * @param[in] y A floating point value
+ * @remarks
+ * - @li @c x cannot be negative if @c y is a fractional value.
+ * - @li @c x cannot be @c 0 if @c y is less than or equal to @c 0.
*/
static double Pow(double x, double y);
* @since 2.0
*
* @return The closest integer to the specified input
- * @param[in] x A floating point value
+ * @param[in] x A floating point value
*/
static double Round(double x);
/**
- * Gets the sine of the specified @c double integer. @n
+ * Gets the sine of the specified @c double integer. @n
* Returns a value between @c -1 and @c 1.
*
* @since 2.0
*
* @return The sine of the input
- * @param[in] x A radian angle
+ * @param[in] x A radian angle
* @see Cos()
* @see Tan()
*/
static double Sin(double x);
/**
- * Gets the hyperbolic sine of the specified @c double integer.
+ * Gets the hyperbolic sine of the specified @c double integer.
*
* @since 2.0
*
* @return The hyperbolic sine of the input
- * @param[in] x A radian angle
+ * @param[in] x A radian angle
*/
static double Sinh(double x);
* @since 2.0
*
* @return The square root of the input, @n
- * else Not-a-Number if @c x is a negative number
- * @param[in] x A non-negative floating point value
+ * else Not-a-Number if @c x is a negative number
+ * @param[in] x A non-negative floating point value
*/
static double Sqrt(double x);
/**
- * Gets the tangent of the specified @c double integer.
+ * Gets the tangent of the specified @c double integer.
*
* @since 2.0
*
* @return The tangent of the input
- * @param[in] x A radian angle
+ * @param[in] x A radian angle
* @see Sin()
* @see Cos()
*/
* @since 2.0
*
* @return The hyperbolic tangent of the input
- * @param[in] x A radian angle
+ * @param[in] x A radian angle
*/
static double Tanh(double x);
*
* @since 2.0
*
- * @param[in] seed An integer value to use as seed by the pseudo-random number generator algorithm
+ * @param[in] seed The integer value used as a seed by the pseudo-random number generator algorithm
* @see Rand()
*/
static void Srand(unsigned int seed);
*
* @since 2.0
*
- * @return An integer value between @c 0 and @c RAND_VALUE_MAX
+ * @return The integer value between @c 0 and @c RAND_VALUE_MAX
* @remarks This method uses a seed to generate the pseudo-random numbers, that must be initialized to some distinctive value using Srand().
* @see Srand()
*/
static int Rand(void);
/**
- * Gets the constant value of E (the base of natural logarithms).
+ * Gets the constant value of E (the base of natural logarithms).
*
* @since 2.0
*
static const double GetE(void);
/**
- * Gets the constant value of PI.
+ * Gets the constant value of PI.
*
* @since 2.0
*
static const double GetPi(void);
/**
- * The maximum value that can be returned by the Rand() method.
- *
- * @since 2.0
- */
+ * The maximum value that can be returned by the Rand() method.
+ *
+ * @since 2.0
+ */
static const int RAND_VALUE_MAX = 32767; // 0x7fff
{
/**
* @class Scanner
- * @brief This class provides to parse primitive types and strings, and supports to use regular expressions and various encoding schemes.
+ * @brief This class provides methods to parse primitive types and strings, and supports the use of regular expressions and various encoding schemes.
* @since 2.1
*
- * The %Scanner class breaks the input, which can be either a %String instance or strings from a file, into tokens using a delimiter.
+ * The %Scanner class breaks the input, which can either be a String instance or strings from a file, into tokens using a delimiter.
* The delimiter is set to whitespace as a default value. The resulting tokens are converted into values of different types according
* to the methods in %Scanner.
*
*
* @since 2.1
* @return An error code
- * @param[in] inputStr The string to scan
+ * @param[in] inputStr The string to scan
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The length of the specified @c string parameter is @c 0.
+ * @exception E_INVALID_ARG The length of the specified @c string is @c 0.
*/
result Construct(const String& inputStr);
*
* @since 2.1
* @return An error code
- * @param[in] inputFilePath The file to read to construct input data
- * @param[in] encodingScheme The encoding type of the file
- * @exception E_SUCCESS The method is successful.
+ * @param[in] inputFilePath The file to read to construct input data
+ * @param[in] encodingScheme The encoding type of the file
+ * @exception E_SUCCESS The method is successful.
* @exception E_FILE_NOT_FOUND The input file does not exist.
- * @exception E_IO The file operation is invalid.
- * @exception E_INVALID_ARG The specified encoding scheme does not exist.
+ * @exception E_IO The file operation is invalid.
+ * @exception E_INVALID_ARG The specified encoding scheme does not exist.
* @remarks The supported encoding schemes are ASCII, GSM, UCS-2, UCS-2LE, UCS-2BE, UCS-4, UCS-4LE, UCS-4BE, UTF-8, UTF-16, UTF-16LE, UTF-16BE, UTF-32, UTF-32LE, UTF-32BE, ISO-8859-1~16 (except ISO-8859-12), Windows-874, Windows-1250 ~ Windows-1258, KSC5601, BIG5, GB2312, Shift_JIS, and ISO-2022-jp.
*/
result Construct(const String& inputFilePath, const String& encodingScheme);
/**
- * Gets the substring of the input data matching to the pattern constructed from the specified string. @n
- * Delimiter will be ignored and the returned string does not include any line terminator.
- * If such a pattern in the input data is not found upto the next line terminator, return an empty string through the out parameter, matchedStr.
+ * Gets the substring of the input data matching the pattern constructed from the specified string. @n
+ * Delimiter is ignored and the returned string does not include any line terminator.
+ * If such a pattern in the input data is not found upto the next line terminator, the %FindInLine() method returns an empty string through the out parameter, @c matchedStr.
*
* @since 2.1
* @return An error code
* @param[in] patternStr The string to construct the pattern
* @param[out] matchedStr The matched string or empty string
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The length of the specified @c string parameter is @c 0.
- * @exception E_DATA_NOT_FOUND No substring is found in the input data of current instance.
+ * @exception E_INVALID_ARG The length of the specified @c string is @c 0.
+ * @exception E_DATA_NOT_FOUND No substring is found in the input data of the current instance.
*/
result FindInLine(const String& patternStr, String& matchedStr);
/**
* Gets the substring matching the pattern from the input data. @n
- * Delimiter will be ignored and the returned string does not include any line terminator.
- * If such a pattern in the input data is not found upto the next line terminator, return an empty string through the out parameter, matchedStr.
+ * Delimiter is ignored and the returned string does not include any line terminator.
+ * If such a pattern in the input data is not found upto the next line terminator, the %FindInLine() method returns an empty string through the out parameter, @c matchedStr.
*
* @since 2.1
* @return An error code
- * @param[in] pattern The pattern to compile for finding substring from input data
- * @param[out] matchedStr The matched string or empty string
- * @exception E_SUCCESS The method is successful.
- * @exception E_DATA_NOT_FOUND No substring is found in the input data of current instance.
+ * @param[in] pattern The pattern to compile for finding the substring from the input data
+ * @param[out] matchedStr The matched string or empty string
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_DATA_NOT_FOUND No substring is found in the input data of the current instance.
*/
result FindInLine(const RegularExpression& pattern, String& matchedStr);
/**
- * Gets the next token as @c signed @c char. @n Next token is converted to @c signed @c char using default radix.
- * The @c signed @c char can hold value from -128 to 127.
+ * Gets the next token as @c signed @c char. @n The next token is converted to a @c signed @c char using a default radix.
+ * The @c signed @c char can hold values from -128 to 127.
*
* @since 2.1
* @return An error code
- * @param[out] nextSignedChar The next token as a @c signed @c char
- * @exception E_SUCCESS The method is successful.
- * @exception E_NUM_FORMAT The next token cannot be translated into a valid signed @c char value.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextSignedChar The next token as a @c signed @c char
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_NUM_FORMAT The next token cannot be translated into a valid signed @c char value.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextSignedChar(signed char& nextSignedChar) const;
/**
- * Gets the next token as @c signed @c char. @n Next token is converted to @c signed @c char using specified @c radix.
- * The @c signed @c char can hold value from -128 to 127.
+ * Gets the next token as @c signed @c char. @n The next token is converted to a @c signed @c char using the specified @c radix.
+ * The @c signed @c char can hold values from -128 to 127.
*
* @since 2.1
* @return An error code
- * @param[out] nextSignedChar The next token as a @c signed @c char
- * @param[in] radix The radix to use for conversion
- * @exception E_SUCCESS The method is successful.
- * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c signed @c char value.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextSignedChar The next token as a @c signed @c char
+ * @param[in] radix The radix to use for conversion
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c signed @c char value.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextSignedChar(signed char& nextSignedChar, int radix) const;
/**
- * Gets the next token as @c int. @n Next token is converted to signed integer using default radix.
- * The signed integer can hold value from -2^31 to 2^31-1.
+ * Gets the next token as @c int. @n The next token is converted to a @c signed integer using a default radix.
+ * The @c signed integer can hold values from -2^31 to 2^31-1.
*
* @since 2.1
* @return An error code
- * @param[out] nextInt The next token as a signed integer
- * @exception E_SUCCESS The method is successful.
- * @exception E_NUM_FORMAT The next token cannot be translated into a valid integer value.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextInt The next token as a @c signed integer
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c signed integer value.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextInt(int& nextInt) const;
/**
- * Gets the next token as @c int. @n Next token is converted to signed integer using specified @c radix.
- * The signed integer can hold value from -2^31 to 2^31-1.
+ * Gets the next token as @c int. @n The next token is converted to a @c signed integer using the specified @c radix.
+ * The @c signed integer can hold values from -2^31 to 2^31-1.
*
* @since 2.1
* @return An error code
- * @param[out] nextInt The next token as a signed integer
- * @param[in] radix The radix to use for conversion
- * @exception E_SUCCESS The method is successful.
- * @exception E_NUM_FORMAT The next token cannot be translated into a valid integer value.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextInt The next token as a @c signed integer
+ * @param[in] radix The radix to use for conversion
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c signed integer value.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextInt(int& nextInt, int radix) const;
/**
- * Gets the next token as @c short. @n Next token is converted to signed @c short using default radix.
- * The signed @c short can hold value from -2^15 to 2^15-1.
+ * Gets the next token as @c short. @n The next token is converted to a @c signed @c short using a default radix.
+ * The @c signed @c short can hold values from -2^15 to 2^15-1.
*
* @since 2.1
* @return An error code
- * @param[out] nextShort The next token as a signed @c short
- * @exception E_SUCCESS The method is successful.
- * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c short value.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextShort The next token as a signed @c short
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c signed @c short value.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextShort(short& nextShort) const;
/**
- * Gets the next token as @c short. @n Next token is converted to signed @c short using specified @c radix.
- * The signed @c short can hold value from -2^15 to 2^15-1.
+ * Gets the next token as @c short. @n The next token is converted to a @c signed @c short using the specified @c radix.
+ * The @c signed @c short can hold values from -2^15 to 2^15-1.
*
* @since 2.1
* @return An error code
- * @param[out] nextShort The next token as a signed @c short
- * @param[in] radix The radix to use for conversion
- * @exception E_SUCCESS The method is successful.
- * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c short value.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextShort The next token as a @c signed @c short
+ * @param[in] radix The radix to use for conversion
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c signed @c short value.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextShort(short& nextShort, int radix) const;
/**
- * Gets the next token as @c long @c long. @n Next token is converted to signed @c long @c long using default radix.
- * The signed @c long @c long can hold value from -2^63 to 2^63-1.
+ * Gets the next token as @c long @c long. @n The next token is converted to a @c signed @c long @c long using a default radix.
+ * The @c signed @c long @c long can hold values from -2^63 to 2^63-1.
*
* @since 2.1
* @return An error code
- * @param[out] nextLongLong The next token as a signed @c long @c long
- * @exception E_SUCCESS The method is successful.
- * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c long @c long value.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextLongLong The next token as a @c signed @c long @c long
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c signed @c long @c long value.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextLongLong(long long& nextLongLong) const;
/**
- * Gets the next token as @c long @c long. @n Next token is converted to signed @c long @c long using specified @c radix.
- * The signed @c long @c long can hold value from -2^63 to 2^63-1.
+ * Gets the next token as @c long @c long. @n The next token is converted to a @c signed @c long @c long using the specified @c radix.
+ * The @c signed @c long @c long can hold values from -2^63 to 2^63-1.
*
* @since 2.1
* @return An error code
- * @param[out] nextLongLong The next token as a signed @c long @c long
- * @param[in] radix The radix to use for conversion
- * @exception E_SUCCESS The method is successful.
- * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c long @c long value.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextLongLong The next token as a @c signed @c long @c long
+ * @param[in] radix The radix to use for conversion
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c signed @c long @c long value.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextLongLong(long long& nextLongLong, int radix) const;
/**
- * Gets the next token as @c float. @n Next token is converted to @c float.
- * The signed @c float can hold a single-precision 32-bit floating number.
+ * Gets the next token as @c float. @n The next token is converted to @c float.
+ * The @c signed @c float can hold a single-precision 32-bit floating number.
*
* @since 2.1
* @return An error code
- * @param[out] nextFloat The next token as a @c float
- * @exception E_SUCCESS The method is successful.
- * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c float value.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextFloat The next token as a @c float
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c float value.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextFloat(float& nextFloat) const;
/**
- * Gets the next token as @c double. @n Next token is converted to @c double.
+ * Gets the next token as @c double. @n The next token is converted to @c double.
* The signed @c double can hold a double-precision 64-bit floating number.
*
* @since 2.1
* @return An error code
- * @param[out] nextDouble The next token as a @c double
- * @exception E_SUCCESS The method is successful.
- * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c double value.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextDouble The next token as a @c double
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c double value.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextDouble(double& nextDouble) const;
/**
- * Gets the next token as @c bool. @n Next token is converted to boolean.
+ * Gets the next token as @c bool. @n The next token is converted to boolean.
* Nothing can be converted, except true/TRUE or false/FALSE.
*
* @since 2.1
* @return An error code
- * @param[out] nextBool The next token as @c bool
- * @exception E_SUCCESS The method is successful.
- * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c bool value.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextBool The next token as @c bool
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_NUM_FORMAT The next token cannot be translated into a valid @c bool value.
+ * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
*/
result GetNextBool(bool& nextBool) const;
/**
- * Gets the input string up to next line delimiter and advances the %Scanner to the beginning of the next line. @n
+ * Gets the input string up to the next line delimiter and advances the %Scanner to the beginning of the next line. @n
* The returned string does not include any line terminator.
*
* @since 2.1
* @return An error code
- * @param[out] nextLine The next line as an instance of String
- * @exception E_SUCCESS The method is successful.
- * @exception E_DATA_NOT_ENOUGH There are no remaining lines for the current instance of %Scanner.
+ * @param[out] nextLine The next line as an instance of String
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_DATA_NOT_ENOUGH There are no lines remaining for the current instance of %Scanner.
*
* The following example demonstrates how to use the %GetNextLine() method.
*
*
* @since 2.1
* @return An error code
- * @param[out] nextTok The next token as an instance of String
- * @exception E_SUCCESS The method is successful.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[out] nextTok The next token as an instance of String
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*
* The following example demonstrates how to use the %GetNextToken() method.
* @code
result GetNextToken(String& nextTok) const;
/**
- * Gets the next token as String if it matches to the pattern constructed from the specified string.
+ * Gets the next token as String if it matches the pattern constructed from the specified string.
*
* @since 2.1
* @return An error code
- * @param[in] pattern The string to construct the pattern
- * @param[out] nextTok The next token as an instance of String, @n
- * else an empty string if not matched
- * @exception E_SUCCESS The method is successful.
- * @exception E_DATA_NOT_FOUND The next token does not match to the pattern.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[in] pattern The string from which to construct the pattern
+ * @param[out] nextTok The next token as an instance of String, @n
+ * else an empty string if it is does not match
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_DATA_NOT_FOUND The next token does not match the pattern.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextToken(const String& pattern, String& nextTok) const;
/**
- * Gets the next token as String if it matches to the pattern.
+ * Gets the next token as String if it matches the pattern.
*
* @since 2.1
* @return An error code
- * @param[in] pattern The pattern to find.
- * @param[out] nextTok The next token as an instance of String, @n
- * else an empty string if not matched
- * @exception E_SUCCESS The method is successful.
- * @exception E_DATA_NOT_FOUND The next token does not match to the pattern.
- * @exception E_DATA_NOT_ENOUGH There are no remaining tokens for the current instance of %Scanner.
+ * @param[in] pattern The pattern to find
+ * @param[out] nextTok The next token as an instance of String, @n
+ * else an empty string if it is does not match
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_DATA_NOT_FOUND The next token does not match the pattern.
+ * @exception E_DATA_NOT_ENOUGH There are no tokens remaining for the current instance of %Scanner.
*/
result GetNextToken(const RegularExpression& pattern, String& nextTok) const;
*
* @since 2.1
* @return @c true if the current instance has another token, @n
- * else @c false
+ * else @c false
*/
bool HasNextToken(void) const;
/**
- * Checks whether the next token matches to the pattern constructed from the specified string.
+ * Checks whether the next token matches the pattern constructed from the specified string.
*
* @since 2.1
- * @return @c true if the next token matches to the pattern constructed from the specified string, @n
- * else @c false
+ * @return @c true if the next token matches the pattern constructed from the specified string, @n
+ * else @c false
* @param[in] pattern The string to construct the pattern
*/
bool HasNextToken(const String& pattern) const;
/**
- * Checks whether the next token matches to the pattern.
+ * Checks whether the next token matches the pattern.
*
* @since 2.1
- * @return @c true if the next token matches to the pattern, @n
- * else @c false
+ * @return @c true if the next token matches the pattern, @n
+ * else @c false
* @param[in] pattern The pattern to find
*/
bool HasNextToken(const RegularExpression& pattern) const;
/**
* Checks whether the next token can be translated into a valid @c signed @c char value in the default radix.
- * The @c signed @c char can hold value from -128 to 127.
+ * The @c signed @c char can hold values from -128 to 127.
*
* @since 2.1
* @return @c true if the next token can be translated into a valid @c signed @c char value in the current radix, @n
- * else @c false
+ * else @c false
*/
bool IsNextTokenConvertibleToSignedChar(void) const;
/**
* Checks whether the next token can be translated into a valid @c signed @c char value in the specified @c radix.
- * The @c signed @c char can hold value from -128 to 127.
+ * The @c signed @c char can hold values from -128 to 127.
*
* @since 2.1
* @return @c true if the next token can be translated into a valid @c signed @c char value in the current radix, @n
- * else @c false
- * @param[in] radix The radix to use to translate the token as a valid @c signed @c char value
+ * else @c false
+ * @param[in] radix The radix used to translate the token as a valid @c signed @c char value
*/
bool IsNextTokenConvertibleToSignedChar(int radix) const;
/**
* Checks whether the next token can be translated into a valid @c int value in the default radix. @n
- * The signed integer can hold value from -2^31 to 2^31-1.
+ * The @c signed integer can hold values from -2^31 to 2^31-1.
*
* @since 2.1
- * @return @c true if the next token can be translated into a valid @c int value in the current radix, @n
- * else @c false
+ * @return @c true if the next token can be translated into a valid @c int value in the current radix, @n
+ * else @c false
*/
bool IsNextTokenConvertibleToInt(void) const;
/**
* Checks whether the next token can be translated into a valid @c int value in the specified @c radix. @n
- * The signed integer can hold value from -2^31 to 2^31-1.
+ * The @c signed integer can hold values from -2^31 to 2^31-1.
*
* @since 2.1
* @return @c true if the next token can be translated into a valid @c int value in the current radix, @n
- * else @c false
- * @param[in] radix The radix to use to translate the token as a valid @c int value
+ * else @c false
+ * @param[in] radix The radix used to translate the token as a valid @c int value
*/
bool IsNextTokenConvertibleToInt(int radix) const;
/**
* Checks whether the next token can be translated into a valid @c short value in the default radix. @n
- * The signed @c short can hold value from -2^15 to 2^15-1.
+ * The @c signed @c short can hold values from -2^15 to 2^15-1.
*
* @since 2.1
- * @return @c true if the next token can be translated into a valid @c short value in the current radix, @n
- * else @c false
+ * @return @c true if the next token can be translated into a valid @c short value in the current radix, @n
+ * else @c false
*/
bool IsNextTokenConvertibleToShort(void) const;
/**
* Checks whether the next token can be translated into a valid @c short value in the specified @c radix. @n
- * The signed @c short can hold value from -2^15 to 2^15-1.
+ * The @c signed @c short can hold values from -2^15 to 2^15-1.
*
* @since 2.1
* @return @c true if the next token can be translated into a valid @c short value in the current radix, @n
- * else @c false
- * @param[in] radix The radix to use to translate the token as a valid @c short value
+ * else @c false
+ * @param[in] radix The radix used to translate the token as a valid @c short value
*/
bool IsNextTokenConvertibleToShort(int radix) const;
/**
* Checks whether the next token can be translated into a valid @c long @c long value. @n
- * The signed @c long @c long can hold value from -2^63 to 2^63-1.
+ * The @c signed @c long @c long can hold value from -2^63 to 2^63-1.
*
* @since 2.1
* @return @c true if the next token can be translated into a valid @c long @c long value in the current radix, @n
- * else @c false
+ * else @c false
*/
bool IsNextTokenConvertibleToLongLong(void) const;
/**
* Checks whether the next token can be translated into a valid @c float value. @n
- * The signed @c float can hold a single-precision 32-bit floating number.
+ * The @c signed @c float can hold a single-precision 32-bit floating number.
*
* @since 2.1
* @return @c true if the next token can be translated into a valid @c float value in the current radix, @n
- * else @c false
+ * else @c false
*/
bool IsNextTokenConvertibleToFloat(void) const;
*
* @since 2.1
* @return @c true if the next token can be translated into a valid @c double value in the current radix, @n
- * else @c false
+ * else @c false
*/
bool IsNextTokenConvertibleToDouble(void) const;
*
* @since 2.1
* @return @c true if the next token can be translated into a valid @c bool value, @n
- * else @c false
+ * else @c false
*/
bool IsNextTokenConvertibleToBool(void) const;
*
* @since 2.1
* @return @c true if the input data of the current instance of %Scanner has another line, @n
- * else @c false
+ * else @c false
*/
bool HasNextLine(void) const;
* @file FBaseUtilStringTokenizer.h
* @brief This is the header file for the %StringTokenizer class.
*
- * @see String()
- *
* This header file contains the declarations of the %StringTokenizer class.
+ *
+ * @see Tizen::Base::String
*/
#ifndef _FBASE_UTIL_STRING_TOKENIZER_H_
*
* @param[in] value An instance of String to parse
* @param[in] delimiters The delimiters
- * @param[in] isToken A flag indicating whether to return the delimiters as tokens @n
+ * @param[in] isToken The flag that indicates whether to return the delimiters as tokens @n
* Set to @c true to treat the delimiters as tokens, @n
* else @c false to skip the delimiters.
*
virtual ~StringTokenizer(void);
/**
- * Gets the token count indicating the number of times the GetNextToken() method can be called before it returns an error code.
+ * Gets the token count that indicates the number of times the %GetNextToken() method can be called before it returns an error code.
*
* @since 2.0
*
- * @return An integer value indicating the number of times the GetNextToken() method can be called
+ * @return The integer value that indicates the number of times the GetNextToken() method can be called
*/
int GetTokenCount(void);
* @since 2.0
*
* @return An error code
- * @param[out] token The next token
+ * @param[out] token The next token
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_RANGE The string tokenizer has no more tokens.
*/
* @since 2.0
*
* @return An error code
- * @param[in] delimiters The new delimiters
+ * @param[in] delimiters The new delimiters
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*
{
/**
* @class StringUtil
- * @brief This class provides various utility methods for %String.
+ * @brief This class provides utility methods for %String operations.
*
* @since 2.0
*
- * The %StringUtil class provides various utility methods for String.
+ * The %StringUtil class provides utility methods for String operations.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/base/utility_namespace.htm">Utility</a>.
*
* Converts an McharBuffer to a null-terminated string. @n
* The position of the buffer is not changed.
*
- * @brief <i> [Deprecated] </i>
- * @deprecated This method is deprecated as @c mchar type is changed to @c wchar_t type.
- * Instead of using this method, use the WcharBufferToString(const WcharBuffer& mb, String& str) method.
- * @since 2.0
+ * @brief <i> [Deprecated] </i>
+ * @deprecated This method is deprecated as @c mchar type is changed to @c wchar_t type.
+ * Instead of using this method, use the WcharBufferToString(const WcharBuffer& mb, String& str) method.
+ * @since 2.0
*
* @return An error code
- * @param[in] mb An instance of McharBuffer
- * @param[out] str The current position
+ * @param[in] mb An instance of McharBuffer
+ * @param[out] str The null-terminated string
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * @c null does not exist between the position and limit of buffer.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - @c null does not exist between the position and limit of buffer.
* @endif
*/
static result MbToString(const McharBuffer& mb, String& str);
* Converts an WcharBuffer to a null-terminated string. @n
* The position of the buffer is not changed.
*
- * @since 2.0
+ * @since 2.0
*
* @return An error code
* @param[in] wb An instance of WcharBuffer
- * @param[out] str The current position
+ * @param[out] str The null-terminated string
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * @c null does not exist between the position and limit of buffer.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - @c null does not exist between the position and limit of buffer.
*/
static result WcharBufferToString(const WcharBuffer& wb, String& str);
* Gets a new McharBuffer from the specified string. @n
* The buffer's limit is the length of the string plus one and the starting position is @c 0.
*
- * @brief <i> [Deprecated] </i>
- * @deprecated This method is deprecated as @c mchar type is changed to @c wchar_t type.
- * Instead of using this method, use the StringToWcharBufferN(const String& str) method.
- * @since 2.0
+ * @brief <i> [Deprecated] </i>
+ * @deprecated This method is deprecated as @c mchar type is changed to @c wchar_t type.
+ * Instead of using this method, use the StringToWcharBufferN(const String& str) method.
+ * @since 2.0
*
* @return A pointer to the McharBuffer instance from the specified string, @n
* else @c null if an exception occurs
* Gets a new WcharBuffer from the specified string. @n
* The buffer's limit is the length of the string plus one and the starting position is @c 0.
*
- * @since 2.0
+ * @since 2.0
*
* @return A pointer to the WcharBuffer instance from the specified string, @n
* else @c null if an exception occurs
* Gets a new McharBuffer from a substring of the specified string. @n
* The buffer's limit is the length of the string plus one and the starting position is @c 0.
*
- * @brief <i> [Deprecated] </i>
- * @deprecated This method is deprecated as @c mchar type is changed to @c wchar_t type.
- * Instead of using this method, use the StringToWcharBufferN(const String& str, int index, int length) method.
- * @since 2.0
+ * @brief <i> [Deprecated] </i>
+ * @deprecated This method is deprecated as @c mchar type is changed to @c wchar_t type.
+ * Instead of using this method, use the StringToWcharBufferN(const String& str, int index, int length) method.
+ * @since 2.0
*
* @return A pointer to the McharBuffer instance from the substring of the specified string, @n
* else @c null if an exception occurs
/**
* @if OSPDEPREC
- * Gets the string length in the McharBuffer. @n
+ * Gets the string length in the specified McharBuffer. @n
* The string length is the length from the current position of the %McharBuffer to the @c null character.
* The position of the buffer is not changed.
*
- * @brief <i> [Deprecated] </i>
- * @deprecated This method is deprecated as @c mchar type is changed to @c wchar_t type.
- * Instead of using this method, use the GetStringLengthInWcharBuffer(const WcharBuffer& wb) method.
+ * @brief <i> [Deprecated] </i>
+ * @deprecated This method is deprecated as @c mchar type is changed to @c wchar_t type.
+ * Instead of using this method, use the GetStringLengthInWcharBuffer(const WcharBuffer& wb) method.
*
* @since 2.0
*
static int GetStringLengthInMb(const McharBuffer& mb);
/**
- * Gets the string length in the WcharBuffer. @n
+ * Gets the string length in the specified WcharBuffer. @n
* The string length is the length from the current position of the %WcharBuffer to the @c null character.
* The position of the buffer is not changed.
*
*
* @return A pointer to the ByteBuffer instance encoded from the specified string, @n
* else @c null if an exception occurs
- * @param[in] unicodeString A string to encode
+ * @param[in] unicodeString The string to encode
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
- * @see Tizen::Base::ByteBuffer
- * @see Tizen::Base::String
*/
static ByteBuffer* StringToUtf8N(const String& unicodeString);
* @since 2.0
*
* @return An error code
- * @param[in] pUtf8String A pointer to a String instance containing UTF-8 codes
+ * @param[in] pUtf8String A pointer to the String instance containing UTF-8 codes
* @param[out] unicodeString A string containing Unicode characters
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c pUtf8String is a @c null reference.
*
* @return A pointer to the ByteBuffer instance decoded from the specified string, @n
* else @c null if an exception occurs
- * @param[in] base64String A string to decode
+ * @param[in] base64String The string to decode
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid. @n
* The specified @c base64String is not a valid Base64 string.
* @since 2.0
*
* @return An error code
- * @param[in] buffer An instance of ByteBuffer to encode
- * @param[out] encodedString An instance of String consisting of base 64 characters
+ * @param[in] buffer An instance of ByteBuffer to encode
+ * @param[out] encodedString An instance of String consisting of base 64 characters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the @c buffer is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The @c buffer is empty.
*
* The following example demonstrates how to use the %EncodeToBase64String() method.
*
*/
enum CompressionLevel
{
- BEST_SPEED = 0, /**< For best speed */
- BEST_COMPRESSION, /**< For best compression */
- DEFAULT_COMPRESSION /**< For average speed and average compression */
+ BEST_SPEED = 0, /**< The compression level for best speed */
+ BEST_COMPRESSION, /**< The compression level for best compression */
+ DEFAULT_COMPRESSION /**< The compression level for average speed and average compression */
};
/**
* @class Uri
- * @brief This class provides useful methods for URI.
+ * @brief This class provides methods for managing URI.
*
* @since 2.0
*
- * The %Uri class represents a Uniform Resource Identifier (URI) as defined by RFC2396 and provides accessors
- * which access the URI component.
- * It also provides methods for creating, accessing, normalizing, resolving, and relativizing %Uri instances.
+ * The %Uri class represents a Uniform Resource Identifier (URI) as defined by RFC2396 and provides methods
+ * for managing URI.
+ * The %Uri class provides methods for creating, accessing, normalizing, resolving, and relativizing %Uri instances.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/base/uri.htm">URI</a>.
*
virtual ~Uri(void);
/**
- * Sets the current %Uri instance to the value of the specified instance of %Uri.
+ * Sets the current %Uri instance with the value of the specified %Uri instance.
*
* @since 2.0
*
- * @param[in] uri An instance of %Uri
+ * @param[in] uri An instance of %Uri to set
*/
void SetUri(const Uri& uri);
/**
- * Sets the current %Uri instance by parsing a given string.
+ * Sets the current %Uri instance by parsing the specified string.
*
* @since 2.0
*
* @return An error code
- * @param[in] str A string to parse into a URI
+ * @param[in] str The string to parse for URI value
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c str is an empty string.
* @exception E_INVALID_FORMAT The specified @c str violates the URI syntax (RFC 2396).
result SetUri(const Tizen::Base::String& str);
/**
- * Sets an absolute %Uri instance with given components.
+ * Sets an absolute %Uri instance with specified components.
*
* @since 2.0
*
* @return An error code
- * @param[in] scheme The scheme
- * @param[in] ssp The scheme-specific-part
- * @param[in] fragment The fragment
+ * @param[in] scheme The scheme
+ * @param[in] ssp The scheme-specific-part
+ * @param[in] fragment The fragment
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_FORMAT A component violates the URI syntax(RFC 2396).
+ * @exception E_INVALID_FORMAT A specified component violates the URI syntax(RFC 2396).
*/
result SetUri(const Tizen::Base::String& scheme, const Tizen::Base::String& ssp, const Tizen::Base::String& fragment);
* @since 2.0
*
* @return An error code
- * @param[in] scheme The scheme
- * @param[in] userInfo The user name and authorization
- * @param[in] host The host name
- * @param[in] port The port number
- * @param[in] path The path
- * @param[in] query The query
- * @param[in] fragment The fragment
+ * @param[in] scheme The scheme
+ * @param[in] userInfo The user name and authorization
+ * @param[in] host The host name
+ * @param[in] port The port number
+ * @param[in] path The path
+ * @param[in] query The query
+ * @param[in] fragment The fragment
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_FORMAT A component violates the URI syntax(RFC 2396).
+ * @exception E_INVALID_FORMAT A specified component violates the URI syntax(RFC 2396).
*/
result SetUri(const Tizen::Base::String& scheme, const Tizen::Base::String& userInfo, const Tizen::Base::String& host, int port, const Tizen::Base::String& path, const Tizen::Base::String& query, const Tizen::Base::String& fragment);
* @since 2.0
*
* @return An error code
- * @param[in] scheme The scheme
- * @param[in] host The host name
- * @param[in] path The path
- * @param[in] fragment The fragment
+ * @param[in] scheme The scheme
+ * @param[in] host The host name
+ * @param[in] path The path
+ * @param[in] fragment The fragment
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_FORMAT A component violates the URI syntax(RFC 2396).
+ * @exception E_INVALID_FORMAT A specified component violates the URI syntax(RFC 2396).
* @remarks The authority and query component are left empty, and the port is set to @c -1.
*/
result SetUri(const Tizen::Base::String& scheme, const Tizen::Base::String& host, const Tizen::Base::String& path, const Tizen::Base::String& fragment);
* @since 2.0
*
* @return An error code
- * @param[in] scheme The scheme
- * @param[in] authority The authority
- * @param[in] path The path
- * @param[in] query The query
- * @param[in] fragment The fragment
+ * @param[in] scheme The scheme
+ * @param[in] authority The authority
+ * @param[in] path The path
+ * @param[in] query The query
+ * @param[in] fragment The fragment
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_FORMAT A component violates the URI syntax(RFC 2396).
+ * @exception E_INVALID_FORMAT A specified component violates the URI syntax(RFC 2396).
*/
result SetUri(const Tizen::Base::String& scheme, const Tizen::Base::String& authority, const Tizen::Base::String& path, const Tizen::Base::String& query, const Tizen::Base::String& fragment);
* @return The value of the authority component, @n
* else an empty string if the authority component is undefined
* @remarks The string returned by this method is equal to the string returned by GetEncodedAuthority(),
- * except that all sequences of the escaped octets are decoded.
+ * except that all the sequences of the escaped octets are decoded.
*/
Tizen::Base::String GetAuthority(void) const;
* @return The value of the fragment component, @n
* else an empty string if the fragment component is undefined
* @remarks The string returned by this method is equal to the string returned by GetEncodedFragment(),
- * except that all sequences of the escaped octets are decoded.
+ * except that all the sequences of the escaped octets are decoded.
*/
Tizen::Base::String GetFragment(void) const;
* @return The value of the path component, @n
* else an empty string if the path component is undefined
* @remarks The string returned by this method is equal to the string returned by GetEncodedPath(),
- * except that all sequences of the escaped octets are decoded.
+ * except that all the sequences of the escaped octets are decoded.
*/
Tizen::Base::String GetPath(void) const;
* @return The value of the query component, @n
* else an empty string if the query component is undefined
* @remarks The string returned by this method is equal to the string returned by GetEncodedQuery(),
- * except that all sequences of the escaped octets are decoded.
+ * except that all the sequences of the escaped octets are decoded.
*/
Tizen::Base::String GetQuery(void) const;
* @return The value of the scheme-specific-part component, @n
* else an empty string if the scheme-specific-part component is undefined
* @remarks The string returned by this method is equal to the string returned by GetEncodedSchemeSpecificPart(),
- * except that all sequences of the escaped octets are decoded.
+ * except that all the sequences of the escaped octets are decoded.
*/
Tizen::Base::String GetSchemeSpecificPart(void) const;
* @return The value of the user-info component, @n
* else an empty string if the user-info component is undefined
* @remarks The string returned by this method is equal to the string returned by GetEncodedUserInfo(),
- * except that all sequences of the escaped octets are decoded.
+ * except that all the sequences of the escaped octets are decoded.
*/
Tizen::Base::String GetUserInfo(void) const;
/**
- * Checks whether the calling %Uri instance is an opaque URI.
+ * Checks whether the current %Uri instance is an opaque URI.
*
* @since 2.0
*
Tizen::Base::String GetEncodedString(void) const;
/**
- * Compares the calling URI instance to the specified %Uri instance. @n
+ * Compares the current URI instance with the specified %Uri instance. @n
* When comparing corresponding components of two URIs, if one component in the current instance is undefined
* but the other is defined, then the current instance is considered to be less than the given object.
*
* = 0 if the current instance is equal to the given object
* > 0 if the current instance is greater than the given object
* @endcode
- * @param[in] uri An instance of %Uri
+ * @param[in] uri An instance of %Uri to compare
* @remarks
*
* Ordering of URIs
* to the ordering of fragments, without regard to case.
* 5. Authority
* If two hierarchical URIs have identical schemes, they are ordered according to the authority,
- * without regard to the case.
+ * without regard to the case. @n
* 5-1. Server-based authority
* If two URIs are server-based, they are ordered according to their user-information,
* without regard to case.
*
* @return @c true if the two instances are equal, @n
* else @c false
- * @param[in] obj The object to compare with the current instance
- * @remarks Two equal instances must return the same hash value. The default
- * implementation of this method returns @c true if two instances
- * have the same address. @n
- * The method can be overridden to support value equality. Furthermore, the Equals()
+ * @param[in] obj The object to compare with the current instance
+ * @remarks
+ * - Two equal instances must return the same hash value. @n The default
+ * implementation of this method returns @c true if the two instances
+ * have the same address.
+ * - The method can be overridden to support value equality. Furthermore, the Equals()
* method must return the same results as the equality operator.
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
* @since 2.0
*
* @return The hash value of the current instance
- * @remarks Two equal instances must return the same hash value. For better performance,
- * the used hash function must generate a random distribution for all inputs.
+ * @remarks Two equal instances must return the same hash value. @n
+ * For better performance, the used hash function must generate a random distribution for all inputs.
*/
virtual int GetHashCode(void) const;
* @return The normalized URI, @n
* else the current URI in case any error occurs
* @remarks Normalization is the process of removing unnecessary "." and ".." segments from the path component of the
- * hierarchical URI. All "." segments are removed and If a ".." segment is preceded by a non-".." segment,
- * both of these segments are removed. If a URI is opaque, the normalization has no effect.
+ * hierarchical URI. All "." segments are removed.
+ * If a ".." segment is preceded by a non-".." segment,
+ * both the segments are removed. If a URI is opaque, the normalization has no effect.
*
* The following example demonstrates how to use the %Normalize() method.
*
* @param[out] uri The parsed URI
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_FORMAT The authority component is defined but cannot be parsed as a server-based authority.
- * @remarks This method is provided because the generic URI syntax cannot always distinguish a malformed server-based authority from a legitimate registry-based authority.
+ * @remarks This method is provided because the generic URI syntax cannot always distinguish a malformed server-based authority from a legitimate registry-based authority. @n
* For example, the authority component in the URI string "//foo:bar/" is not a legal
* server-based authority but it is legal as a registry-based authority.
*/
/**
- * Relativizes the specified %Uri instance against the calling %Uri instance.
+ * Relativizes the specified %Uri instance against the current %Uri instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] uri The %Uri to relativize against the calling %Uri
+ * @param[in] uri The %Uri to relativize against the current %Uri instance
* @param[out] resultUri The relativized URI
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks Relativization is the opposite of Resolution. It is used
- * to divide a URI into the base URI and the relative URI.
+ * @remarks
+ * - Relativization is the opposite of Resolution.
+ * - It is used to divide a URI into the base URI and the relative URI.
*/
result Relativize(const Uri& uri, Uri& resultUri);
/**
- * Resolves the specified %Uri instance against the calling %Uri instance.
+ * Resolves the specified %Uri instance against the current %Uri instance.
*
* @since 2.0
*
* @param[out] resultUri The resolved URI
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks Resolution is the process of resolving a URI against another, base URI. For hierarchical URI,
- * the path of the original is resolved against the path of the base URI and then normalized. @
- * For example, to resolve the URI "/downloads/tizen-sdk" against the base URI "https://developer.tizen.org",
+ * @remarks
+ * - Resolution is the process of resolving a URI against another, base URI.
+ * - For a hierarchical URI, the path of the original URI is resolved against the path of the base URI and then normalized. @n
+ * For example, when you resolve the URI "/downloads/tizen-sdk" against the base URI "https://developer.tizen.org",
* the resultant URI is "https://developer.tizen.org/downloads/tizen-sdk".
*/
result Resolve(const Uri& uri, Uri& resultUri);
* @since 2.0
*
* @return An error code
- * @param[in] authority The authority
+ * @param[in] authority The authority to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_FORMAT The specified string is invalid.
*/
/**
- * Sets the fragment component to the specified String instance.
+ * Sets the fragment component to the specified String instance
*
* @since 2.0
*
* @return An error code
- * @param[in] fragment The new fragment
+ * @param[in] fragment The fragment to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_FORMAT The specified string is invalid.
*/
* @since 2.0
*
* @return An error code
- * @param[in] host The new host
+ * @param[in] host The host to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_FORMAT The specified string is invalid.
*/
* @since 2.0
*
* @return An error code
- * @param[in] path The new path component
+ * @param[in] path The path to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_FORMAT The specified string is invalid.
*/
* @since 2.0
*
* @return An error code
- * @param[in] port The new port component
+ * @param[in] port The port to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c port is negative.
*/
* @since 2.0
*
* @return An error code
- * @param[in] query The new query string
+ * @param[in] query The query to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_FORMAT The specified string is invalid.
*/
* @since 2.0
*
* @return An error code
- * @param[in] scheme The new scheme
+ * @param[in] scheme The scheme to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_FORMAT The specified string is invalid.
*/
* @since 2.0
*
* @return An error code
- * @param[in] ssp The new scheme-specific-part component
+ * @param[in] ssp The scheme-specific-part to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_FORMAT The specified string is invalid.
*/
* @since 2.0
*
* @return An error code
- * @param[in] userInfo The new user-info string
+ * @param[in] userInfo The user-info to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_FORMAT The specified string is invalid.
*/
/**
- * Gets the content of the calling %Uri instance as a string containing escaped octets.
+ * Gets the content of the current %Uri instance as a string containing escaped octets.
*
* @since 2.0
*
- * @return The content of this URI as a string containing escaped octets
+ * @return The content of the current %Uri instance as a string containing escaped octets
*/
Tizen::Base::String ToString(void) const;
{
public:
/**
- * Decodes an encoded string using a specific encoding scheme.
+ * Decodes the specified encoded string using the specified encoding scheme.
*
* @since 2.0
*
* @exception E_SYSTEM A system error has occurred.
* @exception E_UNSUPPORTED_TYPE The specified encoding scheme is not supported.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks This method is used for decoding. It decodes an application/x-www-form-urlencoded string using a
- * specific encoding scheme. The supplied encoding scheme is used to determine what characters are represented
- * by any consecutive sequences of the form "%ab", where ab is the two-digit hexadecimal representation of a
- * byte.
- *@see UrlEncoder
+ * @remarks This method is used for decoding. It decodes an application/x-www-form-urlencoded string using a
+ * specific encoding scheme. @n
+ * The supplied encoding scheme is used to determine what characters are represented
+ * by any consecutive sequences of the form "%ab", where ab is the two-digit hexadecimal representation of a
+ * byte.
+ * @see UrlEncoder
*/
static result Decode(const Tizen::Base::String& str, const Tizen::Base::String& encodingScheme, Tizen::Base::String& decodedStr);
{
public:
/**
- * Encodes an input string using a specific encoding scheme. @n
+ * Encodes the specified input string using the specified encoding scheme. @n
* It encodes all unsafe characters of a string.
*
* @since 2.0
* @param[out] encodedStr The encoded string
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
* @exception E_UNSUPPORTED_TYPE The specified encoding scheme is not supported.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks This method is used for encoding. It encodes input string into an
- * application/x-www-form-urlencoded format using a specific encoding scheme. This method uses the specified
- * encoding scheme to obtain the bytes for unsafe characters.
- *@see UrlDecoder
+ * @remarks This method is used for encoding. @n
+ * It encodes input string into an
+ * application/x-www-form-urlencoded format using a specific encoding scheme. @n
+ * This method uses the specified encoding scheme to obtain the bytes for unsafe characters.
+ * @see UrlDecoder
*/
static result Encode(const Tizen::Base::String& str, const Tizen::Base::String& encodingScheme, Tizen::Base::String& encodedStr);
{
/**
* @class ZipEntry
- * @brief This class provides access to the entries of a zip-archive.
+ * @brief This class provides methods to access the entries of a zip-archive.
*
* @since 2.0
*
virtual ~ZipEntry(void);
/**
- * Gets an entry name associated with a zip entry. @n
+ * Gets the entry name associated with the zip entry. @n
* It can be a file or directory name.
*
* @since 2.0
*
- * @return An entry name
+ * @return The entry name
*
*/
String GetName(void) const;
/**
- * Gets the compression level associated with a zip entry.
+ * Gets the compression level associated with the zip entry.
*
* @since 2.0
*
- * @return The compression level associated with a zip entry
+ * @return The compression level associated with the zip entry
*
*/
CompressionLevel GetCompressionLevel(void) const;
/**
- * Checks whether a zip entry is a file or directory.
+ * Checks whether the zip entry is a file or directory.
*
* @since 2.0
*
bool IsDirectory(void) const;
/**
- * Gets the compressed size of a zip entry.
+ * Gets the compressed size of the zip entry.
*
* @since 2.0
*
- * @return The compressed size of a zip entry
+ * @return The compressed size of the zip entry
*/
unsigned long GetCompressedSize(void) const;
/**
- * Gets the uncompressed size of a zip entry.
+ * Gets the uncompressed size of the zip entry.
*
* @since 2.0
*
- * @return The uncompressed size of a zip entry
+ * @return The uncompressed size of the zip entry
*/
unsigned long GetUncompressedSize(void) const;
/**
- * Gets the name of a zip file to which %ZipEntry belongs.
+ * Gets the name of the zip file to which %ZipEntry belongs.
*
* @since 2.0
*
- * @return The name of a zip file
- * @remarks This method returns the name of a zip file that is opened
- * in the FileUnzipper::Construct() method.
+ * @return The name of the zip file
+ * @remarks This method returns the name of the zip file that is opened
+ * in the FileUnzipper::Construct() method.
*/
String GetArchiveName(void) const;
/**
- * Compares the specified instance to the calling instance.
+ * Compares the specified instance to the current instance.
*
* @since 2.0
*
* @return @c true if the specified instance equals the current instance, @n
* else @c false
- * @param[in] obj The object to compare with the current instance
+ * @param[in] obj The object to compare with the current instance
* @remarks This method returns @c true if all the attributes in the instance are same.
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
{
/**
* @class UuId
- * @brief This class is the base class of the wrapped UUID types and provides useful operators.
+ * @brief This class is the base class of the wrapped UUID types and provides methods for UUIDs.
*
* @since 2.0
*
- * The %UuId class is the base class of the wrapped UUID types and provides useful operators. The UUID consists of 32 hexadecimal digits displayed in 5 groups separated by hyphens to form a total of 36 characters (32 digits and 4 hyphens '-').
+ * The %UuId class is the base class of the wrapped UUID types and provides useful operators. The UUID consists of 32 hexadecimal
+ * digits displayed in 5 groups separated by hyphens to form a total of 36 characters (32 digits and 4 hyphens '-').
*
* It also provides operators for assignment and equality, and methods for parsing, comparing, and generalization.
*
* @if OSPDEPREC
* Initializes an instance of %UuId with the value of the specified UUID.
*
- * @brief <i> [Deprecated] </i>
- * @deprecated This method is deprecated as a UUID type is deprecated.
- * Instead of using this method, use the UuId(const byte uuid[16]) method.
- * @since 2.0
+ * @brief <i> [Deprecated] </i>
+ * @deprecated This method is deprecated as a UUID type is deprecated.
+ * Instead of using this method, use the UuId(const byte uuid[16]) method.
+ * @since 2.0
*
* @param[in] uuid An instance of UUID
* @endif
UuId(const UUID& uuid);
/**
- * Initializes an instance of %UuId with the uuid value.
+ * Initializes an instance of %UuId with the specified uuid value.
*
* @since 2.0
*
* @return @c true if the UUID and the %UuId instance are equal, @n
* else @c false
* @param[in] uuid1 An instance of UUID
- * @param[in] uuid2 An instance of %UuId
+ * @param[in] uuid2 An instance of %UuId
* @endif
*/
_OSP_EXPORT_ friend bool operator ==(const UUID& uuid1, const UuId& uuid2);
*
* @since 2.0
*
- * @return @c true if the two IDs are equal, @n
+ * @return @c true if the two instances are equal, @n
* else @c false
* @param[in] uuid An instance of %UuId
*/
*
* @return @c true if the specified instance of Object is equal to the current instance of %UuId, @n
* else @c false
- * @param[in] obj An instance of Object to compare
- * @remarks This method can be overridden to support value equality. Furthermore, the method must return the same result as the equality operator.
+ * @param[in] obj An instance of Object to compare
+ * @remarks This method can be overridden to support value equality. @n
+ * Furthermore, the method must return the same result
+ * as the equality operator.
* @see Tizen::Base::Object::GetHashCode()
*/
virtual bool Equals(const Object& obj) const;
* @since 2.0
*
* @return The integer value equivalent of the hash value of the current instance of %UuId
- * @remarks Two equal instances must return the same hash value. For better performance,
- * the used hash function must generate a random distribution for all inputs. @n
- * The default implementation of this method returns the value of the current instance.
+ * @remarks
+ * - Two equal instances must return the same hash value. @n
+ * For better performance, the used hash function must
+ * generate a random distribution for all inputs.
+ * - The default implementation of this method returns the value of the current instance.
*/
virtual int GetHashCode(void) const;
/**
- * Gets the string representing the value of the current instance when implemented by a class.
+ * Gets the string representing the value of the current instance.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An instance of the String class with the unicode representation of the value of the current instance @n
- * If an error such as E_OUT_OF_MEMORY occurs, an empty string is returned.
+ * @return An instance of the String class with the unicode representation of the value of the current instance, @n
+ * else an empty string if an error such as @c E_OUT_OF_MEMORY occurs
*/
String ToString(void) const;
* @exception E_INVALID_ARG The string does not contain an %UuId that can be parsed.
* @remarks
* - The format of a string representing a %UuId value is xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (For example, 130DF2EC-8233-4975-B03D-F0AD99E3449D).
- * - This method guarantees that the original value of out-parameter is not changed when the method returns error.
+ * - This method guarantees that the original value of out-parameter is not changed when the method returns an error.
*/
static result Parse(const String& str, UuId& uuid);
/**
* Generates a new %UuId instance with a random value.
*
- * @since 2.0
+ * @since 2.0
*
* @return A new %UuId instance
*/
static UuId* GenerateN(void);
/**
- * Get a new invalid %UuId instance.
+ * Gets a new invalid %UuId instance.
*
- * @since 2.0
+ * @since 2.0
*
* @return A new invalid %UuId instance
*/
static const UuId INVALID_UUID;
/**
- * A byte array of uuid value.
+ * A byte array of the uuid value.
*
* @since 2.0
*/
* @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FIo.h> @n
- * @b Library : @b osp-appfw
+ * @b Library: @b osp-appfw
*
* The %Io namespace allows applications to input/output data to/from file systems and other programs and process it.
* Thus, the %Io namespace is an interface between the system and the application.
- * The %Io namespace provides classes and methods for managing files, directories, registries, databases, channels, and serial port communication.
- * @n
+ * The %Io namespace provides classes and methods for managing files, directories, registries, databases, channels,
+ * and serial port communication.
+ *
* For more information on the %Io namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/io/io_namespace.htm">Io Guide</a>.
*
* The following diagram illustrates the relationships between the classes belonging to the %Io namespace.
*
* @since 2.0
*
- * @return A pointer to the %ClientChannel instance, @n
+ * @return The pointer to the %ClientChannel instance, @n
* else @c null if it fails
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*
* @since 2.0
*
- * @return A pointer to the %ClientChannel instance, @n
+ * @return The pointer to the %ClientChannel instance, @n
* else @c null if it fails
* @param[in] channelName The channel name
* @exception E_SUCCESS The method is successful.
*
* @since 2.0
*
- * @return An error code
- * @param[in] serverChannelId The server channel ID which can be either application ID or appicationID.ChannelName
- * @param[in] pArgs A pointer to an argument list of type String
- * @param[out] reqId The request ID
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The server channel is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @return An error code
+ * @param[in] serverChannelId The server channel ID which can be either application ID or appicationID.ChannelName
+ * @param[in] pArgs A pointer to an argument list of type String
+ * @param[out] reqId The request ID
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The server channel is not found.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
result SendRequest(const Tizen::Base::String& serverChannelId, const Tizen::Base::Collection::IList* pArgs, RequestId& reqId);
/**
* @file FIoDataRow.h
-* @brief This is the header file for the %DataRow class.
+* @brief This is the header file for the %DataRow class.
*
* This header file contains the declarations of the %DataRow class.
*/
virtual ~DataRow(void);
/**
- * Sets a Tizen::Base::ByteBuffer value to the column whose index is specified.
+ * Sets a Tizen::Base::ByteBuffer value to the column with the specified index.
*
* @since 2.1
*
- * @return An error code
+ * @return An error code
* @param[in] columnIndex The index of the column whose value is set @n
- * The column index starts from 0.
+ * The column index starts from @c 0.
* @param[in] pValue The value to set @n
- * The specified @c pValue is a pointer to user-provided Tizen::Base::ByteBuffer type buffer.
+ * The specified @c pValue is a pointer to user-provided Tizen::Base::ByteBuffer type buffer.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The specified @c columnIndex is out of range.
* - The specified @c pValue is @c null.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
- * @remarks This method performs a shallow copy. It copies only the pointer; not the element itself. @n
- * The platform will take the ownership of @c pValue after calling this method.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
+ * @remarks
+ * - This method performs a shallow copy. It copies just the pointer and not the element itself.
+ * - The platform will take the ownership of @c pValue after calling this method.
*/
result SetBlobAt(int columnIndex, Tizen::Base::ByteBuffer* pValue);
/**
- * Sets a Tizen::Base::DateTime value to the column whose index is specified.
+ * Sets a Tizen::Base::DateTime value to the column with the specified index.
*
* @since 2.1
*
* @param[in] value The value to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
- * @remarks Tizen::Io::DbColumnType of the specified @c value is DB_COLUMNTYPE_TEXT.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
+ * @remarks Tizen::Io::DbColumnType of the specified @c value is ::DB_COLUMNTYPE_TEXT.
*/
result SetDateTimeAt(int columnIndex, const Tizen::Base::DateTime& value);
/**
- * Sets a @c double value to the column whose index is specified.
+ * Sets a @c double value to the column with the specified index.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
- * @param[in] columnIndex The index of the column whose value is set @n
- * The column index starts from 0.
- * @param[in] value The value to set
+ * @return An error code
+ * @param[in] columnIndex The index of the column whose value is set @n
+ * The column index starts from @c 0.
+ * @param[in] value The value to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
result SetDoubleAt(int columnIndex, double value);
/**
- * Sets an @c int value to the column whose index is specified.
+ * Sets an @c int value to the column with the specified index.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
- * @param[in] columnIndex The index of the column whose value is set @n
- * The column index starts from 0.
- * @param[in] value The value to set
+ * @return An error code
+ * @param[in] columnIndex The index of the column whose value is set @n
+ * The column index starts from @c 0.
+ * @param[in] value The value to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the operation do not match.
*/
result SetIntAt(int columnIndex, int value);
/**
- * Sets a @c long @c long value to the column whose index is specified.
+ * Sets a @c long @c long value to the column with the specified index.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
- * @param[in] columnIndex The index of the column whose value is set @n
- * The column index starts from 0.
- * @param[in] value The value to set
+ * @return An error code
+ * @param[in] columnIndex The index of the column whose value is set @n
+ * The column index starts from @c 0.
+ * @param[in] value The value to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
result SetInt64At(int columnIndex, long long value);
/**
- * Sets a Tizen::Base::String value to the column whose index is specified.
+ * Sets a Tizen::Base::String value to the column with the specified index.
*
* @since 2.1
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is set @n
- * The column index starts from 0.
- * @param[in] value The value to set
+ * @param[in] columnIndex The index of the column whose value is set @n
+ * The column index starts from @c 0.
+ * @param[in] value The value to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
result SetStringAt(int columnIndex, const Tizen::Base::String& value);
virtual ~DataSet(void);
/**
- * Creates in-memory table.
+ * Creates an in-memory table.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
+ * @return An error code
* @param[in] columnNames The list of column names to create @n
- * The object type in the specified list should be String.
+ * The object type in the specified list should be String.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c columnNames has no element.
*/
*
* @return A pointer to the DataRow instance, @n
* else @c null if the memory is insufficient
- * @remarks The column type is decided by the type of each element inserted in first row.
- * If a specific column element on the first row is not inserted, then the column's type is @c DB_COLUMNTYPE_NULL
- * In that case, when a new column element is added later,
- * then the column's type will be changed according to the new element.
+ * @remarks The column type is decided by the type of each element inserted in first row. @n
+ * If a specific column element on the first row is not inserted, then the column's type is ::DB_COLUMNTYPE_NULL. @n
+ * In that case, when a new column element is added later, then the column's type will be changed according to the new element.
*/
DataRow* CreateDataRowN(void);
/**
- * Gets a table enumerator.
+ * Gets the table enumerator.
*
* @since 2.1
*
virtual bool Equals(const Tizen::Base::Object& obj) const;
/**
- * Gets the hash value of a current instance.
+ * Gets the hash value of the current instance.
*
* @since 2.1
*
/**
* Moves the enumerator to the next position.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
* @exception E_OUT_OF_RANGE The enumerator has reached out of the data set.
* @exception E_OBJECT_LOCKED The DataSet instance is locked.
* @exception E_INVALID_FORMAT The in-memory data is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks After getting this %DataSetEnumerator instance,
- * if this method is called first, the cursor goes to the first position.
- * @see Tizen::Io::DataSetEnumerator::MovePrevious()
- * @see Tizen::Io::DataSetEnumerator::MoveFirst()
- * @see Tizen::Io::DataSetEnumerator::MoveLast()
+ * @remarks After getting this %DataSetEnumerator instance,
+ * if this method is called first, the cursor goes to the first position.
+ * @see Tizen::Io::DataSetEnumerator::MovePrevious()
+ * @see Tizen::Io::DataSetEnumerator::MoveFirst()
+ * @see Tizen::Io::DataSetEnumerator::MoveLast()
*/
virtual result MoveNext(void);
/**
* Moves the enumerator to the previous position.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
* @exception E_OUT_OF_RANGE The enumerator has reached out of the data set.
* @exception E_OBJECT_LOCKED The DataSet instance is locked.
* @exception E_INVALID_FORMAT The in-memory data is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see Tizen::Io::DataSetEnumerator::MoveNext()
- * @see Tizen::Io::DataSetEnumerator::MoveFirst()
- * @see Tizen::Io::DataSetEnumerator::MoveLast()
+ * @see Tizen::Io::DataSetEnumerator::MoveNext()
+ * @see Tizen::Io::DataSetEnumerator::MoveFirst()
+ * @see Tizen::Io::DataSetEnumerator::MoveLast()
*/
virtual result MovePrevious(void);
/**
* Moves the enumerator to the first position.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
- * @exception E_OBJECT_LOCKED The DataSet instance is locked.
+ * @exception E_OBJECT_LOCKED The DataSet instance is locked.
* @exception E_INVALID_FORMAT The in-memory data is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see Tizen:Io::DataSetEnumerator::MoveNext()
- * @see Tizen:Io::DataSetEnumerator::MovePrevious()
- * @see Tizen:Io::DataSetEnumerator::MoveLast()
+ * @see Tizen:Io::DataSetEnumerator::MoveNext()
+ * @see Tizen:Io::DataSetEnumerator::MovePrevious()
+ * @see Tizen:Io::DataSetEnumerator::MoveLast()
*/
virtual result MoveFirst(void);
/**
* Moves the enumerator to the last position.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
- * @exception E_OBJECT_LOCKED The DataSet instance is locked.
+ * @exception E_OBJECT_LOCKED The DataSet instance is locked.
* @exception E_INVALID_FORMAT The in-memory data is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see Tizen:Io::DataSetEnumerator::MoveNext()
- * @see Tizen:Io::DataSetEnumerator::MovePrevious()
- * @see Tizen:Io::DataSetEnumerator::MoveFirst()
+ * @see Tizen:Io::DataSetEnumerator::MoveNext()
+ * @see Tizen:Io::DataSetEnumerator::MovePrevious()
+ * @see Tizen:Io::DataSetEnumerator::MoveFirst()
*/
virtual result MoveLast(void);
/**
- * Resets the calling %DataSetEnumerator instance back to its initial state.
+ * Resets the current %DataSetEnumerator instance to its initial state.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
- * @exception E_OBJECT_LOCKED The DataSet instance is locked.
+ * @exception E_OBJECT_LOCKED The DataSet instance is locked.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks After this method is called, if MoveNext() is called the cursor goes to the first position.
+ * @remarks If MoveNext() is called after this method, the cursor goes to the first position.
*/
virtual result Reset(void);
/**
- * Gets an @c int value from the column whose index is specified.
+ * Gets the @c int value from the column with the specified index.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
- * @param[in] columnIndex The index of the column whose value is required
+ * @return An error code
+ * @param[in] columnIndex The index of the column to get the value
* @param[in,out] value The integer value obtained from the specified column
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
virtual result GetIntAt(int columnIndex, int& value) const;
/**
- * Gets a @c long @c long value from the column whose index is specified.
+ * Gets the @c long @c long value from the column with the specified index.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
- * @param[in] columnIndex The index of the column whose value is required
+ * @return An error code
+ * @param[in] columnIndex The index of the column to get the value
* @param[in,out] value The 64-bit integer value obtained from the specified column
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
virtual result GetInt64At(int columnIndex, long long& value) const;
/**
- * Gets a @c double value from the column whose index is specified.
+ * Gets the @c double value from the column with the specified index.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
- * @param[in] columnIndex The index of the column whose value is required
+ * @return An error code
+ * @param[in] columnIndex The index of the column to get the value
* @param[in,out] value The double value obtained from the specified column
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
virtual result GetDoubleAt(int columnIndex, double& value) const;
/**
- * Gets a Tizen::Base::String value from the column whose index is specified.
+ * Gets the Tizen::Base::String value from the column with the specified index.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] value The Tizen::Base::String value obtained from the specified column
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
- * @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @return An error code
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] value The Tizen::Base::String value obtained from the specified column
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
+ * @exception E_INVALID_ARG The specified @c columnIndex is out of range.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
* @exception E_INVALID_ENCODING_RANGE The string conversion has failed due to invalid encoding range.
*/
virtual result GetStringAt(int columnIndex, Tizen::Base::String& value) const;
/**
- * Gets a Tizen::Base::ByteBuffer value from the column whose index is specified.
+ * Gets the Tizen::Base::ByteBuffer value from the column with the specified index.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
- * @param[in] columnIndex The index of the column whose value is required
+ * @return An error code
+ * @param[in] columnIndex The index of the column to get the value
* @param[in,out] value The Tizen::Base::ByteBuffer value obtained from the specified column @n
- * The %Tizen::Base::ByteBuffer will be filled from the current position and data copy
- * will be continued until %Tizen::Base::ByteBuffer limitation is reached or no more
+ * The %Tizen::Base::ByteBuffer will be filled from the current position and the data copying
+ * will be continued until the %Tizen::Base::ByteBuffer limitation is reached or no more
* blob data remains.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
* @exception E_OVERFLOW The specified Tizen::Base::ByteBuffer @c value is insufficient to save the data.
- * @see Tizen::Base::ByteBuffer
+ * @see Tizen::Base::ByteBuffer
*/
virtual result GetBlobAt(int columnIndex, Tizen::Base::ByteBuffer& value) const;
/**
- * Gets a blob data from the column whose index is specified.
+ * Gets the blob data from the column with the specified index.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] buffer The user-provided buffer used to receive the blob data
- * @param[in] size The maximum buffer length in bytes
+ * @return An error code
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] buffer The buffer to receive the blob data
+ * @param[in] size The maximum buffer length in bytes
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
* @exception E_INVALID_ARG Either the specified @c columnIndex is out of range or the specified @c size is invalid.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
* @exception E_OVERFLOW The specified @c buffer is insufficient to save the data.
*/
virtual result GetBlobAt(int columnIndex, void* buffer, int size) const;
/**
- * Gets a Tizen::Base::DateTime value from the column whose index is specified.
+ * Gets the Tizen::Base::DateTime value from the column with the specified index.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
- * @param[in] columnIndex The index of the column whose value is required
+ * @return An error code
+ * @param[in] columnIndex The index of the column to get the value
* @param[in,out] value The Tizen::Base::DateTime value obtained from the specified column
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
- * @exception E_INVALID_FORMAT The date is not correctly formatted, or the method is trying to access column of type String. @n
- * The date format should be 'mm/dd/yyyy hh:mm:ss'.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
+ * @exception E_INVALID_FORMAT Either of the following conditions has occurred:
+ * - The date is not correctly formatted. @n
+ * The date format should be 'mm/dd/yyyy hh:mm:ss'.
+ * - The method is trying to access column of type String.
* @exception E_OUT_OF_RANGE Either the year, month, day, hour, minute, or second value is out of range,
* or the method is trying to access a column of type String.
*/
*
* @since 2.1
*
- * @return The number of columns in the calling enumerator, @n
+ * @return The number of columns in the current enumerator, @n
* else @c -1 if an exception occurs
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
- * @remarks This method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
+ * @remarks
+ * - The method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual int GetColumnCount(void) const;
/**
- * Gets the type of the column indicated by a specified index.
+ * Gets the type of the column specified by the index.
*
* @since 2.1
*
- * @return The type of column, @n
+ * @return The column type, @n
* else @c DB_COLUMNTYPE_UNDEFINED if an exception occurs
- * @param[in] columnIndex The index of the destination column
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
- * @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @remarks This method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * Currently, @c DB_COLUMNTYPE_INT is returned for a 64-bit integer. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @param[in] columnIndex The column index
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
+ * @exception E_INVALID_ARG The specified @c columnIndex is out of range.
+ * @remarks
+ * - This method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - Currently, @c DB_COLUMNTYPE_INT is returned for a 64-bit integer.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual DbColumnType GetColumnType(int columnIndex) const;
/**
- * Gets the name of the column indicated by a specified index.
+ * Gets the name of the column specified by the index.
*
* @since 2.1
*
* @return The name of the column, @n
* else an empty string if an exception occurs
- * @param[in] columnIndex The index of the destination column
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
- * @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_INVALID_ENCODING_RANGE The string conversion has failed due to invalid encoding range.
- * @remarks This method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @param[in] columnIndex The column index
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
+ * @exception E_INVALID_ARG The specified @c columnIndex is out of range.
+ * @exception E_INVALID_ENCODING_RANGE The string conversion has failed due to invalid encoding range.
+ * @remarks
+ * - This method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::String GetColumnName(int columnIndex) const;
/**
- * Gets the size of data in bytes.
+ * Gets the size of data in bytes of the column specified by the index.
*
* @since 2.1
*
* @return The size of the data in bytes, @n
* else @c -1 if an exception occurs
- * @param[in] columnIndex The index of the destination column
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
- * @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @remarks This method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * If the destination column is of type String, this method returns the @c byte length excluding
- * the @c null terminator character. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @param[in] columnIndex The column index
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE The DataSet instance associated with this instance is deleted.
+ * @exception E_INVALID_ARG The specified @c columnIndex is out of range.
+ * @remarks
+ * - This method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - If the destination column is of type String, this method returns the @c byte length excluding the @c null terminator character.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual int GetColumnSize(int columnIndex) const;
/**
* @class Database
- * @brief This class provides the basic database and database entry management methods.
+ * @brief This class provides methods for database management.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %Database class provides the basic database and database entry management methods.
+ * The %Database class provides methods for database management.
* All members of this class are guaranteed to be thread-safe.
*
* For more information on the class features,
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. @n
+ * For full construction, the Construct() method must be called right after calling this constructor.
*
* @since 2.0
*/
* @param[in] createIfNotExist Set to @c true to create a database file, @n
* else @c false to open an existing database file
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified @c dbPath is invalid. @n
- * - The specified @c dbPath is invalid or the path ends with '/'. @n
- * - The directory name path is missing. @n
- * - The parent directory does not exist. @n
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
- * @exception E_FILE_ALREADY_EXIST The specified database file already exists. @n
- * Creation of database file has failed because the destination file already exists. @n
- * Creation of the database file is attempted if the file does not exist and
- * the specified @c createIfNotExist is @c true.
- * However, at this moment another thread has been already created the database file
- * with the same file path.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified @c dbPath is invalid.
+ * - The specified @c dbPath is invalid or the path ends with '/'.
+ * - The directory name path is missing.
+ * - The parent directory does not exist.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
+ * @exception E_FILE_ALREADY_EXIST Either of the following conditions has occurred:
+ * - The specified database file already exists.
+ * - The creation of the database file failed because the destination file already exists.
+ * - The creation of the database file is attempted if the file does not exist and the specified @c createIfNotExist is
+ * @c true. However, in this case, another thread has already created the database file with the same file path. @n
* This is a rare case, however, it is possible if a race condition is present between several threads.
* @exception E_FILE_NOT_FOUND The specified database file cannot be found or accessed.
- * @exception E_DATABASE Either of the following conditions has occurred: @n
- * - The method has failed to open or create a file. @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_DATABASE Either of the following conditions has occurred:
+ * - The method has failed to open or create a file.
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
- * @remarks To open the database file in the read-only mode,
- * use the Database::Construct(const Tizen::Base::String& dbPath, const char* pOpenMode) method
+ * @remarks To open the database file in the read-only mode, use the Database::Construct(const Tizen::Base::String&, const char*) method
* with "r" as the value for the open mode flag.
* @endcond
*/
*
* @return An error code
* @param[in] dbPath The path of the database file to open
- * @param[in] openMode An open mode flag @n
+ * @param[in] openMode The file opening mode flag @n
* Currently, the following flags can be used in combination with the logical OR operator: @n
* (1) DB_OPEN_READ_ONLY @n
* (2) DB_OPEN_READ_WRITE @n
* (3) DB_OPEN_READ_WRITE | DB_OPEN_CREATE
* @param[in] option This argument is reserved for further use
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified @c dbPath is invalid. @n
- * - The specified @c openMode is invalid. @n
- * - The specified @c dbPath is invalid or the path ends with '/'. @n
- * - The directory name path is missing. @n
- * - The parent directory does not exist. @n
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified @c dbPath is invalid.
+ * - The specified @c openMode is invalid.
+ * - The specified @c dbPath is invalid or the path ends with '/'.
+ * - The directory name path is missing.
+ * - The parent directory does not exist.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_ALREADY_EXIST The specified database file already exists.
* @exception E_FILE_NOT_FOUND The specified database file cannot be found or accessed.
- * @exception E_DATABASE Either of the following conditions has occurred: @n
- * - The method has failed to open or create a file. @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_DATABASE Either of the following conditions has occurred:
+ * - The method has failed to open or create a file.
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @endcond
*/
* - r+: Open for reading and writing.
* - a+: Open for writing and reading. The database file is created if it does not exist.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified @c dbPath is equal to @c 0 or
- * exceeds system limitations. @n
- * - The specified @c dbPath ends with '/'. @n
- * - The combination of the specified @c pOpenMode is not allowed. @n
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * exceeds system limitations.
+ * - The specified @c dbPath ends with '/'.
+ * - The combination of the specified @c pOpenMode is not allowed.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_NOT_FOUND The specified @c dbPath cannot be found.
* @exception E_INVALID_FORMAT The specified @c dbPath is not a database.
* @exception E_STORAGE_FULL The disk space is full.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
- * - %File corruption is detected. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
+ * - %File corruption is detected.
*/
result Construct(const Tizen::Base::String& dbPath, const char* pOpenMode);
* This method opens an existing secure database file or creates a new one according to the specified file opening mode.
* The contents written to the secure database file is automatically encrypted and the contents read from the secure database
* file is automatically decrypted by the platform. @n
- * Applications using this method can access the same secure database files that are created by other applications with the
+ * Applications using this method can access the secure database files that are created by other applications with an
* identical key value in same device. However, the secure files created by this method cannot be accessed in other devices.
*
* @since 2.0
* @return An error code
* @param[in] dbPath The path of the database file to open or create
* @param[in] pOpenMode The file opening mode @n
- * It can be one of the following: @n
- * - r : Open for reading @n
- * - r+: Open for reading and writing @n
- * - a+: Open for writing and reading. The database file is created if it does not exist. @n
- * @param[in] secretKey A key used to encrypt data of a database file or decrypt a secure database file @n
- * If a secure database file is created with a specific key value,
- * other applications can access the same secure database file with the identical key value.
+ * It can be one of the following:
+ * - r : Open for reading
+ * - r+: Open for reading and writing
+ * - a+: Open for writing and reading. The database file is created if it does not exist.
+ * @param[in] secretKey The key used to encrypt the data of the database file or decrypt the secure database file @n
+ * If the secure database file is created with a specific key value,
+ * other applications can access the secure database file with an identical key value.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified @c dbPath is equal to @c 0 or
- * exceeds system limitations. @n
- * - The specified @c dbPath ends with '/'. @n
- * - The combination of the specified @c pOpenMode is not allowed. @n
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * exceeds system limitations.
+ * - The specified @c dbPath ends with '/'.
+ * - The combination of the specified @c pOpenMode is not allowed.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_NOT_FOUND The specified @c dbPath cannot be found.
* @exception E_INVALID_FORMAT The specified @c dbPath is not a database.
* @exception E_STORAGE_FULL The disk space is full.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
- * - %File corruption is detected. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
+ * - %File corruption is detected.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. For more information, see
* <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
* @remarks Before calling this method, check whether the feature is supported by Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
result Construct(const Tizen::Base::String& dbPath, const char* pOpenMode, const Tizen::Base::ByteBuffer& secretKey);
/**
- * Creates a SQL statement for the current database.
+ * Creates an SQL statement for the current database.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* else @c null if an exception occurs
* @param[in] sqlStatement The SQL statement to compile
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c sqlStatement is invalid SQL.
+ * @exception E_INVALID_ARG The specified @c sqlStatement is an invalid SQL.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
DbStatement* CreateStatementN(const Tizen::Base::String& sqlStatement);
/**
- * Executes a statement in the calling %Database instance. @n
+ * Executes a statement in the current %Database instance. @n
* If an application opens a database file using Database::Construct(const Tizen::Base::String& dbPath,
* const char* pOpenMode, const Tizen::Base::ByteBuffer& secretKey),
* the data set written by INSERT/UPDATE is automatically encrypted by the Tizen platform and
- * the data set read by SELECT is also decrypted by itself.
+ * the data set read by SELECT is decrypted.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* SELECT query, or if one of INSERT, UPDATE, and DELETE queries is executed.
* @param[in] dbStatement The DbStatement instance to execute
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c dbStatement includes invalid SQL.
+ * @exception E_INVALID_ARG The specified @c dbStatement includes an invalid SQL.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
* @exception E_STORAGE_FULL The disk space or database image is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks If @c dbStatement contains the SELECT query, the Reset() method of the DbEnumerator instance returned
- * from this method should be called. The Reset() method should be called before re-binding the dbStatement
+ * @remarks
+ * - If @c dbStatement contains the SELECT query, the Reset() method of the DbEnumerator instance returned
+ * from this method should be called. The %Reset() method should be called before re-binding the dbStatement
* with the bind methods of the DbStatement class.
- * This method returns an enumerator if the result set is generated by the SELECT query.
- * @c null is returned if no result set is available after the successful execution of the SELECT query.
+ * - This method returns an enumerator if the result set is generated by the SELECT query.
+ * @c null is returned if no result set is available after the successful execution of the SELECT query. @n
* Note that, a return value of @c null does not mean that the statement execution has failed.
- * The enumerator returned by the SELECT query does not indicate any row before it calls DbEnumerator::MoveNext().
- * The specific error code can be accessed using the GetLastResult() method.
+ * - The enumerator returned by the SELECT query does not indicate any row before it calls DbEnumerator::MoveNext().
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
DbEnumerator* ExecuteStatementN(const DbStatement& dbStatement);
/**
- * Executes SQL statement in this %Database instance. @n
+ * Executes the specified SQL statement in the current %Database instance. @n
* Any SQL statement that does not give a result set can be run using this method; for example, CREATE, INSERT, UPDATE, DELETE.
* The SELECT query cannot be executed using this method. @n
* If an application opens a database file using Database::Construct(const Tizen::Base::String& dbPath,
* @param[in] sqlStatement The SQL statement to execute
* @param[in] option This argument is reserved for further use.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c sqlStatement is invalid SQL.
+ * @exception E_INVALID_ARG The specified @c sqlStatement is an invalid SQL.
* @exception E_INVALID_OPERATION The specified @c sqlStatement is a SELECT query.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
* @exception E_STORAGE_FULL The disk space or database image is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks Use QueryN() to execute SELECT query.
result ExecuteSql(const Tizen::Base::String& sqlStatement, bool option);
/**
- * Executes a SELECT query in the calling %Database instance. @n
+ * Executes the specified SELECT query in the current %Database instance. @n
* If an application opens a database file using Database::Construct(const Tizen::Base::String& dbPath,
* const char* pOpenMode, const Tizen::Base::ByteBuffer& key),
* the data set read by SELECT is automatically decrypted by the Tizen platform.
* else @c null if an exception occurs or if no result set is generated after the successful execution of the SELECT query
* @param[in] sqlStatement The SQL statement to execute
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c sqlStatement is invalid SQL.
+ * @exception E_INVALID_ARG The specified @c sqlStatement is an invalid SQL.
* @exception E_INVALID_OPERATION The specified @c sqlStatement is not a SELECT query.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks This method returns an enumerator if the result set is generated by the SELECT query.
- * @c null is returned if no result set is available after the successful execution of the SELECT query.
+ * @remarks
+ * - This method returns an enumerator if the result set is generated by the SELECT query.
+ * @c null is returned if no result set is available after the successful execution of the SELECT query. @n
* Note that, a return value of @c null does not mean that the statement execution has failed.
- * The enumerator returned by the SELECT query does not indicate any row before it calls
+ * - The enumerator returned by the SELECT query does not indicate any row before it calls
* DbEnumerator::MoveNext().
- * The specific error code can be accessed using the GetLastResult() method.
+ * - The specific error code can be accessed using the GetLastResult() method.
* @see ExecuteSql()
*/
DbEnumerator* QueryN(const Tizen::Base::String& sqlStatement);
result BeginTransaction(void);
/**
- * Commits a transaction within this %Database instance.
+ * Commits a transaction within the current %Database instance.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
* @exception E_STORAGE_FULL The disk space or database image is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks Database::CommitTransaction() automatically resets not only all the DbStatement instances
- * but also all the DbEnumerator instances obtained from the current %Database instance.
- * As a result, the prepared statement of the %DbStatement instances are reset to its initial state, ready to be re-executed,
- * and enumerator of the %DbEnumerator instances are reset to the first position.
- * Therefore, the user should be careful when the same instance of the %Database class is shared across multiple threads.
- * Further, access to the %DbStatement or %DbEnumerator instances resets due to commit operation. This will eventually lead to crash.
- * To avoid a crash, the user can use multiple database instances for each thread.
- * Sharing of the same database instance across multiple threads is not recommended.
+ * but also all the DbEnumerator instances obtained from the current %Database instance. @n
+ * As a result, the prepared statement of the %DbStatement instances are reset to its initial state, ready to be
+ * re-executed, and enumerator of the DbEnumerator instances are reset to the first position. @n
+ * Therefore, you should be careful when the same instance of the %Database class is shared across multiple
+ * threads. Further, access to the %DbStatement or %DbEnumerator instances resets due to a commit operation. @n
+ * This will eventually lead to a crash. To avoid a crash, you can use multiple database instances for each
+ * thread. Sharing of the same database instance across multiple threads is not recommended.
* @see BeginTransaction()
* @see RollbackTransaction()
*/
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
* @exception E_STORAGE_FULL The disk space or database image is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @see BeginTransaction()
result RollbackTransaction(void);
/**
- * Gets the database's filename.
+ * Gets the database file name.
*
* @since 2.0
*
- * @return The filename of this %Database instance
+ * @return The file name of the current %Database instance
*/
Tizen::Base::String GetName(void) const;
* @return An error code
* @param[in] databasePath The path of the database file to delete
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified @c databasePath is invalid. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified @c databasePath is invalid.
* - The specified @c databasePath parameter contains an invalid path or
- * the path ends with '/'. @n
- * - The directory name path is missing. @n
- * - The parent directory does not exist. @n
+ * the path ends with '/'.
+ * - The directory name path is missing.
+ * - The parent directory does not exist.
* - An I/O security issue.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_NOT_FOUND The specified database file cannot be found.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
- * - %File corruption is detected. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
+ * - %File corruption is detected.
* - A system error has occurred.
*/
static result Delete(const Tizen::Base::String& databasePath);
/**
- * Checks whether the database file exists.
+ * Checks whether the specified database file exists.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* else @c false
* @param[in] databasePath The path of the database file to check
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified @c databasePath is invalid. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified @c databasePath is invalid.
* - The specified @c databasePath parameter contains an invalid path or
- * the path ends with '/'. @n
- * - The directory name path is missing. @n
- * - The parent directory does not exist. @n
+ * the path ends with '/'.
+ * - The directory name path is missing.
+ * - The parent directory does not exist.
* - An I/O security issue.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static bool Exists(const Tizen::Base::String& databasePath);
/**
- * Converts a normal database file to a secure database file. @n
+ * Converts the specified normal database file to a secure database file. @n
* A secure database file, that is converted by this method, can be shared among applications with the same key value.
*
* @if OSPCOMPAT
* @return An error code
* @param[in] normalDbPath The normal (non-encrypted) database file path
* @param[in] secureDbPath The secure (encrypted) database file path to create
- * @param[in] secretKey A key to encrypt normal database file @n
+ * @param[in] secretKey The key to encrypt the normal database file @n
* If the normal database file is converted with a specific key value,
- * applications can access the same secure database file with the identical key value.
+ * applications can access the secure database file with an identical key value.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified path is @c 0 or exceeds system limitations. @n
- * - The specified path is invalid. @n
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified path is @c 0 or exceeds system limitations.
+ * - The specified path is invalid.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_NOT_FOUND The specified @c normalDbPath does not exist.
* @exception E_FILE_ALREADY_EXIST The specified @c secureDbPath already exists.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAlT The database file is malformed.
* @exception E_STORAGE_FULL The disk space or database image is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. For more information, see
*
* @since 2.0
*
- * @return Row ID of the most recent successful insert, @n
+ * @return The row ID of the most recent successful insert, @n
* else @c -1 if no successful INSERT operations have ever occurred on
* the current opened database.
- * @remarks The row ID is always available as an undeclared column named ROWID, OID, or _ROWID_
- * as long as those names are not also used by explicitly declared columns.
- * If the table has a column of type INTEGER PRIMARY KEY then that column is another alias
- * for the row ID. @n
- * This method returns the row ID of the most recent successful INSERT operation
- * for current %Database.
+ * @remarks
+ * - The row ID is always available as an undeclared column named ROWID, OID, or _ROWID_
+ * as long as those names are not used by explicitly declared columns.
+ * - If the table has a column of type INTEGER PRIMARY KEY then that column is another alias
+ * for the row ID.
+ * - This method returns the row ID of the most recent successful INSERT operation
+ * for the current %Database instance.
*/
long long GetLastInsertRowId(void) const;
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to move the cursor position of the result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_OUT_OF_RANGE The enumerator has reached out of the result set returned by the SELECT query.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see Tizen::Io::Database::ExecuteStatementN()
- * @see Tizen::Io::Database::QueryN()
- * @see Tizen::Io::DbEnumerator::MovePrevious()
- * @see Tizen::Io::DbEnumerator::MoveFirst()
- * @see Tizen::Io::DbEnumerator::MoveLast()
+ * @see Tizen::Io::Database::ExecuteStatementN()
+ * @see Tizen::Io::Database::QueryN()
+ * @see Tizen::Io::DbEnumerator::MovePrevious()
+ * @see Tizen::Io::DbEnumerator::MoveFirst()
+ * @see Tizen::Io::DbEnumerator::MoveLast()
*/
virtual result MoveNext(void);
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to move the cursor position of the result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_OUT_OF_RANGE The enumerator has reached out of the result set returned by the SELECT query.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see Tizen::Io::Database::ExecuteStatementN()
- * @see Tizen::Io::Database::QueryN()
- * @see Tizen::Io::DbEnumerator::MoveNext()
- * @see Tizen::Io::DbEnumerator::MoveFirst()
- * @see Tizen::Io::DbEnumerator::MoveLast()
+ * @see Tizen::Io::Database::ExecuteStatementN()
+ * @see Tizen::Io::Database::QueryN()
+ * @see Tizen::Io::DbEnumerator::MoveNext()
+ * @see Tizen::Io::DbEnumerator::MoveFirst()
+ * @see Tizen::Io::DbEnumerator::MoveLast()
*/
virtual result MovePrevious(void);
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to move the cursor position of the result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see Tizen::Io::Database::ExecuteStatementN()
- * @see Tizen::Io::Database::QueryN()
- * @see Tizen::Io::DbEnumerator::MoveNext()
- * @see Tizen::Io::DbEnumerator::MovePrevious()
- * @see Tizen::Io::DbEnumerator::MoveLast()
+ * @see Tizen::Io::Database::ExecuteStatementN()
+ * @see Tizen::Io::Database::QueryN()
+ * @see Tizen::Io::DbEnumerator::MoveNext()
+ * @see Tizen::Io::DbEnumerator::MovePrevious()
+ * @see Tizen::Io::DbEnumerator::MoveLast()
*/
virtual result MoveFirst(void);
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to move the cursor position of the result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see Tizen::Io::Database::ExecuteStatementN()
- * @see Tizen::Io::Database::QueryN()
- * @see Tizen::Io::DbEnumerator::MoveNext()
- * @see Tizen::Io::DbEnumerator::MovePrevious()
- * @see Tizen::Io::DbEnumerator::MoveFirst()
+ * @see Tizen::Io::Database::ExecuteStatementN()
+ * @see Tizen::Io::Database::QueryN()
+ * @see Tizen::Io::DbEnumerator::MoveNext()
+ * @see Tizen::Io::DbEnumerator::MovePrevious()
+ * @see Tizen::Io::DbEnumerator::MoveFirst()
*/
virtual result MoveLast(void);
/**
- * Resets the calling %DbEnumerator instance back to its initial state.
+ * Resets the current %DbEnumerator instance to its initial state.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to reset the enumerator of the result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks After this method is called, if MoveNext() is called the cursor goes to the first position.
+ * @remarks If MoveNext() is called after this method, the cursor goes to the first position.
*/
virtual result Reset(void);
/**
- * Gets an @c int value from the column whose index is specified.
+ * Gets the @c int value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] value The integer value obtained from the column
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] value The integer value obtained from the specified column
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
virtual result GetIntAt(int columnIndex, int& value) const;
/**
- * Gets a @c long @c long value from the column whose index is specified.
+ * Gets the @c long @c long value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] value The 64-bit integer value obtained from the column
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] value The 64-bit integer value obtained from the specified column
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
virtual result GetInt64At(int columnIndex, long long& value) const;
/**
- * Gets a @c double value from the column whose index is specified.
+ * Gets the @c double value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] value The value obtained from the column as a double
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] value The double value obtained from the column
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
virtual result GetDoubleAt(int columnIndex, double& value) const;
/**
- * Gets a @c String value from the column whose index is specified.
+ * Gets the @c String value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] value The value obtained from the column as a String
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] value The @c String value obtained from the column
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
- * @exception E_INVALID_ENCODING_RANGE The string conversion has failed due to invalid encoding range, or
- * it is possible if the database file is corrupted.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
+ * @exception E_INVALID_ENCODING_RANGE Either of the following conditions has occurred:
+ * - The string conversion has failed due to invalid encoding range.
+ * - The database file is corrupted.
*/
virtual result GetStringAt(int columnIndex, Tizen::Base::String& value) const;
/**
- * Gets a byte array value from the column whose index is specified.
+ * Gets the byte array value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] value The user-provided buffer used to receive the blob data as a stream of type ByteBuffer @n
- * The buffer will be filled from the current position and data copy will be continued
- * until buffer limitation is reached or no more blob data remains. @n
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] value The buffer to receive the blob data as a stream of type ByteBuffer @n
+ * The buffer will be filled from the current position and the data copying will be continued
+ * until the buffer limitation is reached or no more blob data remains. @n
* The maximum size available is limited to 100 MByte.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
* @exception E_OUT_OF_RANGE The byte buffer operation has failed.
* @exception E_OVERFLOW The specified @c value of the byte buffer is insufficient to save the data.
*/
virtual result GetBlobAt(int columnIndex, Tizen::Base::ByteBuffer& value) const;
/**
- * Gets a blob data from the column whose index is specified.
+ * Gets the blob data from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] buffer The user-provided buffer used to receive the blob data @n
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] buffer The buffer to receive the blob data @n
* The maximum size available is limited to 100 MByte.
* @param[out] size The maximum buffer length in bytes
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range, or the specified @c size is invalid.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
* @exception E_OVERFLOW The specified @c buffer is insufficient to save the data.
*/
virtual result GetBlobAt(int columnIndex, void* buffer, int size) const;
/**
- * Gets a @c DateTime value from the column whose index is specified.
+ * Gets the @c DateTime value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] value The value obtained from the column as a DateTime instance
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] value The value obtained from the column as a %DateTime instance
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
- * @exception E_INVALID_FORMAT The date is not correctly formatted, or the method is trying to access column of type String. @n
- * The date format should be 'mm/dd/yyyy hh:mm:ss'.
- * @exception E_OUT_OF_RANGE Either the year, month, day, hour, minute, or second value is out of range,
- * or the method is trying to access a column of type String.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
+ * @exception E_INVALID_FORMAT The date is not correctly formatted. The date format should be 'mm/dd/yyyy hh:mm:ss'.
+ * @exception E_OUT_OF_RANGE Either the year, month, day, hour, minute, or second value is out of range, or the method is trying to access a column having an invalid value.
+ *
*/
virtual result GetDateTimeAt(int columnIndex, Tizen::Base::DateTime& value) const;
*
* @since 2.0
*
- * @return The number of columns in the calling enumerator, @n
+ * @return The number of columns in the current enumerator, @n
* else @c -1 if an exception occurs
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
- * @remarks The method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - The method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual int GetColumnCount(void) const;
/**
- * Gets the type of the column indicated by the specified index.
+ * Gets the type of the column specified by the index.
*
* @since 2.0
*
- * @return The type of column, @n
+ * @return The column type, @n
* else DB_COLUMNTYPE_UNDEFINED if an exception occurs
- * @param[in] columnIndex The index of the destination column
+ * @param[in] columnIndex The column index
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @remarks This method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * Currently, DB_COLUMNTYPE_INT is returned for a 64-bit integer. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - This method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - Currently, ::DB_COLUMNTYPE_INT is returned for a 64-bit integer.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual DbColumnType GetColumnType(int columnIndex) const;
/**
- * Gets the name of the column indicated by the specified index.
+ * Gets the name of the column specified by the index.
*
* @since 2.0
*
* @return The name of the column, @n
* else an empty string if an exception occurs
- * @param[in] columnIndex The index of the destination column
+ * @param[in] columnIndex The column index
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_INVALID_ENCODING_RANGE The string conversion has failed due to invalid encoding range, or
- * it is possible if the database file is corrupted.
- * @remarks This method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_INVALID_ENCODING_RANGE Either of the following conditions has occurred:
+ * - The string conversion has failed due to invalid encoding range.
+ * - The database file is corrupted.
+ * @remarks
+ * - This method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::String GetColumnName(int columnIndex) const;
/**
- * Gets the size of data in bytes.
+ * Gets the size of data in bytes of the column specified by the index.
*
* @since 2.0
*
* @return The size of the data in bytes, @n
* else @c -1 if an exception occurs
- * @param[in] columnIndex The index of the destination column
+ * @param[in] columnIndex The column index
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* - The Database or DbStatement instance associated with this instance is deleted.
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @remarks This method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * If the destination column is of type String, this method returns the @c byte length excluding the @c null terminator character. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - This method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - If the destination column is of type String, this method returns the @c byte length excluding the @c null terminator character.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual int GetColumnSize(int columnIndex) const;
/**
* @class DbStatement
- * @brief This class provides a method for evaluating pre-compiled statements.
+ * @brief This class provides methods for evaluating pre-compiled statements.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %DbStatement class provides a method for evaluating pre-compiled statements.
- * All members of this class are guaranteed to be thread-safe.
+ * The %DbStatement class provides methods for evaluating pre-compiled statements.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/io/database_operations.htm">Database Operations</a>.
*/
virtual ~DbStatement(void);
/**
- * Binds an integer value to the statement parameter.
+ * Binds the specified integer value to the statement parameter.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is bound
+ * @param[in] columnIndex The column index to bind the value
* @param[out] value The integer value to bind
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The instance has not been properly constructed,
- * or the instance is finalized.
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - The instance has not been properly constructed.
+ * - The instance is finalized.
* @exception E_INVALID_ARG The specified @c columnIndex is invalid.
* @exception E_INVALID_OPERATION This method has failed to bind the parameter because the database state has not been reset
- * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext().
+ * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext(). @n
* In this case DbEnumerator::Reset() should be invoked before calling this method.
*/
result BindInt(int columnIndex, int value);
/**
- * Binds a @c long @c long value to the statement parameter.
+ * Binds the specified @c long @c long value to the statement parameter.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is bound
+ * @param[in] columnIndex The column index to bind the value
* @param[out] value The 64-bit integer value to bind
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The instance has not been properly constructed,
- * or the instance is finalized.
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - The instance has not been properly constructed.
+ * - The instance is finalized.
* @exception E_INVALID_ARG The specified @c columnIndex is invalid.
* @exception E_INVALID_OPERATION This method has failed to bind the parameter because the database state has not been reset
- * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext().
+ * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext(). @n
* In this case DbEnumerator::Reset() should be invoked before calling this method.
*/
result BindInt64(int columnIndex, long long value);
/**
- * Binds a @c double value to the statement parameter.
+ * Binds the specified @c double value to the statement parameter.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is bound
+ * @param[in] columnIndex The column index to bind the value
* @param[out] value The @c double value to bind
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The instance has not been properly constructed,
- * or the instance is finalized.
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - The instance has not been properly constructed.
+ * - The instance is finalized.
* @exception E_INVALID_ARG The specified @c columnIndex is invalid.
* @exception E_INVALID_OPERATION This method has failed to bind the parameter because the database state has not been reset
- * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext().
+ * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext(). @n
* In this case DbEnumerator::Reset() should be invoked before calling this method.
*/
result BindDouble(int columnIndex, double value);
/**
- * Binds a String value to the statement parameter.
+ * Binds the specified string value to the statement parameter.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is bound
+ * @param[in] columnIndex The column index to bind the value
* @param[out] value The string value to bind
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The instance has not been properly constructed,
- * or the instance is finalized.
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - The instance has not been properly constructed.
+ * - The instance is finalized.
* @exception E_INVALID_ARG The specified @c value exceeds size limit.
* @exception E_INVALID_OPERATION This method has failed to bind the parameter because the database state has not been reset
- * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext().
+ * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext(). @n
* In this case DbEnumerator::Reset() should be invoked before calling this method.
*/
result BindString(int columnIndex, const Tizen::Base::String& value);
/**
- * Binds a value of type ByteBuffer to the statement parameter.
+ * Binds the specified ByteBuffer type value to the statement parameter.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is bound
+ * @param[in] columnIndex The column index to bind the value
* @param[out] value The blob value to bind @n
* The maximum available size is limited to 100 MBytes.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The instance has not been properly constructed,
- * or the instance is finalized.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c columnIndex is invalid. @n
- * - The size of byte buffer is less than @c 0 or has @c null data. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - The instance has not been properly constructed.
+ * - The instance is finalized.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c columnIndex is invalid.
+ * - The size of the byte buffer is less than @c 0 or has @c null data.
* - The specified @c value exceeds size limit.
* @exception E_INVALID_OPERATION This method has failed to bind the parameter because the database state has not been reset
- * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext().
+ * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext(). @n
* In this case DbEnumerator::Reset() should be invoked before calling this method.
* @remarks The bound @c byte array size is from the current position of byte buffer to the limit.
*/
result BindBlob(int columnIndex, const Tizen::Base::ByteBuffer& value);
/**
- * Binds the raw blob data to the statement parameter.
+ * Binds the specified raw blob data to the statement parameter.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is bound
+ * @param[in] columnIndex The index of the column to bind the value
* @param[in] buffer A pointer to the buffer where blob data is located @n
* The maximum available size is limited to 100 MBytes.
* @param[in] size The blob data length in bytes
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The instance has not been properly constructed,
- * or the instance is finalized.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c columnIndex is invalid. @n
- * - The specified @c size is less than @c 0. @n
- * - The pointer to the buffer is @c null. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - The instance has not been properly constructed.
+ * - The instance is finalized.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c columnIndex is invalid.
+ * - The specified @c size is less than @c 0.
+ * - The pointer to the buffer is @c null.
* - The specified @c buffer exceeds size limit.
* @exception E_INVALID_OPERATION This method has failed to bind the parameter because the database state has not been reset
- * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext().
+ * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext(). @n
* In this case DbEnumerator::Reset() should be invoked before calling this method.
*/
result BindBlob(int columnIndex, const void* buffer, int size);
/**
- * Binds a DateTime value to the statement parameter.
+ * Binds the specified DateTime value to the statement parameter.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is bound
+ * @param[in] columnIndex The index of the column to bind the value
* @param[out] value The date value to bind
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The instance has not been properly constructed,
- * or the instance is finalized.
- * @exception E_INVALID_ARG The specified @c columnIndex is invalid, or
- * the value is less than @c or a @c null pointer.
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - The instance has not been properly constructed.
+ * - The instance is finalized.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c columnIndex is invalid.
+ * - The value is less than @c or a @c null pointer.
* @exception E_INVALID_OPERATION This method has failed to bind the parameter because the database state has not been reset
- * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext().
+ * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext(). @n
* In this case DbEnumerator::Reset() should be invoked before calling this method.
*/
result BindDateTime(int columnIndex, const Tizen::Base::DateTime& value);
* @endif
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is bound
+ * @param[in] columnIndex The index of the column to bind the @c null value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The instance has not been properly constructed,
- * or the instance is finalized.
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - The instance has not been properly constructed.
+ * - The instance is finalized.
* @exception E_INVALID_ARG The specified @c columnIndex is invalid.
* @exception E_INVALID_OPERATION This method has failed to bind the parameter because the database state has not been reset
- * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext().
+ * after executing the SELECT query by using Database::ExecuteStatementN() or DbEnumerator::MoveNext(). @n
* In this case DbEnumerator::Reset() should be invoked before calling this method.
*/
result BindNull(int columnIndex);
* @file FIoDbTypes.h
* @brief This is the header file for the %DbColumnType enumerator.
*
- * This header file contains the declarations of the %DbColumnType enumerator.
+ * This header file contains the declarations of the DbColumnType enumerator.
*/
#ifndef _FIO_DB_TYPES_H_
/**
* @class DirEntry
- * @brief This class stores the information about each directory entry.
+ * @brief This class provides methods for the information about each directory entry.
*
* @since 2.0
*
*
* @since 2.0
*
- * @return A reference to the calling instance
+ * @return A reference to the current instance
* @param[in] rhs An instance of %DirEntry
*/
DirEntry& operator =(const DirEntry& rhs);
/**
- * Compares the specified instance of Object to the calling instance of %DirEntry.
+ * Compares the specified instance of Tizen::Base::Object to the calling instance of %DirEntry.
*
* @since 2.0
*
*
* The %DirEnumerator class provides methods to access the collection of a specific directory entry list.
* Generally, %DirEnumerator is instantiated by the Directory::ReadN() method,
- * and used to get the %DirEntry instances that have information pertaining to the directory.
+ * and used to get the DirEntry instances that have information pertaining to the directory.
*
* For more information on the class features,
* see <a href="../org.tizen.native.appprogramming/html/guide/io/io_namespace.htm">Io Guide</a>.
* @return A reference to the DirEntry instance
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The current position of the collection is not valid.
- * @remarks Use the MoveNext() method to get information from another file or directory to the currently accessed directory. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - Use the MoveNext() method to get information from another file or directory to the currently accessed directory.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
DirEntry GetCurrentDirEntry(void) const;
/**
- * Gets the pointer to the object at the current position of a directory entry collection.
+ * Gets a pointer to the object at the current position of a directory entry collection.
*
* @since 2.0
*
/**
* Moves the current position of the collection to the next position in the currently accessed directory. @n
- * When %DirEnumerator is instantiated, its initial position is set to @c -1. @n
- * Therefore, calling the GetCurrentDirEntry() method without a call to MoveNext() throws an E_INVALID_STATE exception,
+ * When DirEnumerator is instantiated, its initial position is set to @c -1. @n
+ * Therefore, calling the GetCurrentDirEntry() method without a call to MoveNext() throws an @c E_INVALID_STATE exception,
* and returns a reference to an empty DirEntry instance. @n
* Similarly, calling the GetCurrent() method without a call to MoveNext() returns a @c null pointer to indicate an error condition.
*
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The length of the specified path is @c 0 or exceeds
- * system limitations. @n
- * - The specified path is invalid. @n
+ * system limitations.
+ * - The specified path is invalid.
* - The file handle is invalid (the file is closed by another method).
* @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_END_OF_FILE There are no more directory entries to read.
* @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
virtual result MoveNext(void);
/**
* @class Directory
- * @brief This class provides methods to operate on directories.
+ * @brief This class provides methods for directory operations.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %Directory class provides methods to operate on directories.
+ * The %Directory class provides methods for directory operations.
*
* For more information on the class features,
* see <a href="../org.tizen.native.appprogramming/html/guide/io/io_namespace.htm">Io Guide</a>.
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. @n
+ * For full construction, the Construct() method must be called right after calling this constructor.
*
* @since 2.0
*
* @return An error code
* @param[in] dirPath The path to the directory to open
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified path is @c 0 or exceeds system limitations. @n
- * - The specified path contains prohibited character(s). @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified path is @c 0 or exceeds system limitations.
+ * - The specified path contains prohibited character(s).
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
result Construct(const Tizen::Base::String& dirPath);
* @return A pointer to the DirEnumerator object that provides a way to access the collection of a directory entry list, @n
* else @c null if an exception occurs
* @exception E_SUCCESS The method is successful.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
- * @remarks The returned enumeration objects should be released by the caller. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - The returned enumeration objects should be released by the caller.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
DirEnumerator* ReadN(void);
* @endif
*
* @return An error code
- * @param[in] dirPath The path at which the directory is created
- * @param[in] createParentDirectories Set to @c true if the non-existing parent directories are created automatically
+ * @param[in] dirPath The path to create the directory
+ * @param[in] createParentDirectories Set to @c true to create the non-existing parent directories automatically
* up to the destination, @n
- * else @c false if an absent parent directory causes an exception
+ * else @c false to throw an exception in case of absent parent directory
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified path is @c 0 or exceeds system limitations. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified path is @c 0 or exceeds system limitations.
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_ALREADY_EXIST The specified file already exists.
* @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
static result Create(const Tizen::Base::String& dirPath, bool createParentDirectories = false);
* @param[in] recursive Set to @c true to remove the sub-directories recursively, @n
* else @c false
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The length of the specified path is @c 0 or exceeds
- * system limitations. @n
+ * system limitations.
* - The specified @c dirPath is not directory path.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_NOT_FOUND The specified @c dirPath cannot be found.
* @exception E_FILE_ALREADY_EXIST The specified directory already exists.
* @exception E_MAX_EXCEEDED The number of opened directories has exceeded the maximum limit.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
static result Remove(const Tizen::Base::String& dirPath, bool recursive = false);
* @param[in] orgDirPath The original directory path
* @param[in] newDirPath The new directory path
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified path is @c 0 or exceeds system limitations. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified path is @c 0 or exceeds system limitations.
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
* @exception E_FILE_ALREADY_EXIST The specified file already exists.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
static result Rename(const Tizen::Base::String& orgDirPath, const Tizen::Base::String& newDirPath);
enum FileSeekPosition
{
FILESEEKPOSITION_BEGIN, /**<The beginning of the file */
- FILESEEKPOSITION_CURRENT, /**<The current position of the file */
+ FILESEEKPOSITION_CURRENT, /**<The current position in the file */
FILESEEKPOSITION_END /**<The end of the file */
};
/**
* @class File
- * @brief This class provides the basic file I/O operations, such as read, write, create, and remove.
+ * @brief This class provides the file I/O operations, such as read, write, create, and remove.
*
* @since 2.0
*
* The %File class provides the basic file I/O operations, such as read, write, create, and remove.
* It only provides synchronous file read-write with raw data bytes (UTF-8) or string data.
* It is constructed using the Construct() method to access files and control file I/O operations.
- * There is no method like Close() to close the opened file instances.
+ * It does not provide a Close() method to close the opened file instances.
* The only way to close an opened file is by invoking the destructor of the %File class.
* Therefore, if the %File class is instantiated as a local variable, it is not closed until it goes out of scope.
- * To get a detailed information on a file or directory, use the FileAttributes and Directory classes.
+ * To get detailed information on a file or directory, use the FileAttributes and Directory classes.
*
- * When an application is installed, the application has its own storage area, which is application root directory.
+ * When an application is installed, the application has its own storage area, which is the application root directory.
* The application root directory path can be obtained by calling Tizen::App::App::GetAppRootPath().
* The following are some of the sub-directories of the application root directory:
- * - data - Used to store and access private data of an application (read-write permission) @n
- * To access this directory, use Tizen::App::App::GetInstance()->GetAppRootPath() + L"data"
- * or Tizen::App::App::GetInstance()->GetAppDataPath().
- * - res - Used to read resource files that are delivered with the application package (read-only permission) @n
- * To access this directory, use Tizen::App::App::GetInstance()->GetAppRootPath() + L"res"
- * or Tizen::App::App::GetInstance()->GetAppResourcePath().
- * - shared - Used to share data and resource files with other applications @n
- * There are data and res directories under the shared directory.
- * Use Tizen::App::App::GetInstance()->GetAppRootPath() + L"shared" to access its own shared directory and
- * use Tizen::App::AppManager::GetAppSharedPath() to access other application's shared directory. @n
+ * - data - Used to store and access private data of an application (read-write permission) @n
+ * To access this directory, use Tizen::App::App::GetInstance()->GetAppRootPath() + L"data"
+ * or Tizen::App::App::GetInstance()->GetAppDataPath().
+ * - res - Used to read resource files that are delivered with the application package (read-only permission) @n
+ * To access this directory, use Tizen::App::App::GetInstance()->GetAppRootPath() + L"res"
+ * or Tizen::App::App::GetInstance()->GetAppResourcePath().
+ * - shared - Used to share data and resource files with other applications @n
+ * Shared directory has data and res directories.
+ * Use Tizen::App::App::GetInstance()->GetAppRootPath() + L"shared" to access its own shared directory and
+ * use Tizen::App::AppManager::GetAppSharedPath() to access other application's shared directory.
*
* For more information on the path,
* see <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/io_overview.htm">I/O Overview</a>.
*
- * For more information on class features,
+ * For more information on the class features,
* see <a href="../org.tizen.native.appprogramming/html/guide/io/io_namespace.htm">Io Guide</a>.
*
* The following example demonstrates how to use the %File class.
* @if OSPCOMPAT
* @page CompIoPathPage Compatibility for path
* @section CompIoPathPageIssueSection Issues
- * The path argument of this method in OSP compatible applications has the following issue: @n
+ * The path argument of this method in OSP compatible applications has the following issue:
*
* -# The path should begin with an allowed path prefix such as '/Home', '/Home/Share', '/Res', '/Share/[@e appid]',
* '/Media', and '/Storagecard/Media'.
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. @n
+ * For full construction, the Construct() method must be called right after calling this constructor.
*
* @since 2.0
*/
* - a+: Open for appending and reading. The file is created if it does not exist.
* @param[in] createParentDirectories Set to @c true to automatically create non-existent parent directories up to destination, @n
* else @c false @n
- * This parameter is useful only if the specified @c openMode allows creation of an absent
- * file. For example, the following modes: "w", "w+", "a" and "a+". @n
+ * This parameter is useful only if the specified @c openMode is "w", "w+", "a" or "a+"
+ * that allows the creation of an absent file. @n
* If the value of @c openMode is not any one of these, E_INVALID_ARG exception is thrown.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified path is equal to @c 0 or
- * exceeds system limitations. @n
- * - The combination of the specified @c openMode is not allowed. @n
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission. @n
+ * exceeds system limitations.
+ * - The combination of the specified @c openMode is not allowed.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission. @n
* For example, opening a read-only file in the write mode such as "w" or "a".
* @exception E_FILE_NOT_FOUND The specified @c filePath cannot be found.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
- * @remarks The following file opening mode strings are recognized by this method: "w+", "wb+", "w+b", "w", "wb", "a+",
- * "ab+", "a+b", "a", "ab", "r+", "rb+", "r+b", "r", "rb". @n
- * Other strings lead to E_INVALID_ARG. However, "b"(binary) open mode is ignored internally.
+ * @remarks The valid file opening modes for this method are: "w+", "wb+", "w+b", "w", "wb", "a+",
+ * "ab+", "a+b", "a", "ab", "r+", "rb+", "r+b", "r", and "rb". @n
+ * If any other value is passed, this method throws @c E_INVALID_ARG. However, "b"(binary) open mode is ignored
+ * internally.
* @endcond
*/
result Construct(const Tizen::Base::String& filePath, const Tizen::Base::String& openMode, bool createParentDirectories);
* - a : Open for appending. The file is created if it does not exist.
* - a+: Open for appending and reading. The file is created if it does not exist.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified path is equal to @c 0 or
- * exceeds system limitations. @n
- * - The combination of the specified @c openMode is not allowed. @n
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission. @n
+ * exceeds system limitations.
+ * - The combination of the specified @c openMode is not allowed.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission. @n
* For example, opening a read-only file in the write mode such as "w" or "a".
* @exception E_FILE_NOT_FOUND The specified @c filePath cannot be found.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The following file opening mode strings are recognized by this method: "w+", "wb+", "w+b", "w", "wb", "a+",
- * "ab+", "a+b", "a", "ab", "r+", "rb+", "r+b", "r", "rb". @n
- * Other strings lead to E_INVALID_ARG. However, "b"(binary) open mode is ignored internally.
+ * @remarks The valid file opening modes for this method are: "w+", "wb+", "w+b", "w", "wb", "a+",
+ * "ab+", "a+b", "a", "ab", "r+", "rb+", "r+b", "r", and "rb". @n
+ * If any other value is passed, this method throws @c E_INVALID_ARG. However, "b"(binary) open mode is ignored
+ * internally.
*/
result Construct(const Tizen::Base::String& filePath, const Tizen::Base::String& openMode);
* - a : Open for appending. The file is created if it does not exist.
* - a+: Open for appending and reading. The file is created if it does not exist.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified path is equal to @c 0 or
- * exceeds system limitations. @n
- * - The combination of the specified @c pOpenMode is not allowed. @n
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission. @n
+ * exceeds system limitations.
+ * - The combination of the specified @c pOpenMode is not allowed.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission. @n
* For example, opening a read-only file in the write mode such as "w" or "a".
* @exception E_FILE_NOT_FOUND The specified @c filePath cannot be found.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The following file opening mode strings are recognized by this method: "w+", "wb+", "w+b", "w", "wb", "a+",
- * "ab+", "a+b", "a", "ab", "r+", "rb+", "r+b", "r", "rb". @n
- * Other strings lead to E_INVALID_ARG. However, "b"(binary) open mode is ignored internally.
+ * @remarks The valid file opening modes for this method are: "w+", "wb+", "w+b", "w", "wb", "a+",
+ * "ab+", "a+b", "a", "ab", "r+", "rb+", "r+b", "r", and "rb". @n
+ * If any other value is passed, this method throws @c E_INVALID_ARG. However, "b"(binary) open mode is ignored
+ * internally.
*/
result Construct(const Tizen::Base::String& filePath, const char* pOpenMode);
* This method opens an existing secure file or creates a new one according to the specified file opening mode. @n
* The contents written to the secure file is automatically encrypted and the contents read from the secure file is automatically
* decrypted by the platform. @n
- * Applications using this method can access the secure files that are created by other applications with the identical key value
- * in same device. However, the secure files created by this method cannot be accessed in other devices.
+ * Applications using this method can access the secure files that are created by other applications with an identical key value
+ * in the same device. However, the secure files created by this method cannot be accessed in other devices.
*
* @since 2.0
*
* otherwise it is truncated to zero length.
* - a : Open for appending. The file is created if it does not exist.
* - a+: Open for appending and reading. The file is created if it does not exist.
- * @param[in] secretKey A key used to encrypt data of a file or decrypt a secure file @n
- * If a secure file is created with a specific key value,
- * other applications can access the same secure file with the identical key value.
+ * @param[in] secretKey The key used to encrypt the data of the file or decrypt the secure file @n
+ * If the secure file is created with a specific key value,
+ * other applications can access the secure file with an identical key value.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified path is equal to @c 0 or
* exceeds system limitations.
- * - The combination of the specified @c pOpenMode is not allowed. @n
+ * - The combination of the specified @c pOpenMode is not allowed.
* - The specified @c secretKey is incorrect or the secure file is corrupted.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission. @n
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission. @n
* For example, opening a read-only file in the write mode such as "w" or "a".
* @exception E_FILE_NOT_FOUND The specified @c filePath cannot be found.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
- * - %File corruption is detected. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
+ * - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The following file opening mode strings are recognized by this method: "w+", "wb+", "w+b", "w", "wb", "a+",
- * "ab+", "a+b", "a", "ab", "r+", "rb+", "r+b", "r", "rb". @n
- * Other strings lead to E_INVALID_ARG. However, "b"(binary) open mode is ignored internally.
+ * @remarks The valid file opening modes for this method are: "w+", "wb+", "w+b", "w", "wb", "a+",
+ * "ab+", "a+b", "a", "ab", "r+", "rb+", "r+b", "r", and "rb". @n
+ * If any other value is passed, this method throws @c E_INVALID_ARG. However, "b"(binary) open mode is ignored
+ * internally.
*/
result Construct(const Tizen::Base::String& filePath, const char* pOpenMode, const Tizen::Base::ByteBuffer& secretKey);
/**
* Reads the byte data from the current file pointer. @n
* The user-specified ByteBuffer is filled with the byte data from the current position in the file.
- * The read operation continues until the specified ByteBuffer is filled or end-of-file is met. @n
+ * The read operation continues until the specified ByteBuffer is filled or the end of file is reached. @n
* In the secure mode, the byte data read from the secure file is automatically decrypted by a platform security module.
*
* @since 2.0
*
* @return An error code
- * @param[in, out] buffer A reference to the buffer that is used to receive the byte data read from the file
+ * @param[in, out] buffer The reference to the buffer to copy the byte data
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c buffer has no space to store the read data.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - The file is not opened for read operation. @n
- * - Access is denied due to insufficient permission.
- * @exception E_END_OF_FILE The file pointer has reached end-of-file.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The file is not opened for read operation.
+ * - The access is denied due to insufficient permission.
+ * @exception E_END_OF_FILE The file pointer has reached the end of file.
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
- * @remarks The ByteBuffer should be constructed before being passed to the method.
+ * @remarks The ByteBuffer should be constructed before being passed to this method.
*/
result Read(Tizen::Base::ByteBuffer& buffer);
/**
- * Reads the byte data from the current file pointer and copies it into the specified buffer. @n
+ * Reads the byte data from the current file pointer and copies it to the specified buffer. @n
* In the secure mode, the byte data read from the secure file is automatically decrypted by a platform security module.
*
* @since 2.0
*
* @return The length of the data read in bytes, @n
* else @c 0 in case of failure
- * @param[out] buffer A pointer to the user-supplied buffer where the read data is copied
+ * @param[out] buffer The pointer to the buffer to copy the byte data
* @param[in] length The buffer length in bytes
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c buffer contains a @c null pointer. @n
- * - The length of the specified @c buffer is equal to or smaller than @c 0. @n
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - The file is not opened for read operation. @n
- * - Access is denied due to insufficient permission.
- * @exception E_END_OF_FILE The file pointer has reached end-of-file.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c buffer contains a @c null pointer.
+ * - The length of the specified @c buffer is equal to or smaller than @c 0.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The file is not opened for read operation.
+ * - The access is denied due to insufficient permission.
+ * @exception E_END_OF_FILE The file pointer has reached the end of file.
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
int Read(void* buffer, int length);
/**
- * Reads the string data from the current file pointer and copies the string to the specified buffer (it is assumed that the
- * file is in the UTF-8 format). @n
- * The read operation continues until new line character or end-of-file is met. @n
+ * Reads the string data from the current file pointer and copies it to the specified buffer. @n
+ * It is assumed that the file is in the UTF-8 format.
+ * The read operation continues until a new line character or end-of-file is reached. @n
* In the secure mode, the string data read from the secure file is automatically decrypted by a platform security module.
*
* @since 2.0
*
* @return An error code
- * @param[out] buffer A reference to the buffer where the data is copied
+ * @param[out] buffer A reference to the buffer to copy the string data
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c buffer is invalid.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - The file is not opened for read operation. @n
- * - Access is denied due to insufficient permission.
- * @exception E_END_OF_FILE The file pointer reached end-of-file.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The file is not opened for read operation.
+ * - The access is denied due to insufficient permission.
+ * @exception E_END_OF_FILE The file pointer reached the end of file.
* @exception E_IO Either of the following conditions has occurred:
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
- * @remarks To get the expected string value
- * from a file, which is not in the UTF-8 format (Unicode or any other format),
- * user should use other encoding or decoding methods of the Tizen::Text namespace after reading the content of
- * a file in binary format. @n
- * The maximum length of characters read by this method is defined as 4096. @n
- * Therefore, if the length of a single line (considering new line character or end-of-file) from the current
+ * @remarks To get the expected string value from a file, which is not in the UTF-8 format
+ * (Unicode or any other format), the user should use other encoding or decoding methods of the
+ * Tizen::Text namespace after reading the content of the file in binary format. @n
+ * The maximum length of characters read by this method is defined as @c 4096. @n
+ * Therefore, if the length of a single line (till a new line character or end-of-file is reached) from the current
* file position is longer than 4096, the rest of the characters remain as not read. @n
- * 'ByteBuffer' or 'void*' version of the File::Read() API can be used to overcome this limitation.
+ * The 'ByteBuffer' or 'void*' version of the File::Read() API can be used to overcome this limitation.
*/
result Read(Tizen::Base::String& buffer);
/**
- * Writes the byte data from the specified ByteBuffer into a file beginning at the current position to the limit of the
- * %ByteBuffer. @n
- * In the secure mode, the byte data written by a user is automatically encrypted to the secure file by a platform security module. @n
- * The size of a secure file can be greater than the size of a normal (original) file
- * because of the encryption.
- * However, the file pointer for the secure file is equal to the file pointer for the original file.
+ * Writes the byte data from the specified Tizen::Base::ByteBuffer beginning at the current position to the limit of the %Tizen::Base::ByteBuffer
+ * to a file . @n
+ * In the secure mode, the byte data written is automatically encrypted to a secure file by the platform security module. @n
+ * The size of a secure file can be greater than the size of a normal (original) file because of the encryption.
+ * However, the file pointer for a secure file is equal to the file pointer for an original file.
*
* @since 2.0
*
* @return An error code
- * @param[in] buffer A reference to the buffer that contains byte data to write
+ * @param[in] buffer A reference to the buffer that contains the byte data to write
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c buffer is invalid.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - The file is not opened for write operation. @n
- * - Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The file is not opened for write operation.
+ * - The access is denied due to insufficient permission.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
result Write(const Tizen::Base::ByteBuffer& buffer);
/**
- * Writes the byte data into a file. @n
- * In the secure mode, the byte data written by a user is automatically encrypted to the secure file by a platform security module. @n
- * The size of a secure file can be greater than the size of a normal (original) file
- * because of the encryption.
- * However, the file pointer for the secure file is equal to the file pointer for the original file.
+ * Writes the byte data from the specified buffer to a file. @n
+ * In the secure mode, the byte data written is automatically encrypted to a secure file by the platform security module. @n
+ * The size of a secure file can be greater than the size of a normal (original) file because of the encryption.
+ * However, the file pointer for a secure file is equal to the file pointer for an original file.
*
* @since 2.0
*
* @return An error code
- * @param[in] buffer A pointer to the user-supplied buffer that contains @c byte data to write
+ * @param[in] buffer A pointer to the buffer that contains the @c byte data to write
* @param[in] length The buffer length in bytes
* @exception E_SUCCESS The method is successful.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - The file is not opened for write operation. @n
- * - Access is denied due to insufficient permission.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c buffer contains a @c null pointer. @n
- * - The specified @c buffer length is equal or smaller than @c 0. @n
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The file is not opened for write operation.
+ * - The access is denied due to insufficient permission.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c buffer contains a @c null pointer.
+ * - The specified @c buffer length is equal or smaller than @c 0.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
result Write(const void* buffer, int length);
/**
- * Writes the string data into a file. @n
- * In the secure mode, the string data written by a user is automatically encrypted to the secure file by a platform security
- * module. @n
- * The size of a secure file can be greater than the size of a normal (original) file
- * because of the encryption.
- * However, the file pointer for the secure file is equal to the file pointer for the original file.
+ * Writes the string data from the specified buffer to a file. @n
+ * In the secure mode, the string data written is automatically encrypted to a secure file by the platform security module. @n
+ * The size of a secure file can be greater than the size of a normal (original) file because of the encryption.
+ * However, the file pointer for a secure file is equal to the file pointer for an original file.
*
* @since 2.0
*
* @return An error code
- * @param[in] buffer A reference to the buffer that contains string data to write
+ * @param[in] buffer A reference to the buffer that contains the string data to write
* @exception E_SUCCESS The method is successful.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - The file is not opened for write operation. @n
- * - Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The file is not opened for write operation.
+ * - The access is denied due to insufficient permission.
* @exception E_INVALID_ARG The specified @c buffer contains an empty string.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
result Write(const Tizen::Base::String& buffer);
/**
- * Flushes the internally buffered data to kernel memory of the underlying operating system.
+ * Flushes the internally buffered data to the kernel memory of the underlying operating system.
*
* @since 2.0
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
result Flush(void);
/**
* Gets the offset of the current file pointer relative to the beginning of the file. @n
- * The size of a secure file can be greater than the size of a normal (original) file
- * because of the encryption.
- * However, the file pointer for the secure file is equal to the file pointer for the original file.
+ * The size of a secure file can be greater than the size of a normal (original) file because of the encryption.
+ * However, the file pointer for a secure file is equal to the file pointer for an original file.
*
* @since 2.0
*
* @return The offset of the current file pointer, @n
* else @c -1L if an error occurs
* @exception E_SUCCESS The method is successful.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Seek()
int Tell(void) const;
/**
- * Repositions the file pointer associated with an opened file. @n
+ * Repositions the file pointer associated with the opened file. @n
* Each opened file has its own file pointer, and it points to the next byte to be read or written in the file.
* The repositioning offset can be specified with respect to the beginning of file, current position, or end of the file.
* If the file pointer is over the end-of-file, it expands the file size to the specified position and the expanded area is
* filled with zero. @n
- * The size of a secure file can be greater than the size of a normal (original) file
- * because of the encryption.
- * However, the file pointer for the secure file is equal to the file pointer for the original file.
+ * The size of a secure file can be greater than the size of a normal (original) file because of the encryption.
+ * However, the file pointer for a secure file is equal to the file pointer for an original file.
*
* @since 2.0
*
* @return An error code
- * @param[in] position The origin from where to start the repositioning a file pointer
+ * @param[in] position The starting position to reposition the file pointer
* @param[in] offset The number of bytes to move a file pointer @n
* A negative offset moves the pointer backwards.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c position or @c offset is invalid.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @see FileSeekPosition
*/
/**
* Truncates the file size to the specified length. @n
- * If the specified length is less than the length of file, the bytes present between the @c length and size of a file are
- * removed.
- * If the file size is small, its size is increased. @n
- * The size of a secure file can be greater than the size of a normal (original) file
- * because of the encryption.
+ * If the specified length is less than the length of file, the bytes present between the specified @c length and size of
+ * the file are removed. If the file size is small, its size is increased. @n
+ * The size of a secure file can be greater than the size of a normal (original) file because of the encryption.
* However, the file pointer for a secure file is equal to the file pointer for an original file.
*
* @since 2.0
* @return An error code
* @param[in] length The required file size in bytes after this method is executed
* @exception E_SUCCESS The method is successful.
- * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred: @n
- * - The file is not opened for write operation. @n
- * - Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The file is not opened for write operation.
+ * - The access is denied due to insufficient permission.
* @exception E_INVALID_ARG The specified @c length has a negative value.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
result Truncate(int length);
/**
- * Gets the path associated with a constructed %File.
+ * Gets the path associated with the %File.
*
* @since 2.0
*
- * @return The file path to the currently constructed %File if successful, @n
+ * @return The path of the currently constructed %File, @n
* else an empty string in case of failure
*/
Tizen::Base::String GetName(void) const;
/**
- * Acquires the file lock on the current opened whole file if it is not acquired.
+ * Acquires the file lock on the current opened whole file if it is not acquired. @n
* If the file lock is already acquired by another process, the current process is blocked until the file lock is
* released.
*
* @since 2.1
*
- * @return The pointer to %FileLock instance, @n
- * else @c null pointer in case of failure
- * @param[in] lockType The type of file lock to be created
+ * @return The pointer to the FileLock instance, @n
+ * else @c null pointer in case of failure
+ * @param[in] lockType The type of the file lock to be created
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c lockType is invalid.
- * @exception E_INVALID_OPERATION Either of the following conditions has occurred: @n
- * - The specified @c lockType cannot be FILE_LOCK_SHARED if the current
- * file is not open for reading. @n
- * - The specified @c lockType cannot be FILE_LOCK_EXCLUSIVE if the current
- * file is not open for writing. @n
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The specified @c lockType cannot be @c FILE_LOCK_SHARED if the current
+ * file is not open for reading.
+ * - The specified @c lockType cannot be @c FILE_LOCK_EXCLUSIVE if the current
+ * file is not open for writing.
* @exception E_WOULD_DEADLOCK The method would cause a deadlock. @n
- * The lock is blocked by a lock from another process, and putting the
- * calling process to sleep to wait for that lock to become free would
- * cause a deadlock.
- * @exception E_MAX_EXCEEDED The number of file lock exceeds system limitations.
+ * The lock is blocked by a lock from another process, and putting the
+ * calling process to sleep to wait for that lock to become free would
+ * cause a deadlock.
+ * @exception E_MAX_EXCEEDED The number of file locks has exceeded system limitations.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The %FileLock instance is invalid if the associated %File instance is deleted. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - The FileLock instance is invalid if the associated %File instance is deleted.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
FileLock* LockN(FileLockType lockType);
/**
- * Acquires the file lock on the specified region of the current opened file if it is not acquired.
+ * Acquires the file lock on the specified region of the current opened file if it is not acquired. @n
* If the file lock is already acquired by another process, the current process is blocked until the file lock is
* released.
*
* @since 2.1
*
- * @return The pointer to %FileLock instance, @n
- * else @c null pointer in case of failure
+ * @return The pointer to the FileLock instance, @n
+ * else @c null pointer in case of failure
* @param[in] lockType The type of file lock to be created
* @param[in] offset The starting offset for the locked region
* @param[in] length The length of the locked region in bytes
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The specified @c lockType is invalid.
* - The specified @c offset or @c length is negative or is greater than
* the system limitation.
- * @exception E_INVALID_OPERATION Either of the following conditions has occurred: @n
- * - The specified @c lockType cannot be FILE_LOCK_SHARED if the current
- * file is not open for reading. @n
- * - The specified @c lockType cannot be FILE_LOCK_EXCLUSIVE if the current
- * file is not open for writing. @n
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The specified @c lockType cannot be @c FILE_LOCK_SHARED if the current
+ * file is not open for reading.
+ * - The specified @c lockType cannot be @c FILE_LOCK_EXCLUSIVE if the current
+ * file is not open for writing.
* @exception E_WOULD_DEADLOCK The method would cause a deadlock. @n
- * The lock is blocked by a lock from another process, and putting the
- * calling process to sleep to wait for that lock to become free would
- * cause a deadlock.
- * @exception E_MAX_EXCEEDED The number of file lock exceeds system limitations.
+ * The lock is blocked by a lock from another process, and putting the
+ * calling process to sleep to wait for that lock to become free would
+ * cause a deadlock.
+ * @exception E_MAX_EXCEEDED The number of file locks has exceeded system limitations.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The %FileLock instance is invalid if the associated %File instance is deleted. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - The FileLock instance is invalid if the associated %File instance is deleted.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
FileLock* LockN(FileLockType lockType, int offset, int length);
/**
- * Tries to acquire the file lock on the current opened whole file.
- * If the file lock is already acquired by another process, E_OBJECT_LOCKED is returned.
+ * Tries to acquire the file lock on the current opened whole file. @n
+ * If the file lock is already acquired by another process, @c E_OBJECT_LOCKED is returned.
*
* @since 2.1
*
- * @return The pointer to %FileLock instance, @n
- * else @c null pointer in case of failure
+ * @return The pointer to the FileLock instance, @n
+ * else @c null pointer in case of failure
* @param[in] lockType The type of file lock to be created
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c lockType is invalid.
- * @exception E_INVALID_OPERATION Either of the following conditions has occurred: @n
- * - The specified @c lockType cannot be FILE_LOCK_SHARED if the current
- * file is not open for reading. @n
- * - The specified @c lockType cannot be FILE_LOCK_EXCLUSIVE if the current
- * file is not open for writing. @n
- * @exception E_OBJECT_LOCKED Either of the following conditions has occurred: @n
- * - The file lock is already held by another process. @n
- * - The file to be locked has been memory-mapped by another process.
- * @exception E_MAX_EXCEEDED The number of file lock exceeds system limitations.
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The specified @c lockType cannot be @c FILE_LOCK_SHARED if the current
+ * file is not open for reading.
+ * - The specified @c lockType cannot be @c FILE_LOCK_EXCLUSIVE if the current
+ * file is not open for writing.
+ * @exception E_OBJECT_LOCKED Either of the following conditions has occurred:
+ * - The file lock is already held by another process.
+ * - The file to be locked has been memory-mapped by another process.
+ * @exception E_MAX_EXCEEDED The number of file locks has exceeded system limitations.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The %FileLock instance is invalid if the associated %File instance is deleted. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - The FileLock instance is invalid if the associated %File instance is deleted.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
FileLock* TryToLockN(FileLockType lockType);
/**
- * Tries to acquire the file lock on the specified region of the current opened file.
- * If the file lock is already acquired by another process, E_OBJECT_LOCKED is returned.
+ * Tries to acquire the file lock on the specified region of the current opened file. @n
+ * If the file lock is already acquired by another process, @c E_OBJECT_LOCKED is returned.
*
* @since 2.1
*
- * @return The pointer to %FileLock instance, @n
- * else @c null pointer in case of failure
+ * @return The pointer to the FileLock instance, @n
+ * else @c null pointer in case of failure
* @param[in] lockType The type of file lock to be created
* @param[in] offset The starting offset for the locked region
* @param[in] length The length of the locked region in bytes
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c lockType is invalid.
- * - The specified @c offset or @c length is negative or is greater than
- * the system limitation.
- * @exception E_INVALID_OPERATION Either of the following conditions has occurred: @n
- * - The specified @c lockType cannot be FILE_LOCK_SHARED if the current
- * file is not open for reading. @n
- * - The specified @c lockType cannot be FILE_LOCK_EXCLUSIVE if the current
- * file is not open for writing. @n
- * @exception E_OBJECT_LOCKED Either of the following conditions has occurred: @n
- * - The file lock is already held by another process. @n
- * - The file to be locked has been memory-mapped by another process.
- * @exception E_MAX_EXCEEDED The number of file lock exceeds system limitations.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c lockType is invalid.
+ * - The specified @c offset or @c length is negative or is greater than
+ * the system limitation.
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The specified @c lockType cannot be @c FILE_LOCK_SHARED if the current
+ * file is not open for reading.
+ * - The specified @c lockType cannot be @c FILE_LOCK_EXCLUSIVE if the current
+ * file is not open for writing.
+ * @exception E_OBJECT_LOCKED Either of the following conditions has occurred:
+ * - The file lock is already held by another process.
+ * - The file to be locked has been memory-mapped by another process.
+ * @exception E_MAX_EXCEEDED The number of file locks has exceeded system limitations.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The %FileLock instance is invalid if the associated %File instance is deleted. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - The FileLock instance is invalid if the associated %File instance is deleted.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
FileLock* TryToLockN(FileLockType lockType, int offset, int length);
* @return An error code
* @param[in] filePath The path of the file to delete
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified path is equal to @c 0 or
- * exceeds system limitations. @n
+ * exceeds system limitations.
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission. @n
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission. @n
* For example, opening a read-only file in the write mode.
* @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @remarks The opened file cannot be deleted.
*/
static result Remove(const Tizen::Base::String& filePath);
/**
- * Moves the specified file to another location. @n
+ * Moves the specified file to the specified location. @n
* The opened files cannot be moved. This method is static.
*
* @if OSPCOMPAT
* @param[in] oldFilePath The old file path
* @param[in] newFilePath The new file path
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified path is equal to @c 0 or
- * exceeds system limitations. @n
+ * exceeds system limitations.
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission. @n
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission. @n
* For example, opening a read-only file in the write mode.
- * @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
+ * @exception E_FILE_NOT_FOUND The specified @c filePath cannot be found.
* @exception E_FILE_ALREADY_EXIST The specified file already exists.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @see Copy()
- * @see Remove()
+ * @see Remove()
*/
static result Move(const Tizen::Base::String& oldFilePath, const Tizen::Base::String& newFilePath);
/**
- * Copies the existing source file to the destined location. @n
+ * Copies the existing source file to the specified destination file path. @n
* This method is static.
*
* @since 2.0
* @param[in] failIfExist Set to @c true to return an error if the destination file already exists, @n
* else @c false
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified path is equal to @c 0 or
- * exceeds system limitations. @n
+ * exceeds system limitations.
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission. @n
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission. @n
* For example, opening a read-only file in the write mode.
- * @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
+ * @exception E_FILE_NOT_FOUND The specified @c filePath cannot be found.
* @exception E_FILE_ALREADY_EXIST The specified file already exists.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @see Move()
- * @see Remove()
+ * @see Remove()
*/
static result Copy(const Tizen::Base::String& srcFilePath, const Tizen::Base::String& destFilePath, bool failIfExist);
/**
- * Reads the file information such as size, attribute, creation date, and so on. @n
+ * Gets the attributes of the specified file such as size, attribute, creation date, and so on. @n
* This method is static.
*
* @if OSPCOMPAT
* @endif
*
* @return An error code
- * @param[in] filePath The path of the file @n
+ * @param[in] filePath The path of the file
* @param[out] attribute A %File attribute instance
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified path is equal to @c 0 or
- * exceeds system limitations. @n
+ * exceeds system limitations.
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
- * @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
+ * @exception E_FILE_NOT_FOUND The specified @c filePath cannot be found.
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
static result GetAttributes(const Tizen::Base::String& filePath, FileAttributes& attribute);
/**
- * Gets only the file name from the specified file path. @n
+ * Gets the file name from the specified file path. @n
* For example, if the file path passed is 'xxx/file.txt', 'file.txt' is returned.
*
* @if OSPCOMPAT
* @endif
*
* @return The file name of type String
- * @param[in] filePath The path of the file
+ * @param[in] filePath The file path
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The length of the specified path is @c 0 or exceeds system limitations.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*
* @return The file extension, @n
* else an empty string if the file has no extension
- * @param[in] filePath The path of the file
+ * @param[in] filePath The file path
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The length of the specified path is @c 0 or exceeds system limitations.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* For more information, see @ref CompIoPathPage "here".
* @endif
*
- * @return @c true if file or directory exists, @n
+ * @return @c true if the file or directory exists, @n
* else @c false
* @param[in] filePath The path of the file or directory
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified path is equal to @c 0 or
- * exceeds system limitations. @n
+ * exceeds system limitations.
* - The specified path is invalid.
- * @exception E_ILLEGAL_ACCESS The specified path is not permitted, or
- * access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS Either of the following conditions has occurred:
+ * - The specified path is not permitted.
+ * - Access is denied due to insufficient permission.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static bool IsFileExist(const Tizen::Base::String& filePath);
* @return An error code
* @param[in] plainFilePath The normal (non-encrypted) file path
* @param[in] secureFilePath The secure (encrypted) file path to create
- * @param[in] key A key that encrypts a secure file @n
- * If the secure file is converted with a specific key value,
- * applications can access the same secure file with the identical key value.
+ * @param[in] key The key that encrypts the secure file @n
+ * If the secure file is converted with the specific key value,
+ * applications can access the secure file with an identical key value.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified path is equal to @c 0 or
- * exceeds system limitations. @n
- * - The specified path is invalid. @n
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * exceeds system limitations.
+ * - The specified path is invalid.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_ALREADY_EXIST The specified file already exists.
- * @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
+ * @exception E_FILE_NOT_FOUND The specified @c filePath cannot be found.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
- * - %File corruption is detected. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
+ * - %File corruption is detected.
* - The number of opened files has exceeded the maximum limit.
*/
static result ConvertToSecureFile(const Tizen::Base::String& plainFilePath, const Tizen::Base::String& secureFilePath, const Tizen::Base::ByteBuffer& key);
/**
* @class FileAttributes
- * @brief This class provides a collection of basic file attributes.
+ * @brief This class provides methods for file attributes.
*
* @since 2.0
*
FileAttributes(const FileAttributes& rhs);
/**
- * Assigns the value of the specified instance to the current instance of %FileAttributes.
+ * Assigns the specified value of the specified instance to the current instance of %FileAttributes.
*
* @since 2.0
*
FileAttributes& operator =(const FileAttributes& rhs);
/**
- * Compares the specified instance of Object to the calling instance of %FileAttributes.
+ * Compares the specified instance of Tizen::Base::Object to the current instance of %FileAttributes.
*
* @since 2.0
*
*/
enum FileEventType
{
- FILE_EVENT_TYPE_ACCESS = 0x01, /**<%File was accessed (read)*/
- FILE_EVENT_TYPE_ATTRIBUTE = 0x04, /**<Metadata changed*/
- FILE_EVENT_TYPE_CLOSE_WRITE = 0x08, /**<%File opened for writing was closed*/
- FILE_EVENT_TYPE_CLOSE_NOWRITE = 0x10, /**<%File not opened for writing was closed*/
- FILE_EVENT_TYPE_CREATE = 0x100, /**<%File/directory created in monitored directory*/
- FILE_EVENT_TYPE_DELETE = 0x200, /**<%File/directory deleted from monitored directory*/
- FILE_EVENT_TYPE_DELETE_SELF = 0x400, /**<Monitored file/directory was itself deleted.*/
- FILE_EVENT_TYPE_MODIFY = 0x02, /**<%File was modified*/
- FILE_EVENT_TYPE_MOVE_SELF = 0x800, /**<Monitored file/directory was itself moved.*/
- FILE_EVENT_TYPE_MOVED_FROM = 0x40, /**<%File moved out of monitored directory. */
- FILE_EVENT_TYPE_MOVED_TO = 0x80, /**<%File moved into monitored directory. */
- FILE_EVENT_TYPE_OPEN = 0x20 /**<%File was opened. */
+ FILE_EVENT_TYPE_ACCESS = 0x01, /**< %File was accessed (read) */
+ FILE_EVENT_TYPE_ATTRIBUTE = 0x04, /**< Metadata was changed */
+ FILE_EVENT_TYPE_CLOSE_WRITE = 0x08, /**< %File opened for writing was closed */
+ FILE_EVENT_TYPE_CLOSE_NOWRITE = 0x10, /**< %File not opened for writing was closed */
+ FILE_EVENT_TYPE_CREATE = 0x100, /**< %File/directory created in monitored directory */
+ FILE_EVENT_TYPE_DELETE = 0x200, /**< %File/directory deleted from monitored directory */
+ FILE_EVENT_TYPE_DELETE_SELF = 0x400, /**< Monitored file/directory was itself deleted */
+ FILE_EVENT_TYPE_MODIFY = 0x02, /**< %File was modified */
+ FILE_EVENT_TYPE_MOVE_SELF = 0x800, /**< Monitored file/directory was itself moved.*/
+ FILE_EVENT_TYPE_MOVED_FROM = 0x40, /**< %File moved out of monitored directory */
+ FILE_EVENT_TYPE_MOVED_TO = 0x80, /**< %File moved into monitored directory */
+ FILE_EVENT_TYPE_OPEN = 0x20 /**< %File was opened */
};
/**
- * All file event types.
+ * All the file event types.
*
* @since 2.0
*/
/**
* @class FileEventManager
- * @brief This class provides a mechanism for monitoring file system events.
+ * @brief This class provides methods for monitoring file system events.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %FileEventManager class can be used to monitor individual files or directories. When a directory is monitored, this class will send an event for the directory or file itself, and for sub-files or sub-directories inside the observed directory.
+ * The %FileEventManager class can be used to monitor individual files or directories. When a directory is monitored,
+ * this class will send an event for the directory or file itself, and for sub-files or sub-directories inside the observed directory.
*
* @code
*
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. @n
+ * For full construction, the Construct() method must be called right after calling this constructor.
*
* @since 2.0
*/
virtual ~FileEventManager(void);
/**
- * Initializes this instance of %FileEventManager. @n
+ * Initializes this instance of %FileEventManager.
*
* @since 2.0
*
* @return An error code
- * @param[in] listener A listener invoked when monitored files are changed.
+ * @param[in] listener The listener to be invoked when monitored files are changed
* @exception E_SUCCESS The method is successful.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
- * @exception E_IO Either of the following conditions has occurred: @n
+ * @exception E_IO Either of the following conditions has occurred:
* - The specified listener cannot be registered in worker thread.
* - Detected corruption of a file.
*/
/**
- * Adds a new monitor file, or modifies an existing monitor file, for the file whose location is specified in path; the application has to have read permission for this %path. %File event type can be set in %eventsToMonitor.
+ * Adds the monitor file, or modifies an existing monitor file in the specified path. @n
+ * The application must have read permission for this @c path. The file event type can be set in @c eventsToMonitor.
*
* @since 2.0
*
* @return An error code
* @param[in] path The path to the directory or file to monitor
* @param[in] eventsToMonitor The kind of event to monitor @n
- * Multiple event type can be combined using bitwise OR (see Tizen::Io::FileEventType). @n
- * The Tizen::Io::FILE_EVENT_TYPE_ALL is provided for all file event type @n
- * If a specific eventsToMonitor is set, the events that have the specified file event are returned.
+ * Multiple event types can be combined using bitwise OR (see Tizen::Io::FileEventType). @n
+ * The ::FILE_EVENT_TYPE_ALL is provided for all file event types. @n
+ * If a specific @c eventsToMonitor is set, the events that have the specified file event are returned.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified eventsToMonitor contains no valid events.
* @exception E_FILE_NOT_FOUND An entry for the specified path could not be found.
* @exception E_ILLEGAL_ACCESS The specified path is not permitted.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - The specified path outside of the process's accessible address space. @n
- * - The number of file monitor has been exceeded the maximum limit or
- * the failed to allocate a needed resource. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - The specified path is outside the process's accessible address space.
+ * - The number of file monitors has exceeded the maximum limit.
+ * - Failed to allocate a needed resource.
* - Detected corruption of a file.
* @see FileEventType
*/
result AddPath(const Tizen::Base::String& path, unsigned long eventsToMonitor);
/**
- * Removes the monitored file associated with the current instance.
+ * Removes the specified monitored file associated with the current instance.
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] path The path to the directory or file that is monitored
* @exception E_SUCCESS The method is successful.
* @exception E_IO The specified path is not monitored.
*/
enum FileLockType
{
- FILE_LOCK_SHARED, /**< More than one process can hold a shared file lock on a file region @n
+ FILE_LOCK_SHARED, /**< The shared file lock @n More than one process can hold a shared file lock on a file region @n
A shared lock prevents any other process from setting an exclusive lock on the file
- region. */
- FILE_LOCK_EXCLUSIVE /**< Only one process can hold an exclusive lock on a file region @n
+ region */
+ FILE_LOCK_EXCLUSIVE /**< The exclusive file lock @n Only one process can hold an exclusive lock on a file region @n
An exclusive lock prevents any other process from setting both shared and exclusive
- lock on the file region. */
+ lock on the file region */
};
/**
// limitations under the License.
//
/**
+ * @if OSPDEPREC
* @file FIoIChannelRequestEventListener.h
* @brief This is the header file for the %IChannelRequestEventListener interface.
*
* This header file contains the declarations of the %IChannelRequestEventListener interface.
+ * @endif
*/
#ifndef _FIO_ICHANNEL_REQUESTEVENT_LISTENER_H_
{
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
* @interface IChannelResponseEventListener
* @brief <i> [Deprecated] </i> This interface provides event handlers for any response events received through a channel.
*
-* @deprecated This class is deprecated. Instead of using this class, use the MessagePortManager class.
+* @deprecated This interface is deprecated. Instead of using this interface, use the MessagePortManager class.
* @since 2.0
*
* The %IChannelResponseEventListener interface provides event handlers for receiving the channel response events.
{
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to move the cursor position of the result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_OUT_OF_RANGE The enumerator has reached out of the result set returned by the SELECT query.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to move the cursor position of the result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_OUT_OF_RANGE The enumerator has reached out of the result set returned by the SELECT query.
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to move the cursor position of the result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to move the cursor position of the result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_INVALID_FORMAT The database file is malformed.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
virtual result MoveLast(void) = 0;
/**
- * Resets the calling %IDbEnumerator instance back to its initial state.
+ * Resets the calling %IDbEnumerator instance to its initial state.
*
* @since 2.0
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to reset the enumerator of the result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_OBJECT_LOCKED The database instance is locked.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks After this method is called, if MoveNext() is called the cursor goes to the first position.
+ * @remarks If MoveNext() is called after this method, the cursor goes to the first position.
*/
virtual result Reset(void) = 0;
/**
- * Gets an @c int value from the column whose index is specified.
+ * Gets the @c int value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
+ * @param[in] columnIndex The index of the column to get the value
* @param[in,out] value The integer value obtained from the column
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
virtual result GetIntAt(int columnIndex, int& value) const = 0;
/**
- * Gets a @c long @c long value from the column whose index is specified.
+ * Gets the @c long @c long value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
+ * @param[in] columnIndex The index of the column to get the value
* @param[in,out] value The 64-bit integer value obtained from the column
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
virtual result GetInt64At(int columnIndex, long long& value) const = 0;
/**
- * Gets a @c double value from the column whose index is specified.
+ * Gets the @c double value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] value The value obtained from the column as a double
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] value The double value obtained from the column
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
*/
virtual result GetDoubleAt(int columnIndex, double& value) const = 0;
/**
- * Gets a @c String value from the column whose index is specified.
+ * Gets the @c String value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] value The value obtained from the column as a String
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] value The @c String value obtained from the column
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
- * @exception E_INVALID_ENCODING_RANGE The string conversion has failed due to invalid encoding range, or
- * it is possible if the database file is corrupted.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
+ * @exception E_INVALID_ENCODING_RANGE Either of the following conditions has occurred:
+ * - The string conversion has failed due to invalid encoding range.
+ * - The database file is corrupted.
*/
virtual result GetStringAt(int columnIndex, Tizen::Base::String& value) const = 0;
/**
- * Gets a byte array value from the column whose index is specified.
+ * Gets the byte array value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] value The user-provided buffer used to receive the blob data as a stream of type ByteBuffer @n
- * The buffer will be filled from the current position and data copy will be continued
- * until buffer limitation is reached or no more blob data remains. @n
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] value The buffer used to receive the blob data as a stream of type ByteBuffer @n
+ * The buffer will be filled from the current position and the data copying will be continued
+ * until the buffer limitation is reached or no more blob data remains. @n
* The maximum size available is limited to 100 MByte.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
* @exception E_OUT_OF_RANGE The byte buffer operation has failed.
* @exception E_OVERFLOW The specified @c value of the byte buffer is insufficient to save the data.
*/
virtual result GetBlobAt(int columnIndex, Tizen::Base::ByteBuffer& value) const = 0;
/**
- * Gets a blob data from the column whose index is specified.
+ * Gets the blob data from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
- * @param[in,out] buffer The user-provided buffer used to receive the blob data @n
+ * @param[in] columnIndex The index of the column to get the value
+ * @param[in,out] buffer The buffer used to receive the blob data @n
* The maximum size available is limited to 100 MByte.
* @param[out] size The maximum buffer length in bytes
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_INVALID_ARG The specified @c columnIndex is out of range, or the specified @c size is invalid.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
* @exception E_OVERFLOW The specified @c buffer is insufficient to save the data.
*/
virtual result GetBlobAt(int columnIndex, void* buffer, int size) const = 0;
/**
- * Gets a @c DateTime value from the column whose index is specified.
+ * Gets the @c DateTime value from the column with the specified index.
*
* @since 2.0
*
* @return An error code
- * @param[in] columnIndex The index of the column whose value is required
+ * @param[in] columnIndex The index of the column to get the value
* @param[in,out] value The value obtained from the column as a DateTime instance
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_TYPE_MISMATCH The operation has attempted to access columns of different types.
- * @exception E_INVALID_FORMAT The date is not correctly formatted, or the method is trying to access column of type String. @n
- * The date format should be 'mm/dd/yyyy hh:mm:ss'.
- * @exception E_OUT_OF_RANGE Either the year, month, day, hour, minute, or second value is out of range,
- * or the method is trying to access a column of type String.
+ * @exception E_TYPE_MISMATCH The column type accessed by the method do not match.
+ * @exception E_INVALID_FORMAT The date is not correctly formatted. The date format should be 'mm/dd/yyyy hh:mm:ss'.
+ * @exception E_OUT_OF_RANGE Either the year, month, day, hour, minute, or second value is out of range, or the method is trying to access a column having an invalid value.
*/
virtual result GetDateTimeAt(int columnIndex, Tizen::Base::DateTime& value) const = 0;
*
* @since 2.0
*
- * @return The number of columns in the calling enumerator, @n
+ * @return The number of columns in the current enumerator, @n
* else @c -1 if an exception occurs
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
- * @remarks This method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * (the query did not yield any result).
+ * @remarks
+ * - The method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual int GetColumnCount(void) const = 0;
/**
- * Gets the type of the column indicated by the specified index.
+ * Gets the type of the column specified by the index.
*
* @since 2.0
*
- * @return The type of column, @n
- * else DB_COLUMNTYPE_UNDEFINED if an exception occurs
- * @param[in] columnIndex The index of the destination column
+ * @return The column type, @n
+ * else @c DB_COLUMNTYPE_UNDEFINED if an exception occurs
+ * @param[in] columnIndex The column index
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @remarks This method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * Currently, DB_COLUMNTYPE_INT is returned for a 64-bit integer. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - This method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - Currently, @c DB_COLUMNTYPE_INT is returned for a 64-bit integer.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual DbColumnType GetColumnType(int columnIndex) const = 0;
/**
- * Gets the name of the column indicated by the specified index.
+ * Gets the name of the column specified by the index.
*
* @since 2.0
*
* @return The name of the column, @n
* else an empty string if an exception occurs
- * @param[in] columnIndex The index of the destination column
+ * @param[in] columnIndex The column index
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @exception E_INVALID_ENCODING_RANGE The string conversion has failed due to invalid encoding range, or
- * it is possible if the database file is corrupted.
- * @remarks This method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_INVALID_ENCODING_RANGE Either of the following conditions has occurred:
+ * - The string conversion has failed due to invalid encoding range.
+ * - The database file is corrupted.
+ * @remarks
+ * - This method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::String GetColumnName(int columnIndex) const = 0;
/**
- * Gets the size of data in bytes.
+ * Gets the size of data in bytes of the column specified by the index.
*
* @since 2.0
*
* @return The size of the data in bytes, @n
* else @c -1 if an exception occurs
- * @param[in] columnIndex The index of the destination column
+ * @param[in] columnIndex The column index
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE Either of the following conditions has occurred: @n
- * - This instance has not been properly constructed. @n
+ * @exception E_INVALID_STATE Either of the following conditions has occurred:
+ * - This instance has not been properly constructed.
* - The method has tried to fetch the column data of a result set that is not activated
- * (the query did not yield any result). @n
+ * (the query did not yield any result).
* @exception E_INVALID_ARG The specified @c columnIndex is out of range.
- * @remarks This method must be called after MoveNext(), MoveFirst(), or MoveLast(). @n
- * If the destination column is of type %String, this method returns the @c byte length excluding the @c null terminator character. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - This method must be called after MoveNext(), MoveFirst(), or MoveLast().
+ * - If the destination column is of type String, this method returns the @c byte length excluding the @c null terminator character.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
virtual int GetColumnSize(int columnIndex) const = 0;
/**
* @interface IFileEventListener
-* @brief This listener interface is used for receiving file event.
+* @brief This listener interface is used for receiving file events.
*
* @since 2.0
*
-* The %IFileEventListener interface is used for receiving file event.
+* The %IFileEventListener interface is used for receiving file events.
*/
class _OSP_EXPORT_ IFileEventListener
: virtual public Tizen::Base::Runtime::IEventListener
*
* @return An error code
* @param[in] events The file event type @n
- * Multiple event type can be combined using bitwise OR (see Tizen::Io::FileEventType). @n
- * Tizen::Io::FILE_EVENT_TYPE_ALL is provided for all file event type.
+ * Multiple event type can be combined using bitwise OR (see Tizen::Io::FileEventType). @n
+ * ::FILE_EVENT_TYPE_ALL is provided for all file event type.
* @param[in] path The path to the directory or file where the event has occurred
* @param[in] eventId The event ID associating related events for single operation such as File::Move(), Directory::Rename()
*/
{
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
/**
* Called when a message is received from a remote application. @n
- * This method will be called only if the remote application uses bidirectional communication method - RemoteMessagePort::SendMessage(const LocalMessagePort* pLocalMessagePort, const Tizen::Base::Collection::IMap* pMessagee).
+ * This method will be called only if the remote application uses bidirectional communication method -
+ * RemoteMessagePort::SendMessage(const LocalMessagePort* pLocalMessagePort, const Tizen::Base::Collection::IMap* pMessagee).
* The RemoteMessagePort instance can be used to send a response message to the message port of the remote application.
*
- * @since 2.0
+ * @since 2.0
*
* @param[in] pRemoteMessagePort The message port of a remote application which has sent this message
* @param[in] pMessage A pointer to an argument map of key (String) and value (String or ByteBuffer) pair
/**
* Called when a message is received from a remote application. @n
- * This method will be called only if the remote application uses unidirectional communication method - RemoteMessagePort::SendMessage(const Tizen::Base::Collection::IMap* pMessage).
+ * This method will be called only if the remote application uses unidirectional communication method -
+ * RemoteMessagePort::SendMessage(const Tizen::Base::Collection::IMap* pMessage).
*
* @since 2.0
*
{
/**
-* @interface IMmcStorageFormatListener
-* @brief This interface is the listener to receive the result of external MMC format operations.
-* @since 2.0
+* @interface IMmcStorageFormatListener
+* @brief This interface is the listener to receive the result of external MMC format operations.
+* @since 2.0
*
* The %IMmcStorageFormatListener interface must be registered and implemented by an application to receive the result of
* external MMC format operations.
{
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface called.
*
* @since 2.0
*/
virtual ~IMmcStorageFormatListener(void) {}
/**
- * Called when external MMC format operation is done.
+ * Called when an external MMC format operation is completed.
*
* @since 2.0
*
- * @param[in] r The result of external MMC format operation
+ * @param[in] r The result of an external MMC format operation
* @exception E_SUCCESS The format operation is successful.
* @exception E_IO An unexpected device failure has occurred as the media ejected suddenly.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
{
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface called.
*
* @since 2.0
*/
virtual ~IMmcStorageMountListener(void) {}
/**
- * Called when external MMC mount operation is done.
+ * Called when the external MMC mount operation is completed.
*
* @since 2.0
*
* @param[in] r The result of external MMC mount operation
* @exception E_SUCCESS The mount operation is successful.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - The file system to be mounted has an invalid superblock.
- * - An unexpected device failure has occurred as the media ejected suddenly.
+ * @exception E_IO Either of the following conditions has occurred:
+ * - The file system to be mounted has an invalid superblock.
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
virtual void OnMmcStorageMounted(result r) = 0;
/**
- * Called when external MMC unmount operation is done.
+ * Called when external MMC unmount operation is completed.
*
* @since 2.0
*
* @since 2.0
*
* @param[in] byteBuffer A byte buffer that contains the received data
- * @remarks The ByteBuffer instance needs to be deleted by the application.
+ * @remarks The ByteBuffer instance needs to be deleted by the application.
*/
virtual void OnSerialPortDataReceivedN(Tizen::Base::ByteBuffer& byteBuffer) = 0;
*
* @since 2.0
*
- * @param[in] r The error code
+ * @param[in] r The error code
* @exception E_INVALID_DATA The data is invalid.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
*/
virtual void OnSerialPortErrorOccured(result r) = 0;
* @since 2.0
*
* @return An error code
- * @param[in] listener The message port listener
- * @exception E_SUCCESS The method is successful.
+ * @param[in] listener The message port listener
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_ALREADY_EXIST The listener instance already exists.
*/
result AddMessagePortListener(IMessagePortListener& listener);
* @since 2.0
*
* @return An error code
- * @param[in] listener The message port listener
+ * @param[in] listener The message port listener
* @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The listener instance is not found.
*/
result RemoveMessagePortListener(IMessagePortListener& listener);
/**
- * Gets the name of a local message port.
+ * Gets the name of the local message port.
*
* @since 2.0
*
- * @return The name of a local message port
+ * @return The name of the local message port
*/
Tizen::Base::String GetName(void) const;
/**
- * Checks whether an instance is a trusted message port or not.
+ * Checks whether the instance is a trusted message port or not.
*
* @since 2.0
*
*/
enum MemoryMappedFileFlag
{
- MEMORY_MAPPED_FILE_FLAG_SHARED = 0x01, /**< Changes are shared with other processes mapping the same file */
- MEMORY_MAPPED_FILE_FLAG_PRIVATE = 0x02, /**< Changes are not visible to other processes mapping the same file */
- MEMORY_MAPPED_FILE_FLAG_FIXED = 0x10 /**< This forces the system to use the specified mapping address exactly,
+ MEMORY_MAPPED_FILE_FLAG_SHARED = 0x01, /**< The changes are shared with other processes mapping the same file */
+ MEMORY_MAPPED_FILE_FLAG_PRIVATE = 0x02, /**< The changes are not visible to other processes mapping the same file */
+ MEMORY_MAPPED_FILE_FLAG_FIXED = 0x10 /**< The system is forced to use the specified mapping address exactly,
which should be a multiple of the page size */
};
/**
* @class MemoryMappedFile
- * @brief This class provides features mapping a file to virtual address space.
+ * @brief This class provides methods for mapping a file to virtual address space.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %MemoryMappedFile class provides features for using a memory mapped file,
+ * The %MemoryMappedFile class provides methods for using a memory mapped file,
* which maps the data of a file to an application's virtual address space.
*
* @code
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. @n
+ * For full construction, the Construct() method must be called right after calling this constructor.
*
* @since 2.0
*/
~MemoryMappedFile(void);
/**
- * Initializes this instance of %MemoryMappedFile with a specified file.
+ * Initializes this instance of %MemoryMappedFile with the specified file.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c file is not opened for reading. @n
* The opening mode should not be "w" or "a".
- * @remarks The specified @c file should be initialized by the Io::File::Construct() method.
+ * @remarks The specified @c file should be initialized by the Tizen::Io::File::Construct() method.
* @see Tizen::Io::File
*/
result Construct(const File& file);
* @since 2.0
*
* @return The mapped address space, @n
- * else @c null pointer if this method fails
- * @param[in] address A starting address of the mapping @n
+ * else @c null pointer if it fails
+ * @param[in] address The starting address of the mapping @n
* If the specified @c address is @c null, the system chooses the address.
* It should be a multiple of the page size.
* @param[in] length The length of the mapping space
* @param[in] offset The start offset of the specified file @n
* It should be a multiple of the page size.
* @exception E_SUCCESS The method is successful.
- * @exception E_ILLEGAL_ACCESS The specified @c flag is MEMORY_MAPPED_FILE_FLAG_SHARED and the specified @c
- * protection is MEMORY_PROTECTION_MODE_WRITE, but the specified file of
+ * @exception E_ILLEGAL_ACCESS The specified @c flag is ::MEMORY_MAPPED_FILE_FLAG_SHARED and the specified @c
+ * protection is Base::Runtime::MEMORY_PROTECTION_MODE_WRITE, but the specified file of
* MemoryMappedFile::Construct() is not opened with read-write mode.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c address or @c offset is not aligned on a page boundary. @n
- * - The specified @c length is not positive. @n
- * - The specified @c protection, @c flag, or @c offset @ is invalid. @n
- * - The specified @c flag cannot contain both MEMORY_MAPPED_FILE_FLAG_PRIVATE and
- * MEMORY_MAPPED_FILE_FLAG_SHARED.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c address or @c offset is not aligned on a page boundary.
+ * - The specified @c length is not positive.
+ * - The specified @c protection, @c flag, or @c offset is invalid.
+ * - The specified @c flag cannot contain both ::MEMORY_MAPPED_FILE_FLAG_PRIVATE and
+ * ::MEMORY_MAPPED_FILE_FLAG_SHARED.
* @exception E_MAX_EXCEEDED The number of mapped regions has exceeded the maximum limit.
* @exception E_OBJECT_LOCKED The mapped file has been locked.
- * @exception E_OUT_OF_MEMORY Either of the following conditions has occurred: @n
- * - The memory is insufficient. @n
- * - The specified @c flag is MEMORY_MAPPED_FILE_FLAG_FIXED, and the specified address
- * range exceeds that allowed for the address space of a current process.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - The underlying file system does not support memory mapping. @n
- * - The specified @c protection is MEMORY_PROTECTION_MODE_EXEC, but the mapped file
- * exists on a file system that has been mounted no-exec.
- * @remarks The specific error code can be accessed using the GetLastResult() method. @n
- * When this instance is destructed, all mappings are deleted automatically.
+ * @exception E_OUT_OF_MEMORY Either of the following conditions has occurred:
+ * - The memory is insufficient.
+ * - The specified @c flag is ::MEMORY_MAPPED_FILE_FLAG_FIXED, and the specified @c address
+ * range exceeds that allowed for the address space of a current process.
+ * @exception E_IO Either of the following conditions has occurred:
+ * - The underlying file system does not support memory mapping.
+ * - The specified @c protection is Base::Runtime::MEMORY_PROTECTION_MODE_EXEC, but the mapped file
+ * exists on a file system that has been mounted no-exec.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - When this instance is destructed, all mappings are deleted automatically.
* @see Tizen::Base::Runtime::MemoryManager
*/
void* Map(void* address, long long length, unsigned long protection, unsigned long flag, long long offset);
/**
* Deletes the mapping of the specified address space. @n
* Further references to the addresses within the range result in generation of an invalid memory access. @n
- * This method flushes all changes of a shared mapping to the correlated file on the permanent storage.
+ * This method flushes all the changes of a shared mapping to the correlated file on the permanent storage.
*
* @since 2.0
*
* @param[in] address The memory mapping address to unmap
* @param[in] length The length of the mapping space
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c address is not aligned on a page boundary. @n
- * - The specified @c length is not positive. @n
- * - The specified address range is out of the valid address space of a current process.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c address is not aligned on a page boundary.
+ * - The specified @c length is not positive.
+ * - The specified address range is out of the valid address space of the current process.
* @remarks When this instance is destructed, all mappings of the instance are not unmapped automatically.
*/
result Unmap(void* address, long long length);
/**
- * Flushes all changes of an address range to the correlated file on the permanent storage.
+ * Flushes all the changes of an address range to the correlated file on the permanent storage.
*
* @since 2.0
*
* @param[in] length The length of the mapping space
* @param[in] syncFlag The synchronization option
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c address is not aligned on a page boundary. @n
- * - The specified @c length is not positive. @n
- * - The specified @c syncFlag is invalid. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c address is not aligned on a page boundary.
+ * - The specified @c length is not positive.
+ * - The specified @c syncFlag is invalid.
* - The specified @c address space is not mapped.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @remarks The specific page size of a current file system is provided by Tizen::System::SystemInfo class with
* "StorageInfo" key.
public:
/**
* Requests for a LocalMessagePort instance with the specified message port name. @n
- * This method returns the same %LocalMessagePort instance if it has already been called with the same message port name. @n
+ * This method returns the same %LocalMessagePort instance if it has already been called with the same message port name.
*
* @since 2.0
*
* @return A pointer to the LocalMessagePort instance, @n
* else @c null if it fails
- * @param[in] localMessagePortName The name of a local message port
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The @c localMessagePortName is empty.
- * @exception E_SYSTEM The method has failed due to a severe system error.
- * @remarks It is not recommended to use the message port names that start with "http://tizen.org/messageport". @c E_INVALID_ARG may be returned because they are reserved by platform.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @param[in] localMessagePortName The name of a local message port
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The @c localMessagePortName is empty.
+ * @exception E_SYSTEM The method has failed due to a severe system error.
+ * @remarks
+ * - It is not recommended to use the message port names that start with "http://tizen.org/messageport".
+ * @c E_INVALID_ARG may be returned because they are reserved by platform.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
static LocalMessagePort* RequestLocalMessagePort(const Tizen::Base::String& localMessagePortName);
/**
- * Requests the RemoteMessagePort instance with the specified remote application ID and message port name. @n
- * This method returns the same %RemoteMessagePort instance if it has already been called with the same remote application ID and message port name.
+ * Requests for a RemoteMessagePort instance with the specified remote application ID and message port name. @n
+ * This method returns the same %RemoteMessagePort instance if it has already been called with the same remote application ID
+ * and message port name.
*
* @since 2.0
*
* else @c null if it fails
* @param[in] remoteAppId The remote application ID
* @param[in] remoteMessagePortName The remote message port name
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The remote application ID or the remote message port name is empty.
- * @exception E_OBJ_NOT_FOUND The message port of the target application is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The remote application ID or the remote message port name is empty.
+ * @exception E_OBJ_NOT_FOUND The message port of the target application is not found.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static RemoteMessagePort* RequestRemoteMessagePort(const Tizen::App::AppId& remoteAppId, const Tizen::Base::String& remoteMessagePortName);
/**
* Requests for a trusted LocalMessagePort instance with the specified message port name. @n
* This method returns the same %LocalMessagePort instance if it has already been called with the same message port name. @n
- * Communications over a trusted message port is allowed only if both the applications are signed with a certificate that is uniquely assigned to the developer.
+ * Communications over a trusted message port is allowed only if both the applications are signed with a certificate that is
+ * uniquely assigned to the developer.
*
* @since 2.0
*
* @return A pointer to the trusted LocalMessagePort instance, @n
* else @c null if it fails
- * @param[in] localMessagePortName The name of a local message port
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The @c localMessagePortName is empty.
- * @exception E_SYSTEM The method has failed due to a severe system error.
- * @remarks It is not recommended to use the message port names that start with "http://tizen.org/messageport". @c E_INVALID_ARG may be returned because they are reserved by platform.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @param[in] localMessagePortName The name of a local message port
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The @c localMessagePortName is empty.
+ * @exception E_SYSTEM The method has failed due to a severe system error.
+ * @remarks
+ * - It is not recommended to use the message port names that start with "http://tizen.org/messageport".
+ * @c E_INVALID_ARG may be returned because they are reserved by platform.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
static LocalMessagePort* RequestTrustedLocalMessagePort(const Tizen::Base::String& localMessagePortName);
/**
- * Requests the trusted RemoteMessagePort instance with the specified message port name. @n
- * This method returns the same %RemoteMessagePort instance if it has already been called with the same remote application ID and message port name. @n
- * This message port allows communications only if the applications are signed with the same certificate which is uniquely assigned to the developer.
+ * Requests for a trusted RemoteMessagePort instance with the specified message port name. @n
+ * This method returns the same %RemoteMessagePort instance if it has already been called with the same remote application ID
+ * and message port name. @n
+ * This message port allows communications only if the applications are signed with the same certificate which is uniquely
+ * assigned to the developer.
*
* @since 2.0
*
* @return A pointer to the trusted RemoteMessagePort instance, @n
* else @c null if it fails
- * @param[in] remoteAppId The remote application ID
- * @param[in] remoteMessagePortName The name of a remote message port
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either @c remoteAppId or @c remoteMessagePortName is empty.
- * @exception E_OBJ_NOT_FOUND The message port of the target application is not found.
- * @exception E_CERTIFICATE_VERIFICATION_FAILED The target application is not signed with the same certificate.
- * @exception E_SYSTEM The method has failed due to a severe system error.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @param[in] remoteAppId The remote application ID
+ * @param[in] remoteMessagePortName The name of a remote message port
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either @c remoteAppId or @c remoteMessagePortName is empty.
+ * @exception E_OBJ_NOT_FOUND The message port of the target application is not found.
+ * @exception E_CERTIFICATE_VERIFICATION_FAILED The target application is not signed with the same certificate.
+ * @exception E_SYSTEM The method has failed due to a severe system error.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static RemoteMessagePort* RequestTrustedRemoteMessagePort(const Tizen::App::AppId& remoteAppId, const Tizen::Base::String& remoteMessagePortName);
public:
/**
- * Gets the MMC storage manager instance.
+ * Gets the pointer to the %MmcStorageManager instance.
*
* @since 2.0
*
- * @return A pointer to %MmcStorageManager instance if this method is successful, @n
+ * @return The pointer to %MmcStorageManager instance if this method is successful, @n
* else @c null
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
static MmcStorageManager* GetInstance(void);
/**
- * Mounts file system of external MMC.
+ * Mounts the file system of the external MMC.
*
* @since 2.0
* @privlevel platform
* (%http://tizen.org/privilege/systemsetting.read is deprecated.)
*
* @return An error code
- * @exception E_SUCCESS Mount operation is successfully started.
+ * @exception E_SUCCESS The mount operation is successfully started.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_OPERATION The external MMC has already been mounted.
* @exception E_SERVICE_BUSY One of mount, unmount and format operations is ongoing.
result Mount(void);
/**
- * Unmounts file system of external MMC.
+ * Unmounts the file system of the external MMC.
*
* @since 2.0
* @privlevel platform
* (%http://tizen.org/privilege/systemsetting.read is deprecated.)
*
* @return An error code
- * @exception E_SUCCESS Unmount operation is successfully started.
+ * @exception E_SUCCESS The unmount operation is successfully started.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_OPERATION The external MMC has already been unmounted.
* @exception E_SERVICE_BUSY One of mount, unmount and format operations is ongoing.
result Unmount(void);
/**
- * Formats file system of external MMC.
+ * Formats the file system of the external MMC.
*
* @since 2.0
* @privlevel platform
* (%http://tizen.org/privilege/systemsetting.read is deprecated.)
*
* @return An error code
- * @exception E_SUCCESS Format operation is successfully started.
+ * @exception E_SUCCESS The format operation is successfully started.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_OPERATION The external MMC should be unmounted for format operation.
* @exception E_SERVICE_BUSY One of mount, unmount and format operations is ongoing.
/**
* @class Registry
- * @brief This class provides a mechanism to access and manipulate registry files.
+ * @brief This class provides methods to access and manipulate registry files.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %Registry class provides a mechanism to access and manipulate registry files.
+ * The %Registry class provides methods to access and manipulate registry files.
*
* For more information on the class features,
* see <a href="../org.tizen.native.appprogramming/html/guide/io/io_namespace.htm">Io Guide</a>.
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. @n
+ * For full construction, the Construct() method must be called right after calling this constructor.
*
* @since 2.0
*/
* @param[in] createIfNotExist Set to @c true to create a registry file, @n
* else @c false to open an existing registry file
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified string of a file path is less
- * than or equal to @c 0. @n
- * - The translated overall length of the specified path exceeds the
- * system limitation. @n
- * - The specified path is invalid. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified file path string is less
+ * than or equal to @c 0.
+ * - The overall length of the specified file path exceeds the
+ * system limitation.
+ * - The specified file path is invalid.
* @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
* @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
- * @exception E_END_OF_FILE The file pointer has reached end-of-file.
+ * @exception E_END_OF_FILE The file pointer has reached the end of file.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_INVALID_FORMAT The input registry file contains '0x00' in the middle of the file.
* @exception E_PARSING_FAILED The method has failed to parse the registry file.
* @remarks To load the registry in read-only mode, use the Registry::Construct(const Tizen::Base::String& regPath,
- * long openMode, long option) method with REG_OPEN_READ_ONLY as a value for the open mode flag.
+ * long openMode, long option) method with ::REG_OPEN_READ_ONLY as value for the open mode flag.
* @endcond
*/
result Construct(const Tizen::Base::String& regPath, bool createIfNotExist);
*
* @return An error code
* @param[in] regPath The path of the registry file to open or create
- * @param[in] openMode An open mode flag @n
+ * @param[in] openMode The flag specifying the file opening mode @n
* Currently, the following flags can be used in combination with
* the logical OR operator: @n
* (1) REG_OPEN_READ_ONLY @n
* (2) REG_OPEN_READ_WRITE @n
* (3) REG_OPEN_READ_WRITE | REG_OPEN_CREATE
- * @param[in] option This argument is reserved for further use @n It is recommended to use @c 0.
+ * @param[in] option This argument is reserved for future use. @n It is recommended to use @c 0.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified string of a file path is less
- * than or equal to @c 0. @n
- * - The translated overall length of the specified path exceeds the
- * system limitation. @n
- * - The specified path is invalid. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified file path string is less
+ * than or equal to @c 0.
+ * - The overall length of the specified file path exceeds the
+ * system limitation.
+ * - The specified file path is invalid.
* @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
- * @exception E_END_OF_FILE The file pointer has reached end-of-file.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
+ * @exception E_END_OF_FILE The file pointer has reached the end of file.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_INVALID_FORMAT The input registry file contains '0x00' in the middle of the file.
* @exception E_PARSING_FAILED The method has failed to parse the registry file.
/**
* Initializes this instance of %Registry with the specified parameters. @n
- * This method opens an existing registry file or creates a new one according to the specified file opening mode.
- * And this method loads data of the registry file to system memory and flushes the data to the storage when this instance
+ * This method opens an existing registry file or creates a new one according to the specified file opening mode,
+ * loads the data of the registry file to system memory, and flushes the data to the storage when this instance
* is released or Registry::Flush() is called.
*
* @since 2.0
* - a : Open for writing. The registry file is created if it does not exist.
* - a+: Open for writing and reading. The registry file is created if it does not exist.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The overall length of the specified @c regPath is equal to @c 0 or
- * exceeds system limitations. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified file path string is less than or equal to @c 0.
+ * - The overall length of the specified file path exceeds the system limitation.
* - The combination of the specified @c pOpenMode is not allowed. @n
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_NOT_FOUND The specified @c regPath cannot be found.
- * @exception E_INVALID_FORMAT Either of the following conditions has occurred: @n
+ * @exception E_INVALID_FORMAT Either of the following conditions has occurred:
* - The section or entry name of the registry file includes one of the following characters:
- * '\0', '\n', '#' and '='.
+ * '\0', '\\n', '#' and '='.
* - The entry value of the registry file includes one of the following characters:
- * '\0' and '\n'.
+ * '\0' and '\\n'.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
/**
* Initializes this instance of %Registry with the specified parameters. @n
- * This method opens an existing secure registry file or creates a new one according to the specified file opening mode.
- * And this method loads data of the secure registry file to system memory and flushes the data to the storage when this instance
+ * This method opens an existing secure registry file or creates a new one according to the specified file opening mode,
+ * loads the data of the secure registry file to system memory and flushes the data to the storage when this instance
* is released or Registry::Flush() is called.
* The contents written to the secure registry file is automatically encrypted and the contents read from the secure registry
* file is automatically decrypted by the platform. @n
- * Applications using this method can access the same secure registry files that are created by other applications with the
- * identical key value in same device. However, the secure registry files created by this method cannot be accessed in other devices.
+ * Applications that use this method can access the secure registry files that are created by other applications with
+ * an identical key value in the same device. However, the secure registry files created by this method cannot be accessed in other devices.
*
* @since 2.0
*
* otherwise it is truncated to zero length.
* - a : Open for writing. The registry file is created if it does not exist.
* - a+: Open for writing and reading. The registry file is created if it does not exist.
- * @param[in] secretKey A key used to encrypt data of a registry file or decrypt a secure registry file @n
- * If a secure registry file is created with a specific key value,
- * other applications can access the same secure registry file with the identical key value.
+ * @param[in] secretKey The key to encrypt the data of the registry file or to decrypt the secure registry file @n
+ * If the secure registry file is created with a specific key value,
+ * other applications can access the secure registry file with an identical key value.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The overall length of the specified path is equal to @c 0 or
* exceeds system limitations.
- * - The combination of the specified @c pOpenMode is not allowed. @n
+ * - The combination of the specified @c pOpenMode is not allowed.
* - The specified @c secretKey is incorrect or the secure registry file is corrupted.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_NOT_FOUND The specified @c regPath cannot be found.
- * @exception E_INVALID_FORMAT Either of the following conditions has occurred: @n
+ * @exception E_INVALID_FORMAT Either of the following conditions has occurred:
* - The section or entry name of the registry file includes one of the following characters:
- * '\0', '\n', '#' and '='.
+ * '\0', '\\n', '#' and '='.
* - The entry value of the registry file includes one of the following characters:
- * '\0' and '\n'.
+ * '\0' and '\\n'.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
- * - %File corruption is detected. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
+ * - %File corruption is detected.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
result Construct(const Tizen::Base::String& regPath, const char* pOpenMode, const Tizen::Base::ByteBuffer& secretKey);
/**
- * Flushes the current contents of a registry in memory. @n
- * If the secure mode is set to be @c true, the contents of the registry are automatically encrypted
+ * Flushes the current contents of the registry in memory. @n
+ * If the secure mode is set, the contents of the registry are automatically encrypted
* and saved by the platform.
*
* @since 2.0
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_MAX_EXCEEDED The number of opened files has exceeded the maximum limit.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
- * - %File corruption is detected. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
+ * - %File corruption is detected.
*/
result Flush(void);
/**
- * Creates the specified section then adds it into the registry.
+ * Creates the specified section and adds it to the registry.
*
* @since 2.0
*
* @return An error code
* @param[in] sectionName The section name
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The length of the specified string for a section name is less than
- * or equal to @c 0.
- * @exception E_SECTION_ALREADY_EXIST A section with the specified name already exists.
+ * @exception E_INVALID_ARG The length of the specified string for a section name is less than or equal to @c 0.
+ * @exception E_SECTION_ALREADY_EXIST The section with the specified name already exists.
*/
result AddSection(const Tizen::Base::String& sectionName);
/**
- * Removes the section from %Registry.
+ * Removes the section from the registry.
*
* @since 2.0
*
* @return An error code
- * @param[in] sectionName The section name to remove
+ * @param[in] sectionName The name of the section to remove
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The length of the specified string for a section is less than
- * or equal to @c 0.
+ * @exception E_INVALID_ARG The length of the specified string for a section is less than or equal to @c 0.
* @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
*/
result RemoveSection(const Tizen::Base::String& sectionName);
/**
- * Gets all section names in the registry.
+ * Gets all the section names in the registry.
*
* @since 2.0
*
- * @return A list of section names @n
+ * @return The list of all section names in the registry @n
* If this method fails, @c null value is returned. @n
- * The specific error code can be accessed using the GetLastResult() method. @n
- * When there are no sections at all, the method returns an empty list instance. @n
+ * When there are no sections, the method returns an empty list instance. @n
* Use the Tizen::Base::Collection::ICollection::GetCount() method to check the number of elements in the list.
* @exception E_SUCCESS The method is successful.
- * @remarks Do not forget to delete not only the returned IList instance, but also its
- * contents by invoking IList::RemoveAll(). @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - Do not forget to delete not only the returned Tizen::Base::Collection::IList instance, but also its contents by invoking IList::RemoveAll().
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::Collection::IList* GetAllSectionNamesN(void) const;
/**
- * Gets all entry names in the specified section of the registry.
+ * Gets all the entry names in the specified section of the registry.
*
* @since 2.0
*
- * @return A list of entry names @n
+ * @return The list of entry names @n
* If this method fails, @c null value is returned. @n
- * When there are no entries at all, the method returns an empty list instance. @n
+ * When there are no entries, the method returns an empty list instance. @n
* Use the Tizen::Base::Collection::ICollection::GetCount() method to check the number of element in the list.
* @param[in] sectionName The section name
* @exception E_SUCCESS The method is successful.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
* @exception E_IO A system error has occurred.
- * @remarks Do not forget to delete not only the returned IList instance, but also its
- * contents by invoking IList::RemoveAll(). @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - Do not forget to delete not only the returned Tizen::Base::Collection::IList instance, but also its contents by invoking IList::RemoveAll().
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::Collection::IList* GetAllEntryNamesN(const Tizen::Base::String& sectionName) const;
/**
- * Adds the name-value pair of type integer as an entry of the specific section.
+ * Adds the name and integer value as an entry of the specific section.
*
* @since 2.0
*
* @param[in] entryName The entry name
* @param[in] value The @c int value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
* @exception E_KEY_ALREADY_EXIST The specified @c entryName already exists in this section.
*/
result AddValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, int value);
/**
- * Adds the name-value pair of type double as an entry of the specific section.
+ * Adds the name and double value as an entry of the specific section.
*
* @since 2.0
*
* @param[in] entryName The entry name
* @param[in] value The @c double value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
* @exception E_KEY_ALREADY_EXIST The specified @c entryName already exists in this section.
- * @remarks This method converts the specified double type @c value to string value using "%lg" format specifier. @n
- * Also, it does not depend on system locale.
+ * @remarks This method converts the specified double type @c value to string value using the "%lg" format specifier. @n
+ * It does not depend on the system locale.
*/
result AddValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, double value);
/**
- * Adds the name-value pair of type float as an entry of the specific section.
+ * Adds the name and float value as an entry of the specific section.
*
* @since 2.0
*
* @param[in] entryName The entry name
* @param[in] value The @c float value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
* @exception E_KEY_ALREADY_EXIST The specified @c entryName already exists in this section.
- * @remarks This method converts the specified float type @c value to string value using "%g" format specifier. @n
- * Also, it does not depend on system locale.
+ * @remarks This method converts the specified float type @c value to string value using the "%g" format specifier. @n
+ * It does not depend on the system locale.
*/
result AddValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, float value);
/**
- * Adds the name-value pair of type String as an entry of the specific section.
+ * Adds the name and String value as an entry of the specific section.
*
* @since 2.0
*
* @param[in] entryName The entry name
* @param[in] value The String value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0.
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
* @exception E_KEY_ALREADY_EXIST The specified @c entryName already exists in this section.
*/
result AddValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, const Tizen::Base::String& value);
/**
- * Adds the name-value pair of type UuId as an entry for the specified section.
+ * Adds the name and UuId value as an entry for the specified section.
*
* @since 2.0
*
* @param[in] entryName The entry name
* @param[in] value The UuId value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
* @exception E_KEY_ALREADY_EXIST The specified @c entryName already exists in this section.
*/
result AddValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, const Tizen::Base::UuId& value);
/**
- * Adds the name-value pair of type ByteBuffer as an entry for the specified section.
+ * Adds the name and ByteBuffer value as an entry for the specified section.
*
* @since 2.0
*
* @return An error code
* @param[in] sectionName The section name
* @param[in] entryName The entry name
- * @param[in] value The @c ByteBuffer value @n
+ * @param[in] value The ByteBuffer value @n
* Note that, it should be constructed before being passed to the method.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
* @exception E_KEY_ALREADY_EXIST The specified @c entryName already exists in this section.
- * @remarks Note that all the contents of @c ByteBuffer are saved as an entry value.
- * That is, byte data from @c 0 up to the buffer limit is saved.
+ * @remarks All the contents of @c ByteBuffer are saved as an entry value. That is, byte data from @c 0 up to the buffer limit is saved.
* @see Tizen::Base::ByteBuffer
*/
result AddValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, const Tizen::Base::ByteBuffer& value);
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The name of entry where its value will be fetched
+ * @param[in] entryName The entry name to get the value
* @param[out] retVal The return value obtained from the registry
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @exception E_PARSING_FAILED The method has failed to parse the encoded entry value string, or the value is retrieved by using an incorrect data type.
- * @exception E_DATA_NOT_FOUND The name-value pair has no value assigned (if the value is retrieved using the REGTYPE_STRING type, an empty string is returned even if no value is assigned).
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @exception E_PARSING_FAILED Either of the following conditions has occurred:
+ * - The method has failed to parse the encoded entry value string.
+ * - The specified data type of the value and the data type of the retrieved value are different.
+ * @exception E_DATA_NOT_FOUND There is no value assigned for the specified entry name. @n
+ * If the value is retrieved using the REGTYPE_STRING type,
+ * an empty string is returned even if no value is assigned.
*/
result GetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, int& retVal) const;
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The name of entry where its value will be fetched
+ * @param[in] entryName The entry name to get the value
* @param[out] retVal The return value obtained from the registry
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @exception E_PARSING_FAILED The method has failed to parse the encoded entry value string, or the value is retrieved by using an incorrect data type.
- * @exception E_DATA_NOT_FOUND The name-value pair has no value assigned (if the value is retrieved using the REGTYPE_STRING type, an empty string is returned even if no value is assigned).
- * @remarks This method does not depend on system locale.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @exception E_PARSING_FAILED Either of the following conditions has occurred:
+ * - The method has failed to parse the encoded entry value string.
+ * - The specified data type of the value and the data type of the retrieved value are different.
+ * @exception E_DATA_NOT_FOUND There is no value assigned for the specified entry name. @n
+ * If the value is retrieved using the REGTYPE_STRING type,
+ * an empty string is returned even if no value is assigned.
+ * @remarks This method does not depend on the system locale.
*/
result GetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, double& retVal) const;
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The name of entry where its value will be fetched
+ * @param[in] entryName The entry name to get the value
* @param[out] retVal The return value obtained from the registry
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @exception E_PARSING_FAILED The method has failed to parse the encoded entry value string, or the value is retrieved by using an incorrect data type.
- * @exception E_DATA_NOT_FOUND The name-value pair has no value assigned (if the value is retrieved using the REGTYPE_STRING type, an empty string is returned even if no value is assigned).
- * @remarks This method does not depend on system locale.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @exception E_PARSING_FAILED Either of the following conditions has occurred:
+ * - The method has failed to parse the encoded entry value string.
+ * - The specified data type of the value and the data type of the retrieved value are different.
+ * @exception E_DATA_NOT_FOUND There is no value assigned for the specified entry name. @n
+ * If the value is retrieved using the REGTYPE_STRING type,
+ * an empty string is returned even if no value is assigned.
+ * @remarks This method does not depend on the system locale.
*/
result GetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, float& retVal) const;
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The name of entry where its value will be fetched
+ * @param[in] entryName The entry name to get the value
* @param[out] retVal The return value obtained from the registry
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @exception E_PARSING_FAILED The method has failed to parse the encoded entry value string, or the value is retrieved by using an incorrect data type.
- * @exception E_DATA_NOT_FOUND The name-value pair has no value assigned (if the value is retrieved using the REGTYPE_STRING type, an empty string is returned even if no value is assigned).
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @exception E_PARSING_FAILED Either of the following conditions has occurred:
+ * - The method has failed to parse the encoded entry value string.
+ * - The specified data type of the value and the data type of the retrieved value are different.
+ * @exception E_DATA_NOT_FOUND There is no value assigned for the specified entry name. @n
+ * If the value is retrieved using the REGTYPE_STRING type,
+ * an empty string is returned even if no value is assigned.
*/
result GetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, Tizen::Base::String& retVal) const;
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The name of entry where its value will be fetched
+ * @param[in] entryName The entry name to get the value
* @param[out] retVal The return value obtained from the registry
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @exception E_PARSING_FAILED The method has failed to parse the encoded entry value string, or the value is retrieved by using an incorrect data type.
- * @exception E_DATA_NOT_FOUND The name-value pair has no value assigned (if the value is retrieved using the REGTYPE_STRING type, an empty string is returned even if no value is assigned).
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @exception E_PARSING_FAILED Either of the following conditions has occurred:
+ * - The method has failed to parse the encoded entry value string.
+ * - The specified data type of the value and the data type of the retrieved value are different.
+ * @exception E_DATA_NOT_FOUND There is no value assigned for the specified entry name. @n
+ * If the value is retrieved using the REGTYPE_STRING type,
+ * an empty string is returned even if no value is assigned.
*/
result GetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, Tizen::Base::UuId& retVal) const;
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The name of entry where its value will be fetched
+ * @param[in] entryName The entry name to get
* @param[out] retVal The return value obtained from the registry
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @exception E_PARSING_FAILED The method has failed to parse the encoded entry value string, or the value is retrieved by using an incorrect data type.
- * @exception E_DATA_NOT_FOUND The name-value pair has no value assigned (if the value is retrieved using the REGTYPE_STRING type, an empty string is returned even if no value is assigned).
- * @remarks The ByteBuffer should be constructed before passing it to the method.
- * That is, the size of the binary data to be fetched should be decided beforehand.
- * When the %ByteBuffer capacity is less than the actual binary data stored in the registry,
- * this method reads the data as much as the %ByteBuffer capacity. The position of the %ByteBuffer and
- * limit are not changed. When the %ByteBuffer capacity is greater than the actual data size,
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @exception E_PARSING_FAILED Either of the following conditions has occurred:
+ * - The method has failed to parse the encoded entry value string.
+ * - The specified data type of the value and the data type of the retrieved value are different.
+ * @exception E_DATA_NOT_FOUND There is no value assigned for the specified entry name. @n
+ * If the value is retrieved using the REGTYPE_STRING type,
+ * an empty string is returned even if no value is assigned.
+ * @remarks Decide the size of the byte data to be fecthed and construct the Tizen::Base::ByteBuffer before passing it to the method. @n
+ * When the %Tizen::Base::ByteBuffer capacity is less than the actual binary data stored in the registry,
+ * this method reads data that fits the %Tizen::Base::ByteBuffer capacity. The position of the %Tizen::Base::ByteBuffer and
+ * limit are not changed. @n
+ * When the %Tizen::Base::ByteBuffer capacity is greater than the actual data size,
* the method reads the whole data and adjusts the limit of the buffer accordingly.
* @see Tizen::Base::ByteBuffer
*/
result GetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, Tizen::Base::ByteBuffer& retVal) const;
/**
- * Modifies the value of the specified entry using the specified @c int value.
+ * Sets the @c int value for the specified entry.
*
* @since 2.0
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The entry name to modify
+ * @param[in] entryName The entry name to set the value
* @param[in] newValue The @c int value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @remarks This method will not add a name-value pair as an entry of a specific section
- * if no entry with the specified name exists.
- * In such a case, it returns E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @remarks This method will not set the specified value as an entry of the specific section
+ * if no entry with the specified name exists. @n
+ * In such a case, it returns @c E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
* @see AddValue()
*/
result SetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, int newValue);
/**
- * Modifies the value of the specified entry using the specified @c double value.
+ * Sets the @c double value for the specified entry.
*
* @since 2.0
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The entry name to modify
+ * @param[in] entryName The entry name to set the value
* @param[in] newValue The @c double value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @remarks This method will not add a name-value pair as an entry of a specific section
- * if no entry with the specified name exists.
- * In such a case, it returns E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
- * @remarks This method converts the specified double type @c newValue to string value using "%lg" format specifier. @n
- * Also, it does not depend on system locale.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @remarks
+ * - This method will not set the specified value as an entry of the specific section
+ * if no entry with the specified name exists. @n
+ * In such a case, it returns @c E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
+ * - This method converts the specified double type @c newValue to string value using the "%lg" format specifier. @n
+ * It does not depend on the system locale.
* @see AddValue()
*/
result SetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, double newValue);
/**
- * Modifies the value of the specified entry using the specified @c float value.
+ * Sets the @c float value for the specified entry.
*
* @since 2.0
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The entry name to modify
+ * @param[in] entryName The entry name to set the value
* @param[in] newValue The @c float value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @remarks This method will not add a name-value pair as an entry of a specific section
- * if no entry with the specified name exists.
- * In such a case, it returns E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
- * @remarks This method converts the specified float type @c newValue to string value using "%g" format specifier. @n
- * Also, it does not depend on system locale.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @remarks
+ * - This method will not set the specified value as an entry of the specific section
+ * if no entry with the specified name exists. @n
+ * In such a case, it returns @c E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
+ * - This method converts the specified float type @c newValue to string value using the "%g" format specifier. @n
+ * It does not depend on the system locale.
* @see AddValue()
*/
result SetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, float newValue);
/**
- * Modifies the value of the specified entry using the specified String value.
+ * Sets the String value for the specified entry.
*
* @since 2.0
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The entry name to modify
+ * @param[in] entryName The entry name to set the value
* @param[in] newValue The String value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0.
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @remarks This method will not add a name-value pair as an entry of a specific section
- * if no entry with the specified name exists.
- * In such a case, it returns E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @remarks This method will not set the specified value as an entry of the specific section
+ * if no entry with the specified name exists. @n
+ * In such a case, it returns @c E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
* @see AddValue()
*/
result SetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, const Tizen::Base::String& newValue);
/**
- * Modifies the value of the specified entry using the specified UuID value.
+ * Sets the UuId value for the specified entry.
*
* @since 2.0
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The entry name to modify
+ * @param[in] entryName The entry name to set the value
* @param[in] newValue The UuId value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @remarks This method will not add a name-value pair as an entry of a specific section if no
- * entry with the specified name exists.
- * In such a case, it returns E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @remarks This method will not set the specified value as an entry of the specific section
+ * if no entry with the specified name exists. @n
+ * In such a case, it returns E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
* @see AddValue()
*/
result SetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, const Tizen::Base::UuId& newValue);
/**
- * Modifies the value of the specified entry using the specified ByteBuffer value.
+ * Sets the ByteBuffer value for the specified entry.
*
* @since 2.0
*
* @return An error code
* @param[in] sectionName The section name
- * @param[in] entryName The entry name to modify
+ * @param[in] entryName The entry name to set the value
* @param[in] newValue The @c ByteBuffer value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either the length of the specified string for a section
- * or an entry is less than or equal to @c 0,
- * or a @c null value is passed. @n
- * Note that, it is also possible that the data inside a registry instance is
- * corrupted due to its usage in a multi-threaded environment without
- * synchronization.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
- * @remarks This method will not add a name-value pair as an entry of a specific section
- * if no entry with the specified name exists.
- * In such a case, it returns E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
+ * @exception E_INVALID_ARG The length of the specified section name or entry name is less than or equal to @c 0.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
+ * @remarks This method will not set the specified value as an entry of the specific section
+ * if no entry with the specified name exists. @n
+ * In such a case, it returns E_KEY_NOT_FOUND. Use AddValue() to insert a new entry.
* @see AddValue()
*/
result SetValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName, const Tizen::Base::ByteBuffer& newValue);
/**
- * Removes the name-value pair entry from specific section.
+ * Removes the name-value pair entry from specified section.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The length of the specified string for a section or entry is less
* than or equal to @c 0.
- * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found within the registry.
- * @exception E_KEY_NOT_FOUND The specified @c entryName is not found within the registry.
+ * @exception E_SECTION_NOT_FOUND The specified @c sectionName is not found in the registry.
+ * @exception E_KEY_NOT_FOUND The specified @c entryName is not found in the registry.
*/
result RemoveValue(const Tizen::Base::String& sectionName, const Tizen::Base::String& entryName);
*
* @since 2.1
*
- * @return The pointer to %FileLock instance, @n
- * else @c null pointer in case of failure
- * @param[in] lockType The type of file lock to be created
+ * @return The pointer to the FileLock instance, @n
+ * else @c null pointer in case of failure
+ * @param[in] lockType The file lock type to be created
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c lockType is invalid.
- * @exception E_INVALID_OPERATION Either of the following conditions has occurred: @n
- * - The specified @c lockType cannot be FILE_LOCK_SHARED if the current
- * file is not open for reading. @n
- * - The specified @c lockType cannot be FILE_LOCK_EXCLUSIVE if the current
- * file is not open for writing. @n
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The specified @c lockType cannot be @c FILE_LOCK_SHARED if the current
+ * file is not open for reading.
+ * - The specified @c lockType cannot be @c FILE_LOCK_EXCLUSIVE if the current
+ * file is not open for writing.
* @exception E_WOULD_DEADLOCK The method would cause a deadlock. @n
- * The lock is blocked by a lock from another process, and putting the
- * calling process to sleep to wait for that lock to become free would
- * cause a deadlock.
- * @exception E_MAX_EXCEEDED The number of file lock exceeds system limitations.
+ * The lock is blocked by a lock from another process, and putting the
+ * calling process to sleep to wait for that lock to become free would
+ * cause a deadlock.
+ * @exception E_MAX_EXCEEDED The number of file locks has exceeded system limitations.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The %FileLock instance is invalid if the associated %File instance is deleted. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - The FileLock instance is invalid if the associated %File instance is deleted.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
FileLock* LockN(FileLockType lockType);
/**
* Tries to acquire the file lock on the current opened whole file.
- * If the file lock is already acquired by another process, E_OBJECT_LOCKED is returned.
+ * If the file lock is already acquired by another process, @c E_OBJECT_LOCKED is returned.
*
* @since 2.1
*
- * @return The pointer to %FileLock instance, @n
- * else @c null pointer in case of failure
+ * @return The pointer to the FileLock instance, @n
+ * else @c null pointer in case of failure
* @param[in] lockType The type of file lock to be created
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c lockType is invalid.
- * @exception E_INVALID_OPERATION Either of the following conditions has occurred: @n
- * - The specified @c lockType cannot be FILE_LOCK_SHARED if the current
- * file is not open for reading. @n
- * - The specified @c lockType cannot be FILE_LOCK_EXCLUSIVE if the current
- * file is not open for writing. @n
- * @exception E_OBJECT_LOCKED Either of the following conditions has occurred: @n
- * - The file lock is already held by another process. @n
- * - The file to be locked has been memory-mapped by another process.
- * @exception E_MAX_EXCEEDED The number of file lock exceeds system limitations.
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - The specified @c lockType cannot be @c FILE_LOCK_SHARED if the current
+ * file is not open for reading.
+ * - The specified @c lockType cannot be @c FILE_LOCK_EXCLUSIVE if the current
+ * file is not open for writing.
+ * @exception E_OBJECT_LOCKED Either of the following conditions has occurred:
+ * - The file lock is already held by another process.
+ * - The file to be locked has been memory-mapped by another process.
+ * @exception E_MAX_EXCEEDED The number of file locks has exceeded system limitations.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The %FileLock instance is invalid if the associated %File instance is deleted. @n
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - The FileLock instance is invalid if the associated %File instance is deleted.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
FileLock* TryToLockN(FileLockType lockType);
* @return An error code
* @param[in] regPath The path of the registry file to remove
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The length of the specified string of a file path is less
- * than or equal to @c 0. @n
- * - The translated overall length of the specified path exceeds the
- * system limitation. @n
- * - The specified path is invalid. @n
+ * than or equal to @c 0.
+ * - The overall length of the specified path exceeds the
+ * system limitation.
+ * - The specified path is invalid.
* @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
* - %File corruption is detected.
*/
static result Remove(const Tizen::Base::String& regPath);
* @return An error code
* @param[in] plainRegPath The normal (non-encrypted) registry file path
* @param[in] secureRegPath The secure (encrypted) registry file path to create
- * @param[in] key A key that encrypts a secure registry file @n
- * If the secure registry file is converted with a specific key value,
- * applications can access the same secure registry file with the identical key value.
+ * @param[in] key The key that encrypts the secure registry file @n
+ * If the secure registry file is converted with the specific key value,
+ * applications can access the same secure registry file with an identical key value.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The length of the specified string of a file path is less
- * than or equal to @c 0. @n
- * - The translated overall length of the specified path exceeds the
- * system limitation. @n
- * - The specified path is invalid. @n
- * @exception E_ILLEGAL_ACCESS Access is denied due to insufficient permission.
+ * than or equal to @c 0.
+ * - The overall length of the specified path exceeds the
+ * system limitation.
+ * - The specified path is invalid.
+ * @exception E_ILLEGAL_ACCESS The access is denied due to insufficient permission.
* @exception E_FILE_ALREADY_EXIST The specified file already exists.
* @exception E_FILE_NOT_FOUND An entry for the specified file or path cannot be found.
* @exception E_INVALID_FORMAT The input registry file contains '0x00' in the middle of the file.
* @exception E_PARSING_FAILED The method has failed to parse the registry file.
* @exception E_STORAGE_FULL The disk space is full.
- * @exception E_IO Either of the following conditions has occurred: @n
- * - An unexpected device failure has occurred as the media ejected suddenly. @n
- * - %File corruption is detected. @n
+ * @exception E_IO Either of the following conditions has occurred:
+ * - An unexpected device failure has occurred as the media ejected suddenly.
+ * - %File corruption is detected.
* - The number of opened files has exceeded the maximum limit.
*/
static result ConvertToSecureRegistry(const Tizen::Base::String& plainRegPath, const Tizen::Base::String& secureRegPath, const Tizen::Base::ByteBuffer& key);
public:
/**
- * Gets the name of a remote message port.
+ * Gets the name of the remote message port.
*
* @since 2.0
*
- * @return The name of a remote message port
+ * @return The name of the remote message port
*/
Tizen::Base::String GetName(void) const;
/**
- * Gets the ID of a remote application.
+ * Gets the ID of the remote application.
*
* @since 2.0
*
- * @return The ID of a remote application
+ * @return The ID of the remote application
*/
Tizen::App::AppId GetAppId(void) const;
/**
- * Checks whether an instance is a trusted message port or not.
+ * Checks whether an instance is a trusted message port.
*
* @since 2.0
*
*
* @since 2.0
*
- * @return An error code
- * @param[in] pMessage A pointer to an argument map of key (String) and value (String or ByteBuffer) pair @n
- * The recommended message size is under 4KB.
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The message argument is not a map of key (String) and value (String or ByteBuffer) pair.
- * @exception E_OBJ_NOT_FOUND The message port of the target application is not found.
- * @exception E_MAX_EXCEEDED The size of @c pMessage has exceeded the maximum limit.
- * @exception E_SYSTEM The method has failed due to a severe system error.
- * @remarks The recommended message size is under 4KB because severe system performance degradation may occur for large messages. @c E_MAX_EXCEEDED may be returned for messages over 4KB size.
+ * @return An error code
+ * @param[in] pMessage A pointer to an argument map of key (String) and value (String or ByteBuffer) pair @n
+ * The recommended message size is under 4KB.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The message argument is not a map of key (String) and value (String or ByteBuffer) pair.
+ * @exception E_OBJ_NOT_FOUND The message port of the target application is not found.
+ * @exception E_MAX_EXCEEDED The size of @c pMessage has exceeded the maximum limit.
+ * @exception E_SYSTEM The method has failed due to a severe system error.
+ * @remarks The recommended message size is under 4KB because severe system performance degradation may occur for large
+ * messages. @n
+ * @c E_MAX_EXCEEDED may be returned for messages over 4KB size.
*/
result SendMessage(const Tizen::Base::Collection::IMap* pMessage);
/**
- * Sends a message to the message port of a remote application. This method is used for the bidirectional communication.
+ * Sends a message to the message port of a remote application. @n
+ * This method is used for the bidirectional communication.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] pLocalMessagePort The local message port
- * @param[in] pMessage A pointer to an argument map of key (String) and value (String or ByteBuffer) pair @n
- * The recommended message size is under 4KB.
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The local message port is @c null. @n
- * - The message argument is not a map of key (String) and value (String or ByteBuffer) pair.
- * @exception E_OBJ_NOT_FOUND The message port of the target application is not found.
- * @exception E_MAX_EXCEEDED The size of @c pMessage has exceeded the maximum limit.
- * @exception E_SYSTEM The method has failed due to a severe system error.
- * @remarks The recommended message size is under 4KB because severe system performance degradation may occur for large messages. @c E_MAX_EXCEEDED may be returned for messages over 4KB size.
+ * @return An error code
+ * @param[in] pLocalMessagePort The local message port
+ * @param[in] pMessage A pointer to an argument map of key (String) and value (String or ByteBuffer) pair @n
+ * The recommended message size is under 4KB.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The local message port is @c null.
+ * - The message argument is not a map of key (String) and value (String or ByteBuffer) pair.
+ * @exception E_OBJ_NOT_FOUND The message port of the target application is not found.
+ * @exception E_MAX_EXCEEDED The size of @c pMessage has exceeded the maximum limit.
+ * @exception E_SYSTEM The method has failed due to a severe system error.
+ * @remarks The recommended message size is under 4KB because severe system performance degradation may occur for large
+ * messages. @n
+ * @c E_MAX_EXCEEDED may be returned for messages over 4KB size.
*/
result SendMessage(const LocalMessagePort* pLocalMessagePort, const Tizen::Base::Collection::IMap* pMessage);
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. @n
+ * For full construction, the Construct() method must be called right after calling this constructor.
*
* @since 2.0
*/
virtual ~SerialPort(void);
/**
- * Constructs a new serial port connection. @n
- * If the specified port is open, E_SYSTEM is returned.
+ * Constructs a new serial port connection with the specified serial port event listener. @n
+ * If the specified port is open, @c E_SYSTEM is returned.
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] listener The serial port event listener
* @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
*/
result Construct(ISerialPortEventListener& listener);
/**
- * Writes data to the output buffer synchronously.
+ * Writes the specified data synchronously.
*
* @since 2.0
*
* @return An error code
- * @param[in] byteBuffer A reference to the buffer that contains the string data to write
- * @exception E_SUCCESS The method is successful.
- * @exception E_MAX_EXCEEDED The buffer size has exceeded the maximum limit of the current device.
- * @exception E_SYSTEM A system error has occurred.
+ * @param[in] byteBuffer A reference to the buffer that contains the string data to write
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_MAX_EXCEEDED The buffer size has exceeded the maximum limit of the current device.
+ * @exception E_SYSTEM A system error has occurred.
* @see GetWriteBufferSize()
*/
result Write(const Tizen::Base::ByteBuffer& byteBuffer);
/**
* Gets the size of the write buffer.
*
- * @since 2.0
+ * @since 2.0
*
- * @return The size of the write buffer
+ * @return The size of the write buffer
* @remarks The size of the write buffer depends on the device.
*/
int GetWriteBufferSize(void) const;
*
* @final This class is not intended for extension.
*
-* The %ServerChannel class provides methods to receive a request from a client application. An application can receive a request from another application using the %ServerChannel class. The instance of %ServerChannel is retrieved using ServerChannel::GetInstance().
+* The %ServerChannel class provides methods to receive a request from a client application. An application can receive a
+* request from another application using the %ServerChannel class. The instance of %ServerChannel is retrieved using
+* ServerChannel::GetInstance().
*
* The following example demonstrates how to use the %ServerChannel class.
*
*
* @since 2.0
*
- * @return A pointer to the %ServerChannel instance, @n
+ * @return The pointer to the %ServerChannel instance, @n
* else @c null if it fails
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*
* @since 2.0
*
- * @return A pointer to the %ServerChannel instance, @n
+ * @return The pointer to the %ServerChannel instance, @n
* else @c null if it fails
* @param[in] channelName The channel name
* @exception E_SUCCESS The method is successful.
/**
* @class SqlStatementBuilder
- * @brief This class provides methods for building SQL statement.
+ * @brief This class provides methods for building an SQL statement.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %SqlStatementBuilder class provides methods for building SQL statement.
+ * The %SqlStatementBuilder class provides methods for building an SQL statement.
*/
class _OSP_EXPORT_ SqlStatementBuilder
: public Tizen::Base::Object
public:
/**
- * Creates SQL SELECT statement.
+ * Creates an SQL SELECT statement.
*
* @since 2.0
*
- * @return A created SQL SELECT statement, @n
+ * @return The SQL SELECT statement, @n
* else an empty string in case of failure
- * @param[in] table A table name to query from
- * @param[in] pColumnList A list of column names to query @n
+ * @param[in] table The table name to query from
+ * @param[in] pColumnList The list of column names to query @n
* The type of objects contained in the specified @c pColumnList must be
* Tizen::Base::String class.
* If it is @c null, all columns are returned in result set.
- * @param[in] pWhere A filter to select desired rows to query @n
+ * @param[in] pWhere The filter to select the desired rows to query @n
* It is an SQL 'WHERE' clause excluding the 'WHERE' itself such as
* column1 = 'stringValue' AND column2 = numericValue.
- * @param[in] pOrder Sorting order of rows to query @n
+ * @param[in] pOrder The sorting order of rows to query @n
* It is an SQL 'ORDER BY' clause excluding the 'ORDER BY' itself.
- * @param[in] pLimit Limitation of the number of rows to query @n
+ * @param[in] pLimit The limit of the number of rows to query @n
* It is the SQL 'LIMIT' clause excluding the 'LIMIT' itself.
- * @param[in] pGroup A filter to select a column grouping rows to query @n
+ * @param[in] pGroup The filter to select a column grouping rows to query @n
* It is the SQL 'GROUP BY' clause excluding the 'GROUP BY' itself.
- * @param[in] pHaving A filter for the group @n
+ * @param[in] pHaving The filter for the group @n
* It is the SQL 'HAVING' clause excluding the 'HAVING' itself.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG Either of the following conditions has occurred:
* - The specified @c pOrder is @c null and @c pLimit is not @c null.
* - The specified @c pGroup is @c null and @c pHaving is not @c null.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks If the value specified in the @c pWhere is string, the value must be wrapped in
- * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.
- * For more information on the SQL statement, see SQLite SQL documents.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - If the value specified in the @c pWhere is string, the value must be wrapped in
+ * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.
+ * For more information on the SQL statement, see SQLite SQL documents.
*/
static Tizen::Base::String CreateSelectStatement(const Tizen::Base::String& table, const Tizen::Base::Collection::IList* pColumnList,
const Tizen::Base::String* pWhere, const Tizen::Base::String* pOrder = null, const Tizen::Base::String* pLimit = null,
const Tizen::Base::String* pGroup = null, const Tizen::Base::String* pHaving = null);
/**
- * Creates SQL INSERT statement.
+ * Creates an SQL INSERT statement.
*
* @since 2.0
*
- * @return A created SQL INSERT statement, @n
+ * @return The SQL INSERT statement, @n
* else an empty string in case of failure @n
- * @param[in] table A table name to insert
- * @param[in] insertMap Column-value pairs to insert @n
+ * @param[in] table The table name to insert
+ * @param[in] insertMap The column-value pairs to insert @n
* The type of objects contained in the specified @c insertMap must be
* Tizen::Base::String class.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c insertMap is empty.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks If the value specified in the @c insertMap is string, the value must be wrapped in
- * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.
- * For more information on the SQL statement, see SQLite SQL documents.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - If the value specified in the @c insertMap is string, the value must be wrapped in
+ * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.
+ * For more information on the SQL statement, see SQLite SQL documents.
*/
static Tizen::Base::String CreateInsertStatement(const Tizen::Base::String& table, const Tizen::Base::Collection::IMap& insertMap);
/**
- * Creates SQL UPDATE statement.
+ * Creates an SQL UPDATE statement.
*
* @since 2.0
*
- * @return A created SQL UPDATE statement, @n
+ * @return The SQL UPDATE statement, @n
* else an empty string in case of failure @n
- * @param[in] table A table name to update
- * @param[in] updateMap Column-value pairs to update @n
+ * @param[in] table The table name to update
+ * @param[in] updateMap The column-value pairs to update @n
* The type of objects contained in the specified @c updateMap must be
* Tizen::Base::String class.
- * @param[in] pWhere A filter to select desired rows to update @n
+ * @param[in] pWhere The filter to select desired rows to update @n
* It is an SQL 'WHERE' clause excluding the 'WHERE' itself such as
* column1 = 'stringValue' AND column2 = numericValue.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c updateMap is empty.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks If the value specified in the @c pWhere or @c updateMap is string, the value must be wrapped in
- * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.
- * For more information on the SQL statement, see SQLITE SQL documents.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - If the value specified in the @c pWhere or @c updateMap is string, the value must be wrapped in
+ * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.
+ * For more information on the SQL statement, see SQLITE SQL documents.
*/
static Tizen::Base::String CreateUpdateStatement(const Tizen::Base::String& table, const Tizen::Base::Collection::IMap& updateMap,
const Tizen::Base::String* pWhere);
/**
- * Creates SQL DELETE statement.
+ * Creates an SQL DELETE statement.
*
* @since 2.0
*
- * @return A created SQL DELETE statement, @n
+ * @return The SQL DELETE statement, @n
* else an empty string in case of failure @n
- * @param[in] table A table name to query
- * @param[in] pWhere A filter to select desired rows to delete @n
+ * @param[in] table The table name to query
+ * @param[in] pWhere The filter to select desired rows to delete @n
* It is an SQL 'WHERE' clause excluding the 'WHERE' itself such as
* column1 = 'stringValue' AND column2 = numericValue.
* If it is @c null, all rows are deleted.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified parameter is invalid.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks If the value specified in the @c pWhere is string, the value must be wrapped in
- * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.
- * For more information on the SQL statement, see SQLITE SQL documents.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - If the value specified in the @c pWhere is string, the value must be wrapped in
+ * single quotes. Otherwise it is not needed to wrap the numeric value in single quotes.
+ * For more information on the SQL statement, see SQLITE SQL documents.
*/
static Tizen::Base::String CreateDeleteStatement(const Tizen::Base::String& table, const Tizen::Base::String* pWhere);
TIME_FIELD_MILLISECOND, /**< Millisecond : 0-based (0~999) */
TIME_FIELD_ZONE_OFFSET, /**< Time Zone Offset : 0-based (-43200000~54000000 in milliseconds) */
TIME_FIELD_DST_OFFSET, /**< Daylight Saving Offset : 0-based (0~3600000 in milliseconds)*/
- TIME_FIELD_FIELD_COUNT /**< The number of time field */
+ TIME_FIELD_FIELD_COUNT /**< The number of time fields */
};
class _OSP_EXPORT_ Calendar
virtual ~Calendar(void);
/**
- * Adds the specified amount to the given time field, based on the calendar rules. @n
- * It is equivalent to calling SetTimeField(field, GetTimeField(field)+amount) with two adjustments. @n
+ * Adds the specified amount to the specified time field, based on the calendar rules. @n
+ * It is equivalent to calling SetTimeField(field, GetTimeField(field)+amount) with the following two adjustments: @n
*
* @b Add @b Rule1: The value of the time field @c field after the call minus the value of the field
* before the call is delta modulo any overflow that has occurred in the field.
* equal to its prior value because of changes in its minimum or maximum value after the time field @c field
* is changed, then its value is adjusted to be as close as possible to its expected value. @n
*
- * A smaller field represents a smaller unit of time. TIME_FIELD_HOUR is a smaller field than TIME_FIELD_DAY_OF_MONTH.
+ * A smaller field represents a smaller unit of time. @c TIME_FIELD_HOUR is a smaller field than @c TIME_FIELD_DAY_OF_MONTH.
* No adjustment is made to smaller fields that are not expected to be invariant.
- * The calendar system determines what fields are expected to be invariant.
+ * The calendar system determines the fields that are expected to be invariant.
*
* In addition, this method forces re-computation of the calendar's milliseconds and
* all time fields immediately. @n
*
* For example, consider a GregorianCalendar set to Oct 31, 2004.
- * Calling AddTimeField(TIME_FIELD_MONTH, 13) sets the calendar to Nov 30, 2005. @n
- * The TIME_FIELD_MONTH field is set to NOVEMBER by @b Rule1, since adding 13 months to October gives the
+ * Calling AddTimeField(@c TIME_FIELD_MONTH, 13) sets the calendar to Nov 30, 2005. @n
+ * The @c TIME_FIELD_MONTH field is set to NOVEMBER by @b Rule1, since adding 13 months to October sets the month as
* November of the next year.
- * Since, the TIME_FIELD_DAY_OF_MONTH cannot be 31 in November in a %GregorianCalendar, the TIME_FIELD_DAY_OF_MONTH is set to 30 by @b Rule2.
+ * Since, the @c TIME_FIELD_DAY_OF_MONTH cannot be 31 in November in a %GregorianCalendar, the @c TIME_FIELD_DAY_OF_MONTH is set to 30 by @b Rule2.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompCalendarAddTimeFieldPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompCalendarAddTimeFieldPage "here".
* @endif
*
* @return An error code
* @param[in] field The time field
* @param[in] amount The amount to add
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c field is invalid.
+ * @exception E_INVALID_ARG The specified @c field is invalid.
*/
virtual result AddTimeField(TimeField field, int amount) = 0;
/**
* @if OSPCOMPAT
- * @page CompCalendarAddTimeFieldPage Compatibility for AddTimeField()
- * @section CompCalendarAddTimeFieldIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_INVALID_STATE if the time field is invalid.
- *
- * @section CompCalendarAddTimeFieldSolutionSection Resolutions
- * This issue has been resolved in Tizen.
+ * @page CompCalendarAddTimeFieldPage Compatibility for AddTimeField()
+ * @section CompCalendarAddTimeFieldIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_INVALID_STATE if the time field is invalid.
+ *
+ * @section CompCalendarAddTimeFieldSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
*
* @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the time field is invalid.
+ * -# The method returns @c E_INVALID_ARG if the time field is invalid.
* @endif
*/
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
- * @since 2.0
+ * @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompCalendarAfterPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompCalendarAfterPage "here".
* @endif
*
- * @return An error code
- * @param[in] otherCalendar The instance of %Calendar to compare
- * @param[out] after Set to @c true if the current instance of %Calendar is after the specified instance of %Calendar, @n
+ * @return An error code
+ * @param[in] otherCalendar The instance of %Calendar to compare
+ * @param[out] after Set to @c true if the current instance of %Calendar is after the specified instance of %Calendar, @n
* else @c false
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c otherCalendar is invalid.
- * @exception E_INVALID_STATE In this method, the time fields of this instance are calculated. @n
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified @c otherCalendar is invalid.
+ * @exception E_INVALID_STATE In this method, the time fields of this instance are calculated. @n
* If any time field value previously set is invalid, this exception is returned.
- * @exception E_OUT_OF_RANGE In this method, the time fields of this instance are calculated. @n
- * If the value of the time fields goes out of range, this exception is returned.
+ * @exception E_OUT_OF_RANGE In this method, the time fields of this instance are calculated. @n
+ * If the value of the time fields goes out of range, this exception is returned.
*/
result After(const Calendar& otherCalendar, bool& after);
/**
* @if OSPCOMPAT
- * @page CompCalendarAfterPage Compatibility for After()
- * @section CompCalendarAfterIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_INVALID_STATE and E_OUT_OF_RANGE if the instance of %Calendar to be compared is invalid.
- *
- * @section CompCalendarAfterSolutionSection Resolutions
- * This issue has been resolved in Tizen.
+ * @page CompCalendarAfterPage Compatibility for After()
+ * @section CompCalendarAfterIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_INVALID_STATE and @c E_OUT_OF_RANGE if the instance of %Calendar to be compared is invalid.
+ *
+ * @section CompCalendarAfterSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
*
* @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the instance of %Calendar to be compared is invalid.
- * -# The method returns E_INVALID_STATE if any time field value previously set is invalid.
- * -# The method returns E_OUT_OF_RANGE if the value of the time fields goes out of range.
+ * -# The method returns @c E_INVALID_ARG if the instance of %Calendar to be compared is invalid.
+ * -# The method returns @c E_INVALID_STATE if any time field value previously set is invalid.
+ * -# The method returns @c E_OUT_OF_RANGE if the value of the time fields goes out of range.
* @endif
- */
+ */
/**
* Compares the current instance of %Calendar with the specified instance.
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
- * @since 2.0
+ * @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompCalendarBeforePage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompCalendarBeforePage "here".
* @endif
*
- * @return An error code
- * @param[in] otherCalendar The instance of %Calendar to compare
- * @param[out] before Set to @c true if the current instance of %Calendar is before the specified instance of %Calendar, @n
- * else @c false
+ * @return An error code
+ * @param[in] otherCalendar The instance of %Calendar to compare
+ * @param[out] before Set to @c true if the current instance of %Calendar is before the specified instance of %Calendar, @n
+ * else @c false
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c otherCalendar is invalid.
- * @exception E_INVALID_STATE In this method, the time fields of this instance are calculated. @n
- * If any time field value previously set is invalid, this exception is returned.
- * @exception E_OUT_OF_RANGE In this method, the time fields of this instance are calculated. @n
- * If the value of the time fields goes out of range, this exception is returned.
+ * @exception E_INVALID_ARG The specified @c otherCalendar is invalid.
+ * @exception E_INVALID_STATE In this method, the time fields of this instance are calculated. @n
+ * If any time field value previously set is invalid, this exception is returned.
+ * @exception E_OUT_OF_RANGE In this method, the time fields of this instance are calculated. @n
+ * If the value of the time fields goes out of range, this exception is returned.
*/
result Before(const Calendar& otherCalendar, bool& before);
/**
* @if OSPCOMPAT
- * @page CompCalendarBeforePage Compatibility for Before()
- * @section CompCalendarBeforeIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_INVALID_STATE and E_OUT_OF_RANGE if the instance of %Calendar to be compared is invalid.
- *
- * @section CompCalendarBeforeSolutionSection Resolutions
- * This issue has been resolved in Tizen.
+ * @page CompCalendarBeforePage Compatibility for Before()
+ * @section CompCalendarBeforeIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_INVALID_STATE and @c E_OUT_OF_RANGE if the instance of %Calendar to be compared is invalid.
+ *
+ * @section CompCalendarBeforeSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
*
* @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the instance of %Calendar to be compared is invalid.
- * -# The method returns E_INVALID_STATE if any time field value previously set is invalid.
- * -# The method returns E_OUT_OF_RANGE if the value of the time fields goes out of range.
- * @endif
- */
+ * -# The method returns @c E_INVALID_ARG if the instance of %Calendar to be compared is invalid.
+ * -# The method returns @c E_INVALID_STATE if any time field value previously set is invalid.
+ * -# The method returns @c E_OUT_OF_RANGE if the value of the time fields goes out of range.
+ * @endif
+ */
/**
* Clears all the time fields and sets it to @c 0. @n
- * Zero is not the default value for each field. It means the field is cleared.
+ * Zero is not the default value for each field. It means that the field is cleared.
*
* @since 2.0
*
/**
* Clears the specified time field and sets it to @c 0. @n
- * Zero is not the default value for each field. It means the field is cleared.
+ * Zero is not the default value for each field. It means that the field is cleared.
*
* @since 2.0
*
*
* @return @c true if the value of the specified instance of Tizen::Base::Object is equal to the value of the current instance of %Calendar, @n
* else @c false
- * @param[in] obj An instance of Tizen::Base::Object to compare
+ * @param[in] obj An instance of Tizen::Base::Object to compare
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
virtual int GetHashCode(void) const;
/**
- * Rolls up or down as per the specified @c amount in the specified time field without changing the larger fields (for example, TIME_FIELD_YEAR field cannot be changed when the input field is TIME_FIELD_MONTH). @n
+ * Rolls up or down as per the specified @c amount in the specified time field without changing the larger fields
+ * (for example, @c TIME_FIELD_YEAR field cannot be changed when the input field is @c TIME_FIELD_MONTH). @n
* If the specified @c amount is negative, the amount value is deducted from the specified time field value.
- * In this method, the time field of this instance is operated upon. If the value of the specified @c field goes out of range, E_OUT_OF_RANGE is returned.
+ * In this method, the time field of this instance is operated upon. If the value of the specified @c field goes out of range,
+ * @c E_OUT_OF_RANGE is returned.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompCalendarRollPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompCalendarRollPage "here".
* @endif
*
* @return An error code
- * @param[in] field The time field to roll
- * @param[in] amount The amount to add to the time field
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c field is invalid (for example, TIME_FIELD_DST_OFFSET, TIME_FIELD_ZONE_OFFSET).
- * @exception E_OUT_OF_RANGE In this method, the time fields of this instance are calculated. @n
- * If the value of the time fields goes out of range, this exception is returned.
+ * @param[in] field The time field to roll
+ * @param[in] amount The amount to add to the time field
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified @c field is invalid (for example, @c TIME_FIELD_DST_OFFSET, @c TIME_FIELD_ZONE_OFFSET).
+ * @exception E_OUT_OF_RANGE In this method, the time fields of this instance are calculated. @n
+ * If the value of the time fields goes out of range, this exception is returned.
*/
virtual result Roll(TimeField field, int amount);
/**
* @if OSPCOMPAT
- * @page CompCalendarRollPage Compatibility for Roll()
- * @section CompCalendarRollIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_INVALID_STATE if the time field is invalid.
- *
- * @section CompCalendarRollSolutionSection Resolutions
- * This issue has been resolved in Tizen.
+ * @page CompCalendarRollPage Compatibility for Roll()
+ * @section CompCalendarRollIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_INVALID_STATE if the time field is invalid.
+ *
+ * @section CompCalendarRollSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
*
* @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the time field is invalid.
+ * -# The method returns @c E_INVALID_ARG if the time field is invalid.
* @endif
- */
+ */
/**
* Sets the specified time field with the specified @c value. @n
* until GetTimeField(), GetTime(), or GetTimeInMillisec() is called.
* Thus, even if you call this method several times, unnecessary multiple computations are not triggered. @n
*
- * As a result of changing a field using SetTimeField(), other fields may also change
+ * When a field is changed using SetTimeField(), other fields may also change
* depending on the field, the field value, and the calendar system. @n
*
* For example, consider a GregorianCalendar set to Oct. 31, 2004.
- * Calling SetTimeField(TIME_FIELD_MONTH, NOVEMBER) sets the calendar to Nov 31, 2004. @n
+ * Calling SetTimeField(@c TIME_FIELD_MONTH, NOVEMBER) sets the calendar to Nov 31, 2004. @n
* But, if you call GetTime(), then Dec 1, 2004 is returned because Nov 31, 2004 does not exist.
- * However, a call to SetTimeField(TIME_FIELD_MONTH, SEPTEMBER) before a call to GetTime() sets the calendar
+ * However, a call to SetTimeField(@c TIME_FIELD_MONTH, SEPTEMBER) before a call to GetTime() sets the calendar
* to Sep 30, 2004, since no re-computation has occurred after the first call to SetTimeField().
*
* The value of field is not affected by it being local time or UTC time.
/**
* Sets the value of year, month, day, hour, minute, and seconds. @n
- * The date and time are local time.
+ * The date and time are the local date and time.
*
* @since 2.0
*
* @return An error code
- * @param[in] year The value to set for year
- * @param[in] month The value to set for month @n
+ * @param[in] year The year to set
+ * @param[in] month The month to set @n
* The indexing is 1-based. Therefore, 1 means January.
- * @param[in] day The value to set for day
- * @param[in] hour The value to set for hour
- * @param[in] minute The value to set for minute
- * @param[in] second The value to set for second
+ * @param[in] day The day to set
+ * @param[in] hour The hour to set
+ * @param[in] minute The minute to set
+ * @param[in] second The second to set
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE A time field or its value is out of range in lenient mode.
+ * @exception E_OUT_OF_RANGE A time field or its value is out of range in lenient mode.
*/
result SetTime(int year, int month, int day, int hour = 0, int minute = 0, int second = 0);
/**
- * Sets the calendar's current time with the specified Tizen::Base::DateTime.
+ * Sets the current time of this %Calendar instance with the specified Tizen::Base::DateTime.
*
* @since 2.0
*
/**
* Gets the actual maximum value that the specified field can have, given the current date. @n
- * For example, if the current date is "Feb 10, 2004" and the time field specified is TIME_FIELD_DAY_OF_MONTH, then the actual
- * maximum value for this time field is 29.
+ * For example, if the current date is "Feb 10, 2004" and the time field specified is @c TIME_FIELD_DAY_OF_MONTH, then the actual
+ * maximum value for this time field is @c 29.
*
* @since 2.0
*
* @return An integer value indicating the actual maximum value
- * @param[in] field The time field
+ * @param[in] field The time field
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c field is invalid.
+ * @exception E_INVALID_ARG The specified @c field is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual int GetActualMaxTimeField(TimeField field) const;
/**
* Gets the actual minimum value that the specified time field can have, given the current date. @n
- * For the Gregorian calendar, this is the same as GetMinTimeField() and
- * GetGreatestMinTimeField().
+ * For the Gregorian calendar, this is the same as GetMinTimeField() and GetGreatestMinTimeField().
*
* @since 2.0
*
* @return An integer value indicating the actual minimum value
- * @param[in] field The time field
+ * @param[in] field The time field
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c field is invalid.
+ * @exception E_INVALID_ARG The specified @c field is invalid.
* @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
/**
* Gets the value of the first day of the week. @n
- * For example, in USA, the first day of the week is SUNDAY. But, it is MONDAY in France.
+ * For example, in USA, the first day of the week is SUNDAY. But, in France, it is MONDAY.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An integer value indicating the first day of the week, @n
- * else @c -1 if the method fails
+ * @return An integer value indicating the first day of the week, @n
+ * else @c -1 if it fails
*/
int GetFirstDayOfWeek(void) const;
* @since 2.0
*
* @return An integer value indicating the greatest minimum value for the specified time field
- * @param[in] field The time field
+ * @param[in] field The time field
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c field is invalid.
+ * @exception E_INVALID_ARG The specified @c field is invalid.
* @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
* @since 2.0
*
* @return An integer value indicating the least maximum value for the specified time field
- * @param[in] field The time field
+ * @param[in] field The time field
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c field is invalid.
+ * @exception E_INVALID_ARG The specified @c field is invalid.
* @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
* @since 2.0
*
* @return An integer value indicating the maximum value for the specified time field
- * @param[in] field The time field
+ * @param[in] field The time field
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c field is invalid.
+ * @exception E_INVALID_ARG The specified @c field is invalid.
* @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
* @since 2.0
*
* @return An integer value indicating the minimum value for the specified time field
- * @param[in] field The time field
+ * @param[in] field The time field
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c field is invalid.
+ * @exception E_INVALID_ARG The specified @c field is invalid.
* @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
* @since 2.0
*
* @return An instance of Tizen::Base::DateTime with the current time in local time
- * @remarks The time specified is local time.
+ * @remarks The time specified is the local time.
*/
Tizen::Base::DateTime GetTime(void) const;
*
* @return An integer value indicating the value of the specified time field
*
- * @param[in] field The given time field
+ * @param[in] field The given time field
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c field is invalid.
+ * @exception E_INVALID_ARG The specified @c field is invalid.
* @exception E_SYSTEM A system error has occurred.
- * @remarks This method is semantically const, but may alter the instance in memory.
- * All fields are re-computed if any field is invalid.
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - This method is semantically const, but may alter the instance in memory.
+ * - All fields are re-computed if any field is invalid.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
int GetTimeField(TimeField field) const;
* @since 2.0
*
* @return An error code
- * @param[out] millisec The current time in milliseconds from starting day (Jan 1, 1.)
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE In this method, the time fields of this instance are calculated. @n
- * If any time field value previously set is invalid, this exception is returned.
- * @exception E_OUT_OF_RANGE The value of the argument is out of the valid range defined by the method.
+ * @param[out] millisec The current time in milliseconds from starting day (Jan 1, 1.)
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE In this method, the time fields of this instance are calculated. @n
+ * If any time field value previously set is invalid, this exception is returned.
+ * @exception E_OUT_OF_RANGE The value of the argument is out of the valid range defined by the method.
*/
result GetTimeInMillisec(long long& millisec) const;
* @since 2.0
*
* @return The TimeZone instance associated with the current instance of %Calendar
- * @remarks The returned reference is valid only until the SetTimeZone() method is called or this instance of %Calendar is destroyed.
+ * @remarks The returned reference is valid only until the SetTimeZone() method is called or
+ * this instance of %Calendar is destroyed.
* @see SetTimeZone()
*/
TimeZone GetTimeZone(void) const;
* @since 2.0
*
* @return An instance of CalendarType representing the calendar type of the current instance of %Calendar @n
- * For example, CALENDAR_GREGORIAN.
+ * For example, @c CALENDAR_GREGORIAN.
*/
virtual CalendarType GetType(void) const = 0;
* @since 2.0
*
* @return An error code
- * @param[out] isInDst Set to @c true if the current date is in DST, @n
- * else @c false
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE In this method, the time fields of this instance are calculated. @n
- * If any time field value previously set is invalid, this exception is returned.
- * @exception E_OUT_OF_RANGE A time field or its value is out of range. @n
- * In this method, the time fields of this instance are calculated. If the value of the time fields goes out of range, this exception is returned.
+ * @param[out] isInDst Set to @c true if the current date is in DST, @n
+ * else @c false
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE In this method, the time fields of this instance are calculated. @n
+ * If any time field value previously set is invalid, this exception is returned.
+ * @exception E_OUT_OF_RANGE A time field or its value is out of range. @n
+ * In this method, the time fields of this instance are calculated.
+ * If the value of the time fields goes out of range, this exception is returned.
*/
virtual result IsInDst(bool& isInDst) const = 0;
/**
* Creates an instance of %Calendar of the specified type with the GMT time zone and the system locale. @n
- * An instance has weekdata which are the first of week, minimal days in the first week, weekend on set, and weekend cease.
- * The weekdata are set as default values by the locale.
+ * The instance has weekdata which is the first of week, minimal days in the first week, weekend on set, and weekend cease.
+ * The weekdata is set to default values by the locale.
*
* @since 2.0
*
* @return A pointer to the created %Calendar instance, @n
- * else @c null if the method fails
+ * else @c null if it fails
* @param[in] calendarType The type of calendar @n
- * Default calendar is the Gregorian calendar (CALENDAR_GREGORIAN).
+ * The default calendar is the Gregorian calendar (@c CALENDAR_GREGORIAN).
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
/**
* Creates an instance of %Calendar of the specified type with the specified time zone and the system locale. @n
* The @c timeZone is used for the zone offset and the DST offset.
- * An instance has weekdata which are the first of week, minimal days in the first week, weekend on set, and weekend cease.
- * The weekdata are set as default values by the locale.
+ * The instance has weekdata which is the first of week, minimal days in the first week, weekend on set, and weekend cease.
+ * The weekdata is set to default values by the locale.
*
* @since 2.0
*
* @return A pointer to the created %Calendar instance, @n
- * else @c null if the method fails
+ * else @c null if it fails
* @param[in] timeZone An instance of TimeZone
* @param[in] calendarType The type of calendar @n
- * Default calendar is the Gregorian calendar (CALENDAR_GREGORIAN).
+ * The default calendar is the Gregorian calendar (@c CALENDAR_GREGORIAN).
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
/**
* Creates an instance of %Calendar of the specified type with the specified @c locale and the GMT time zone. @n
- * An instance has weekdata which are the first of week, minimal days in the first week, weekend on set, and weekend cease.
- * The weekdata are set as default values by the specified @c locale.
+ * The instance has weekdata which is the first of week, minimal days in the first week, weekend on set, and weekend cease.
+ * The weekdata is set to default values by the specified @c locale.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompCalendarCreateInstanceNPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompCalendarCreateInstanceNPage "here".
* @endif
*
* @return A pointer to the created %Calendar instance, @n
- * else @c null if the method fails
+ * else @c null if it fails
* @param[in] locale The locale for whose country the %Calendar instance is needed
* @param[in] calendarType The type of calendar @n
- * Default calendar is the Gregorian calendar (CALENDAR_GREGORIAN).
+ * The default calendar is the Gregorian calendar (@c CALENDAR_GREGORIAN).
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c locale is invalid.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG The specified @c locale is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static Calendar* CreateInstanceN(const Locale& locale, CalendarType calendarType = CALENDAR_GREGORIAN);
/**
* Creates an instance of %Calendar of the specified type with the specified time zone and @c locale. @n
* The @c timeZone is used for the zone offset and the DST offset.
- * An instance has weekdata which are the first of week, minimal days in the first week, weekend on set, and weekend cease.
- * The weekdata are set as default values by the specified @c locale.
+ * The instance has weekdata which is the first of week, minimal days in the first week, weekend on set, and weekend cease.
+ * The weekdata is set to default values by the specified @c locale.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompCalendarCreateInstanceNPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompCalendarCreateInstanceNPage "here".
* @endif
*
* @return A pointer to the created %Calendar instance, @n
- * else @c null if the method fails
+ * else @c null if it fails
* @param[in] timeZone An instance of TimeZone
- * @param[in] locale The locale for whose country the %Calendar instance is needed
- * @param[in] calendarType The type of calendar @n
- * Default calendar is the Gregorian calendar (CALENDAR_GREGORIAN).
+ * @param[in] locale The locale for the country the %Calendar instance is created
+ * @param[in] calendarType The calendar type @n
+ * The default calendar is the Gregorian calendar (@c CALENDAR_GREGORIAN).
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c locale is invalid.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG The specified @c locale is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static Calendar* CreateInstanceN(const TimeZone& timeZone, const Locale& locale, CalendarType calendarType = CALENDAR_GREGORIAN);
/**
* @if OSPCOMPAT
- * @page CompCalendarCreateInstanceNPage Compatibility for CreateInstanceN()
- * @section CompCalendarCreateInstanceNIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the locale is invalid.
- *
- * @section CompCalendarCreateInstanceNSolutionSection Resolutions
- * This issue has been resolved in Tizen.
- * @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the locale is invalid.
+ * @page CompCalendarCreateInstanceNPage Compatibility for CreateInstanceN()
+ * @section CompCalendarCreateInstanceNIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_UNSUPPORTED_OPERATION if the locale is invalid.
+ *
+ * @section CompCalendarCreateInstanceNSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
+ * @par When working in Tizen:
+ * -# The method returns @c E_INVALID_ARG if the locale is invalid.
* @endif
- */
+ */
protected:
/**
* @enum AmPm
*
* Defines the AM/PM mode. @n
- * This is a.m./p.m. The indexing is 0-based.
+ * The indexing is 0-based.
*
* @since 2.0
*/
/**
* @enum CalendarLimitType
*
- * Defines the calendar limitations.
+ * Defines the calendar limits.
*
* @since 2.0
*/
*/
enum StampValue
{
- UNSET = 0, /**< Unset */
- COMPUTED, /**< Computed */
- MINIMUM_USER_STAMP /**< Minimum user stamp */
+ UNSET = 0, /**< The stamp is unset */
+ COMPUTED, /**< The stamp is computed */
+ MINIMUM_USER_STAMP /**< The minimum user stamp */
};
/**
- * This is the default constructor for this class. @n
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
- *
- * @since 2.0
- *
- * @see Construct()
- */
+ * This is the default constructor for this class. @n
+ * The object is not fully constructed after this constructor is called. For full construction,
+ * the Construct() method must be called right after calling this constructor.
+ *
+ * @since 2.0
+ */
Calendar(void);
/**
- * Initializes this instance of %Calendar.
- *
- * @since 2.0
- *
- * @return An error code
- * @exception E_SUCCESS The method is successful.
- */
+ * Initializes this instance of %Calendar.
+ *
+ * @since 2.0
+ *
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
+ */
result Construct(void);
/**
- * Initializes this instance of %Calendar with the specified parameter.
- *
- * @since 2.0
- *
- * @return An error code
- * @param[in] calendar The %Calendar instance to copy
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- *
- */
+ * Initializes this instance of %Calendar with the specified %Calendar instance.
+ *
+ * @since 2.0
+ *
+ * @return An error code
+ * @param[in] calendar The %Calendar instance to copy
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ *
+ */
result Construct(const Calendar& calendar);
/**
- * Initializes this instance of %Calendar with the specified time zone and @c locale. @n
- * The @c timeZone is used for the zone offset and the DST offset.
- * An instance has weekdata which are the first of week, minimal days in the first week, weekend on set, and weekend cease.
- * The weekdata are set as default values by the specified @c locale.
- *
- * @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
- * @endif
- * @since 2.0
- * @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompCalendarConstructPage "here".
- * @endif
- *
- * @return An error code
- * @param[in] timeZone An instance of TimeZone
- * @param[in] locale An instance of Locale
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c locale is invalid.
- */
+ * Initializes this instance of %Calendar with the specified time zone and @c locale. @n
+ * The @c timeZone is used for the zone offset and the DST offset.
+ * The instance has weekdata which is the first of week, minimal days in the first week, weekend on set, and weekend cease.
+ * The weekdata is set to default values by the specified @c locale.
+ *
+ * @if OSPCOMPAT
+ * @brief <i> [Compatibility] </i>
+ * @endif
+ * @since 2.0
+ * @if OSPCOMPAT
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompCalendarConstructPage "here".
+ * @endif
+ *
+ * @return An error code
+ * @param[in] timeZone An instance of TimeZone
+ * @param[in] locale An instance of Locale
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified @c locale is invalid.
+ */
result Construct(const Tizen::Locales::TimeZone& timeZone, const Locale& locale);
/**
- * @if OSPCOMPAT
- * @page CompCalendarConstructPage Compatibility for Construct()
- * @section CompCalendarConstructIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the locale is invalid.
- *
- * @section CompCalendarConstructSolutionSection Resolutions
- * This issue has been resolved in Tizen.
- * @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the locale is invalid.
- * @endif
- */
+ * @if OSPCOMPAT
+ * @page CompCalendarConstructPage Compatibility for Construct()
+ * @section CompCalendarConstructIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_UNSUPPORTED_OPERATION if the locale is invalid.
+ *
+ * @section CompCalendarConstructSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
+ * @par When working in Tizen:
+ * -# The method returns @c E_INVALID_ARG if the locale is invalid.
+ * @endif
+ */
/**
- * Rolls up or down with a single unit of time on a given time field without changing larger fields. @n
- * When rolling on the MONTH field, other fields such as DATE field might conflict
- * and needs to be changed.
+ * Rolls up or down with a single unit of time on the specified time field without changing the larger fields. @n
+ * When rolling on the MONTH field, other fields such as DATE field might conflict and need to be changed.
*
* @since 2.0
*
* @return An error code
- * @param[in] field The time field to change
- * @param[in] up Set to @c true if the time field must be rolled upwards, @n
- * else @c false
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE In this method, the time fields of this instance are calculated. @n
- * If any time field value previously set is invalid, this exception is returned.
- * @exception E_INVALID_ARG The specified @c field is invalid (for example, TIME_FIELD_DST_OFFSET, TIME_FIELD_ZONE_OFFSET).
- * @exception E_OUT_OF_RANGE A time field or its value is out of range. @n
- * In this method, the time fields of this instance are calculated.
- * If the value of the time fields goes out of range, this exception is returned.
+ * @param[in] field The time field to change
+ * @param[in] up Set to @c true if the time field must be rolled upwards, @n
+ * else @c false
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE In this method, the time fields of this instance are calculated. @n
+ * If any time field value previously set is invalid, this exception is returned.
+ * @exception E_INVALID_ARG The specified @c field is invalid (for example, @c TIME_FIELD_DST_OFFSET, @c TIME_FIELD_ZONE_OFFSET).
+ * @exception E_OUT_OF_RANGE A time field or its value is out of range. @n
+ * In this method, the time fields of this instance are calculated.
+ * If the value of the time fields goes out of range, this exception is returned.
*/
virtual result RollWithSingleUnit(TimeField field, bool up) = 0;
*
* @return @c true if the current instance of %Calendar is equivalent to the specified %Calendar instance, @n
* else @c false
- * @param[in] calendar The instance of %Calendar to compare with
+ * @param[in] calendar The instance of %Calendar to compare
* @remarks If the specified %Calendar instance is equivalent to the current instance, the two instances behave
* exactly the same, but they may be set to different times.
*/
/**
* Computes the time field value. @n
* Converts the current millisecond time value to TimeField. @n
- * This allows synching up the time field values with a new time that is set for the calendar.
+ * This allows syncing up the time field values with a new time that is set for the calendar.
*
* @since 2.0
*
* @return An error code
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE The time fields contain an invalid value. @n
- * In this method, the time fields of this instance are calculated. If the value of the time fields goes out of range, this exception is returned.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_RANGE The time fields contain an invalid value. @n
+ * In this method, the time fields of this instance are calculated.
+ * If the value of the time fields goes out of range, this exception is returned.
*/
virtual result ComputeTimeFields(void) = 0;
virtual int GetMonthLength(int extendedYear, int month) const = 0;
/**
- * Handles the limits of different types. @n
+ * Handle the limits of the specified time field that depend on the type of limit. @n
* Derived classes must implement this method for the following fields:
- * TIME_FIELD_ERA, TIME_FIELD_YEAR, TIME_FIELD_MONTH, TIME_FIELD_WEEK_OF_YEAR, TIME_FIELD_WEEK_OF_MONTH,
- * TIME_FIELD_DAY_OF_MONTH, TIME_FIELD_DAY_OF_YEAR, TIME_FIELD_DAY_OF_WEEK_IN_MONTH, TIME_FIELD_YEAR_WOY,
- * TIME_FIELD_EXTENDED_YEAR.
+ * @c TIME_FIELD_ERA, @c TIME_FIELD_YEAR, @c TIME_FIELD_MONTH, @c TIME_FIELD_WEEK_OF_YEAR, @c TIME_FIELD_WEEK_OF_MONTH,
+ * @c TIME_FIELD_DAY_OF_MONTH, @c TIME_FIELD_DAY_OF_YEAR, @c TIME_FIELD_DAY_OF_WEEK_IN_MONTH, @c TIME_FIELD_YEAR_WOY,
+ * @c TIME_FIELD_EXTENDED_YEAR.
*
* @since 2.0
*
*/
virtual int HandleGetLimit(TimeField field, CalendarLimitType limitType) const = 0;
- /*
+ /**
* Creates and returns a polymorphic copy of this calendar.
*
* @since 2.0
public:
/**
- * Millisecond constants for one day.
+ * One day in milliseconds.
*
* @since 2.0
*/
static const int ONE_DAY_IN_MILLISEC = 86400000;
/**
- * Millisecond constants for one hour.
+ * One hour in milliseconds.
*
* @since 2.0
*/
static const int ONE_HOUR_IN_MILLISEC = 60 * 60 * 1000;
/**
- * Millisecond constants for one minute.
+ * One minute in milliseconds.
*
* @since 2.0
*/
static const int ONE_MINUTE_IN_MILLISEC = 60000;
/**
- * Millisecond constants for one second.
+ * One second in milliseconds.
*
* @since 2.0
*/
static const int ONE_SECOND_IN_MILLISEC = 1000;
/**
- * Millisecond constants for one week.
+ * One week in milliseconds.
*
* @since 2.0
*/
/**
* @class Currency
- * @brief This class represents currencies.
+ * @brief This class provides methods for currencies.
*
* @since 2.0
*
/**
* This is the default constructor for this class. @n
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. For full construction, the Construct() method
+ * must be called right after calling this constructor.
*
* @since 2.0
- *
- * @see Construct()
*/
Currency(void);
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompCurrencyConstructPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompCurrencyConstructPage "here".
* @endif
*
* @return An error code
- * @param[in] locale The specified @c locale to get the currency symbol
- * @exception E_SUCCESS The method is successful.
+ * @param[in] locale The specified @c locale to get the currency symbol
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c locale is not supported.
*/
result Construct(const Locale& locale);
/**
* Initializes this instance of %Currency with the specified currency code. @n
- * Currencies are enumerated as defined by ISO 4217. For example, if the locale is Korean (language) and Korea (country), the currency code is "KRW".
+ * The currencies are enumerated as defined by ISO 4217. For example, if the locale is Korean (language) and Korea (country),
+ * the currency code is "KRW".
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompCurrencyConstructPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompCurrencyConstructPage "here".
* @endif
*
* @return An error code
- * @param[in] currencyCode The specified currency code to get the currency symbol
- * @exception E_SUCCESS The method is successful.
+ * @param[in] currencyCode The specified currency code to get the currency symbol
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c currencyCode is not supported.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
*/
result Construct(const Tizen::Base::String& currencyCode);
/**
* @if OSPCOMPAT
- * @page CompCurrencyConstructPage Compatibility for Construct()
- * @section CompCurrencyConstructIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the argument is invalid.
- *
- * @section CompCurrencyConstructSolutionSection Resolutions
- * This issue has been resolved in Tizen.
+ * @page CompCurrencyConstructPage Compatibility for Construct()
+ * @section CompCurrencyConstructIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns E_UNSUPPORTED_OPERATION if the argument is invalid.
+ *
+ * @section CompCurrencyConstructSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
* @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the argument is invalid.
+ * -# The method returns E_INVALID_ARG if the argument is invalid.
* @endif
- */
+ */
/**
*
* @return @c true if the value of the specified instance is equal to that of the current instance, @n
* else @c false
- * @param[in] obj The object to compare with the current instance
+ * @param[in] obj The object to compare with the current instance
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
* else a @c null pointer is returned if there is no currency available or there is some failure @n
* The array is a list of all the available currencies.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static Tizen::Base::Collection::IList* GetAvailableCurrenciesN(void);
*/
enum DateTimeStyle
{
- DATE_TIME_STYLE_NONE = -1, /**< The date time style: None */
- DATE_TIME_STYLE_FULL = 0, /**< The date time style: FULL is pretty completely specified, such as Tuesday, April 12, 1952 AD or 3:30:42PM PST */
- DATE_TIME_STYLE_LONG = 1, /**< The date time style: LONG is longer, such as July 18, 2012 or 3:30:32PM */
- DATE_TIME_STYLE_MEDIUM = 2, /**< The date time style: MEDIUM is a little longer, such as Jan 12, 1952 */
- DATE_TIME_STYLE_SHORT = 3, /**< The date time style: SHORT is completely numeric, such as 12/13/52 or 3:30PM */
- DATE_TIME_STYLE_DEFAULT = DATE_TIME_STYLE_MEDIUM /**< The default date time style: Medium */
+ DATE_TIME_STYLE_NONE = -1, /**< No date time style */
+ DATE_TIME_STYLE_FULL = 0, /**< The full date time style @n For example, Tuesday, April 12, 1952 AD or 3:30:42PM PST */
+ DATE_TIME_STYLE_LONG = 1, /**< The long date time style @n For example, July 18, 2012 or 3:30:32PM */
+ DATE_TIME_STYLE_MEDIUM = 2, /**< The medium date time style @n For example, Jan 12, 1952 */
+ DATE_TIME_STYLE_SHORT = 3, /**< The short date time style @n This style is completely numeric. For example, 12/13/52 or 3:30PM */
+ DATE_TIME_STYLE_DEFAULT = DATE_TIME_STYLE_MEDIUM /**< The default date time style @n This is set to Medium */
};
/**
* @return A pointer to the system locale date formatter, @n
* else @c null if an error occurs
* @param[in] style The formatting style @n
- * For example, "M/d/yy" is the short form for displaying only date in the US locale.
+ * For example, "M/d/yy" is the short form for displaying only the date in the US locale.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_UNSUPPORTED_OPERATION The current locale is not supported.
- * @exception E_INVALID_ARG The specified @c style is an invalid value.
+ * @exception E_INVALID_ARG The specified @c style is an invalid value.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static DateTimeFormatter* CreateDateFormatterN(DateTimeStyle style = DATE_TIME_STYLE_DEFAULT);
* Creates the date formatter with the specified formatting style for the specified locale.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompDateTimeFormatterCreateDateFormatterNPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompDateTimeFormatterCreateDateFormatterNPage "here".
* @endif
*
* @return A pointer to the specified locale date formatter, @n
* else @c null if an error occurs
* @param[in] locale The locale
* @param[in] style The formatting style @n
- * For example, "M/d/yy" is the short form for displaying only date in the US locale.
+ * For example, "M/d/yy" is the short form for displaying only the date in the US locale.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c locale or @c style is invalid.
+ * @exception E_INVALID_ARG The specified @c locale or @c style is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static DateTimeFormatter* CreateDateFormatterN(const Locale& locale, DateTimeStyle style = DATE_TIME_STYLE_DEFAULT);
/**
* @if OSPCOMPAT
- * @page CompDateTimeFormatterCreateDateFormatterNPage Compatibility for CreateDateFormatterN()
- * @section CompDateTimeFormatterCreateDateFormatterNIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the @c locale is invalid.
- *
- * @section CompDateTimeFormatterCreateDateFormatterNtSolutionSection Resolutions
- * This issue has been resolved in Tizen.
+ * @page CompDateTimeFormatterCreateDateFormatterNPage Compatibility for CreateDateFormatterN()
+ * @section CompDateTimeFormatterCreateDateFormatterNIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns E_UNSUPPORTED_OPERATION if the @c locale is invalid.
+ *
+ * @section CompDateTimeFormatterCreateDateFormatterNtSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
* @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the @c locale or @c style is invalid.
+ * -# The method returns E_INVALID_ARG if the @c locale or @c style is invalid.
* @endif
- */
+ */
/**
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_UNSUPPORTED_OPERATION The current locale is not supported.
- * @exception E_INVALID_ARG The specified @c style is invalid.
+ * @exception E_INVALID_ARG The specified @c style is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static DateTimeFormatter* CreateTimeFormatterN(DateTimeStyle style = DATE_TIME_STYLE_DEFAULT);
* Creates the time formatter with the specified formatting style for the specified @c locale.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompDateTimeFormatterCreateTimeFormatterNPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompDateTimeFormatterCreateTimeFormatterNPage "here".
* @endif
*
* @return A pointer to the specified locale time formatter, @n
* For example, "h:mm a" is the short form for displaying the 12-hour time format in the US locale.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c locale or @c style is invalid.
+ * @exception E_INVALID_ARG The specified @c locale or @c style is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static DateTimeFormatter* CreateTimeFormatterN(const Locale& locale, DateTimeStyle style = DATE_TIME_STYLE_DEFAULT);
/**
* @if OSPCOMPAT
- * @page CompDateTimeFormatterCreateTimeFormatterNPage Compatibility for CreateTimeFormatterN()
- * @section CompDateTimeFormatterCreateTimeFormatterNIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the @c locale is invalid.
- *
- * @section CompGrDateTimeFormatterCreateTimeFormatterNSolutionSection Resolutions
- * This issue has been resolved in Tizen.
- * @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the @c locale or @c style is invalid.
+ * @page CompDateTimeFormatterCreateTimeFormatterNPage Compatibility for CreateTimeFormatterN()
+ * @section CompDateTimeFormatterCreateTimeFormatterNIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns E_UNSUPPORTED_OPERATION if the @c locale is invalid.
+ *
+ * @section CompGrDateTimeFormatterCreateTimeFormatterNSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
+ * @par When working in Tizen:
+ * -# The method returns E_INVALID_ARG if the @c locale or @c style is invalid.
* @endif
- */
+ */
/**
* Creates the date/time formatter with the specified formatting style for the system locale.
* @return A pointer to the system locale date/time formatter, @n
* else @c null if an error occurs
* @param[in] dateStyle The date formatting style @n
- * For example, "M/d/yy" is the short form for displaying only date in the US locale.
+ * For example, "M/d/yy" is the short form for displaying only the date in the US locale.
* @param[in] timeStyle The time formatting style @n
* For example, "h:mm a" is the short form for displaying the 12-hour time format in the US locale.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_UNSUPPORTED_OPERATION The current locale is not supported.
- * @exception E_INVALID_ARG The specified @c dateStyle or @c timeStyle is invalid.
+ * @exception E_INVALID_ARG The specified @c dateStyle or @c timeStyle is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static DateTimeFormatter* CreateDateTimeFormatterN(DateTimeStyle dateStyle = DATE_TIME_STYLE_DEFAULT, DateTimeStyle timeStyle = DATE_TIME_STYLE_DEFAULT);
* For example, "h:mm a" is the short form for displaying the 12-hour time format in the US locale.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c locale is not supported, or the @c dateStyle or the @c timeStyle is invalid.
+ * @exception E_INVALID_ARG The specified @c locale is not supported, or the @c dateStyle or the @c timeStyle is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static DateTimeFormatter* CreateDateTimeFormatterN(const Locale& locale, DateTimeStyle dateStyle = DATE_TIME_STYLE_DEFAULT, DateTimeStyle timeStyle = DATE_TIME_STYLE_DEFAULT);
/**
- * Formats a Tizen::Base::DateTime object into a date/time string and appends the resulting string to the specified string buffer.
+ * Formats a Tizen::Base::DateTime object into a date/time string and appends the resulting string to the specified string.
*
* @since 2.0
*
* @return An error code
* @param[in] date The Tizen::Base::DateTime object to format
- * @param[out] str The string to append to the resultant string
+ * @param[out] str The string to which formatted string is appended
* @exception E_SUCCESS The method is successful.
* @remarks This method does not handle the time zone information, so "z" pattern always returns "GMT+00:00".
- * @see Tizen::Base::DateTime
*/
virtual result Format(const Tizen::Base::DateTime& date, Tizen::Base::String& str) const;
*
* @return An error code
* @param[in] calendar The Calendar object to format
- * @param[out] str The string to append to the resultant string
+ * @param[out] str The string to which formatted string is appended
* @exception E_SUCCESS The method is successful.
- * @see Tizen::Base::DateTime
+ * @see Tizen::Base::DateTime
*/
virtual result Format(const Calendar& calendar, Tizen::Base::String& str) const;
*
* @since 2.0
*
- * @param[in] pattern The new date and time pattern for the date format
+ * @param[in] pattern The date and time pattern for the date format
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The length of the specified @c pattern is @c 0.
*/
/**
- * Gets a pattern string describing the date format.
+ * Gets the pattern string describing the date format.
*
* @since 2.0
*
- * @return A string describing the date format
+ * @return The date format pattern string
*/
Tizen::Base::String GetPattern(void) const;
*
* @since 2.0
*
- * @return A pointer to DateTimeSymbols for the formatter instance
+ * @return A pointer to DateTimeSymbols of the formatter
* @see SetDateTimeSymbols()
*/
const DateTimeSymbols* GetDateTimeSymbols(void) const;
/**
- * Sets the date and time format symbols of the date format.
+ * Sets the date and time format symbols of the formatter.
*
* @since 2.0
*
- * @param[in] newSymbols The new date and time format symbols
+ * @param[in] newSymbols The date and time format symbols
* @see GetDateTimeSymbols()
*/
void SetDateTimeSymbols(const DateTimeSymbols& newSymbols);
/**
* @class DateTimeSymbols
- * @brief This class provides methods that help in providing date and time symbols.
+ * @brief This class provides methods for date and time symbols.
*
* @since 2.0
*
- * The %DateTimeSymbols class is used for encapsulating localizable date-time formatting data, such as the names of the months, the days of the week, and the time zone data.
- * It is also used by DateTimeFormatter.
- * %DateTimeSymbols specifies the exact character strings to use for various parts of a date or time. For example, the names of the months and days of the week, the strings for AM and PM, and the day of the week considered to be the first day of the week.
+ * The %DateTimeSymbols class is used for encapsulating localizable date-time formatting data, such as the names of the months,
+ * the days of the week, and the time zone data. It is also used by DateTimeFormatter.
+ * %DateTimeSymbols specifies the exact character strings to use for various parts of a date or time. For example, the names of
+ * the months and days of the week, the strings for AM and PM, and the day of the week considered to be the first day of the week.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/locales/datetime_formatter.htm">Date and Time Formatter</a>.
*
public:
/**
* This is the default constructor for this class. @n
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. For full construction, the Construct() method
+ * must be called right after calling this constructor.
*
* @since 2.0
- *
- * @see Construct()
*/
DateTimeSymbols(void);
* Initializes this instance of %DateTimeSymbols with the specified @c locale and @c calendarType.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompDateTimeSymbolsConstructPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompDateTimeSymbolsConstructPage "here".
* @endif
*
* @return An error code
* @param[in] calendarType The calendar type
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c locale or @c calendarType is invalid.
+ * @exception E_INVALID_ARG The specified @c locale or @c calendarType is invalid.
*/
result Construct(const Locale& locale, CalendarType calendarType = CALENDAR_GREGORIAN);
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompDateTimeSymbolsConstructPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompDateTimeSymbolsConstructPage "here".
* @endif
*
* @return An error code
* @param[in] calendarType The calendar type
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c calendarType is invalid.
+ * @exception E_INVALID_ARG The specified @c calendarType is invalid.
*/
result Construct(CalendarType calendarType);
/**
* @if OSPCOMPAT
- * @page CompDateTimeSymbolsConstructPage Compatibility for Construct()
- * @section CompDateTimeSymbolsConstructIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the @c calendarType is invalid.
- *
- * @section CompDateTimeSymbolsConstructSolutionSection Resolutions
- * This issue has been resolved in Tizen.
- * @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the @c calendarType is invalid.
+ * @page CompDateTimeSymbolsConstructPage Compatibility for Construct()
+ * @section CompDateTimeSymbolsConstructIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns E_UNSUPPORTED_OPERATION if the @c calendarType is invalid.
+ *
+ * @section CompDateTimeSymbolsConstructSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
+ * @par When working in Tizen:
+ * -# The method returns E_INVALID_ARG if the @c calendarType is invalid.
* @endif
- */
+ */
/**
/**
* Sets the era strings. @n
- * Multiple strings can be concatenated by '|'. For example: "AD|BC".
+ * Multiple strings can be concatenated using '|'. For example: "AD|BC".
*
* @since 2.0
*
* @return An error code
- * @param[in] eras The era strings concatenated by '|'
+ * @param[in] eras The era strings concatenated using '|'
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c eras contains an invalid value.
* @see GetEras()
/**
* Gets the list of the month name strings. @n
- * For example: "January", "February", etc.
+ * For example: "January", "February".
*
* @since 2.0
*
/**
- * Sets the month name strings concatenated by '|'. @n
+ * Sets the month name strings concatenated using '|'. @n
* For example: "January|February|March|April|May|June|July|August|September|October|November|December".
*
* @since 2.0
*
* @return An error code
- * @param[in] months The new month strings concatenated by '|'
+ * @param[in] months The month strings concatenated using '|'
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c months contains an invalid value.
* @see GetMonths()
/**
* Gets the list of the short month name strings. @n
- * For example: "Jan", "Feb", etc.
+ * For example: "Jan", "Feb".
*
* @since 2.0
*
/**
- * Sets the short month name strings concatenated by '|'. @n
+ * Sets the short month name strings concatenated using '|'. @n
* For example: "Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec".
*
- * @since 2.0
+ * @since 2.0
* @return An error code
- * @param[in] shortMonths The new short month name strings concatenated by '|'
+ * @param[in] shortMonths The short month name strings concatenated using '|'
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c shortMonths contains an invalid value. @n See the valid string in the description of the method.
- * @see GetShortMonths()
+ * @exception E_INVALID_ARG The specified @c shortMonths contains an invalid value. @n
+ * See the valid string in the description of the method.
+ * @see GetShortMonths()
*/
result SetShortMonths(const Tizen::Base::String& shortMonths);
/**
* Gets the list of the weekday name strings. @n
- * For example: "Sunday", "Monday", etc.
+ * For example: "Sunday", "Monday".
*
* @since 2.0
*
* @since 2.0
*
* @return An error code
- * @param[in] weekdays The new weekday name strings concatenated by '|'
+ * @param[in] weekdays The weekday name strings concatenated using '|'
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c weekdays contains an invalid value.
* @see GetWeekdays()
/**
* Gets the list of the short weekday name strings. @n
- * For example: "Sun", "Mon", etc.
+ * For example: "Sun", "Mon".
*
* @since 2.0
*
/**
- * Sets the weekday name strings concatenated by '|'. @n
+ * Sets the weekday name strings concatenated using '|'. @n
* For example: "Sun|Mon|Tue|Wed|Thu|Fri|Sat".
*
* @since 2.0
*
* @return An error code
- * @param[in] shortWeekdays The new short weekday strings concatenated by '|'
+ * @param[in] shortWeekdays The short weekday strings concatenated using '|'
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c shortWeekdays contains an invalid value.
* @see GetShortWeekdays()
/**
- * Sets the AM/PM strings concatenated by '|'. @n
+ * Sets the AM/PM strings concatenated using '|'. @n
* For example: "AM|PM".
*
* @since 2.0
*
* @return An error code
- * @param[in] amPm The new AM/PM strings concatenated by '|'
+ * @param[in] amPm The AM/PM strings concatenated using '|'
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c amPm contains an invalid value.
* @see GetAmPm()
* Gets the name of the time zone. @n
* For example: "Eastern European Time (EET)", "Eastern European Summer Time (EEST)".
*
- * @since 2.0
+ * @since 2.0
*
- * @return The time zone name, @n
- * else an empty string if @c timeZoneId is not found @n
- * or the time zone name of @c timeZoneStyle is not found.
+ * @return The time zone name, @n
+ * else an empty string if @c timeZoneId is not found @n
+ * or the time zone name of @c timeZoneStyle is not found.
* @param[in] timeZoneId The time zone ID
* @param[in] timeZoneStyle The parameter may contain one of the following time zone styles:
* @li The normal time zone (0)
* @return An error code
* @param[in] timeZoneId The time zone ID @n
* For example: "Europe/Helsinki".
- * @param[in] concatenatedTimeZoneName The new concatenated time zone name @n
+ * @param[in] concatenatedTimeZoneName The concatenated time zone name @n
* For example, "Eastern European Time|EET|Eastern European Summer Time|EEST".
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c timeZoneId or @c concatenatedTimeZoneName contains an invalid value.
* @exception E_OBJ_NOT_FOUND The specified @c timeZoneId is not found.
- * @see GetTimeZoneName()
- * @see AddTimeZoneName()
+ * @see GetTimeZoneName()
+ * @see AddTimeZoneName()
*/
result SetTimeZoneName(const Tizen::Base::String& timeZoneId, const Tizen::Base::String& concatenatedTimeZoneName);
/**
- * Adds a new time zone name string that is related to time zone ID.
+ * Adds the time zone name that is related to time zone ID.
*
* @since 2.0
*
/**
* @class GregorianCalendar
- * @brief This class is a concrete subclass of calendar and provides the Gregorian calendar that is the most commonly used standard calendar.
+ * @brief This class is a concrete subclass of calendar and provides the Gregorian calendar that is the most commonly used
+ * standard calendar.
*
* @since 2.0
*
- * @final This class is not intended for extension.
+ * @final This class is not intended for extension.
*
* The %GregorianCalendar class is a concrete subclass of calendar and provides the Gregorian calendar that is the most commonly used standard calendar.
*
public:
/**
* This is the default constructor for this class. @n
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must
+ * be called right after calling this constructor.
*
* @since 2.0
- *
- * @see Construct()
*/
GregorianCalendar(void);
/**
- * Initializes this instance of %GregorianCalendar with the current GMT time zone and the system locale.
- * The time zone is used for the zone offset and the DST offset.
- * An instance has weekdata which are the first of week, minimal days in the first week, weekend on set and weekend cease.
- * The weekdata are set as default values by the locale.
- *
- * @since 2.0
- *
- * @return An error code
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- */
+ * Initializes this instance of %GregorianCalendar with the current GMT time zone and the system locale. @n
+ * The time zone is used for the zone offset and the DST offset.
+ * An instance has weekdata which is the first of week, minimal days in the first week, weekend on set and weekend cease.
+ * The weekdata is set to default values by the locale.
+ *
+ * @since 2.0
+ *
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ */
result Construct(void);
/**
* Initializes this instance of %GregorianCalendar based on the current time in the specified time zone with the system locale. @n
* The @c timeZone is used for the zone offset and the DST offset.
- * An instance has weekdata which are the first of week, minimal days in the first week, weekend on set, and weekend cease.
- * The weekdata are set as default values by the locale.
+ * An instance has weekdata which is the first of week, minimal days in the first week, weekend on set, and weekend cease.
+ * The weekdata is set to default values by the locale.
*
* @since 2.0
*
/**
* Initializes this instance of %GregorianCalendar based on the current time in the GMT time zone with the specified @c locale.
* The time zone is used for the zone offset and the DST offset.
- * An instance has weekdata which are the first of week, minimal days in the first week, weekend on set, and weekend cease.
- * The weekdata are set as default values by the specified @c locale.
+ * An instance has weekdata which is the first of week, minimal days in the first week, weekend on set, and weekend cease.
+ * The weekdata is set to default values by the specified @c locale.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompGregorianCalendarConstructPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompGregorianCalendarConstructPage "here".
* @endif
*
* @return An error code
- * @param[in] locale An instance of Locale
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c locale is invalid.
+ * @param[in] locale An instance of Locale
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG The specified @c locale is invalid.
*/
result Construct(const Locale& locale);
/**
* Initializes this instance of %GregorianCalendar based on the current time in the specified time zone with the specified system locale. @n
* The @c timeZone is used for the zone offset and the DST offset.
- * An instance has weekdata which are the first of week, minimal days in the first week, weekend on set, and weekend cease.
- * The weekdata are set as default values by the specified @c locale.
+ * An instance has weekdata which is the first of week, minimal days in the first week, weekend on set, and weekend cease.
+ * The weekdata is set to default values by the specified @c locale.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompGregorianCalendarConstructPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompGregorianCalendarConstructPage "here".
* @endif
*
* @return An error code
* @param[in] locale An instance of Locale
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c locale is invalid.
+ * @exception E_INVALID_ARG The specified @c locale is invalid.
*/
result Construct(const TimeZone& timeZone, const Locale& locale);
/**
* @if OSPCOMPAT
- * @page CompGregorianCalendarConstructPage Compatibility for Construct()
- * @section CompGregorianCalendarConstructIssueSection Issues
+ * @page CompGregorianCalendarConstructPage Compatibility for Construct()
+ * @section CompGregorianCalendarConstructIssueSection Issues
* Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the @c locale is invalid.
+ * -# The method returns @c E_UNSUPPORTED_OPERATION if the @c locale is invalid.
*
- * @section CompGregorianCalendarConstructSolutionSection Resolutions
+ * @section CompGregorianCalendarConstructSolutionSection Resolutions
* This issue has been resolved in Tizen.
* @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the @c locale is invalid.
+ * -# The method returns @c E_INVALID_ARG if the @c locale is invalid.
* @endif
*/
* Initializes this instance of %GregorianCalendar based on the specified @c year, @c month, @c day, @c hour, @c minute, and @c second
* in the GMT time zone with the system locale. @n
* The time zone is used for the zone offset and the DST offset.
- * An instance has weekdata which are the first of week, minimal days in the first week, weekend on set, and weekend cease.
- * The weekdata are set as default values by the locale.
- * The Gregorian calendar is lenient: time fields are normalized when the user calls the Calendar::GetTimeField() method.
+ * An instance has weekdata which is the first of week, minimal days in the first week, weekend on set, and weekend cease.
+ * The weekdata is set to default values by the locale.
+ * The Gregorian calendar is lenient; time fields are normalized when the user calls the Calendar::GetTimeField() method.
*
* @since 2.0
*
* @return An error code
- * @param[in] year An integer value used to set the year time field
- * @param[in] month An integer value used to set the month time field @n
+ * @param[in] year The year value
+ * @param[in] month The month value @n
* The indexing is 1-based. Therefore, 1 means January.
- * @param[in] day An integer value used to set the date time field
- * @param[in] hour An integer value used to set the hour time field
- * @param[in] minute An integer value used to set the minute time field
- * @param[in] second An integer value used to set the second time field
+ * @param[in] day The date value
+ * @param[in] hour The hour value
+ * @param[in] minute The minute value
+ * @param[in] second The second value
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG An argument is invalid.
+ * @exception E_INVALID_ARG A specified argument is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_OUT_OF_RANGE In this method, time fields of this instance are calculated. @n
- * If the value of the time fields goes out of range, this exception is returned.
+ * @exception E_OUT_OF_RANGE In this method, the time fields of this instance are calculated. @n
+ * If the value of the time fields go out of range, this exception is returned.
*/
result Construct(int year, int month, int day, int hour = 0, int minute = 0, int second = 0);
/**
* Initializes this instance of %GregorianCalendar based on the specified date and time in the GMT time zone with the system locale. @n
* The time zone is used for the zone offset and the DST offset.
- * An instance has weekdata which are the first of week, minimal days in the first week, weekend on set, and weekend cease.
- * The weekdata are set as default values by the locale.
+ * An instance has weekdata which is the first of week, minimal days in the first week, weekend on set, and weekend cease.
+ * The weekdata is set to default values by the locale.
*
* @since 2.0
*
* @param[in] dateTime An instance of Tizen::Base::DateTime
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c dateTime is invalid.
- * @exception E_OUT_OF_RANGE In this method, time fields of this instance are calculated. @n
- * If the value of the time fields goes out of range, this exception is returned.
+ * @exception E_INVALID_ARG The specified @c dateTime is invalid.
+ * @exception E_OUT_OF_RANGE In this method, the time fields of this instance are calculated. @n
+ * If the value of the time fields go out of range, this exception is returned.
*/
result Construct(const Tizen::Base::DateTime& dateTime);
/**
* Adds the specified amount to the specified time field, based on the calendar rules. @n
- * It is equivalent to calling Set(field, GetTimeField(field)+amount) with two adjustments. @n
+ * It is equivalent to calling Set(field, GetTimeField(field)+amount) with the following two adjustments: @n
*
- * @b Add @b Rule1: The value of @c field after the call minus the value of @c field before the call is delta, modulo any overflow that has occurred in @c field.
- * Overflow occurs when the @c field value exceeds its range and, as a result, the next larger field is incremented or decremented and the @c field value is adjusted back into its range. @n
+ * @b Add @b Rule1: The value of @c field after the call minus the value of @c field before the call is delta, modulo any
+ * overflow that has occurred in @c field. Overflow occurs when the @c field value exceeds its range and, as a result,
+ * the next larger field is incremented or decremented and the @c field value is adjusted back into its range. @n
*
- * @b Add @b Rule2: If a smaller field is expected to be invariant, but it is impossible for it to be equal to its prior value because of
- * changes in its minimum or maximum value after the @c field value is changed, then its value is adjusted to the closest possible value. @n
+ * @b Add @b Rule2: If a smaller field is expected to be invariant, but it is impossible for it to be equal to its prior
+ * value because of changes in its minimum or maximum value after the @c field value is changed, then its value is adjusted
+ * to the closest possible value. @n
*
- * A smaller field represents a smaller unit of time. The TIME_FIELD_HOUR field is smaller than the TIME_FIELD_DAY_OF_MONTH field.
+ * A smaller field represents a smaller unit of time. The @c TIME_FIELD_HOUR field is smaller than the @c TIME_FIELD_DAY_OF_MONTH field.
* No adjustment is made to smaller fields that are not expected to be invariant.
* The calendar system determines what fields are expected to be invariant. @n
*
- * In addition, this method forces re-computation of the calendar's milliseconds and all time fields immediately.
+ * In addition, this method forces re-computation of the calendar's milliseconds and all the time fields immediately.
* @n
- * For example, consider a %GregorianCalendar set to Oct. 31. 2004. Calling AddTimeField(TIME_FIELD_MONTH, 13) sets the calendar to Nov. 30. 2005.
- * The TIME_FIELD_MONTH field is set to TIME_FIELD_NOVEMBER by @b Rule1, since adding 13 months to October gives November of the next year. Since
- * the TIME_FIELD_DAY_OF_MONTH cannot be 31 in November in a %GregorianCalendar, TIME_FIELD_DAY_OF_MONTH is set to 30 by @b Rule2.
+ * For example, consider a %GregorianCalendar set to Oct. 31. 2004. Calling AddTimeField(@c TIME_FIELD_MONTH, 13) sets the calendar to Nov. 30. 2005.
+ * The @c TIME_FIELD_MONTH field is set to @c TIME_FIELD_NOVEMBER by @b Rule1, since adding 13 months to October gives the month
+ * value as November of the next year. Since the @c TIME_FIELD_DAY_OF_MONTH cannot be 31 in November in a %GregorianCalendar,
+ * @c TIME_FIELD_DAY_OF_MONTH is set to 30 by @b Rule2.
*
* @since 2.0
*
* @return An error code
- * @param[in] field The time field
- * @param[in] amount The amount to add
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c field is invalid.
- * @exception E_OUT_OF_RANGE In this method, time fields of this instance are calculated. @n
- * If the value of the time fields goes out of range, this exception is returned.
- * @remarks The TIME_FIELD_EXTENDED_YEAR and TIME_FIELD_YEAR_WOY fields cannot be added.
+ * @param[in] field The time field
+ * @param[in] amount The amount to add
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified @c field is invalid.
+ * @exception E_OUT_OF_RANGE In this method, the time fields of this instance are calculated. @n
+ * If the value of the time fields go out of range, this exception is returned.
+ * @remarks The @c TIME_FIELD_EXTENDED_YEAR and @c TIME_FIELD_YEAR_WOY fields cannot be added.
*/
virtual result AddTimeField(TimeField field, int amount);
* @since 2.0
*
* @return An integer value indicating the actual minimum value
- * @param[in] field The time field
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified time field is invalid.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @param[in] field The time field
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified time field is invalid.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual int GetActualMinTimeField(TimeField field) const;
* @since 2.0
*
* @return An integer value indicating the actual maximum value
- * @param[in] field The time field
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified time field is invalid.
-
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @param[in] field The time field
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified time field is invalid.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual int GetActualMaxTimeField(TimeField field) const;
- /*
+ /**
* Gets the Gregorian Calendar change date. @n
* This is the point when the switch from Julian dates to Gregorian dates occurred.
- * Default is 00:00:00 local time, October 15, 1582. Previous to this the time and date are Julian dates.
+ * Default is 00:00:00 local time, October 15, 1582. Previous to this, the time and date are Julian dates.
*
* @since 2.0
*
- * @return The milliseconds which is the Gregorian cutover time for this calendar
+ * @return The Gregorian cutover time for this calendar in milliseconds
*/
long long GetGregorianChange(void) const;
* @since 2.0
*
* @return An instance of CalendarType representing the calendar type of the current instance of Calendar @n
- * In this case, CALENDAR_GREGORIAN.
+ * In this case, @c CALENDAR_GREGORIAN.
*/
virtual CalendarType GetType(void) const;
* @param[out] isInDst Set to @c true if the current date is in DST, @n
* else @c false
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_RANGE In this method, time fields of this instance are calculated. @n
- * If the value of the time fields goes out of range, this exception is returned.
- * @exception E_INVALID_STATE In this method, time fields of this instance are calculated. @n
- * If any time field value previously set is invalid, this exception is returned.
+ * @exception E_OUT_OF_RANGE In this method, time fields of this instance are calculated. @n
+ * If the value of the time fields go out of range, this exception is returned.
+ * @exception E_INVALID_STATE In this method, time fields of this instance are calculated. @n
+ * If any time field value previously set is invalid, this exception is returned.
*/
virtual result IsInDst(bool& isInDst) const;
bool IsLeapYear(int year) const;
- /*
+ /**
* Sets the Gregorian Calendar change date. @n
* This is the point when the switch from Julian dates to Gregorian dates occurred.
* Default is 00:00:00 local time, Oct 15, 1582. Previous to this, dates are in the Julian calendar.
*
- * To obtain a pure Julian calendar, set the change @c change to MAX_MILLISECOND.
- * To obtain a pure Gregorian calendar, set the change @c change to MIN_MILLISECOND.
+ * To obtain a pure Julian calendar, set @c change to @c MAX_MILLISECOND.
+ * To obtain a pure Gregorian calendar, set @c change to @c MIN_MILLISECOND.
*
* @since 2.0
*
* @return An error code
- * @param[in] change The given Gregorian cutover date
+ * @param[in] change The Gregorian cutover date
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*/
/**
* Rolls up or down as per the specified amount in the specified field. @n
- * This method overrides Calendar(). @n
+ * This method overrides Calendar().Roll(TimeField, int). @n
* For more details, refer to Tizen::Locales::Calendar::Roll(TimeField, int).
*
* @since 2.0
* @param[in] amount The amount to roll up/down
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE In this method, time fields of this instance are calculated. @n
- * If any time field value previously set is invalid, this exception is returned.
- * @exception E_INVALID_ARG The specified @c field is invalid (for example, TIME_FIELD_DST_OFFSET, TIME_FIELD_ZONE_OFFSET).
- * @exception E_OUT_OF_RANGE In this method, time fields of this instance are calculated. @n
- * If the value of the time fields goes out of range, this exception is returned.
+ * If any time field value previously set is invalid, this exception is returned.
+ * @exception E_INVALID_ARG The specified @c field is invalid (for example, @c TIME_FIELD_DST_OFFSET, @c TIME_FIELD_ZONE_OFFSET).
+ * @exception E_OUT_OF_RANGE In this method, time fields of this instance are calculated. @n
+ * If the value of the time fields go out of range, this exception is returned.
*/
virtual result Roll(TimeField field, int amount);
- /*
- * Gets the millisecond which is midnight, local time at or before the Gregorian cutover.
+ /**
+ * Gets the midnight, local time at or before the Gregorian cutover in milliseconds.
*
* @since 2.0
*
- * @return The millisecond which is midnight, local time at or before the Gregorian cutover
- * If this method fails, @c -1 is returned.
+ * @return The midnight, local time at or before the Gregorian cutover in milliseconds. @n
+ * If this method fails, @c -1 is returned. @n
* The specific error code can be accessed using the GetLastResult() method.
*/
long long GetNormalizedGregorianCutover(void) const;
- /*
+ /**
* Gets the year of the Gregorian cutover, with @c 0 representing 1 BC, @c -1 representing 2 BC, and so on.
*
* @since 2.0
*
- * @return The year of the Gregorian cutover
- * If this method fails, @c -1 is returned.
+ * @return The year of the Gregorian cutover @n
+ * If this method fails, @c -1 is returned. @n
* The specific error code can be accessed using the GetLastResult() method.
*/
int GetGregorianCutoverYear(void) const;
- /*
+ /**
* Gets the Julian day number of the Gregorian cutover.
*
* @since 2.0
int GetCutoverJulianDay(void) const;
- /*
+ /**
* Checks whether the current calendar is a Gregorian calendar or not.
*
* @since 2.0
public:
/*
- * Defines the length of months.
+ * The length of months.
*
* @since 2.0
*/
static const int MONTH_LENGTH[24];
/*
- * Defines the days of a year.
+ * The days of a year.
*
* @since 2.0
*/
* @enum LanguageCode
*
* Defines the ISO 639-2 language code. @n
- * The LanguageCode enumerator represents the ISO 639-2 language codes. @n
+ * This enum represents the ISO 639-2 language codes. @n
* The specific LanguageCode represents the language code with the locale's ISO-15924 abbreviation script code. @n
* The supported ISO-15924 script codes are Arabic, Cyrillic, Latin, Hans, Hant and Gurmukhi.
*
* @enum CountryCode
*
* Defines the ISO 3166-1 alpha-2 country code. @n
- * The CountryCode enumerator represents the ISO 3166-1 alpha-2 country codes.
- * The area code for Latin america and the Caribbean represents the ISO 3166-1 numeric-3.
+ * This enum represents the ISO 3166-1 alpha-2 country codes.
+ * The area code for Latin america and the Caribbean represents the ISO 3166-1 numeric-3 code.
*
* @since 2.0
*/
*
* @final This class is not intended for extension.
*
- * @remarks For more information on the example codes for %Locale class, see LocaleManager.
+ * @remarks For more information on the example codes for the %Locale class, see LocaleManager.
*
* The %Locale class represents a specific geographical, political, or cultural region. @n
* A %Locale object has three attributes:
*
* @since 2.0
*
- * @param[in] languageCode The language code
- * @param[in] countryCode The country code
- * @param[in] pVariantCodeString A pointer to the variant code string @n
- * It is converted to a uppercase letter if it is written in a lowercase letter.
+ * @param[in] languageCode The language code
+ * @param[in] countryCode The country code
+ * @param[in] pVariantCodeString A pointer to the variant code string @n
+ * It is converted to upper case letters if it is written in lower case letters.
*/
Locale(LanguageCode languageCode, CountryCode countryCode, const Tizen::Base::String* pVariantCodeString = null);
* Assigns the value of the specified instance to the current instance of %Locale. @n
* Copying of objects using this copy assignment operator is allowed.
*
- * @since 2.0
+ * @since 2.0
*
* @return A reference to the current instance of %Locale
- * @param[in] otherLocale An instance of %Locale
+ * @param[in] otherLocale An instance of %Locale
*/
Locale& operator =(const Locale& otherLocale);
/**
* Compares the current instance of %Locale with the specified instance of %Locale.
*
- * @since 2.0
+ * @since 2.0
*
* @return @c true if the value of the specified instance is equal to the value of the current instance, @n
* else @c false
- * @param[in] otherLocale An instance of %Locale
+ * @param[in] otherLocale An instance of %Locale
*/
bool operator ==(const Locale& otherLocale) const;
bool operator !=(const Locale& otherLocale) const;
/**
- * Converts the operand @c obj to an object of the %Locale type and then compares it with the current instance of %Locale.
+ * Converts the operand @c obj to an object of the %Locale type and compares it with the current instance of %Locale.
*
* @since 2.0
*
* @return @c true if the value of the current instance is equal to the value of the specified Tizen::Base::Object, @n
* else @c false
- * @param[in] obj The object to compare with the current instance
- * @see Tizen::Base::Object::Equals()
+ * @param[in] obj The object to compare with the current instance
+ * @see Tizen::Base::Object::Equals()
*/
virtual bool Equals(const Object& obj) const;
* @since 2.0
*
* @return The language code, @n
- * The specific language code string has the locale's ISO-15924 abbreviation script code.
+ * The specific language code string has the locale's ISO-15924 abbreviation script code.
*/
Tizen::Base::String GetLanguageCodeString(void) const;
*
* @since 2.0
*
- * @return The variant code string written in a uppercase letter even if it was set to a lowercase letter, @n
+ * @return The variant code string in upper case letters even if it was set to lower case letters, @n
* else an empty string if the variant is not specified
* @see SetVariantCodeString()
*/
* Gets the string representing the current instance of %Locale. @n
* The string consists of the values returned by GetLanguageCodeString(), GetCountryCodeString(), and GetVariantCodeString() assembled into a string.
*
- * @since 2.0
+ * @since 2.0
*
- * @return A concatenated string with the language code string, country code string, and variant string @n
- * For example, if the language code is LANGUAGE_ENG, country code is COUNTRY_US, and variant string is empty, @n
+ * @return The concatenated string with the language code string, country code string, and variant string @n
+ * For example, if the language code is ::LANGUAGE_ENG, country code is ::COUNTRY_US, and variant string is empty, @n
* the locale code string is "eng_US".
- * @see GetLanguageCodeString()
- * @see GetCountryCodeString()
- * @see GetVariantCodeString()
*/
Tizen::Base::String GetLocaleCodeString(void) const;
/**
- * Gets the country name of the current instance of %Locale that is appropriate for display to the user. @n
+ * Gets the country name of the current instance of %Locale that is appropriate for display. @n
* The name is localized for this locale. For example, if this locale is eng_US, the name is "United States".
*
* @since 2.0
*
* @return An error code
- * @param[out] countryName The country name of the locale
- * @exception E_SUCCESS The method is successful.
- * @exception E_UNSUPPORTED_OPERATION The current @c locale does not have country name entry in the database.
+ * @param[out] countryName The country name of the locale
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_UNSUPPORTED_OPERATION The current @c locale does not have a country name entry in the database.
*/
result GetCountryName(Tizen::Base::String& countryName) const;
/**
- * Gets the country name of the current instance of %Locale that is appropriate for display to the user in the specified %Locale. @n
+ * Gets the country name of the current instance of %Locale that is appropriate for display in the specified %Locale. @n
* The country name is localized for the specified locale(@c otherLocale). For example, if
* the current instance of %Locale is fra_FR and the @c otherLocale is eng_US, the name is "France";
* if the current instance is eng_US and the @c otherLocale is fra_FR, the name returned is "Etats-Unis".
* @since 2.0
*
* @return An error code
- * @param[in] otherLocale An instance of %Locale according to which the country name of the specified %Locale is displayed
- * @param[out] countryName The country name of the locale
- * @exception E_SUCCESS The method is successful.
- * @exception E_UNSUPPORTED_OPERATION The specified @c locale is not supported, or the current @c locale does not have country name entry in the database.
+ * @param[in] otherLocale An instance of %Locale to display the country name
+ * @param[out] countryName The country name of the locale
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c locale is not supported, or the current @c locale does not have a country name entry in the database.
*/
result GetCountryName(const Locale& otherLocale, Tizen::Base::String& countryName) const;
/**
- * Gets the language name of the current instance of %Locale that is appropriate for display to the user. @n
- * The name is localized for the locale. For example, if this locale is
- * eng_US, the name is "English".
+ * Gets the language name of the current instance of %Locale that is appropriate for display. @n
+ * The name is localized for the locale. For example, if this locale is eng_US, the name is "English".
*
* @since 2.0
*
* @return An error code
- * @param[out] languageName The language name of the locale
- * @exception E_SUCCESS The method is successful.
- * @exception E_UNSUPPORTED_OPERATION The current @c locale does not have country name entry in the database.
+ * @param[out] languageName The language name of the locale
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_UNSUPPORTED_OPERATION The current @c locale does not have a country name entry in the database.
*/
result GetLanguageName(Tizen::Base::String& languageName) const;
/**
- * Gets the language name of the current instance of %Locale that is appropriate for display to the user in the specified %Locale. @n
+ * Gets the language name of the current instance of %Locale that is appropriate for display in the specified %Locale. @n
* The name is localized for the specified locale (@c otherLocale). For example, if
* the current instance is fra_FR and the @c otherLocale is eng_US, the name is "French";
* if the current instance is engUS and the @c otherLocale is fra_FR, the name returned is "anglais".
* @since 2.0
*
* @return An error code
- * @param[in] otherLocale An instance of %Locale according to which the language name of the specified %Locale is displayed
- * @param[out] languageName The language name of the locale
- * @exception E_SUCCESS The method is successful.
+ * @param[in] otherLocale An instance of %Locale to display the language name
+ * @param[out] languageName The language name of the locale
+ * @exception E_SUCCESS The method is successful.
* @exception E_UNSUPPORTED_OPERATION The specified @c locale is not supported, or the current @c locale does not have country name entry in the database.
*/
result GetLanguageName(const Locale& otherLocale, Tizen::Base::String& languageName) const;
/**
* Sets the variant code with the specified variant code string. @n
- * The variant code string is converted to a uppercase letter even if it is set to a lowercase letter.
+ * The variant code string is converted to upper case letters even if it is set to lower case letters.
*
* @since 2.0
*
- * @param[in] pVariantCode A pointer to the variant code
+ * @param[in] pVariantCode The pointer to the variant code
*/
void SetVariantCodeString(const Tizen::Base::String* pVariantCode = null);
* @since 2.0
*
* @param[in] languageCodeString The language code, @n
- * To get the specified LanguageCode with the locale's ISO-15924 abbreviation script code, @n
- * the form of languageCodeString should combine the ISO 639-2 language codes and the locale's ISO-15924 abbreviation script code by "-". @n
- * For example, if the language code is "aze" and the script code is "latn", @n
- * the languageCodeString is "aze-latn", and the LanguageCode is LANGUAGE_AZE_LATIN.
- * @return An instance of LanguageCode associated with the @c languageCodeString.
+ * To get the specified language code with the locale's ISO-15924 abbreviation script code,
+ * the form of @c languageCodeString should combine the ISO 639-2 language codes and the locale's
+ * ISO-15924 abbreviation script code by "-". @n
+ * For example, if the language code is "aze" and the script code is "latn",
+ * the @c languageCodeString is "aze-latn", and the language code is @c LANGUAGE_AZE_LATIN.
+ * @return An instance of LanguageCode associated with @c languageCodeString.
*/
static LanguageCode StringToLanguageCode(const Tizen::Base::String& languageCodeString);
/**
- * Gets the country code equivalent to the specified country code string.
+ * Gets the country code equivalent of the specified country code string.
*
* @since 2.0
*
* @param[in] countryCodeString The country code
- * @return An instance of CountryCode associated with the @c countryCodeString.
+ * @return An instance of CountryCode associated with the @c countryCodeString.
*/
static CountryCode StringToCountryCode(const Tizen::Base::String& countryCodeString);
/**
- * Gets the language code string equivalent to the specified @c languageCode.
+ * Gets the language code string equivalent of the specified @c languageCode.
*
* @since 2.0
*
* @param[in] languageCode The language code
- * @return The language code string associated with the @c languageCode, @n
- * else an empty string if languageCode is invalid.
- * @see StringToLanguageCode()
+ * @return The language code string associated with @c languageCode, @n
+ * else an empty string if @c languageCode is invalid.
+ * @see StringToLanguageCode()
*/
static Tizen::Base::String LanguageCodeToString(LanguageCode languageCode);
/**
- * Gets the country code string equivalent to the specified @c countryCode.
+ * Gets the country code string equivalent of the specified @c countryCode.
*
* @since 2.0
*
* @param[in] countryCode The country code
- * @return The ISO 3166-1 alpha-2 country code string associated with the @c countryCode, @n
- * else an empty string if countryCode is invalid.
+ * @return The ISO 3166-1 alpha-2 country code string associated with @c countryCode, @n
+ * else an empty string if @c countryCode is invalid.
*/
static Tizen::Base::String CountryCodeToString(CountryCode countryCode);
/**
- * Gets the 2-letter language code string equivalent to the specified @c languageCode.
+ * Gets the 2-letter language code string equivalent of the specified @c languageCode.
*
* @since 2.0
*
* @param[in] languageCode The language code
- * @return The ISO 639-2 language code string associated with the @c languageCode, @n
- * or The ISO 639-2 language code string with the ISO-15924 script code @n
- * if the @c languageCode represents The ISO 639-2 language code with the ISO-15924 script code, @n
- * else an empty string if languageCode is invalid.
+ * @return The ISO 639-2 language code string associated with @c languageCode, @n
+ * or the ISO 639-2 language code string with the ISO-15924 script code if the @c languageCode represents
+ * the ISO 639-2 language code with the ISO-15924 script code, @n
+ * else an empty string if @c languageCode is invalid.
*/
static Tizen::Base::String LanguageCodeToTwoLetterLanguageCodeString(LanguageCode languageCode);
/**
- * Gets the language code equivalent to the specified 2-letter language code string.
+ * Gets the language code equivalent of the specified 2-letter language code string.
*
* @since 2.0
*
* @param[in] languageCodeString The language code string
- * @return An instance of LanguageCode associated with the @c languageCodeString.
- * @see StringToLanguageCode()
+ * @return An instance of LanguageCode associated with @c languageCodeString.
+ * @see StringToLanguageCode()
*/
static LanguageCode TwoLetterLanguageCodeStringToLanguageCode(const Tizen::Base::String& languageCodeString);
/**
- * Gets the 3-letter country code string equivalent to the specified @c countryCode.
+ * Gets the 3-letter country code string equivalent of the specified @c countryCode.
*
* @since 2.0
*
* @param[in] countryCode The country code
- * @return The ISO 3166-1 alpha-3 country code string associated with the @c countryCode, @n
- * else an empty string if countryCode is invalid
- * @see CountryCodeToString()
- * @remarks COUNTRY_AREA_419 returns an empty string, since it is not defined in the ISO 3166-1 alpha-3.
+ * @return The ISO 3166-1 alpha-3 country code string associated with @c countryCode, @n
+ * else an empty string if @c countryCode is invalid
+ * @remarks @c COUNTRY_AREA_419 returns an empty string, since it is not defined in the ISO 3166-1 alpha-3.
+ * @see CountryCodeToString()
*/
static Tizen::Base::String CountryCodeToThreeLetterCountryCodeString(CountryCode countryCode);
/**
- * Gets the country code equivalent to the specified 3-letter country code string.
+ * Gets the country code equivalent of the specified 3-letter country code string.
*
* @since 2.0
*
* @param[in] countryCodeString The country code string
- * @return An instance of CountryCode associated with the @c countryCodeString.
- * @see StringToCountryCode()
+ * @return An instance of CountryCode associated with @c countryCodeString.
+ * @see StringToCountryCode()
*/
static CountryCode ThreeLetterCountryCodeStringToCountryCode(const Tizen::Base::String& countryCodeString);
/**
* @class LocaleManager
- * @brief This class is used for the %LocaleManager identification.
+ * @brief This class provides methods for %LocaleManager identification.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %LocaleManager class helps application programmers handle the system locale information of the device. Each device system has at least one installed locale and often has many locales from which the user can choose.
+ * The %LocaleManager class provides methods for the system locale information of the device. Each device system has at least
+ * one installed locale and often has many locales from which the user can choose.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/locales/lang_country_codes.htm">Retrieving Language and Country Codes</a>.
public:
/**
* This is the default constructor for this class. @n
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. For full construction, the Construct()
+ * method must be called right after calling this constructor.
*
* @since 2.0
*
- * @see Construct()
- *
*/
LocaleManager(void);
*
* @since 2.0
*
- * @return An instance of Locale
+ * @return The system locale
* @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * The resulting Locale instance is Locale (LANGUAGE_INVALID, COUNTRY_INVALID).
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - The resulting Locale instance is Locale(@c LANGUAGE_INVALID, @c COUNTRY_INVALID).
*/
Locale GetSystemLocale(void) const;
/**
- * Gets a list of all the available locales.
+ * Gets the list of all the available locales.
*
* @since 2.0
*
- * @return A list of Locale instances, @n
- * else @c null if the method fails
+ * @return The list of available locales, @n
+ * else @c null if it fails
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The IList returned contains the list of all the locales installed on the system.
- * The specific error code can be accessed using the GetLastResult() method.
+ * @remarks
+ * - The Tizen::Base::Collection::IList returned contains the list of all the locales installed on the system.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::Collection::IList* GetAvailableLocalesN(void) const;
*
* @since 2.0
*
- * @return An instance of Tizen::Base::String (ISO 639-2 code format), @n
+ * @return The user selected language as an instance of Tizen::Base::String (ISO 639-2 code format), @n
* else empty string if the method fails
* @exception E_SUCCESS The method is successful.
* @remarks The specific error code can be accessed using the GetLastResult() method.
/**
- * Gets a list of all the available languages supported by the device, which can be different according to the target country/region of the device.
+ * Gets the list of all the available languages supported by the device, which can be different according to the target
+ * country/region of the device.
*
* @since 2.0
*
- * @return A list of Tizen::Base::String instances (ISO 639-2 code format), @n
- * else @c null if the method fails
+ * @return The list of all available languages as Tizen::Base::String instances (ISO 639-2 code format), @n
+ * else @c null if it fails
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
/**
- * Gets a list of all the available time zone IDs.
+ * Gets the list of all the available time zone IDs.
*
* @since 2.0
*
- * @return A list of Tizen::Base::String instances, @n
- * else @c null if the method fails
+ * @return The list of all available time zone IDs as Tizen::Base::String instances, @n
+ * else @c null if it fails
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
/**
- * Gets a list of all the available time zone IDs with the specified Greenwich Mean Time (GMT) offset for this time zone.
+ * Gets the list of all the available time zone IDs with the specified Greenwich Mean Time (GMT) offset for this time zone.
*
* @since 2.0
*
- * @return A list of Tizen::Base::String instances, @n
- * else @c null if the method fails
+ * @return The list of all availabke time zone IDs with the GMT offset as Tizen::Base::String instances, @n
+ * else @c null if it fails
* @param[in] rawOffset The specified GMT offset for this time zone (Daylight Saving Time (DST) is not considered) @n
* The value of @c rawOffset is in minutes.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * If there are no time zones for the specified GMT offset, an empty list is returned.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - If there are no time zones for the specified GMT offset, an empty list is returned.
*/
Tizen::Base::Collection::IList* GetAvailableTimeZonesN(int rawOffset) const;
*
* @since 2.0
*
- * The %NumberFormatter class is used to format all number formats, including decimal and real numbers, currency, and percentage for any locale. It also provides methods to determine the locales that have number formats and their names. You can write codes completely independent of the locale conventions for decimal points, thousand separators as well as of the specific decimal digits used or whether the number format is a decimal. A normal decimal number can also be displayed as a currency or as a percentage.
+ * The %NumberFormatter class is used to format all number formats, including decimal and real numbers, currency, and percentage
+ * for any locale. It also provides methods to determine the locales that have number formats and their names. You can write
+ * codes completely independent of the locale conventions for decimal points, thousand separators, the specific
+ * decimal digits used, or the number format. A normal decimal number can also be displayed as a currency or as a percentage.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/locales/num_formatter.htm">Number Formatters</a>.
*
* Creates a number formatter for the specified locale.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompNumberFormatterCreateNumberFormatterNPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompNumberFormatterCreateNumberFormatterNPage "here".
* @endif
*
- * @return A pointer to a general number formatter for the specified @c locale, @n
+ * @return A pointer to the general number formatter for the specified @c locale, @n
* else @c null if an error occurs
* @param[in] locale An instance of Locale
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c locale is invalid.
+ * @exception E_INVALID_ARG The specified @c locale is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static NumberFormatter* CreateNumberFormatterN(const Locale& locale);
/**
* @if OSPCOMPAT
- * @page CompNumberFormatterCreateNumberFormatterNPage Compatibility for CreateNumberFormatterN()
- * @section CompNumberFormatterCreateNumberFormatterNIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the @c locale is invalid.
- *
- * @section CompNumberFormatterCreateNumberFormatterNSolutionSection Resolutions
- * This issue has been resolved in Tizen.
- * @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the @c locale is invalid.
+ * @page CompNumberFormatterCreateNumberFormatterNPage Compatibility for CreateNumberFormatterN()
+ * @section CompNumberFormatterCreateNumberFormatterNIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_UNSUPPORTED_OPERATION if the @c locale is invalid.
+ *
+ * @section CompNumberFormatterCreateNumberFormatterNSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
+ * @par When working in Tizen:
+ * -# The method returns @c E_INVALID_ARG if the @c locale is invalid.
* @endif
- */
+ */
/**
* Creates a currency formatter for the default locale.
*
* @since 2.0
*
- * @return A pointer to a currency formatter for the default locale, @n
+ * @return A pointer to the currency formatter for the default locale, @n
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* Creates a currency formatter for the specified @c locale.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompNumberFormatterCreateCurrencyFormatterNPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompNumberFormatterCreateCurrencyFormatterNPage "here".
* @endif
*
- * @return A pointer to a currency formatter for the specified @c locale, @n
+ * @return A pointer to the currency formatter for the specified @c locale, @n
* else @c null if an error occurs
- * @param[in] locale An instance of Locale
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c locale is invalid.
+ * @param[in] locale An instance of Locale
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG The specified @c locale is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static NumberFormatter* CreateCurrencyFormatterN(const Locale& locale);
/**
* @if OSPCOMPAT
- * @page CompNumberFormatterCreateCurrencyFormatterNPage Compatibility for CreateCurrencyFormatterN()
- * @section CompNumberFormatterCreateCurrencyFormatterNIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the @c locale is invalid.
- *
- * @section CompNumberFormatterCreateCurrencyFormatterNSolutionSection Resolutions
- * This issue has been resolved in Tizen.
+ * @page CompNumberFormatterCreateCurrencyFormatterNPage Compatibility for CreateCurrencyFormatterN()
+ * @section CompNumberFormatterCreateCurrencyFormatterNIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_UNSUPPORTED_OPERATION if the @c locale is invalid.
+ *
+ * @section CompNumberFormatterCreateCurrencyFormatterNSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
* @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the @c locale is invalid.
+ * -# The method returns @c E_INVALID_ARG if the @c locale is invalid.
* @endif
- */
+ */
/**
* Creates a percentage formatter for the system locale.
*
* @since 2.0
*
- * @return A pointer to a percentage formatter for the default locale, @n
+ * @return A pointer to the percentage formatter for the default locale, @n
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* Creates a percentage formatter for the specified @c locale.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompNumberFormatterCreatePercentFormatterNPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompNumberFormatterCreatePercentFormatterNPage "here".
* @endif
*
- * @return A pointer to a percentage formatter for the specified @c locale, @n
+ * @return A pointer to the percentage formatter for the specified @c locale, @n
* else @c null if an error occurs
- * @param[in] locale An instance of Locale
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @param[in] locale An instance of Locale
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c locale is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static NumberFormatter* CreatePercentFormatterN(const Locale& locale);
- /**
+ /**
* @if OSPCOMPAT
- * @page CompNumberFormatterCreatePercentFormatterNPage Compatibility for CreatePercentFormatterN()
- * @section CompNumberFormatterCreatePercentFormatterNIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the @c locale is invalid.
- *
- * @section CompNumberFormatterCreatePercentFormatterNSolutionSection Resolutions
- * This issue has been resolved in Tizen.
+ * @page CompNumberFormatterCreatePercentFormatterNPage Compatibility for CreatePercentFormatterN()
+ * @section CompNumberFormatterCreatePercentFormatterNIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_UNSUPPORTED_OPERATION if the @c locale is invalid.
+ *
+ * @section CompNumberFormatterCreatePercentFormatterNSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
* @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the @c locale is invalid.
+ * -# The method returns @c E_INVALID_ARG if the @c locale is invalid.
* @endif
- */
+ */
*
* @return An error code
* @param[in] number The number of type Tizen::Base::Long to format
- * @param[out] str The string to append to the resultant string
+ * @param[out] str The string to append
* @exception E_SUCCESS The method is successful.
*/
virtual result Format(long number, Tizen::Base::String& str) const;
*
* @return An error code
* @param[in] number The number of type Tizen::Base::Double to format
- * @param[out] str The string to append to the resultant string
+ * @param[out] str The string to append
* @exception E_SUCCESS The method is successful.
*/
virtual result Format(double number, Tizen::Base::String& str) const;
* @remarks The initial value is derived in a locale dependent way. @n
* The returned value may be @c null if no valid currency is determined
* or no currency has been set using the SetCurrency() method.
- * @see SetCurrency()
*/
virtual const Currency* GetCurrency(void) const;
/**
- * Sets the currency used by the current number format when formatting currency values.
+ * Sets the currency to be used by the current number format when formatting currency values.
*
- * @since 2.0
+ * @since 2.0
*
- * @param[in] currency The new currency to use by the current number format
+ * @param[in] currency The currency to set
* @remarks This does not update the minimum or maximum number of fractional digits used by the number format.
- * @see GetCurrency()
+ * @see GetCurrency()
*/
virtual void SetCurrency(const Currency& currency);
*
* @param[in] newValue The maximum number of integer digits allowed in the integer portion of a number, @n
* If less than zero, @c 0 is used.
- * @remarks The maximum integer digits must be greater than or equal to the minimum integer digits.
+ * @remarks The maximum integer digits must be greater than or equal to the minimum integer digits.@n
* If the new value for the maximum integer digits is less than the current value of the minimum integer digits,
* the minimum integer digits are also set to the new value.
* @see GetMaxIntegerDigits()
*
* @since 2.0
*
- * @return An integer value representing the minimum number of digits allowed in the integer portion of a number
+ * @return An integer value representing the minimum number of digits
* @see SetMinIntegerDigits()
*/
virtual int GetMinIntegerDigits(void) const;
*
* @since 2.0
*
- * @param[in] newValue The minimum number of integer digits allowed in the integer portion of a number @n
- * If less than zero, @c 0 is used.
- * @remarks The minimum integer digits must be less than or equal to the maximum integer digits.
+ * @param[in] newValue The minimum number of integer digits allowed in the integer portion of a number @n
+ * If less than zero, @c 0 is used.
+ * @remarks The minimum integer digits must be less than or equal to the maximum integer digits. @n
* If the new value for the minimum integer digits exceeds the current value of the maximum integer digits,
* the maximum integer digits are also set to the new value.
* @see GetMinIntegerDigits()
*
* @since 2.0
*
- * @return An integer value representing the maximum number of digits allowed in the fractional portion of a number
+ * @return An integer value representing the maximum number of digits
* @see SetMaxFractionDigits()
*/
virtual int GetMaxFractionDigits(void) const;
*
* @param[in] newValue The maximum number of fractional digits allowed in the fractional portion of a number @n
* If less than zero, @c 0 is used.
- * @remarks The maximum fractional digits must be greater than or equal to the minimum fractional digits.
+ * @remarks The maximum fractional digits must be greater than or equal to the minimum fractional digits. @n
* If the new value for the maximum fractional digits is less than the current value of the minimum fractional digits,
* the minimum fractional digits are also set to the new value.
* @see GetMaxFractionDigits()
*
* @param[in] newValue The minimum number of fractional digits allowed in the fractional portion of a number @n
* If less than zero, @c 0 is used.
- * @remarks The minimum fractional digits must be less than or equal to the maximum fractional digits.
+ * @remarks The minimum fractional digits must be less than or equal to the maximum fractional digits. @n
* If the new value for the minimum fractional digits exceeds the current value of the maximum fraction digits,
* the maximum fraction digits are also set to the new value.
* @see GetMinFractionDigits()
*
* @return @c true if grouping is used in the current instance of %NumberFormatter, @n
* else @c false
- * @remarks For example, in the English locale, with grouping on, the number 1234567
+ * @remarks
+ * - For example, in the English locale, with grouping on, the number 1234567
* might be formatted as "1,234,567".
- * The grouping separator as well as the size of each group is locale dependent
+ * - The grouping separator as well as the size of each group is locale dependent
* and is determined by subclasses of %NumberFormatter.
* @see SetGroupingUsed()
*/
/**
- * Sets the current instance of %NumberFormatter to use or not to use grouping.
+ * Sets the use of grouping in the current instance of %NumberFormatter.
*
* @since 2.0
*
- * @param[in] newValue Set to @c true if grouping is used in the current formatter, @n
+ * @param[in] newValue Set to @c true to use grouping in the current formatter, @n
* else @c false
* @see IsGroupingUsed()
*/
/**
- * Applies the specified pattern to the current instance of %NumberFormatter.
+ * Applies the pattern to the current instance of %NumberFormatter.
*
* @since 2.0
*
* @return An error code
- * @param[in] pattern The new pattern
- * @param[in] localized The localization On/Off flag @n
+ * @param[in] pattern The pattern to apply
+ * @param[in] localized The flag to set the localization on or off @n
* Set to @c true if the pattern is applied with the localized symbols, @n
- * else @c false.
+ * else @c false
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c pattern is invalid or its length is @c 0.
*/
/**
- * Sets a new value for the positive prefix of the current instance of %NumberFormatter.
+ * Sets the positive prefix of the current instance of %NumberFormatter.
*
* @since 2.0
*
- * @param[in] newValue The new positive prefix
+ * @param[in] newValue The positive prefix to set
* @see GetPositivePrefix()
*/
void SetPositivePrefix(const Tizen::Base::String& newValue);
/**
- * Sets a new value for the negative prefix of the current instance of %NumberFormatter.
+ * Sets the negative prefix of the current instance of %NumberFormatter.
*
* @since 2.0
*
- * @param[in] newValue The new negative prefix
+ * @param[in] newValue The negative prefix to set
* @see GetNegativePrefix()
*/
void SetNegativePrefix(const Tizen::Base::String& newValue);
/**
- * Sets a new value for the positive suffix of the current instance of %NumberFormatter.
+ * Sets the positive suffix of the current instance of %NumberFormatter.
*
* @since 2.0
*
- * @param[in] newValue The new positive suffix
+ * @param[in] newValue The positive suffix to set
* @see GetPositiveSuffix()
*/
void SetPositiveSuffix(const Tizen::Base::String& newValue);
/**
- * Sets a new value for the negative suffix of the current instance of %NumberFormatter.
+ * Sets the negative suffix of the current instance of %NumberFormatter.
*
* @since 2.0
*
- * @param[in] newValue The new negative suffix
+ * @param[in] newValue The negative suffix to set
* @see GetNegativeSuffix()
*/
void SetNegativeSuffix(const Tizen::Base::String& newValue);
/**
- * Sets a new value for the multiplier for use in percent, per mill, and so on.
+ * Sets the multiplier for use in percent, per mill, and so on.
*
* @since 2.0
*
- * @param[in] newValue The new value for the multiplier
+ * @param[in] newValue The multiplier to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
* @remarks For example, in percentage, set the suffixes to have "%" and the multiplier to be 100.
* @since 2.0
*
* @return An integer value representing the grouping size
- * @remarks Grouping size is the number of digits between grouping separators in the integer portion of a number. @n
- * For example, in the number "123,456.78", the grouping size is 3.
+ * @remarks The grouping size is the number of digits between the grouping separators in the integer portion of a number. @n
+ * For example, in the number "123,456.78", the grouping size is 3.
* @see SetGroupingSize()
* @see IsGroupingUsed()
*/
/**
- * Sets a new value for the grouping size.
+ * Sets the grouping size.
*
* @since 2.0
*
- * @param[in] newValue The new value for the grouping size
+ * @param[in] newValue The grouping size to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
* @see GetGroupingSize()
/**
- * Sets the behavior of the decimal separator. @n
+ * Sets the visibility behavior of the decimal separator. @n
* The decimal separator can be set to always appear using this method.
*
* @since 2.0
*
- * @param[in] newValue Set to @c true if the decimal separator is always shown, @n
+ * @param[in] newValue Set to @c true to always show the decimal separator, @n
* else @c false
* @see IsDecimalSeparatorAlwaysShown()
*/
/**
- * Sets the behavior of the plus sign. @n
+ * Sets the visibility behavior of the plus sign. @n
* The plus sign can be set to always appear using this method.
*
* @since 2.0
*
- * @param[in] newValue Set to @c true if the plus sign is always shown, @n
+ * @param[in] newValue Set to @c true to always show the plus sign, @n
* else @c false
* @see IsPositiveSignAlwaysShown()
*/
/**
* @class NumberSymbols
- * @brief This class provides methods that help in providing number symbols.
+ * @brief This class provides methods for number symbols.
*
* @since 2.0
*
- * The %NumberSymbols class represents the set of symbols (such as the decimal separator and the grouping separator) needed by NumberFormatter to format numbers.
- * %NumberFormatter creates its own instance of %NumberSymbols from its locale data. %NumberSymbols can be adopted by a %NumberFormatter instance, or it can be specified when a %NumberFormatter is created. If you need to change any of these symbols, you can get the %NumberSymbols instance from your %NumberFormatter and then modify it.
+ * The %NumberSymbols class represents the set of symbols (such as the decimal separator and the grouping separator) needed by
+ * NumberFormatter to format numbers. %NumberFormatter creates its own instance of %NumberSymbols from its locale data.
+ * %NumberSymbols can be adapted by a %NumberFormatter instance, or it can be specified when a %NumberFormatter is created.
+ * If you need to change any of these symbols, you can get the %NumberSymbols instance from your %NumberFormatter and then modify it.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/locales/num_symbols_currencies.htm">Number Symbols and Currencies</a>.
*/
public:
/**
* This is the default constructor for this class. @n
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. For full construction, the Construct()
+ * method must be called right after calling this constructor.
*
- * @since 2.0
- *
- * @see Construct()
+ * @since 2.0
*/
NumberSymbols(void);
* Initializes this instance of %NumberSymbols with the specified @c locale.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
- * @since 2.0
+ * @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompNumberSymbolsConstructPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompNumberSymbolsConstructPage "here".
* @endif
*
* @return An error code
- * @param[in] locale An instance of Locale
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @param[in] locale An instance of Locale
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c locale is invalid.
*/
result Construct(const Locale& locale);
/**
* @if OSPCOMPAT
- * @page CompNumberSymbolsConstructPage Compatibility for Construct()
- * @section CompNumberSymbolsConstructIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the @c locale is invalid.
- *
- * @section CompNumberSymbolsConstructSolutionSection Resolutions
- * This issue has been resolved in Tizen.
+ * @page CompNumberSymbolsConstructPage Compatibility for Construct()
+ * @section CompNumberSymbolsConstructIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_UNSUPPORTED_OPERATION if the @c locale is invalid.
+ *
+ * @section CompNumberSymbolsConstructSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
* @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the @c locale is invalid.
+ * -# The method returns @c E_INVALID_ARG if the @c locale is invalid.
* @endif
- */
+ */
/**
* Gets the character used for number format.
* @return The character used for number format, @n
* else an empty string if the @c symbol is invalid
* @param[in] symbol The number format symbol instance
- * @see SetNumberSymbol()
+ * @see SetNumberSymbol()
*/
Tizen::Base::String GetNumberSymbol(NumberSymbol symbol) const;
* @param[in] symbol A symbol to set
* @param[in] str The new string for symbol
* @exception E_SUCCESS The method is successful.
- * @see GetNumberSymbol()
+ * @see GetNumberSymbol()
*/
result SetNumberSymbol(NumberSymbol symbol, const Tizen::Base::String& str);
* @since 2.0
*
* @return A pointer to the current instance of Locale, @n
- * else @c null if this method fails
+ * else @c null if it fails
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
const Locale* GetLocale(void) const;
/**
* @class TimeRule
- * @brief This class is for setting and getting the time rule.
+ * @brief This class provides methods for setting and getting the time rule.
*
* @since 2.0
*
* @param[in] day The day
* @param[in] hour The hour
* @param[in] minute The minute
- * @param[in] timeMode The time mode - TIME_MODE_UTC, TIME_MODE_STANDARD, or TIME_MODE_WALL
+ * @param[in] timeMode The time mode - @c TIME_MODE_UTC, @c TIME_MODE_STANDARD, or @c TIME_MODE_WALL
*/
TimeRule(Month month, int day, int hour = 0, int minute = 0, Tizen::System::TimeMode timeMode = Tizen::System::TIME_MODE_WALL);
* @param[in] dayOfWeek The day of the week
* @param[in] hour The hour
* @param[in] minute The minute
- * @param[in] timeMode The time mode - TIME_MODE_UTC, TIME_MODE_STANDARD, or TIME_MODE_WALL
+ * @param[in] timeMode The time mode - @c TIME_MODE_UTC, @c TIME_MODE_STANDARD, or @c TIME_MODE_WALL
*/
TimeRule(Month month, Week week, DayOfWeek dayOfWeek,
int hour = 0, int minute = 0, Tizen::System::TimeMode timeMode = Tizen::System::TIME_MODE_WALL);
* @b on @b or @b before @c day
* @param[in] hour The hour
* @param[in] minute The minute
- * @param[in] timeMode The time mode - TIME_MODE_UTC, TIME_MODE_STANDARD, or TIME_MODE_WALL
+ * @param[in] timeMode The time mode - @c TIME_MODE_UTC, @c TIME_MODE_STANDARD, or @c TIME_MODE_WALL
*/
TimeRule(Month month, int day, DayOfWeek dayOfWeek,
bool onOrAfterDay, int hour = 0, int minute = 0, Tizen::System::TimeMode timeMode = Tizen::System::TIME_MODE_WALL);
* @since 2.0
*
* @return @c true if the value of the specified instance is equal to that of the current instance, @n
- * else @c false
- * @param[in] obj The object to compare with the current instance
+ * else @c false
+ * @param[in] obj The object to compare with the current instance
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
* @param[in] day The day
* @param[in] week The week
* @param[in] dayOfWeek The day of week
- * @param[in] beforeAfter If @c after is ON_OR_AFTER_DAY, this rule selects the first @c dayOfWeek
+ * @param[in] beforeAfter If @c after is @c ON_OR_AFTER_DAY, this rule selects the first @c dayOfWeek
* @b on @b or @b after @c day.
- * If @c after is ON_OR_BEFORE_DAY, this rule selects the last @c dayOfWeek
+ * If @c after is @c ON_OR_BEFORE_DAY, this rule selects the last @c dayOfWeek
* @b on @b or @b before @c day.
* @param[in] hour The hour
* @param[in] minute The minute
- * @param[in] timeMode The time mode - TIME_MODE_UTC, TIME_MODE_STANDARD, TIME_MODE_WALL
+ * @param[in] timeMode The time mode - @c TIME_MODE_UTC, @c TIME_MODE_STANDARD, @c TIME_MODE_WALL
*/
void SetValue(Month month, int day, Week week,
DayOfWeek dayOfWeek, bool onOrAfterDay, int hour,
*
* @final This class is not intended for extension.
*
- * The %TimeZone class represents a time zone offset and figures out Daylight Saving Time (DST).
+ * The %TimeZone class represents the time zones and offers methods for time zone offset and Daylight Saving Time (DST).
+ * The time zone ID format is "Area/Location". @n
+ * However, the specialized time zone IDs have a different format, such as CST6CDT, EST5EDT and so on. @n
*
- * The form of time zone ID is "Area/Location". @n
+ * For more information on IDs, see <a href="http://www.iana.org/time-zones" target="_blank">Time Zone Database</a>. @n
*
- * However, the specialized time zone IDs have the different form, such as CST6CDT, EST5EDT and so on. @n
- *
- * For more information on IDs, refer <a href="http://www.iana.org/time-zones" target="_blank">Time Zone Database</a>. @n
- *
- * The supported time zone list depends on the device. Therefore, it must be checked by using LocaleManager::GetAvailableTimeZonesN().
+ * The supported time zone list depends on the device. Therefore, you must call LocaleManager::GetAvailableTimeZonesN() to get
+ * the supported time zones.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/locales/time_zone.htm">Time Zones</a>.
*
*
* @param[in] rawOffset The base time zone offset to GMT in minutes
* @param[in] id The time zone ID
- * @remarks The form of time zone @c id is "Area/Location". @n For more information on IDs, refer <a href="http://www.iana.org/time-zones" target="_blank">here</a>. @n
- * However, the supported time zone list depends on the device. Therefore, it must be checked before using this method.
- * @see LocaleManager::GetAvailableTimeZonesN()
+ * @remarks The format of time zone @c id is "Area/Location". @n
+ * For more information on IDs, refer <a href="http://www.iana.org/time-zones" target="_blank">here</a>. @n
+ * However, the supported time zone list depends on the device. Therefore, you must call
+ * LocaleManager::GetAvailableTimeZonesN() to get the supported time zones.
*/
TimeZone(int rawOffset, const Tizen::Base::String& id);
/**
* Initializes this instance of %TimeZone with the specified raw GMT offset,
- * the ID of the time zone, the rules for starting/ending DST, and the DST offset.
+ * the time zone ID, the rules for starting/ending DST, and the DST offset.
*
* @since 2.0
*
* @param[in] startRule The DST starting rule
* @param[in] endRule The DST end rule
* @param[in] dstOffset The amount of time in minutes saved during DST
- * @remarks The form of time zone @c id is "Area/Location". @n For more information on IDs, refer <a href="http://www.iana.org/time-zones" target="_blank">here</a>. @n
- * However, the supported time zone list depends on the device. Therefore, it must be checked before using this method.
- * @see LocaleManager::GetAvailableTimeZonesN()
+ * @remarks The form of time zone @c id is "Area/Location". @n
+ * For more information on IDs, refer <a href="http://www.iana.org/time-zones" target="_blank">here</a>. @n
+ * However, the supported time zone list depends on the device. Therefore, you must call
+ * LocaleManager::GetAvailableTimeZonesN() to get the supported time zones.
*/
TimeZone(int rawOffset, const Tizen::Base::String& id,
const TimeRule& startRule, const TimeRule& endRule, int dstOffset);
/**
- * Checks whether the specified instance of %TimeZone equals the value of the current instance.
+ * Checks whether the specified %TimeZone instance is equal to the current instance.
*
* @since 2.0
*
bool operator ==(const TimeZone& otherTimeZone) const;
/**
- * Checks whether the %TimeZone instance is equal to the current instance.
+ * Checks whether the specified %TimeZone instance is equal to the current instance.
*
* @since 2.0
*
* @since 2.0
*
* @return @c true if the value of the specified instance is equal to that of the current instance, @n
- * else @c false
- * @param[in] obj The object to compare with the current instance
+ * else @c false
+ * @param[in] obj The object to compare with the current instance
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
/**
* Converts the Coordinated Universal Time (UTC) time to the standard time.
*
- * @since 2.0
+ * @since 2.0
*
* @return The standard time
* @param[in] utcTime The UTC time
/**
* Converts the wall time to the UTC time.
*
- * @since 2.0
+ * @since 2.0
*
* @return The UTC time
* @param[in] wallTime The wall time
/**
* Gets the raw and GMT offset for the specified instance of Tizen::Base::DateTime in the current time zone.
*
- * @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @if OSPCOMPAT
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompTimeZoneGetOffsetPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompTimeZoneGetOffsetPage "here".
* @endif
*
* @return An error code
* @param[out] dstOffset The offset to add to @c rawOffset to obtain the total offset between the local and GMT time @n
* If DST is not in effect, it is zero.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c date is invalid.
- * @remarks Local millisecond = GMT milliseconds + rawOffset(in milliseconds) + dstOffset(in milliseconds).
- * All computations are performed in Gregorian calendar.
+ * @exception E_INVALID_ARG The specified @c date is invalid.
+ * @remarks Local millisecond = GMT milliseconds + rawOffset(in milliseconds) + dstOffset(in milliseconds). @n
+ * All computations are performed in Gregorian calendar.
*/
result GetOffset(const Tizen::Base::DateTime& date, bool local, int& rawOffset, int& dstOffset) const;
/**
- * Gets the difference in minutes between the local standard time and GMT, taking into consideration both the raw offset and the effect of DST.
+ * Gets the difference in minutes between the local standard time and GMT, taking into consideration both the raw offset
+ * and the effect of DST.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompTimeZoneGetOffsetPage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompTimeZoneGetOffsetPage "here".
* @endif
*
* @return An error code
* The value is GMT time from starting day (Jan 1, 1.).
* @param[out] offset The offset between the local standard time and GMT, taking into consideration DST
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c ticks is invalid.
- * @see Base::DateTime::GetTicks()
+ * @exception E_INVALID_ARG The specified @c ticks is invalid.
+ * @see Base::DateTime::GetTicks()
*/
result GetOffset(long long ticks, int& offset) const;
- /**
+ /**
* @if OSPCOMPAT
- * @page CompTimeZoneGetOffsetPage Compatibility for GetOffset()
- * @section CompTimeZoneGetOffsetIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_OUT_OF_RANGE if an argument is invalid.
- *
- * @section CompTimeZoneGetOffsetSolutionSection Resolutions
- * This issue has been resolved in Tizen.
- * @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if an argument is invalid.
+ * @page CompTimeZoneGetOffsetPage Compatibility for GetOffset()
+ * @section CompTimeZoneGetOffsetIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_OUT_OF_RANGE if an argument is invalid.
+ *
+ * @section CompTimeZoneGetOffsetSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
+ * @par When working in Tizen:
+ * -# The method returns @c E_INVALID_ARG if an argument is invalid.
* @endif
- */
+ */
/**
* Gets the difference in minutes between the local standard time and GMT, without including DST (that is, raw offset).
int GetRawOffset(void) const;
/**
- * Gets the ID of the time zone.
+ * Gets the time zone ID.
*
* @since 2.0
*
- * @return The ID of the time zone
+ * @return The time zone ID
*/
Tizen::Base::String GetId(void) const;
static TimeZone GetGmtTimeZone(void);
/**
- * Gets the time zone instance from the given ID.
+ * Gets the time zone instance for the specified ID.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompTimeZoneGetTimeZonePage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompTimeZoneGetTimeZonePage "here".
* @endif
*
* @return An error code
* @param[in] id The time zone ID
- * @param[out] timeZone The time zone for the given ID
+ * @param[out] timeZone The time zone for the specified ID
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c id is invalid.
- * @remarks The %TimeZone instance for the specified @c id does not contain the DST information.
- * The supported time zone list depends on the device. Therefore, it should be checked before using this method.
- * @see LocaleManager::GetAvailableTimeZonesN()
+ * @exception E_INVALID_ARG The specified @c id is invalid.
+ * @remarks The %TimeZone instance for the specified @c id does not contain the DST information.@n
+ * The supported time zone list depends on the device. Therefore, you must call
+ * LocaleManager::GetAvailableTimeZonesN() to get the supported time zones.
*/
static result GetTimeZone(const Tizen::Base::String& id, Tizen::Locales::TimeZone& timeZone);
/**
- * Gets the %TimeZone instance from the specified ID and UTC time.
+ * Gets a %TimeZone instance from the specified ID and UTC time.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
* @since 2.0
* @if OSPCOMPAT
- * @compatibility This method has compatibility issues with OSP compatible applications. @n
- * For more information, see @ref CompTimeZoneGetTimeZonePage "here".
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompTimeZoneGetTimeZonePage "here".
* @endif
*
* @return An error code
* @param[in] utcTime The UTC time
* @param[out] timeZone The time zone for the specified ID and UTC time
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c id is invalid.
- * @remarks The %TimeZone instance for the specified ID and UTC time contains the DST information.
- * The supported time zone list depends on the device. Therefore, it should be checked before using this method.
- * @see LocaleManager::GetAvailableTimeZonesN()
+ * @exception E_INVALID_ARG The specified @c id is invalid.
+ * @remarks The %TimeZone instance for the specified ID and UTC time contains the DST information. @n
+ * The supported time zone list depends on the device. Therefore, you must call
+ * LocaleManager::GetAvailableTimeZonesN() to get the supported time zones.
*/
static result GetTimeZone(const Tizen::Base::String& id, const Tizen::Base::DateTime& utcTime, Tizen::Locales::TimeZone& timeZone);
- /**
+ /**
* @if OSPCOMPAT
- * @page CompTimeZoneGetTimeZonePage Compatibility for GetTimeZone()
- * @section CompTimeZoneGetTimeZoneIssueSection Issues
- * Implementation of this method in OSP compatible applications has the following issue: @n
- * -# The method returns E_UNSUPPORTED_OPERATION if the time zone ID is invalid.
- *
- * @section CompTimeZoneGetTimeZoneSolutionSection Resolutions
- * This issue has been resolved in Tizen.
+ * @page CompTimeZoneGetTimeZonePage Compatibility for GetTimeZone()
+ * @section CompTimeZoneGetTimeZoneIssueSection Issues
+ * Implementation of this method in OSP compatible applications has the following issue: @n
+ * -# The method returns @c E_UNSUPPORTED_OPERATION if the time zone ID is invalid.
+ *
+ * @section CompTimeZoneGetTimeZoneSolutionSection Resolutions
+ * This issue has been resolved in Tizen.
* @par When working in Tizen:
- * -# The method returns E_INVALID_ARG if the time zone ID is invalid.
+ * -# The method returns @c E_INVALID_ARG if the time zone ID is invalid.
* @endif
- */
+ */
/**
* Converts the UTC time to the standard time.
* @since 2.0
*
* @return The UTC time
- * @param[in] standardTime The standard time
+ * @param[in] standardTime The standard time
* @param[in] rawOffset The time zone's raw offset in minutes
*/
static Tizen::Base::DateTime StandardTimeToUtcTime(const Tizen::Base::DateTime& standardTime, int rawOffset);
* @since 2.0
*
* @return The wall time
- * @param[in] utcTime The UTC time
+ * @param[in] utcTime The UTC time
* @param[in] rawOffset The time zone's raw offset in minutes
* @param[in] dstOffset The amount of time in minutes saved during DST
*/
* @since 2.0
*
* @return The UTC time
- * @param[in] wallTime The wall time
+ * @param[in] wallTime The wall time
* @param[in] rawOffset The time zone's raw offset in minutes
* @param[in] dstOffset The amount of time in minutes saved during DST
*/
* @b Library: @b osp-appfw
*
*
- * The %Locales namespace contains classes representing a specific cultural region (locale) and the classes for manipulating and formatting locale-sensitive information, such as dates, times, numbers, and time zones.
+ * The %Locales namespace contains classes representing a specific cultural region (locale) and the classes for manipulating and
+ * formatting locale-sensitive information, such as dates, times, numbers, and time zones.
*
- * Even if the list of all the available languages supported by the device is different, the localized information by the %Locales namespace should be represented properly.
+ * Even if the list of all the available languages supported by the device is different, the localized information by
+ * the %Locales namespace should be represented properly.
*
* For more information on the %Locales namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/locales/locales_namespace.htm">Locales Guide</a>.
*
/**
* @class AccessController
- * @brief This class provides a way to check the privilege of privileged API.
+ * @brief This class provides methods to check the privilege of privileged API.
* @since 2.0
*
- * The %AccessController class provides a way to check the privilege of privileged API.
+ * The %AccessController class provides methods to check the privilege of privileged API.
*/
class _OSP_EXPORT_ AccessController
{
* @exception E_DATA_NOT_FOUND The privilege information does not exist.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method.
* @exception E_SYSTEM An unexpected system error has occurred.
*/
static result CheckPrivilege(int privilege);
* @exception E_INVALID_ARG The specified @c privilege is an invalid privilege string.
* @exception E_DATA_NOT_FOUND The privilege information does not exist.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result CheckPrivilege(const Tizen::Base::String& privilege);
/**
- * Checks whether the client application which has @c packageId has a privilege to invoke the privileged API.
+ * Checks whether the client application with the specified @c packageId has a privilege to invoke the privileged API.
*
* @since 2.1
* @privlevel partner
* @privilege %http://tizen.org/privilege/privilegemanager.read
*
* @return An error code
- * @param[in] packageId The package ID
+ * @param[in] packageId The package ID
* @param[in] privilege A string of the specified privilege
* @exception E_SUCCESS The method is successful and the request is granted.
* @exception E_INVALID_ARG The specified @c privilege is an invalid privilege string.
* @exception E_DATA_NOT_FOUND The privilege information does not exist.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result CheckPrivilege(const Tizen::App::PackageId& packageId, const Tizen::Base::String& privilege);
//
/**
- * @file FSecAesSecureRandom.h
+ * @file FSecAesSecureRandom.h
* @brief This is the header file for the %AesSecureRandom class.
*
* This header file contains the declarations of the %AesSecureRandom class.
* @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
* @param[in] numBytes The number of random bytes to generate
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c numBytes is @c 0 or negative.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GenerateRandomBytesN(int numBytes);
//
/**
- * @file FSecCert.h
+ * @file FSecCert.h
* @brief This is the header file for the %Cert namespace.
*
* This header file contains the declarations and descriptions of the %Cert namespace.
* @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FSecurity.h> @n
- * @b Library : @b osp-appfw
+ * @b Library: @b osp-appfw
*
* The %Cert namespace contains classes and interfaces for managing certificates, by getting information from security certificates and validating their paths. @n
*
/**
* @enum CertificateType
*
- * Defines the type of certificate.
+ * Defines the type of security certificate.
*
* @since 2.0
*/
enum CertificateType
{
ROOT_CA, /**< The Factory-supplied certificates for SSL: ROOT CA */
- OPERATOR_DOMAIN, /**< The Operator Domain */
- TRUSTED_THIRD_PARTY_DOMAIN, /**< The Trusted Third Party Domain */
- USER_CERT, /**< The User Certificates */
- UNKNOWN_TYPE = 10, /**< The unknown type */
+ OPERATOR_DOMAIN, /**< The operator domain certificate */
+ TRUSTED_THIRD_PARTY_DOMAIN, /**< The trusted third party domain certificate*/
+ USER_CERT, /**< The user certificate */
+ UNKNOWN_TYPE = 10, /**< The unknown type certificate*/
}; //CertificateType
/**
* @enum ValidityPeriod
*
- * Defines the validity period.
+ * Defines the certificate validity period.
*
* @since 2.0
*/
enum ValidityPeriod
{
- VALIDITY_PERIOD_VALID, /**< The validity period */
- VALIDITY_PERIOD_EXPIRED, /**< The expiry period */
- VALIDITY_PERIOD_NOT_YET_VALID, /**< The period that is not yet valid */
+ VALIDITY_PERIOD_VALID, /**< The certificate is valid */
+ VALIDITY_PERIOD_EXPIRED, /**< The certificate has expired */
+ VALIDITY_PERIOD_NOT_YET_VALID, /**< The certificate period is not yet valid */
}; //ValidityPeriod
/**
*
* @since 2.0
*
- * The %ICertificate interface is an abstraction for certificates having different formats. For example, different types of certificates, such as X.509 and PGP, share
- * general functionalities, namely encoding and verifying, and some type of information like public keys. Despite containing different sets of information and having different ways for storing, and retrieving them,
+ * The %ICertificate interface is an abstraction for certificates having different formats. For example, different types of
+ * certificates, such as X.509 and PGP, share general functionalities, namely encoding and verifying, and information like
+ * public keys. Despite containing different sets of information and having different ways for storing and retrieving them,
* the X.509, X.968, and WTLS certificates can all be implemented by using the %ICertificate interface.
*
* An identity certificate is a binding of a principal to a public key, which is vouched for by another principal.
*
* @since 2.0
*
- * @return The format of this certificate
+ * @return The certificate format
*/
virtual Tizen::Base::String GetFormat(void) const = 0;
*
* @since 2.0
*
- * @return The type of this certificate
+ * @return The certificate type
* @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual CertificateType GetType(void) const = 0;
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation or the
- * Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetEncodedDataN(void) const = 0;
/**
* Gets the fingerprint of the certificate. @n
- * It is the hashed value of the encoding of the certificate.
+ * It is the hash value of the encoding of the certificate.
*
* @since 2.0
*
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate parsing operation or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate parsing operation has failed.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetFingerprintN(void) const = 0;
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c publicKey is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate parsing operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate parsing operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual bool Verify(const Tizen::Security::IPublicKey& publicKey) = 0;
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::IPublicKey* GetPublicKeyN(void) const = 0;
/**
- * Gets the @c serialNumber value from the certificate. @n
- * The serial number is an integer assigned by the Certification Authority (CA) to each certificate. It is unique for each certificate issued by a
- * given CA (that is, the issuer name and serial number must identify a unique certificate). @n
+ * Gets the serial number of the certificate. @n
+ * The serial number is a unique integer assigned by the Certification Authority (CA) to each certificate (that is, the issuer name and serial number
+ * must identify a unique certificate). @n
*
* This is defined in ASN.1 as demonstrated in the following code:
*
* CertificateSerialNumber ::= INTEGER
* @endcode
*
- * Since the serial number can be greater than the system's maximum value for @c int, the output parameter type is @c ByteBuffer, instead of @c int.
+ * Since the serial number can be greater than the system's maximum defined value for @c int, the output parameter type
+ * is @c ByteBuffer, instead of @c int.
*
* @since 2.0
*
* @return The serial number of the certificate
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to get the certificate serial number information.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to get the certificate serial number information.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::String GetSerialNumber(void) const = 0;
/**
* Checks whether the certificate is currently valid. @n
- * It is valid if the current date and time are within the validity period given in the certificate. @n
- * The validity period consists of two date and time values: the initial date and time, and the final date and time until the validity of the certificate. @n
+ * It is valid if the current date and time are within the validity period of the certificate. The validity period consists
+ * of two date and time values: the initial date and time, and the final date and time for the validity of the certificate. @n
*
* This is defined in ASN.1 as demonstrated in the following code:
*
* generalTime GeneralizedTime }
* @endcode
*
- * @since 2.0
+ * @since 2.0
*
* @return The validity period of the certificate
* @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual ValidityPeriod CheckValidityPeriod(void) = 0;
/**
* Gets the notBefore value of Tizen::Base::String type from the validity period of the certificate. @n
- * This value represents the date and time before which the certificate is not valid.
+ * This value represents the date and time before which the certificate is not valid.
*
* @since 2.0
*
* @return A string representing the date and time value before which the certificate is not valid
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to get the certificate validity information.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to get the certificate validity information.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Tizen::Security::Cert::X509Certificate::CheckValidityPeriod() for relevant ASN.1 definitions
*/
virtual Tizen::Base::String GetNotBefore(void) const = 0;
/**
* Gets the notAfter value of Tizen::Base::String type from the validity period of the certificate. @n
- * This value represents the date and time after which the certificate is not valid.
+ * This value represents the date and time after which the certificate is not valid.
*
* @since 2.0
*
* @return A string representing the date and time value after which the certificate is not valid
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to get the certificate validity information.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to get the certificate validity information.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Tizen::Security::Cert::X509Certificate::CheckValidityPeriod() for relevant ASN.1 definitions
*/
virtual Tizen::Base::String GetNotAfter(void) const = 0;
* @return The name of the issuer of the certificate
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to get the certificate issuer information.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to get the certificate issuer information.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::String GetIssuer(void) const = 0;
* @return The subject name of the certificate
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to get the certificate issuer information.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to get the certificate issuer information.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::String GetSubject(void) const = 0;
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetSignatureN(void) const = 0;
//
/**
- * @file FSecCertICertificatePath.h
+ * @file FSecCertICertificatePath.h
* @brief This is the header file for the %ICertificatePath interface.
*
* This header file contains the declarations of the %ICertificatePath interface.
class ICertificatePathValidationResult;
/**
* @interface ICertificatePath
- * @brief This interface validates the certificate path and gets more information about it.
+ * @brief This interface provides methods for validating the certificate path and get information about it.
*
* @since 2.0
*
- * The %ICertificatePath interface validates the certificate path and gets more information about it. @n
+ * The %ICertificatePath interface provides methods for validating the certificate path and get information about it. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/certificate_namespace.htm">Certificates</a>. @n
*
virtual Tizen::Base::String GetFormat(void) const = 0;
/**
- * Adds a certificate to the certificate chain.
+ * Adds the specified certificate to the certificate chain.
* The order of certificates should be as follows: @n
* 1. User certificate.
* 2. Intermediate certificate.
* @since 2.0
*
* @return An error code
- * @param[in] certificate A reference to a certificate
+ * @param[in] certificate A reference to the certificate to add
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c certificate or the certificate data is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
*/
virtual result AddCertificate(const Tizen::Security::Cert::ICertificate& certificate) = 0;
/**
* Validates the specified certificate path.
*
- * @since 2.0
+ * @since 2.0
*
- * @return The result of the certificate path validation
+ * @return The result of the certificate path validation
* @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::Cert::ValidationResult Validate(void) = 0;
* @since 2.0
*
* @return The result of the certificate path validation
- * @param[in] trustAnchor The most trusted Certificate Authority (CA)
+ * @param[in] trustAnchor The trusted Certificate Authority (CA)
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::Cert::ValidationResult Validate(const Tizen::Security::Cert::ICertificate& trustAnchor) = 0;
/**
* Gets the trust anchor for the certificate path.
*
- * @since 2.0
+ * @since 2.0
*
* @return The root certificate, @n
* else @c null if an error occurs
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OBJ_NOT_FOUND The certificate is not found.
* @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * Either of the following conditions has occurred:
+ * - The certificate link list operation.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::Cert::ICertificate* GetTrustAnchorN(void) const = 0;
* @return The length of the certificate path, @n
* else @c -1 if an error occurs
* @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate list is empty.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate list is empty.
*/
virtual int GetLength(void) const = 0;
/**
* Gets the list of certificates in this certificate path.
*
- * @since 2.0
+ * @since 2.0
*
* @return A pointer to the ICertificate interface, @n
* else @c null if an error occurs
* @exception E_INVALID_ARG The value of the specified @c nth is out of the valid range. @n
* It must be less than the value retrieved by the GetLength() method.
* @exception E_OBJ_NOT_FOUND The certificate is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate list is empty.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate list is empty.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::Cert::ICertificate* GetCertificateN(int nth) const = 0;
/**
* @interface ICertificateSelector
- * @brief This interface is a selector that defines a set of criterion for selecting certificates.
+ * @brief This interface is a selector that defines a set of criterion for selecting certificates.
*
* @since 2.0
*
* The %ICertificateSelector interface is a selector that defines a set of criterion for selecting certificates.
- * The classes that implement this interface are used to specify the certificates, which must be retrieved from a certificate store. @n
+ * The classes that implement this interface are used to specify the certificates, which must be retrieved from a certificate store. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/certificate_namespace.htm">Certificates</a>.
*
/**
* @interface ICertificateStore
- * @brief This is the interface for retrieving and managing the certificates from a repository.
+ * @brief This interface provides methods for retrieving and managing the certificates from a repository.
*
* @since 2.0
*
* @since 2.0
*
* @return An error code
- * @param[in] selector A selector that defines a set of criterion for selecting certificates
+ * @param[in] selector The selector that defines a set of criterion for selecting certificates
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The IPC operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The IPC operation has failed.
* @exception E_INVALID_ARG The specified @c selector is invalid.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
virtual result GetCertificateCount(int& count) const = 0;
/**
- * Gets each certificate that matches the specified selector.
+ * Gets the certificate that matches the specified selector.
*
* @since 2.0
*
- * @return The certificates that match the specified selector
+ * @return The certificate that matches the specified selector
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OBJ_NOT_FOUND The certificate is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::Cert::ICertificate* GetNextCertificateN(void) const = 0;
* @param[in] certificate A reference to the certificate to insert
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c certificate or the certificate data is invalid, or
- * the specified @c certificateType is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * Either the IPC operation or the file operation or the DB operation has failed.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c certificate or the certificate data is invalid.
+ * - The specified @c certificateType is invalid.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - Either the IPC operation or the file operation or the DB operation has failed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
virtual result Insert(CertificateType certificateType, const Tizen::Security::Cert::ICertificate& certificate) = 0;
* @param[in] newCert A reference to the new certificate
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c certificate or the certificate data is invalid, or
- * the specified @c certificateType is invalid.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c certificate or the certificate data is invalid.
+ * - The specified @c certificateType is invalid.
* @exception E_OBJ_NOT_FOUND The certificate is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * Either the IPC operation or the file operation or the DB operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - Either the IPC operation or the file operation or the DB operation has failed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
virtual result Update(CertificateType certificateType, const Tizen::Security::Cert::ICertificate& oldCert, const Tizen::Security::Cert::ICertificate& newCert) = 0;
* @param[in] certificate A reference to the certificate to remove
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c certificate or the certificate data is invalid, or
- * the specified @c certificateType is invalid.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c certificate or the certificate data is invalid.
+ * - The specified @c certificateType is invalid.
* @exception E_OBJ_NOT_FOUND The certificate is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * Either the IPC operation or the file operation or the DB operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - Either the IPC operation or the file operation or the DB operation has failed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
virtual result Remove(CertificateType certificateType, const Tizen::Security::Cert::ICertificate& certificate) = 0;
//
/**
- * @file FSecCertTypes.h
+ * @file FSecCertTypes.h
* @brief This is the header file for the %CertTypes definitions.
*
* This header file contains the %CertTypes definitions.
*/
enum ValidationResult
{
- VALIDATION_SUCCESS = 0, /**< Success */
+ VALIDATION_SUCCESS = 0, /**< The validation is a success */
VALIDATION_ERROR_INVALID_PATH, /**< The certificate path does not validate */
- VALIDATION_ERROR_NO_ROOT, /**< The root certificate is not found */
+ VALIDATION_ERROR_NO_ROOT, /**< The root certificate is not found */
VALIDATION_ERROR_CERT_EXPIRED, /**< The certificate date falls outside the validity period */
VALIDATION_ERROR_CERT_REVOKED, /**< The certificate has been revoked */
- VALIDATION_ERROR_INVALID_SIGNATURE, /**< The signature is not valid */
+ VALIDATION_ERROR_INVALID_SIGNATURE, /**< The signature is not valid */
}; //ValidationResult
//
/**
- * @file FSecCertX509Certificate.h
+ * @file FSecCertX509Certificate.h
* @brief This is the header file for the %X509Certificate class.
*
* This header file contains the declarations of the %X509Certificate class.
/**
* @class X509Certificate
- * @brief This class is used for managing a variety of identity certificates.
+ * @brief This class provides methods for managing identity certificates.
*
* @since 2.0
*
- * The %X509Certificate class is used for managing a variety of identity certificates. @n
+ * The %X509Certificate class provides methods for managing identity certificates. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/certificate_namespace.htm">Certificates</a>.
*
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
result Construct(const Tizen::Base::ByteBuffer& input);
/**
- * Gets the format name for this certificate.
+ * Gets the format of this certificate.
*
* @since 2.0
*
- * @return The format of this certificate
+ * @return The certificate format
*/
virtual Tizen::Base::String GetFormat(void) const;
*
* @return The certificate type
* @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual CertificateType GetType(void) const;
/**
* Gets the encoded form of the certificate. @n
- * It is assumed that each certificate type will have only a single form of encoding. For example, X.509 certificates will be encoded as ASN.1 DER.
+ * It is assumed that each certificate type will have only a single form of encoding. For example, X.509 certificates will
+ * be encoded as ASN.1 DER.
*
* @since 2.0
*
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetEncodedDataN(void) const;
/**
* Gets the fingerprint of the certificate. @n
- * It is the hashed value of the encoding of the certificate.
+ * It is the hash value of the encoding of the certificate.
*
* @since 2.0
*
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate parsing operation or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate parsing operation has failed.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetFingerprintN(void) const;
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c publicKey is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate parsing operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate parsing operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual bool Verify(const Tizen::Security::IPublicKey& publicKey);
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::IPublicKey* GetPublicKeyN(void) const;
int GetSpecVersion(void) const;
/**
- * Gets the serial number value from the certificate. @n
- * The serial number is an integer assigned by the Certification Authority (CA) to each certificate. It is unique for each certificate issued by a given
- * CA (that is, the issuer name and serial number must identify a unique certificate). @n
+ * Gets the serial number of the certificate. @n
+ * The serial number is a unique integer assigned by the Certification Authority (CA) to each certificate (that is,
+ * the issuer name and serial number must identify a unique certificate). @n
*
* This is defined in ASN.1 as demonstrated in the following code:
*
* CertificateSerialNumber ::= INTEGER
* @endcode
*
- * This serial number can be greater than the system's maximum defined value for @c int, the output parameter type is @c ByteBuffer, instead of @c int.
+ * Since the serial number can be greater than the system's maximum defined value for @c int, the output parameter type
+ * is @c ByteBuffer, instead of @c int.
*
- * @since 2.0
+ * @since 2.0
*
* @return The serial number of the certificate
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::String GetSerialNumber(void) const;
/**
* Checks whether the certificate is currently valid. @n
- * It is valid if the current date and time are within the validity period given in the certificate. The validity period consists of two date and time
- * values: the initial date and time, and the final date and time until the validity of the certificate. @n
+ * It is valid if the current date and time are within the validity period of the certificate. The validity period consists
+ * of two date and time values: the initial date and time, and the final date and time for the validity of the certificate. @n
*
* This is defined in ASN.1 as demonstrated in the following code:
*
*
* @return The validity period of the certificate
* @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual ValidityPeriod CheckValidityPeriod(void);
* Gets the notBefore value of @c String type from the validity period of the certificate. @n
* This value represents the date and time before which the certificate is not valid.
*
- * @since 2.0
+ * @since 2.0
*
* @return A string representing the date and time value before which the certificate is not valid
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to get the certificate validity information.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to get the certificate validity information.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Tizen::Security::Cert::X509Certificate::CheckValidityPeriod(void) for relevant ASN.1 definitions.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::String GetNotBefore(void) const;
* Gets the notAfter value of @c String type from the validity period of the certificate. @n
* This value represents the date and time after which the certificate is not valid.
*
- * @since 2.0
+ * @since 2.0
*
* @return A string representing the date and time value after which the certificate is not valid
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to get the certificate validity information.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to get the certificate validity information.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Tizen::Security::Cert::X509Certificate::CheckValidityPeriod(void) for relevant ASN.1 definitions.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::String GetNotAfter(void) const;
/**
* Gets the name of the issuer of the certificate.
*
- * @since 2.0
+ * @since 2.0
*
* @return The name of the issuer of the certificate
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to get the certificate issuer information.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to get the certificate issuer information.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::String GetIssuer(void) const;
/**
* Gets the subject name of the certificate.
*
- * @since 2.0
+ * @since 2.0
*
* @return The subject name of the certificate
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to get the certificate issuer information.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to get the certificate issuer information.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::String GetSubject(void) const;
*
* The algorithm name is determined from the algorithm OID string.
*
- * @since 2.0
+ * @since 2.0
*
* @return The signature algorithm of the certificate
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::String GetSignatureAlgorithm(void) const;
/**
* Gets the signature of the certificate.
*
- * @since 2.0
+ * @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetSignatureN(void) const;
/**
* @class X509CertificatePath
- * @brief This class provides the certificate path.
+ * @brief This class provides methods for the certificate path.
*
* @since 2.0
*
- * The %X509CertificatePath class provides the certificate path. @n
+ * The %X509CertificatePath class provides methods for the certificate path. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/certificate_namespace.htm">Certificates</a>.
*/
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c certificate or the certificate data is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
*/
virtual result AddCertificate(const Tizen::Security::Cert::ICertificate& certificate);
*
* @return The result of the certificate path validation
* @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * The certificate link list operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::Cert::ValidationResult Validate(void);
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::Cert::ValidationResult Validate(const Tizen::Security::Cert::ICertificate& trustAnchor);
* @return The length of the certificate path, @n
* else @c -1 if an error occurs
* @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
*/
virtual int GetLength(void) const;
*
* @return A pointer to the ICertificate interface, @n
* else @c null if an error occurs
- * @param[in] nth The nth certificate in the certificate path (starts from @c 0)
+ * @param[in] nth The nth certificate in the certificate path (starts from @c 0)
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The value of the specified @c nth is out of the valid range. @n
* It must be less than the value retrieved by the GetLength() method.
* @exception E_OBJ_NOT_FOUND The certificate is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::Cert::ICertificate* GetCertificateN(int nth) const;
* @since 2.0
*
* @return The root certificate, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OBJ_NOT_FOUND The certificate is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The certificate link list operation or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The certificate link list operation has failed.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::Cert::ICertificate* GetTrustAnchorN(void) const;
/**
* @class X509CertificateSelector
- * @brief This class is used for managing a variety of identity certificates.
+ * @brief This class provides methods for managing a variety of identity certificates.
*
* @since 2.0
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/certificate_namespace.htm">Certificates</a>.
*
* @see ICertificate
- * @see Tizen::Security::Cert::ICertificateSelector
+ * @see ICertificateSelector
*/
class _OSP_EXPORT_ X509CertificateSelector
: public virtual ICertificateSelector
/**
* @class X509CertificateStore
- * @brief This class is used for retrieving and managing certificates from a repository.
+ * @brief This class provides methods for retrieving and managing certificates from a repository.
*
* @since 2.0
*
* @privilege %http://tizen.org/privilege/certificate.read
*
* @return An error code
- * @param[in] selector A selector that defines a set of criterion for selecting certificates
+ * @param[in] selector The selector that defines a set of criterion for selecting certificates
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The IPC operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The IPC operation has failed.
* @exception E_INVALID_ARG The specified @c selector is invalid.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
virtual result SetCertificateSelector(const Tizen::Security::Cert::ICertificateSelector& selector);
/**
- * Gets a count of certificates that match the specified selector.
+ * Gets the count of certificates that match the specified selector.
*
* @since 2.0
*
virtual result GetCertificateCount(int& count) const;
/**
- * Gets each certificate that matches the specified selector.
+ * Gets the certificate that matches the specified selector.
*
* @since 2.0
*
* @privlevel partner
* @privilege %http://tizen.org/privilege/certificate.read
*
- * @return The certificates that matches the specified selector
+ * @return The certificate that matches the specified selector
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OBJ_NOT_FOUND The certificate is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
virtual Tizen::Security::Cert::ICertificate* GetNextCertificateN(void) const;
* @param[in] certificate A reference to the certificate to insert
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c certificate or the certificate data is invalid, or
- * the specified @c certificateType is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * Either the IPC operation or the file operation or the DB operation has failed.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c certificate or the certificate data is invalid.
+ * - The specified @c certificateType is invalid.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - Either the IPC operation or the file operation or the DB operation has failed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
virtual result Insert(CertificateType certificateType, const Tizen::Security::Cert::ICertificate& certificate);
/**
- * Updates the certificate in the certificate store.
+ * Updates the certificate in the certificate store.
*
* @since 2.0
*
* @param[in] newCert A reference to the new certificate
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c certificate or the certificate data is invalid, or
- * the specified @c certificateType is invalid.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c certificate or the certificate data is invalid.
+ * - The specified @c certificateType is invalid.
* @exception E_OBJ_NOT_FOUND The certificate is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * Either the IPC operation or the file operation or the DB operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - Either the IPC operation or the file operation or the DB operation has failed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
virtual result Update(CertificateType certificateType, const Tizen::Security::Cert::ICertificate& oldCert, const Tizen::Security::Cert::ICertificate& newCert);
/**
- * Removes the certificate from the certificate store.
+ * Removes the certificate from the certificate store.
*
* @since 2.0
*
* @param[in] certificate A reference to the certificate to remove
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c certificate or the certificate data is invalid, or
- * the specified @c certificateType is invalid.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c certificate or the certificate data is invalid.
+ * - The specified @c certificateType is invalid.
* @exception E_OBJ_NOT_FOUND The certificate is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * Either the IPC operation or the file operation or the DB operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - Either the IPC operation or the file operation or the DB operation has failed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
virtual result Remove(CertificateType certificateType, const Tizen::Security::Cert::ICertificate& certificate);
* @privilege %http://tizen.org/privilege/certificate.write
*
* @return An error code
- * @param[in] filePath The file path of PKCS 12 certificate to insert
- * @param[in] password The password string to decrypt PKCS 12 certificate
+ * @param[in] filePath The file path of PKCS 12 certificate to insert
+ * @param[in] password The password string to decrypt PKCS 12 certificate
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c certificate or the certificate data is invalid.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FSecurity.h> @n
- * @b Library : @b osp-appfw
+ * @b Library: @b osp-appfw
*
- * The %Crypto namespace provides classes and methods to handle encryption and decryption using hashing, symmetric and asymmetric ciphers. It also provides a mechanism for sending messages over an insecure channel using a key pair (public and private keys). @n
+ * The %Crypto namespace provides classes and methods to handle encryption and decryption using hashing, symmetric and asymmetric
+ * ciphers. It also provides a mechanism for sending messages over an insecure channel using a key pair (public and private keys). @n
*
* For more information on the %Crypto namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/security/cryptography.htm">Crypto Guide</a>. @n
*
* @class AesCipher
* @brief This class provides methods for encryption and decryption using the Advanced Encryption Standard (AES) method.
*
- * @since 2.0
+ * @since 2.0
*
* The %AesCipher class provides a symmetric cipher using the Advanced Encryption Standard (AES) method.
- * Set appropriate values for the requested mode/key bit/padding scheme and cipher operation mode (::CIPHER_ENCRYPT, ::CIPHER_DECRYPT, ::CIPHER_WRAP,
- * or ::CIPHER_UNWRAP) parameters. @n
+ * This class allows to set appropriate values for the requested mode/key bit/padding scheme and cipher operation mode (::CIPHER_ENCRYPT, ::CIPHER_DECRYPT,
+ * ::CIPHER_WRAP, or ::CIPHER_UNWRAP) parameters. @n
*
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/ciphers.htm">Ciphers</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/ciphers.htm">Ciphers</a>.
*
* @see ISymmetricCipher
* @see DesCipher
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, @n
- * the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. @n
+ * For full construction, the Construct() method must be called right after calling this constructor.
*
* @since 2.0
*/
* @since 2.0
*
* @return An error code
- * @param[in] transformation The name of the requested mode/key bit/padding scheme @n
+ * @param[in] transformation The requested mode/key bit/padding scheme @n
* For example, "CBC/128/NOPADDING" or "CBC/192/NOPADDING".
* @param[in] opMode The cipher operation mode @n
* For example, @c CIPHER_ENCRYPT, @c CIPHER_DECRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c opMode does not contain a valid value for the cipher operation.
- * @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
- * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN() method is used, then the result obtained is @c null and an exception is returned.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c opMode does not contain a valid value for the cipher operation.
+ * @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
+ * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN()
+ * method is used, then the result obtained is @c null and an exception is returned.
*/
virtual result Construct(const Tizen::Base::String& transformation, enum CipherOperation opMode);
/**
- * Sets a symmetric key for encryption or decryption.
+ * Sets the symmetric key for encryption or decryption.
*
* @since 2.0
*
virtual result SetKey(const Tizen::Security::ISecretKey& key);
/**
- * Sets the initial vector.
+ * Sets the specified initial vector.
*
* @since 2.0
*
virtual result SetInitialVector(const Tizen::Base::ByteBuffer& initialVector);
/**
- * Encrypts the data (single-part).
+ * Encrypts the specified data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
- * @param[in] input An instance of Tizen::Base::ByteBuffer
+ * @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* EncryptN(const Tizen::Base::ByteBuffer& input);
* Decrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& input);
/**
- * Initializes a multiple-part encryption or decryption operation.
+ * Initializes the instance of %AesCipher for the multiple-part encryption or decryption.
*
* @since 2.0
*
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
*/
virtual result Initialize(void);
/**
- * Updates a multiple-part encryption or decryption operation.
+ * Updates the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
* @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* UpdateN(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part encryption or decryption operation.
+ * Finalizes the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
* Wraps a key.
*
* @since 2.0
- * @pre Before calling this method, a secret key should be set using SetKey().
+ * @pre Before calling this method, set a secret key using SetKey().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] secretKey The secret key to wrap
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_UNSUPPORTED_ALGORITHM The specified cipher algorithm for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* WrapN(const Tizen::Base::ByteBuffer& secretKey);
* Unwraps a previously wrapped key.
*
* @since 2.0
- * @pre Before calling this method, a secret key should be set using SetKey().
+ * @pre Before calling this method, set a secret key using SetKey().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] wrappedKey The wrapped key to unwrap
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_UNSUPPORTED_ALGORITHM The specified cipher algorithm for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* UnwrapN(const Tizen::Base::ByteBuffer& wrappedKey);
* @class CastCipher
* @brief This class provides methods for encryption and decryption using the CAST-128 algorithm.
*
- * @since 2.0
+ * @since 2.0
*
* The %CastCipher class provides a symmetric cipher using the CAST-128 algorithm.
- * Set appropriate values for the requested mode/key bit/padding scheme and cipher operation mode (::CIPHER_ENCRYPT
+ * This class allows to set appropriate values for the requested mode/key bit/padding scheme and cipher operation mode (::CIPHER_ENCRYPT
* or ::CIPHER_DECRYPT) parameters. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/ciphers.htm">Ciphers</a>.
* @since 2.0
*
* @return An error code
- * @param[in] transformation The name of the requested key bit/padding scheme @n
+ * @param[in] transformation The requested key bit/padding scheme @n
* The valid values for %CastCipher are "128/PKCS7PADDING" and "128/NOPADDING".
* @param[in] opMode The cipher operation mode @n
* The valid values for %CastCipher are @c CIPHER_ENCRYPT and @c CIPHER_DECRYPT.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c opMode does not contain a valid value for the cipher operation.
- * @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
- * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN() method is used, then the result obtained is @c null and an exception is returned.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c opMode does not contain a valid value for the cipher operation.
+ * @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
+ * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN()
+ * method is used, then the result obtained is @c null and an exception is returned.
*/
virtual result Construct(const Tizen::Base::String& transformation, enum CipherOperation opMode);
/**
- * Sets a symmetric key for encryption or decryption.
+ * Sets the symmetric key for encryption or decryption.
*
* @since 2.0
*
* Encrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* EncryptN(const Tizen::Base::ByteBuffer& input);
* Decrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& input);
/**
- * Initializes a multiple-part encryption or decryption operation.
+ * Initializes the instance of %CastCipher for the multiple-part encryption or decryption.
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
*/
virtual result Initialize(void);
/**
- * Updates a multiple-part encryption or decryption operation.
+ * Updates the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* UpdateN(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part encryption or decryption operation.
+ * Finalizes the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] secretKey The secret key to wrap
- * @remarks This operation is not supported in the %CastCipher class.
+ * @remarks
+ * - This operation is not supported in the %CastCipher class.
* Therefore, this method always returns @c null.
- * @remarks The @c E_UNSUPPORTED_ALGORITHM exception is returned if the GetLastResult() method is called.
+ * - The @c E_UNSUPPORTED_ALGORITHM exception is returned if the GetLastResult() method is called.
*/
virtual Tizen::Base::ByteBuffer* WrapN(const Tizen::Base::ByteBuffer& secretKey);
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] wrappedKey The wrapped key to unwrap
- * @remarks This operation is not supported in the %CastCipher class.
+ * @remarks
+ * - This operation is not supported in the %CastCipher class.
* Therefore, this method always returns @c null.
- * @remarks The @c E_UNSUPPORTED_ALGORITHM exception is returned if the GetLastResult() method is called.
+ * - The @c E_UNSUPPORTED_ALGORITHM exception is returned if the GetLastResult() method is called.
*/
virtual Tizen::Base::ByteBuffer* UnwrapN(const Tizen::Base::ByteBuffer& wrappedKey);
* @class DesCipher
* @brief This class provides methods for encryption and decryption using the Data Encryption Standard (DES) method.
*
- * @since 2.0
+ * @since 2.0
*
* The %DesCipher class provides a symmetric cipher using the Data Encryption Standard (DES) method.
- * Sets appropriate values for the requested mode/key bit/padding scheme and cipher operation mode
+ * This class allows to set appropriate values for the requested mode/key bit/padding scheme and cipher operation mode
* (::CIPHER_ENCRYPT or ::CIPHER_DECRYPT) parameters. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/ciphers.htm">Ciphers</a>.
* @since 2.0
*
* @return An error code
- * @param[in] transformation The name of the requested mode/key bit/padding scheme @n
+ * @param[in] transformation The requested mode/key bit/padding scheme @n
* For example, "CBC/NOPADDING" or "CBC/PKCS7PADDING".
* @param[in] opMode The cipher operation mode @n
* The valid values for %DesCipher are @c CIPHER_ENCRYPT and @c CIPHER_DECRYPT.
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c opMode does not contain a valid value for the cipher operation.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c opMode does not contain a valid value for the cipher operation.
* @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
- * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN() method is used, then the result obtained is @c null and an exception is returned.
+ * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN()
+ * method is used, then the result obtained is @c null and an exception is returned.
*/
virtual result Construct(const Tizen::Base::String& transformation, enum CipherOperation opMode);
/**
- * Sets a symmetric key for encryption or decryption.
+ * Sets the symmetric key for encryption or decryption.
*
* @since 2.0
*
* Encrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* EncryptN(const Tizen::Base::ByteBuffer& input);
* Decrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
- * @param[in] input An instance of Tizen::Base::ByteBuffer
+ * @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& input);
/**
- * Initializes a multiple-part encryption or decryption operation.
+ * Initializes the instance of %DesCipher for the multiple-part encryption or decryption.
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
*/
virtual result Initialize(void);
/**
- * Updates a multiple-part encryption or decryption operation.
+ * Updates the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* UpdateN(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part encryption or decryption operation.
+ * Finalizes the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
* @class DesEdeCipher
* @brief This class provides methods for encryption and decryption using the Data Encryption Standard in the Encrypt-Decrypt-Encrypt (DES-EDE) mode.
*
- * @since 2.0
+ * @since 2.0
*
* The %DesEdeCipher class provides symmetric cipher using the Data Encryption Standard in the Encrypt-Decrypt-Encrypt (DES-EDE) mode.
- * Sets appropriate values for the requested mode/key bit/padding scheme and cipher operation (::CIPHER_ENCRYPT or ::CIPHER_DECRYPT) parameters. @n
+ * This class allows to set appropriate values for the requested mode/key bit/padding scheme and cipher operation (::CIPHER_ENCRYPT or ::CIPHER_DECRYPT) parameters. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/ciphers.htm">Ciphers</a>.
*
* @since 2.0
*
* @return An error code
- * @param[in] transformation The name of the requested mode/key bit/padding scheme @n
+ * @param[in] transformation The requested mode/key bit/padding scheme @n
* For example, "CBC/NOPADDING" or "CBC/PKCS7PADDING".
* @param[in] opMode The cipher operation mode @n
* The valid values for %DesEdeCipher are @c CIPHER_ENCRYPT and @c CIPHER_DECRYPT.
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c opMode does not contain a valid value for the cipher operation.
- * @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
- * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN() method is used, then the result obtained is @c null and an exception is returned.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c opMode does not contain a valid value for the cipher operation.
+ * @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
+ * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN()
+ * method is used, then the result obtained is @c null and an exception is returned.
*/
virtual result Construct(const Tizen::Base::String& transformation, enum CipherOperation opMode);
/**
- * Sets a symmetric key for encryption or decryption.
+ * Sets the symmetric key for encryption or decryption.
*
* @since 2.0
*
* Encrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* EncryptN(const Tizen::Base::ByteBuffer& input);
* Decrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& input);
/**
- * Initializes a multiple-part encryption or decryption operation.
+ * Initializes the instance of %DesEdeCipher for the multiple-part encryption or decryption.
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
*/
virtual result Initialize(void);
/**
- * Updates a multiple-part encryption or decryption operation.
+ * Updates the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* UpdateN(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part encryption or decryption operation.
+ * Finalizes the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
//
/**
- * @file FSecCryptoDhKeyExchange.h
+ * @file FSecCryptoDhKeyExchange.h
* @brief This is the header file for the %DhKeyExchange class.
*
* This header file contains the declarations of the %DhKeyExchange class.
* @class DhKeyExchange
* @brief This class provides methods for a key exchange mechanism using the Diffie-Hellman (DH) algorithm.
*
- * @since 2.0
+ * @since 2.0
*
* The %DhKeyExchange class provides a DH key exchange between two communicating users. @n
*
* @since 2.0
*
* @return An error code
- * @param[in] keyParameters The domain parameters ('p' prime number and 'g' generator) of DH
- * algorithm that needs to instantiate
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified input parameter is invalid, or the specified @c keyParameters does not contain a valid value. */
+ * @param[in] keyParameters The domain parameters ('p' prime number and 'g' generator) of DH algorithm
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG The specified input parameter is invalid, or the specified @c keyParameters does not contain a valid value.
+ */
virtual result Construct(const Tizen::Security::IKeyParameters& keyParameters);
/**
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GenerateSecretN(Tizen::Security::IPrivateKey& privateKey, Tizen::Security::IPublicKey& publicKey);
/**
* @interface IAsymmetricCipher
- * @brief This interface provides the functionality of an asymmetric cryptographic cipher for encryption and decryption.
+ * @brief This interface provides methods for the functionality of an asymmetric cryptographic cipher for encryption and decryption.
*
* @since 2.0
*
virtual ~IAsymmetricCipher(void) {}
/**
- * Sets an asymmetric private key for encryption or decryption.
+ * Sets the asymmetric private key for encryption or decryption.
*
* @since 2.0
*
virtual result SetPrivateKey(const Tizen::Security::IKey& key) = 0;
/**
- * Sets an asymmetric public key for encryption or decryption.
+ * Sets the asymmetric public key for encryption or decryption.
*
* @since 2.0
*
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
+ * @return A pointer to the Tizen::Base::ByteBuffer instance that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_UNSUPPORTED_ALGORITHM The algorithm is not supported.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.n
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual Tizen::Base::ByteBuffer* EncryptN(const Tizen::Base::ByteBuffer& input) = 0;
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
+ * @return A pointer to the Tizen::Base::ByteBuffer instance that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_UNSUPPORTED_ALGORITHM The algorithm is not supported.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& input) = 0;
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/hashing.htm">Hashing</a>. @n
*
- * The following example demonstrates how to use the %IHash interface.
- * @code
+ * The following example demonstrates how to use the %IHash interface.
+ * @code
*
* result
* MyClass::TestHashSample(void)
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
/**
* Sets the hash algorithm. @n
- * Only supported in Secure Hash Algorithm-2 (SHA-2).
+ * This method is only supported in Secure Hash Algorithm-2 (SHA-2).
*
* @since 2.0
*
* @return An error code
- * @param[in] algorithm The name of the hash algorithm @n
+ * @param[in] algorithm The hash algorithm name @n
* For example, "SHA2/224", "SHA2/256", "SHA2/384", or "SHA2/512".
* @exception E_SUCCESS The method is successful.
* @exception E_UNSUPPORTED_ALGORITHM The algorithm is not supported.
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
- * @param[in] input An instance of Tizen::Base::ByteBuffer
+ * @param[in] input An instance of Tizen::Base::ByteBuffer containing the data
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual Tizen::Base::ByteBuffer* GetHashN(const Tizen::Base::ByteBuffer& input) const = 0;
/**
- * Initializes a multiple-part hash operation.
+ * Initializes the multiple-part hash operation.
*
* @since 2.0
*
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
*/
virtual result Initialize(void) = 0;
/**
- * Updates a multiple-part hash operation while processing another data part.
+ * Updates the multiple-part hash operation while processing another data part.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual result Update(const Tizen::Base::ByteBuffer& input) = 0;
/**
- * Finalizes a multiple-part hash operation.
+ * Finalizes the multiple-part hash operation.
*
* @since 2.0
*
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void) = 0;
} } } //Tizen::Security::Crypto
-#endif //_FSEC_CRYPTO_IHASH_H_
+#endif //_FSEC_CRYPTO_IHASH_H_
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
* @since 2.0
*
* @return An error code
- * @param[in] algorithm The name of the HMAC algorithm @n
+ * @param[in] algorithm The HMAC algorithm @n
* For example, "HMACSHA2/224", "HMACSHA2/256", "HMACSHA2/384", or "HMACSHA2/512".
* @exception E_SUCCESS The method is successful.
* @exception E_UNSUPPORTED_ALGORITHM The algorithm is not supported.
virtual result SetKey(const Tizen::Security::ISecretKey& key) = 0;
/**
- * Gets the HMAC with a given input.
+ * Gets the HMAC for the specified input.
*
- * @since 2.0
+ * @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual Tizen::Base::ByteBuffer* GetHmacN(const Tizen::Base::ByteBuffer& input) const = 0;
/**
- * Initializes a multiple-part HMAC operation.
+ * Initializes the multiple-part HMAC operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
*/
virtual result Initialize(void) = 0;
/**
- * Updates a multiple-part HMAC operation while processing another data part.
+ * Updates the multiple-part HMAC operation while processing another data part.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual result Update(const Tizen::Base::ByteBuffer& input) = 0;
/**
- * Finalizes a multiple-part HMAC operation.
+ * Finalizes the multiple-part HMAC operation.
*
* @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void) = 0;
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
* @since 2.0
*
* @return An error code
- * @param[in] keyParameters The domain parameters of the key exchange algorithm that needs to instantiate
+ * @param[in] keyParameters The domain parameters of the key exchange algorithm
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GenerateSecretN(Tizen::Security::IPrivateKey& privateKey, Tizen::Security::IPublicKey& publicKey) = 0;
//
/**
- * @file FSecCryptoISignature.h
+ * @file FSecCryptoISignature.h
* @brief This is the header file for the %ISignature interface.
*
* This header file contains the declarations of the %ISignature interface.
/**
* @interface ISignature
- * @brief This interface provides the functionality of a digital signature algorithm.
+ * @brief This interface provides methods for a digital signature algorithm.
*
* @since 2.0
*
*
* The following example demonstrates how to use the %ISignature interface.
*
- * @code
+ * @code
*
* void
* MyClass::TestSignatureSample(void)
*
* r = E_SUCCESS;
*
- * CATCH:
+ * CATCH:
* delete pSignature;
* delete pOutput;
* delete pKeyPairGen;
* delete pKeyPair;
- * }
+ * }
*
- * @endcode
+ * @endcode
*/
class _OSP_EXPORT_ ISignature
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
virtual ~ISignature(void) {}
/**
- * Sets an asymmetric private key for signature.
+ * Sets the asymmetric private key for signature.
*
* @since 2.0
*
virtual result SetPrivateKey(const Tizen::Security::IKey& key) = 0;
/**
- * Sets an asymmetric public key for verification.
+ * Sets the asymmetric public key for verification.
*
* @since 2.0
*
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual Tizen::Base::ByteBuffer* SignN(const Tizen::Base::ByteBuffer& input) = 0;
/**
- * Verifies the data. @n
+ * Verifies the specified data. @n
* The verification is done by comparing the @c signedData to the signature created by the @c data.
*
* @since 2.0
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual bool Verify(const Tizen::Base::ByteBuffer& data, const Tizen::Base::ByteBuffer& signedData) = 0;
//
/**
- * @file FSecCryptoISymmetricCipher.h
+ * @file FSecCryptoISymmetricCipher.h
* @brief This is the header file for the %ISymmetricCipher interface.
*
* This header file contains the declarations of the %ISymmetricCipher interface.
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
* @since 2.0
*
* @return An error code
- * @param[in] transformation The name of the requested mode or key bit or padding scheme
+ * @param[in] transformation The requested mode or key bit or padding scheme
* @param[in] opMode The cipher operation mode @n
* For example, @c CIPHER_ENCRYPT, @c CIPHER_DECRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP.
* @exception E_SUCCESS The method is successful.
virtual result Construct(const Tizen::Base::String& transformation, enum CipherOperation opMode = Tizen::Security::Crypto::CIPHER_ENCRYPT) = 0;
/**
- * Sets a symmetric key for encryption or decryption.
+ * Sets the symmetric key for encryption or decryption.
*
* @since 2.0
*
* @return An error code
- * @param[in] key An instance of ISecretKey
+ * @param[in] key An instance of ISecretKey to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c key is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @since 2.0
*
* @return An error code
- * @param[in] initialVector The initial vector
+ * @param[in] initialVector The initial vector to set
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual Tizen::Base::ByteBuffer* EncryptN(const Tizen::Base::ByteBuffer& input) = 0;
* @exception E_KEY_NOT_FOUND The key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& input) = 0;
/**
- * Initializes a multiple-part encryption or decryption operation.
+ * Initializes the instance of %ISymmetricCipher for the multiple-part encryption or decryption operation.
+ *
*
* @since 2.0
*
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
*/
virtual result Initialize(void) = 0;
/**
- * Updates a multiple-part encryption or decryption operation.
+ * Updates the instance of %ISymmetricCipher for the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* UpdateN(const Tizen::Base::ByteBuffer& input) = 0;
/**
- * Finalizes a multiple-part encryption or decryption operation.
+ * Finalizes the instance of %ISymmetricCipher for the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void) = 0;
/**
- * Wraps the specified key.
+ * Wraps a key.
*
* @since 2.0
*
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks
- * - The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
* - This operation is only supported in AesCipher.
*/
virtual Tizen::Base::ByteBuffer* WrapN(const Tizen::Base::ByteBuffer& secretKey) = 0;
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks
* - The specific error code can be accessed using the GetLastResult() method.
* - This operation is only supported in AesCipher.
* @class KeaKeyExchange
* @brief This class provides methods for performing the key exchange mechanism using Key Exchange Algorithm (KEA).
*
- * @since 2.0
+ * @since 2.0
*
* The %KeaKeyExchange class provides a KEA key exchange between two communicating users. @n
*
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_exchange_algorithm.htm">Key exchanging</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_exchange_algorithm.htm">Key exchanging</a>.
*
- * @see IKeyExchange
- * @see KeyPairGenerator
+ * @see IKeyExchange
+ * @see KeyPairGenerator
*
- * The following example demonstrates how to use the %KeaKeyExchange class.
- * @code
+ * The following example demonstrates how to use the %KeaKeyExchange class.
+ * @code
*
* void KeaGenerateSecretExample(void)
* {
* This parameter needs to be instantiated.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
*/
virtual result Construct(const Tizen::Security::IKeyParameters& keyParameters);
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GenerateSecretN(Tizen::Security::IPrivateKey& privateKey, Tizen::Security::IPublicKey& publicKey);
/**
* This destructor overrides Tizen::Base::Object::~Object().
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~Md5Hash(void);
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetHashN(const Tizen::Base::ByteBuffer& input) const;
/**
- * Initializes a multiple-part hash operation.
+ * Initializes the multiple-part hash operation.
*
* @since 2.0
*
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the openssl library.
*/
virtual result Initialize(void);
/**
- * Updates a multiple-part hash operation while processing another data part.
+ * Updates the multiple-part hash operation while processing another data part.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual result Update(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part hash operation.
+ * Finalizes the multiple-part hash operation.
*
* @since 2.0
*
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the openssl library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
*
* @since 2.0
*
- * The %Md5Hmac class implements the basic hash procedure to encrypt messages using the Hash Message Authentication Code (HMAC) algorithm, which provides a hash with a secret key. @n
+ * The %Md5Hmac class implements the basic hash procedure to encrypt messages using the Hash Message Authentication Code (HMAC)
+ * algorithm, which provides a hash with a secret key.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/hashing.htm">Hashing</a>.
*
/**
* This destructor overrides Tizen::Base::Object::~Object().
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~Md5Hmac(void);
* @since 2.0
*
* @return An error code
- * @param[in] algorithm The name of the HMAC algorithm @n
+ * @param[in] algorithm The HMAC algorithm name @n
* For example, "HMACSHA2/224", "HMACSHA2/256", "HMACSHA2/384", or "HMACSHA2/512".
* @exception E_SUCCESS The method is successful.
* @exception E_UNSUPPORTED_ALGORITHM The algorithm is not supported.
- * @remarks Do not call this method. It is not supported.
+ * @remarks Do not call this method. It is not supported.
*/
virtual result SetAlgorithm(const Tizen::Base::String& algorithm);
/**
* Sets the secret key.
*
- * @since 2.0
+ * @since 2.0
*
* @return An error code
* @param[in] key An instance of ISecretKey
virtual result SetKey(const Tizen::Security::ISecretKey& key);
/**
- * Gets the HMAC with the specified input.
+ * Gets the HMAC for the specified input.
*
* @since 2.0
*
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetHmacN(const Tizen::Base::ByteBuffer& input) const;
/**
- * Initializes a multiple-part HMAC operation.
+ * Initializes the multiple-part HMAC operation.
*
* @since 2.0
*
virtual result Initialize(void);
/**
- * Updates a multiple-part HMAC operation while processing another data part.
+ * Updates the multiple-part HMAC operation while processing another data part.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual result Update(const Tizen::Base::ByteBuffer& input);
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
*
* @since 2.0
*
- * The %Rc2Cipher class provides a symmetric cipher using the RC2 algorithm.
- * It sets appropriate values for the requested mode/key bit/padding scheme and cipher operation (CIPHER_ENCRYPT or CIPHER_DECRYPT) parameters. @n
+ * The %Rc2Cipher class provides a symmetric cipher using the RC2 algorithm. @n
+ * This class allows to set appropriate values for the requested mode/key bit/padding scheme and cipher operation (CIPHER_ENCRYPT or CIPHER_DECRYPT) parameters. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/ciphers.htm">Ciphers</a>.
*
* @see ISymmetricCipher
- * @see DesCipher
- * @see DesEdeCipher
+ * @see DesCipher
+ * @see DesEdeCipher
*/
class _OSP_EXPORT_ Rc2Cipher
: public virtual ISymmetricCipher
* @since 2.0
*
* @return An error code
- * @param[in] transformation The name of the requested mode/padding scheme @n
+ * @param[in] transformation The requested mode/padding scheme @n
* The RC2 support variable length key ranges from 8 bits to 128 bits, in steps of 8 bits.
* The key bits are not required to be mentioned in the transformation.
* There are four valid transformations for RC2, "CBC/NOPADDING",
* @param[in] opMode The cipher operation mode @n
* The valid values for %Rc2Cipher are @c CIPHER_ENCRYPT and @c CIPHER_DECRYPT.
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c opMode does not contain a valid value for the cipher operation.
- * @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
- * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN() method is used, then the result obtained is @c null and an exception is returned.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c opMode does not contain a valid value for the cipher operation.
+ * @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
+ * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN() method is used, then the
+ * result obtained is @c null and an exception is returned.
*/
virtual result Construct(const Tizen::Base::String& transformation, enum CipherOperation opMode);
/**
- * Sets a symmetric key for encryption or decryption. @n
- * The variable length key ranges from 8 bits to 128 bits, in steps of 8 bits.
+ * Sets the symmetric key for encryption or decryption. @n
+ * The variable length key ranges from 8 bits to 128 bits, in steps of 8 bits.
*
* @since 2.0
*
* Encrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* EncryptN(const Tizen::Base::ByteBuffer& input);
* Decrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& input);
/**
- * Initializes a multiple-part encryption or decryption operation.
+ * Initializes the instance of %Rc2Cipher for the multiple-part encryption or decryption.
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
*/
virtual result Initialize(void);
/**
- * Updates a multiple-part encryption or decryption operation.
+ * Updates the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* UpdateN(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part encryption or decryption operation.
+ * Finalizes the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
*
* @since 2.0
*
- * The %Rc4Cipher class provides a symmetric cipher using the RC4 algorithm.
- * It sets appropriate values for the requested mode/key bit/padding scheme and cipher operation (CIPHER_ENCRYPT or CIPHER_DECRYPT) parameters. @n
+ * The %Rc4Cipher class provides a symmetric cipher using the RC4 algorithm. @n
+ * This class allows to set appropriate values for the requested mode/key bit/padding scheme and cipher operation (CIPHER_ENCRYPT or CIPHER_DECRYPT) parameters. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/ciphers.htm">Ciphers</a>.
*
* @see ISymmetricCipher
- * @see DesCipher
- * @see DesEdeCipher
+ * @see DesCipher
+ * @see DesEdeCipher
*/
class _OSP_EXPORT_ Rc4Cipher
: public virtual ISymmetricCipher
* @param[in] opMode The cipher operation mode @n
* The valid values for %Rc4Cipher are @c CIPHER_ENCRYPT and @c CIPHER_DECRYPT.
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
- * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN() method is used, then the result obtained is @c null and an exception is returned.
+ * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN()
+ * method is used, then the result obtained is @c null and an exception is returned.
*/
virtual result Construct(const Tizen::Base::String& transformation, enum CipherOperation opMode);
/**
- * Sets a symmetric key for encryption or decryption operation. @n
- * The variable length key ranges from 40 bits to 256 bits, in steps of 8 bits.
+ * Sets the symmetric key for encryption or decryption operation. @n
+ * The variable length key ranges from 40 bits to 256 bits, in steps of 8 bits.
*
* @since 2.0
*
* Encrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* EncryptN(const Tizen::Base::ByteBuffer& input);
* Decrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& input);
/**
- * Initializes a multiple-part encryption or decryption operation.
+ * Initializes the instance of %Rc4Cipher for the multiple-part encryption or decryption.
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- The method has failed to operate with the OpenSSL library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
*/
virtual result Initialize(void);
/**
- * Updates a multiple-part encryption or decryption operation.
+ * Updates the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* UpdateN(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part encryption or decryption operation.
+ * Finalizes the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks This operation is not required for RC4. Always return @c null if this method is called.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
virtual ~RsaCipher(void);
/**
- * Sets an asymmetric private key for encryption or decryption.
+ * Sets the asymmetric private key for encryption or decryption.
*
* @since 2.0
*
virtual result SetPrivateKey(const Tizen::Security::IKey& key);
/**
- * Sets an asymmetric public key for encryption or decryption.
+ * Sets the asymmetric public key for encryption or decryption.
*
* @since 2.0
*
* @exception E_UNSUPPORTED_ALGORITHM The algorithm is not supported.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* EncryptN(const Tizen::Base::ByteBuffer& input);
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
- * @param[in] input An instance of Tizen::Base::ByteBuffer
+ * @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_UNSUPPORTED_ALGORITHM The algorithm is not supported.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& input);
*
* The %RsaSignature class implements the Rivest Shamir Adleman (RSA) signatures. @n
*
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/ciphers.htm">Ciphers</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/ciphers.htm">Ciphers</a>.
*
* @see ISignature
* @see IKeyPairGenerator
virtual ~RsaSignature(void);
/**
- * Sets an asymmetric private key for signature.
+ * Sets the asymmetric private key for signature.
*
* @since 2.0
*
* @return An error code
- * @param[in] key An instance of IKey.
- * Key can be in PEM/DER/PKCS8 format only.
+ * @param[in] key An instance of IKey
+ * The key can be in PEM/DER/PKCS8 format only.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c key is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
virtual result SetPrivateKey(const Tizen::Security::IKey& key);
/**
- * Sets an asymmetric public key for verification.
+ * Sets the asymmetric public key for verification.
*
* @since 2.0
*
* @return An error code
* @param[in] key An instance of IKey
- * Key can be in PEM/DER/X509 public key format only.
+ * The key can be in PEM/DER/X509 public key format only.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c key is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* The %SignN() method only supports sha1withRsa for signing the data
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
+ * @return A pointer to the Tizen::Base::ByteBuffer instance that contains the output, @n
* else @c null if an error occurs
- * @param[in] input An instance of Tizen::Base::ByteBuffer
+ * @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* SignN(const Tizen::Base::ByteBuffer& input);
/**
* Signs the data. @n
- * The %SignN() method provides the additional option to developer for setting digest algorithm that is needed for signing the data
+ * The %SignN() method provides the additional option for setting the digest algorithm that is needed for signing the data
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
+ * @return A pointer to the Tizen::Base::ByteBuffer instance that contains the output, @n
* else @c null if an error occurs
- * @param[in] input An instance of Tizen::Base::ByteBuffer
- * @param[in] algorithm An instance of Tizen::Base::String that contains the digest algorithm,
- * valid values are MD5, MD5WITHSHA1, SHA1, SHA2/224, SHA2/256, SHA2/384, SHA2/512.
+ * @param[in] input An instance of Tizen::Base::ByteBuffer
+ * @param[in] algorithm The Tizen::Base::String instance that contains the digest algorithm. @n
+ * The valid values are MD5, MD5WITHSHA1, SHA1, SHA2/224, SHA2/256, SHA2/384, SHA2/512.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_UNSUPPORTED_ALGORITHM The specified algorithm is not supported.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::ByteBuffer* SignN(const Tizen::Base::ByteBuffer& input, const Tizen::Base::String& algorithm);
* @return @c true if the signed data is correct, @n
* else @c false
* @param[in] data An instance of Tizen::Base::ByteBuffer that contains the original data
- * @param[in] signedData A instance of Tizen::Base::ByteBuffer that contains the signed data
+ * @param[in] signedData An instance of Tizen::Base::ByteBuffer that contains the signed data
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual bool Verify(const Tizen::Base::ByteBuffer& data, const Tizen::Base::ByteBuffer& signedData);
/**
* Verifies the data. @n
* The verification is done by comparing the @c signedData to the signature created by the @c data. @n
- * The %Verify() method provides the additional option to developer for setting digest algorithm that is needed for verifying the signed data
+ * The %Verify() method provides the additional option for setting the digest algorithm that is needed for verifying the signed data
*
* @since 2.0
*
* @return @c true if the signed data is correct, @n
* else @c false
* @param[in] data An instance of Tizen::Base::ByteBuffer that contains the original data
- * @param[in] signedData A instance of Tizen::Base::ByteBuffer that contains the signed data
- * @param[in] algorithm An instance of Tizen::Base::String that contains the digest algorithm,
- * valid values are MD5, MD5WITHSHA1, SHA1, SHA2/224, SHA2/256, SHA2/384, SHA2/512.
+ * @param[in] signedData An instance of Tizen::Base::ByteBuffer that contains the signed data
+ * @param[in] algorithm The Tizen::Base::String instance that contains the digest algorithm. @n
+ * The valid values are MD5, MD5WITHSHA1, SHA1, SHA2/224, SHA2/256, SHA2/384, SHA2/512.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_UNSUPPORTED_ALGORITHM The specified algorithm is not supported.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
bool Verify(const Tizen::Base::ByteBuffer& data, const Tizen::Base::ByteBuffer& signedData, const Tizen::Base::String& algorithm);
*
* The %Sha1Hash class implements the SHA-1 hash algorithm. @n
*
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/hashing.htm">Hashing</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/hashing.htm">Hashing</a>.
*
* @see IHash
* @see Md5Hash
* @since 2.0
*
* @return An error code
- * @param[in] algorithm The name of the hash algorithm @n
+ * @param[in] algorithm The hash algorithm name @n
* For example "SHA2/224", "SHA2/256", "SHA2/384", or "SHA2/512".
* @exception E_SUCCESS The method is successful.
* @exception E_UNSUPPORTED_ALGORITHM The algorithm is not supported.
virtual result SetAlgorithm(const Tizen::Base::String& algorithm);
/**
- * Gets the hashes of a data (single-part).
+ * Gets the hashes of the specified data (single-part).
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetHashN(const Tizen::Base::ByteBuffer& input) const;
/**
- * Initializes a multiple-part hash operation.
+ * Initializes the multiple-part hash operation.
*
* @since 2.0
*
virtual result Initialize(void);
/**
- * Updates a multiple-part hash operation while processing another data part.
+ * Updates the multiple-part hash operation while processing another data part.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual result Update(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part hash operation.
+ * Finalizes the multiple-part hash operation.
*
* @since 2.0
*
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
*
* The %Sha1Hmac class implements the SHA-1 HMAC algorithm. @n
*
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/hashing.htm">Hashing</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/hashing.htm">Hashing</a>.
*
* @see IHmac
* @see Md5Hmac
/**
* This is the default constructor for this class.
*
- * @since 2.0
+ * @since 2.0
*/
Sha1Hmac(void);
/**
- * This destructor overrides Tizen::Base::Object::~Object().
+ * This destructor overrides Tizen::Base::Object::~Object().
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~Sha1Hmac(void);
* @since 2.0
*
* @return An error code
- * @param[in] algorithm The name of the HMAC algorithm @n
+ * @param[in] algorithm The HMAC algorithm name @n
* For example, "HMACSHA2/224", "HMACSHA2/256", "HMACSHA2/384", or "HMACSHA2/512".
* @exception E_SUCCESS The method is successful.
* @exception E_UNSUPPORTED_ALGORITHM The algorithm is not supported.
virtual result SetKey(const Tizen::Security::ISecretKey& key);
/**
- * Gets HMAC with the given input.
+ * Gets the HMAC for the specified input.
*
* @since 2.0
*
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetHmacN(const Tizen::Base::ByteBuffer& input) const;
/**
- * Initializes a multiple-part HMAC operation.
+ * Initializes the multiple-part HMAC operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
*/
virtual result Initialize(void);
/**
- * Updates a multiple-part HMAC operation while processing another data part.
+ * Updates the multiple-part HMAC operation while processing another data part.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual result Update(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part HMAC operation.
+ * Finalizes the multiple-part HMAC operation.
*
* @since 2.0
*
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
*
* The %Sha2Hash class implements the SHA-2 hash algorithm. @n
*
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/hashing.htm">Hashing</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/hashing.htm">Hashing</a>.
*
* @see Tizen::Security::Crypto::IHash
* @see Tizen::Security::Crypto::Md5Hash
Sha2Hash(void);
/**
- * This destructor overrides Tizen::Base::Object::~Object().
+ * This destructor overrides Tizen::Base::Object::~Object().
*
* @since 2.0
*/
* @since 2.0
*
* @return An error code
- * @param[in] algorithm The name of the hash algorithm @n
+ * @param[in] algorithm The hash algorithm name @n
* For example, "SHA2/224", "SHA2/256", "SHA2/384", or "SHA2/512".
* @exception E_SUCCESS The method is successful.
* @exception E_UNSUPPORTED_ALGORITHM The algorithm is not supported.
virtual result SetAlgorithm(const Tizen::Base::String& algorithm);
/**
- * Gets the hashes of the data (single-part).
+ * Gets the hashes of the specified data (single-part).
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetHashN(const Tizen::Base::ByteBuffer& input) const;
/**
- * Initializes a multiple-part hash operation.
+ * Initializes the multiple-part hash operation.
*
* @since 2.0
*
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
*/
virtual result Initialize(void);
/**
- * Updates a multiple-part hash operation while processing another data part.
+ * Updates the multiple-part hash operation while processing another data part.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual result Update(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part hash operation.
+ * Finalizes the multiple-part hash operation.
*
* @since 2.0
*
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
*
* The %Sha2Hmac class implements the SHA-2 HMAC algorithm. @n
*
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/hashing.htm">Hashing</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/hashing.htm">Hashing</a>.
*
* @see Tizen::Security::Crypto::IHmac
* @see Tizen::Security::Crypto::Md5Hmac
* @since 2.0
*
* @return An error code
- * @param[in] algorithm The name of the HMAC algorithm @n
+ * @param[in] algorithm The HMAC algorithm name @n
* For example, "HMACSHA2/224", "HMACSHA2/256", "HMACSHA2/384", or "HMACSHA2/512".
* @exception E_SUCCESS The method is successful.
* @exception E_UNSUPPORTED_ALGORITHM The algorithm is not supported.
virtual result SetKey(const Tizen::Security::ISecretKey& key);
/**
- * Gets the HMAC with the given input.
+ * Gets the HMAC for the specified input.
*
* @since 2.0
*
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetHmacN(const Tizen::Base::ByteBuffer& input) const;
/**
- * Initializes a multiple-part HMAC operation.
+ * Initializes the multiple-part HMAC operation.
*
* @since 2.0
*
virtual result Initialize(void);
/**
- * Updates a multiple-part HMAC operation while processing another part of the data.
+ * Updates the multiple-part HMAC operation while processing another part of the data.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual result Update(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part HMAC operation.
+ * Finalizes the multiple-part HMAC operation.
*
* @since 2.0
*
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
*
* @since 2.0
*
- * The %SkipJackCipher class provides a symmetric cipher using the Skipjack algorithm. Appropriate values have to be set for the requested mode or key bit or
- * padding scheme and the cipher operation (::CIPHER_ENCRYPT or ::CIPHER_DECRYPT) parameters. @n
+ * The %SkipJackCipher class provides a symmetric cipher using the Skipjack algorithm. @n
+ * This class allows to set appropriate values for the requested mode or key bit or padding scheme and the cipher operation (::CIPHER_ENCRYPT or ::CIPHER_DECRYPT) parameters.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/ciphers.htm">Ciphers</a>.
*
* @since 2.0
*
* @return An error code
- * @param[in] transformation The name of the requested mode or padding scheme @n
+ * @param[in] transformation The requested mode or padding scheme @n
* As the default key size of the Skipjack cipher is 80 bits, there is no need to mention it explicitly.
* For example, "CBC/PKCS7PADDING" or "ECB/NOPADDING".
* @param[in] opMode The cipher operation mode @n
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c opMode contains invalid value for the cipher operation.
- * @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
- * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN() method is used, then the result obtained is @c null and an exception is returned.
+ * @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n
+ * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN() method is used,
+ * then the result obtained is @c null and an exception is returned.
*/
virtual result Construct(const Tizen::Base::String& transformation, enum CipherOperation opMode);
/**
- * Sets a symmetric key for encryption or decryption.
+ * Sets the symmetric key for encryption or decryption.
*
* @since 2.0
*
* Encrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* EncryptN(const Tizen::Base::ByteBuffer& input);
* Decrypts the data (single-part).
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
* @param[in] input An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The input Tizen::Base::ByteBuffer is empty or contains invalid data.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& input);
/**
- * Initializes a multiple-part encryption or decryption operation.
+ * Initializes the instance of %SkipJackCipher for the multiple-part encryption or decryption.
*
* @since 2.0
- * @pre Before calling this method, a secret key and an initial vector should be set using SetKey() and SetInitialVector().
+ * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector().
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_KEY_NOT_FOUND The specified key is not found.
* @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
*/
virtual result Initialize(void);
/**
- * Updates a multiple-part encryption or decryption operation.
+ * Updates the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
* @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* UpdateN(const Tizen::Base::ByteBuffer& input);
/**
- * Finalizes a multiple-part encryption or decryption operation.
+ * Finalizes the multiple-part encryption or decryption operation.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OVERFLOW This operation has caused the memory to overflow.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or
- * the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* FinalizeN(void);
/**
- * Wraps the specified key.
+ * Wraps a key.
*
- * @since 2.0
+ * @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
virtual Tizen::Base::ByteBuffer* WrapN(const Tizen::Base::ByteBuffer& secretKey);
/**
- * Unwraps the specified wrapped key.
+ * Unwraps a previously wrapped key.
*
* @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
* @param[in] wrappedKey The wrapped key to unwrap
* @remarks
- * - This operation is not supported in %SkipJackCipher. Therefore, this method always returns @c null. @n
+ * - This operation is not supported in %SkipJackCipher. Therefore, this method always returns @c null.
* - The @c E_UNSUPPORTED_ALGORITHM exception is returned using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* UnwrapN(const Tizen::Base::ByteBuffer& wrappedKey);
{
/**
- * @enum CipherOperation
+ * @enum CipherOperation
*
* Defines the cipher operation.
*
- * @since 2.0
+ * @since 2.0
*/
enum CipherOperation
{
- CIPHER_ENCRYPT = 0, /**<The encrypt mode */
- CIPHER_DECRYPT = 1, /**<The decrypt mode */
- CIPHER_WRAP = 2, /**<The wrap mode */
- CIPHER_UNWRAP = 3 /**<The unwrap mode */
+ CIPHER_ENCRYPT = 0, /**< The encrypt mode */
+ CIPHER_DECRYPT = 1, /**< The decrypt mode */
+ CIPHER_WRAP = 2, /**< The wrap mode */
+ CIPHER_UNWRAP = 3 /**< The unwrap mode */
}; // CipherOperation
} } } //Tizen::Security:Crypto
{
/**
- * @enum KeyParameterType
+ * @enum KeyParameterType
*
* Defines the type of key parameters for asymmetric algorithms.
*
- * @since 2.0
+ * @since 2.0
*/
enum KeyParameterType
{
- KEY_PARAMETER_DH_P = 0, /**< The DH param P */
- KEY_PARAMETER_DH_G = 1, /**< The DH param G */
+ KEY_PARAMETER_DH_P = 0, /**< The DH param P */
+ KEY_PARAMETER_DH_G = 1, /**< The DH param G */
KEY_PARAMETER_DH_PRIVATE_KEY_SIZE = 2, /**< The DH private key size */
KEY_PARAMETER_KEA_P = 3, /**< The KEA param P */
KEY_PARAMETER_KEA_G = 4, /**< The KEA param G */
//
/**
- * @file FSecDesEdeSecureRandom.h
+ * @file FSecDesEdeSecureRandom.h
* @brief This is the header file for the %DesEdeSecureRandom class.
*
* This header file contains the declarations of the %DesEdeSecureRandom class.
/**
* This is the default constructor for this class.
*
- * @since 2.0
+ * @since 2.0
*/
DesEdeSecureRandom(void);
/**
- * This destructor overrides Tizen::Base::Object::~Object().
+ * This destructor overrides Tizen::Base::Object::~Object().
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~DesEdeSecureRandom(void);
/**
- * Generates a user-defined number of random bytes.
+ * Generates the specified number of random bytes.
*
- * @since 2.0
+ * @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
+ * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
* else @c null if an error occurs
- * @param[in] numBytes The number of random bytes to generate
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c numBytes is @c 0 or negative.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or the Tizen::Base::ByteBuffer operation has failed.
+ * @param[in] numBytes The number of random bytes to generate
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG The specified @c numBytes is @c 0 or negative.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
*/
virtual Tizen::Base::ByteBuffer* GenerateRandomBytesN(int numBytes);
*
* @since 2.0
*
- * The %DesSecureRandom class generates a secure random object that can be used to seed deterministic, cryptographic algorithms.
- * The DES method generates a user-defined number of random bytes. @n
+ * The %DesSecureRandom class generates a secure random object that can be used to seed deterministic, cryptographic algorithms.
+ * The DES method generates a user-defined number of random bytes. @n
*
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
*
* @see ISecureRandom
* @see AesSecureRandom
/**
* This is the default constructor for this class.
*
- * @since 2.0
+ * @since 2.0
*/
DesSecureRandom(void);
/**
- * This destructor overrides Tizen::Base::Object::~Object().
+ * This destructor overrides Tizen::Base::Object::~Object().
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~DesSecureRandom(void);
/**
- * Generates a user-specified number of random bytes.
+ * Generates a user-defined number of random bytes.
*
- * @since 2.0
+ * @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class, @n
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c numBytes is @c 0 or negative.
- * @exception E_SYSTEM A system error has occurred. @n
- * The Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM A system error has occurred. @n
+ * The Tizen::Base::ByteBuffer operation has failed.
*/
virtual Tizen::Base::ByteBuffer* GenerateRandomBytesN(int numBytes);
//
/**
- * @file FSecIKey.h
+ * @file FSecIKey.h
* @brief This is the header file for the %IKey interface.
*
* This header file contains the declarations of the %IKey interface.
{
/**
- * @interface IKey
- * @brief This interface provides methods that help in setting the buffer for the key. These methods also extract the encoding format of the key.
+ * @interface IKey
+ * @brief This interface provides methods that help in setting the buffer for the key. These methods also extract
+ * the encoding format of the key.
*
* @since 2.0
*
- * The %IKey interface provides methods that help in setting the buffer for the key. These methods also extract the encoding format of the key. @n
+ * The %IKey interface provides methods that help in setting the buffer for the key. These methods also extract the encoding
+ * format of the key. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
*
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
//
/**
- * @file FSecIKeyPairGenerator.h
+ * @file FSecIKeyPairGenerator.h
* @brief This is the header file for the %IKeyPairGenerator interface.
*
* This header file contains the declarations of the %IKeyPairGenerator interface.
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
* @return An error code
* @param[in] modulusBitSize The modulus size in bits
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c modulusBitSize is invalid. @n
- * The modulus size must be atleast greater than or equal to @c 1024 bits @n
- * to generate cryptographically secure keys.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c modulusBitSize is invalid.
+ * - The modulus size must be atleast greater than or equal to @c 1024 bits
+ * to generate cryptographically secure keys.
*/
virtual result Construct(int modulusBitSize) = 0;
* @exception E_SUCCESS The method is successful.
* @exception E_UNSUPPORTED_ALGORITHM The requested algorithm is not supported.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::KeyPair* GenerateKeyPairN(void) const = 0;
//
/**
- * @file FSecIKeyParameters.h
+ * @file FSecIKeyParameters.h
* @brief This is the header file for the %IKeyParameters interface.
*
* This header file contains the declarations of the %IKeyParameters interface.
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
virtual ~IKeyParameters(void) {}
/**
- * Gets the value of the parameter for a specified key parameter type.
+ * Gets the value of the parameter for the specified key parameter type.
*
* @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the parameter values, @n
* else @c null if an error occurs
* @param[in] paramType The type of the parameter @n
- * For example, @c KEY_PARAMETER_DH_G.
+ * For example, @c KEY_PARAMETER_DH_G.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_UNSUPPORTED_TYPE The specified @c paramType is not supported.
//
/**
- * @file FSecIPrivateKey.h
+ * @file FSecIPrivateKey.h
* @brief This is the header file for the %IPrivateKey interface.
*
* This header file contains the declarations of the %IPrivateKey interface.
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~IPrivateKey(void){}
/**
- * Gets the name of the primary encoding format of a key.
+ * Gets the name of the primary encoding format of the key.
*
* @since 2.0
*
- * @return The primary encoding format of a key
+ * @return The primary encoding format of the key
*/
virtual Tizen::Base::String GetFormat(void) const = 0;
/**
- * Gets a private key in its primary encoding format.
+ * Gets the private key in its primary encoding format.
*
* @since 2.0
*
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetEncodedN(void) const = 0;
//
/**
- * @file FSecIPublicKey.h
+ * @file FSecIPublicKey.h
* @brief This is the header file for the %IPublicKey interface.
*
* This header file contains the declarations of the %IPublicKey interface.
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~IPublicKey(void){}
/**
- * Gets the name of the primary encoding format of a key.
+ * Gets the name of the primary encoding format of the key.
*
* @since 2.0
*
- * @return The primary encoding format of a key
+ * @return The primary encoding format of the key
*/
virtual Tizen::Base::String GetFormat(void) const = 0;
/**
- * Gets a public key in its primary encoding format.
+ * Gets the public key in its primary encoding format.
*
- * @since 2.0
+ * @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetEncodedN(void) const = 0;
//
/**
- * @file FSecISecretKey.h
+ * @file FSecISecretKey.h
* @brief This is the header file for the %ISecretKey interface.
*
* This header file contains the declarations of the %ISecretKey interface.
/**
* @interface ISecretKey
- * @brief This interface provides methods that help in setting the buffer for the key. These methods also extract the encoding format of the key.
+ * @brief This interface provides methods that help in setting the buffer for the key. These methods also extract
+ * the encoding format of the key.
*
* @since 2.0
*
- * The %ISecretKey interface provides methods that help in setting the buffer for the key. These methods also extract the encoding format of the key. @n
+ * The %ISecretKey interface provides methods that help in setting the buffer for the key. These methods also extract the
+ * encoding format of the key. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
*
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetEncodedN(void) const = 0;
* @interface ISecretKeyGenerator
* @brief This interface provides the abstract methods for generating a secret (symmetric) key.
*
- * @since 2.0
+ * @since 2.0
*
* The %ISecretKeyGenerator interface provides the abstract methods for generating a secret (symmetric) key. @n
*
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~ISecretKeyGenerator(void) {}
* else @c null if the secret key generation fails
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::ISecretKey* GenerateKeyN(void) = 0;
* @interface ISecureRandom
* @brief This interface provides the abstract methods for generating a secure random object.
*
- * @since 2.0
+ * @since 2.0
*
- * The %ISecureRandom interface provides the abstract methods for generating a secure random object. @n
+ * The %ISecureRandom interface provides the abstract methods for generating a secure random object. @n
*
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
*
* @see Tizen::Security::AesSecureRandom
* @see Tizen::Security::DesSecureRandom
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes @n
- * are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c numBytes is @c 0 or negative.
- * @exception E_SYSTEM A system error has occurred. @n
- * The method has failed to operate with the OpenSSL library, or the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
-
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - A system error has occurred.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GenerateRandomBytesN(int numBytes) = 0;
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, @n
- * the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. For full construction, @n
+ * the Construct() method must be called right after calling this constructor.
*
- * @since 2.0
+ * @since 2.0
*/
KeaKeyParameters(void);
/**
- * This destructor overrides Tizen::Base::Object::~Object().
+ * This destructor overrides Tizen::Base::Object::~Object().
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~KeaKeyParameters(void);
* @since 2.0
*
* @return An error code
- * @param[in] primeNumber The prime number to instantiate
- * @param[in] generatorNumber The generator value to instantiate
- * @param[in] privateKeySize The size of the private key to instantiate
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @param[in] primeNumber The prime number to instantiate
+ * @param[in] generatorNumber The generator value to instantiate
+ * @param[in] privateKeySize The size of the private key to instantiate
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
*
*/
result Construct(const Tizen::Base::ByteBuffer& primeNumber, const Tizen::Base::ByteBuffer& generatorNumber, int privateKeySize);
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the parameter values, @n
* else @c null if an error occurs
* @param[in] paramType The parameter type @n
- * For example, @c KEY_PARAMETER_KEA_P.
+ * For example, @c KEY_PARAMETER_KEA_P.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_UNSUPPORTED_TYPE The specified @c paramType is not supported.
{
/**
- * @class KeyPair
- * @brief This class is a simple holder for a key pair (a public and a private key).
+ * @class KeyPair
+ * @brief This class is a simple holder for a key pair (a public and a private key).
*
- * @since 2.0
+ * @since 2.0
*
- * The %KeyPair class manages a pair of keys comprising of a public and a private key, which are used in asymmetric ciphers. The key pairs are mainly used to encrypt messages and provide digital signatures. @n
+ * The %KeyPair class manages a pair of keys comprising of a public and a private key, which are used in asymmetric ciphers.
+ * The key pairs are mainly used to encrypt messages and provide digital signatures. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
*
- * @see IKeyPairGenerator
- * @see Tizen::Security::IPublicKey
- * @see Tizen::Security::IPrivateKey
+ * @see IKeyPairGenerator
+ * @see Tizen::Security::IPublicKey
+ * @see Tizen::Security::IPrivateKey
*/
class _OSP_EXPORT_ KeyPair
: public Tizen::Base::Object
{
/**
- * @class KeyPairGenerator
- * @brief This class provides a pair of public and private keys for the Public key algorithm.
+ * @class KeyPairGenerator
+ * @brief This class provides methods for generating a pair of public and private keys for the Public key algorithm.
*
- * @since 2.0
+ * @since 2.0
*
- * The %KeyPairGenerator class generates a key pair and its parameters that consists of a public and private key. These are used in asymmetric ciphers. The generated key pair and parameters are based on the underlying key pair encryption algorithm. @n
+ * The %KeyPairGenerator class generates a key pair and its parameters that consists of a public and private key.
+ * These are used in asymmetric ciphers. The generated key pair and parameters are based on the underlying key pair
+ * encryption algorithm. @n
*
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
*
- * @see Tizen::Security::IKeyPairGenerator
- * @see Tizen::Security::KeyPair
+ * @see Tizen::Security::IKeyPairGenerator
+ * @see Tizen::Security::KeyPair
*/
class _OSP_EXPORT_ KeyPairGenerator
: public virtual IKeyPairGenerator
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, @n
- * the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. For full construction, @n
+ * the Construct() method must be called right after calling this constructor.
*
- * @since 2.0
+ * @since 2.0
*/
KeyPairGenerator(void);
/**
- * This destructor overrides Tizen::Base::Object::~Object().
+ * This destructor overrides Tizen::Base::Object::~Object().
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~KeyPairGenerator(void);
* @since 2.0
*
* @return An error code
- * @param[in] modulusBitSize The modulus size in bits
+ * @param[in] modulusBitSize The modulus size in bits
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified size is invalid. @n
- * The modulus size must be at least greater than or equal to @c 1024 bits @n
- * to generate cryptographically secure keys.
+ * The modulus size must be at least greater than or equal to @c 1024 bits
+ * to generate cryptographically secure keys.
*/
virtual result Construct(int modulusBitSize);
/**
* Constructs and initializes an instance of %KeyPairGenerator with the specified parameters.
*
- * @since 2.0
+ * @since 2.0
*
* @return An error code
* @param[in] modulusBitSize The modulus size in bits @n
* This is used for key generation.
- * @param[in] algorithm The algorithm used to generate the key parameters @n
+ * @param[in] algorithm The algorithm used to generate the key parameters @n
* The supported algorithms are RSA, DH, and KEA. The default value is RSA.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified size is invalid. @n
- * @exception E_UNSUPPORTED_ALGORITHM The requested @c algorithm is not supported. @n
- * The modulus size must be at least greater than or equal to @c 1024 bits @n
- * to generate cryptographically secure keys.
+ * @exception E_UNSUPPORTED_ALGORITHM Either of the following conditions has occurred:
+ * - The requested @c algorithm is not supported.
+ * - The modulus size must be at least greater than or equal to @c 1024 bits
+ * to generate cryptographically secure keys.
*/
result Construct(int modulusBitSize, Tizen::Base::String algorithm);
* The generated key parameters may be required to create a key pair. The RSA algorithm
* does not call this method to generate a key pair.
*
- * @since 2.0
+ * @since 2.0
*
- * @return A pointer to the IKeyParameters class that contains a subset of the domain parameters ('p' prime
- * number, 'g' generator) that are used to generate a key pair, @n
- * else @c null if the method fails to create the key parameters
+ * @return A pointer to the IKeyParameters instance that contains a subset of the domain parameters ('p' prime
+ * number, 'g' generator) that are used to generate the key pair, @n
+ * else @c null if the method fails to create the key parameters
* @param[in] lInBits The size of 'p', a prime number in bits @n
* The size must be @c 1024 bits, @c 2048 bits, or @c 3072 bits.
* @param[in] nInBits The size of 'g', a generator value in bits @n
* - 256 bits, when @c lInBits is @c 3072 bits.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error. @n
- * The method has failed to operate with the OpenSSL library, or the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - The method cannot proceed due to a severe system error.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Security::IKeyParameters* GenerateKeyParametersN(int lInBits = 1024, int nInBits = 160) const;
*
* @since 2.0
*
- * @return A pointer to the KeyPair class, @n
+ * @return A pointer to the KeyPair instance, @n
* else @c null if the method fails to create the key pair
- * @param[in] pKeyParams The domain parameters of the key exchange algorithm @n
+ * @param[in] pKeyParams The domain parameters of the key exchange algorithm @n
* These parameters are instantiated.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error. @n
- * The method has failed to operate with the OpenSSL library, or the Tizen::Base::ByteBuffer operation has failed.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - The method cannot proceed due to a severe system error.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Security::KeyPair* GenerateKeyPairN(Tizen::Security::IKeyParameters* pKeyParams) const;
*
* @since 2.0
*
- * @return A pointer to the KeyPair class, @n
- else @c null if the method fails to create the key pair.
- * Default key format will be pkcs1 for private key and x509 for public key.
+ * @return A pointer to the KeyPair instance, @n
+ * else @c null if the method fails to create the key pair. @n
+ * The default key format will be pkcs1 for private key and x509 for public key.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error. @n
- * The method has failed to operate with the OpenSSL library, or the Tizen::Base::ByteBuffer operation has failed.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM Either of the following conditions has occurred:
+ * - The method cannot proceed due to a severe system error.
+ * - The method has failed to operate with the OpenSSL library.
+ * - The Tizen::Base::ByteBuffer operation has failed.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::KeyPair* GenerateKeyPairN(void) const;
class _KeyPairGeneratorImpl* __pKeyPairGeneratorImpl;
friend class _KeyPairGeneratorImpl;
-}; //KeyPairGenerator
+}; //KeyPairGenerator
} } //Tizen::Security
#include <FSecPkcsPkcs08AttributeValue.h>
/**
- * @namespace Tizen::Security::Pkcs
- * @brief This namespace contains classes and interfaces for managing the PKCS 5 and 8 implementation.
- * @since 2.1
+ * @namespace Tizen::Security::Pkcs
+ * @brief This namespace contains classes and interfaces for managing the PKCS 5 and 8 implementation.
+ * @since 2.1
*
- * @remarks @b Header @b %file: @b \#include @b <FSecurity.h> @n
- * @b Library : @b osp-appfw
+ * @remarks @b Header @b %file: @b \#include @b <FSecurity.h> @n
+ * @b Library: @b osp-appfw
*
*
* The %Pkcs namespace provides classes and interfaces for managing PKCS 5 and 8 implementation.
* mac genaration/verification.
* It also provides a standard format to store private key and encrypted private key.
*
- * For more information on the %Pkcs namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/security/public_key_cryptography.htm">Pkcs Guide</a>. @n
+ * For more information on the %Pkcs namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/security/public_key_cryptography.htm">Pkcs Guide</a>. @n
*
* The following diagram illustrates the relationships between the classes belonging to the %Pkcs namespace.
* @image html security_pkcs_classdiagram.png
* @since 2.1
*
* The %AlgorithmIdentifier class implements the ASN.1 specified %AlgorithmIdentifier, which is used for
- * creating the standard %AlgorithmIdentifier object.
- * %AlgorithmIdentifier structure consists the OID value of the algorithm along with the parameters of that algorithm.
+ * creating the standard %AlgorithmIdentifier object. The %AlgorithmIdentifier structure consists of the OID value of the
+ * algorithm along with the parameters of the algorithm.
*
- * This is defined in ASN.1 as demonstrated in the following code:
+ * This is defined in ASN.1 as demonstrated in the following code:
* @code
* AlgorithmIdentifier { ALGORITHM-IDENTIFIER:InfoObjectSet }
* ::=
virtual ~AlgorithmIdentifier(void);
/**
- * Initializes the %AlgorithmIdentifier with supplied input parameter values.
+ * Initializes the %AlgorithmIdentifier with the specified input parameter values.
*
* @since 2.1
*
* @return An error code
* @param[in] objectId The object identifier of a particular algorithm @n
- * Object IDs are defined by standard bodies for algorithms and other crypto objects.
- * Object ID of %AlgorithmIdentifier can be described in string format like 1.2.3.4
+ * The object IDs are defined by standard bodies for algorithms and other crypto objects. @n
+ * The object ID of %AlgorithmIdentifier can be described in string format like 1.2.3.4
* @param[in] pParams A pointer to the AlgorithmParameters object @n
- * This is an optional parameter and contains a list of user specified input parameters for the specified algorithm. For example, for Symmetric algorithms Initial vector, IV is required as an input. The default value of this parameter is @c null.
- * @exception E_SUCCESS The method is successful.
+ * This is an optional parameter and contains a list of user specified input parameters for
+ * the specified algorithm. For example, for Symmetric algorithms Initial vector, IV is required
+ * as an input. The default value of this parameter is @c null.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
* @exception E_UNSUPPORTED_ALGORITHM The object ID of the input algorithm is not supported.
*/
result Construct(const Tizen::Base::String& objectId, const IAlgorithmParameters* pParams = null);
/**
- * Initializes this instance of %AlgorithmIdentifier with the DER encoded Tizen::Base::ByteBuffer that contains @n
+ * Initializes this instance of %AlgorithmIdentifier with the DER encoded Tizen::Base::ByteBuffer that contains
* the ASN.1 specified %AlgorithmIdentifier structure.
*
* @since 2.1
*
* @return An error code
- * @param[in] encodedData An instance of DER encoded Tizen::Base::ByteBuffer
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @param[in] encodedData An instance of DER encoded Tizen::Base::ByteBuffer
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& encodedData);
/**
* Checks whether the specified instance of %AlgorithmIdentifier equals the current instance.
*
- * @since 2.1
+ * @since 2.1
*
* @return @c true if the specified instance equals the current instance, @n
- * else @c false
- * @param[in] rhs An instance of %AlgorithmIdentifier
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * else @c false
+ * @param[in] rhs An instance of %AlgorithmIdentifier
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual bool Equals(const Tizen::Base::Object& rhs) const;
virtual int GetHashCode(void) const;
/**
- * Gets the copy of %AlgorithmIdentifier instance.
+ * Gets the copy of the %AlgorithmIdentifier instance.
*
* @since 2.1
*
- * @return Pointer to %AlgorithmIdentifier, containing the copy of the specified instance, @n
- * else @c null if an error occurs
+ * @return A pointer to the %AlgorithmIdentifier instance that is the copy of the specified instance, @n
+ * else @c null if an error occurs
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
AlgorithmIdentifier* CloneN(void) const;
*
* @since 2.1
*
- * @return Pointer to IAlgorithmParameters, containing the parameter list of algorithm, @n
- * else @c null if an no parameters exist
+ * @return A pointer to the IAlgorithmParameters instance containing the parameter list of algorithm, @n
+ * else @c null if no parameters exist
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
IAlgorithmParameters* GetParametersN(void) const;
/**
* Gets the object ID value of an algorithm in string format.
*
- * @since 2.1
+ * @since 2.1
*
- * @return Object ID of %AlgorithmIdentifier in string format like 1.2.3.4
+ * @return The object ID of %AlgorithmIdentifier in string format like 1.2.3.4
*
*/
Tizen::Base::String GetAlgorithmObjectId(void) const;
*
* @since 2.1
*
- * @return Pointer to the DER encoded Tizen::Base::ByteBuffer, @n
- * else @c null if an error occurs
+ * @return A pointer to the DER encoded Tizen::Base::ByteBuffer, @n
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
/**
* @interface IAlgorithmParameters
- * @brief This interface is an interface class for cryptographic algorithm parameters such as IV, etc. It provides the generic
- * functionalities that must be supported by all derived algorithm parameters such PbKdf2Parameters, PbEs2Parameters.
+ * @brief This interface is an interface class for cryptographic algorithm parameters such as IV. It provides the generic
+ * functionalities that must be supported by all the derived algorithm parameters such PbKdf2Parameters, PbEs2Parameters.
*
* @since 2.1
*
- * The %IAlgorithmParameters interface is an interface class for cryptographic algorithm parameters such as IV, etc. It provides the generic
- * functionalities that must be supported by all derived algorithm parameters such PbKdf2Parameters, PbEs2Parameters.
- * This is an abstract class and hence, object of this class cannot be instantiated.
+ * The %IAlgorithmParameters interface is an interface class for cryptographic algorithm parameters such as IV. It provides the generic
+ * functionalities that must be supported by all derived algorithm parameters such PbKdf2Parameters, PbEs2Parameters.
+ * This is an abstract class and hence, object of this class cannot be instantiated.
*
*/
{
public:
/**
- * This polymorphic destructor should be overridden if required. This way, @n
- * the destructors of the derived classes are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.1
*/
virtual ~IAlgorithmParameters(void) {}
/**
- * Gets the copy of parameters of the specified algorithm type.
+ * Gets the copy of the parameters of the specified algorithm type.
*
- * @since 2.1
+ * @since 2.1
*
- * @return Pointer to AlgorithmParameters, containing the instance of algorithm parameter , @n
- * else @c null if an error occurs
+ * @return A pointer to AlgorithmParameters, containing the instance of algorithm parameter , @n
+ * else @c null if an error occurs
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual IAlgorithmParameters* CloneN(void) const = 0;
/**
* Gets the PKCS algorithm parameter type enumerated value.
*
- * @since 2.1
+ * @since 2.1
*
- * @return PkcsAlgorithmParamterType, containing the enumerated value of PkcsAlgorithmParameterType
+ * @return The type containing the enumerated value of PkcsAlgorithmParameterType
*
*/
virtual PkcsAlgorithmParameterType GetType(void) const = 0;
//
// This method is reserved and may change its name at any time without prior notice.
//
- // @since 2.1
+ // @since 2.1
//
virtual void IAlgorithmParameters_Reserved1(void) {}
//
// This method is reserved and may change its name at any time without prior notice.
//
- // @since 2.1
+ // @since 2.1
//
virtual void IAlgorithmParameters_Reserved2(void) {}
//
// This method is reserved and may change its name at any time without prior notice.
//
- // @since 2.1
+ // @since 2.1
//
virtual void IAlgorithmParameters_Reserved3(void) {}
* @since 2.1
*
* The %InitialVector class implements the functionalities specified by the %InitialVector class.
- * This class represents the Initial Vector parameter for symmetric ciphers such as DES, AES, DES_EDE.
- * This %InitialVector parameters will be used by both PKCS05 and PKCS08 related classes at the time of encryption.
+ * This class represents the Initial Vector parameter for symmetric ciphers such as DES, AES, DES_EDE.
+ * This %InitialVector parameters will be used by both PKCS05 and PKCS08 related classes at the time of encryption.
*
*
*/
*
* @return An error code
*
- * @param[in] initialVector An instance of Tizen::Base::ByteBuffer, holding the initial vector data
- * @exception E_SUCCESS The method is successful.
+ * @param[in] initialVector An instance of Tizen::Base::ByteBuffer holding the initial vector data
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& initialVector);
/**
- * Gets copy of this instance.
+ * Gets a copy of this instance.
*
* @since 2.1
*
- * @return A pointer to IAlgorithmParameters, containing the copy of this instance
+ * @return A pointer to IAlgorithmParameters containing the copy of this instance
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual IAlgorithmParameters* CloneN(void) const;
*
* @since 2.1
*
- * @return PkcsAlgorithmParameterType Enum value containing the PKCS_ALGO_PARAM_TYPE_IV value for Initial Vector parameter
+ * @return PkcsAlgorithmParameterType The enum value containing the @c PKCS_ALGO_PARAM_TYPE_IV value for Initial Vector parameter
*
*/
virtual PkcsAlgorithmParameterType GetType(void) const;
* @since 2.1
*
* @return @c true if the specified instance equals the current instance, @n
- * else @c false
+ * else @c false
* @param[in] rhs An instance of %InitialVector
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual bool Equals(const Tizen::Base::Object& rhs) const;
virtual int GetHashCode(void) const;
/**
- * Gets the instance of Tizen::Base::ByteBuffer that contains the Initial Vector value.
+ * Gets an instance of Tizen::Base::ByteBuffer that contains the Initial Vector value.
*
* @since 2.1
*
const Tizen::Base::ByteBuffer& GetInitialVector(void) const;
/**
- * Gets the encoded form of the InitialVector. @n
- * It is assumed that each InitialVector type will have only a single form of encoding that is DER encoding.
+ * Gets the encoded form of the %InitialVector. @n
+ * It is assumed that each %InitialVector type will have only a single form of encoding that is DER encoding.
*
* @since 2.1
*
- * @return Pointer to the DER encoded Tizen::Base::ByteBuffer, @n
- * else @c null if an error occurs
+ * @return A pointer to the DER encoded Tizen::Base::ByteBuffer, @n
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
/**
* @class Pkcs05PbEs2Parameters
- * @brief This class implements the functionalities specified by the PKCS05 encryption scheme 2.
+ * @brief This class provides methods for the functionalities specified by the PKCS05 encryption scheme 2.
*
* @since 2.1
*
* The %Pkcs05PbEs2Parameters class implements the functionalities specified by the PKCS05 encryption scheme 2.
- * PBES2 combines a password-based key derivation function, which is PBKDF2
- * for PKCS #5 version 2.1, with an underlying encryption scheme.
- * The key length and any other parameters for the underlying encryption scheme depends on the scheme.
+ * PBES2 combines a password-based key derivation function, which is PBKDF2 for PKCS #5 version 2.1, with an underlying
+ * encryption scheme. The key length and any other parameters for the underlying encryption scheme depends on the scheme.
*
- * This is defined in ASN.1 as demonstrated in the following code:
+ * This is defined in ASN.1 as demonstrated in the following code:
* @code
* PBES2-params ::= SEQUENCE {
* keyDerivationFunc AlgorithmIdentifier {{PBES2-KDFs}},
virtual ~Pkcs05PbEs2Parameters(void);
/**
- * Initializes this instance of %Pkcs05PbEs2Parameters with the encoded Tizen::Base::ByteBuffer, which contain Password Based Encryption Parameters Structure(PBES2) in ASN.1 DER format.
+ * Initializes this instance of %Pkcs05PbEs2Parameters with the specified encoded Tizen::Base::ByteBuffer, which contains
+ * Password Based Encryption Parameters Structure(PBES2) in ASN.1 DER format.
*
* @since 2.1
*
* @return An error code
* @param[in] encodedData The DER encoded Tizen::Base::ByteBuffer containing %Pkcs05PbEs2Parameters
- * @exception E_SUCCESS The method is successful.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& encodedData);
/**
- * Initializes this %Pkcs05PbEs2Parameters with specified input parameters values.
+ * Initializes this %Pkcs05PbEs2Parameters with the specified input parameters values.
*
* @since 2.1
*
* @return An error code
- * @param[in] keyDerivationFunction An instance of AlgorithmIdentifier, holding key derivation function
- * @param[in] encryptionScheme An instance of AlgorithmIdentifier, holding encryption scheme
- * @exception E_SUCCESS The method is successful.
+ * @param[in] keyDerivationFunction An instance of AlgorithmIdentifier holding key derivation function
+ * @param[in] encryptionScheme An instance of AlgorithmIdentifier holding encryption scheme
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const AlgorithmIdentifier& keyDerivationFunction, const AlgorithmIdentifier& encryptionScheme);
*
* @since 2.1
*
- * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
- * else @c null if an error occurs
+ * @return A pointer to the Tizen::Base::ByteBuffer instance that contains the output, @n
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
Tizen::Base::ByteBuffer* GetEncodedDataN(void) const;
/**
- * Gets the reference to the AlgorithmIdentifier instance, which identifies the underlying key derivation function. @n
- * It will be an algorithm ID with an OID in the set PBES2-KDFs, which for this version of PKCS #5 will consist of id-PBKDF2.
+ * Gets a reference to the AlgorithmIdentifier instance, which identifies the underlying key derivation function. @n
+ * It will be an algorithm ID with an OID in the set PBES2-KDFs, which will consist of id-PBKDF2 for this version of PKCS #5.
*
* @since 2.1
*
- * @return A reference to AlgorithmIdentifier holding the underlying key derivation function
+ * @return A reference to the AlgorithmIdentifier instance holding the underlying key derivation function
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
const AlgorithmIdentifier& GetKeyDerivationAlgorithm(void) const;
/**
- * Gets the reference to the AlgorithmIdentifier instance, which identifies the underlying encryption algorithm. @n
+ * Gets a reference to the AlgorithmIdentifier instance, which identifies the underlying encryption algorithm. @n
* It shall be an OID in the set PBES2-Encs, whose definition is left to the application.
*
* @since 2.1
*
- * @return A reference to AlgorithmIdentifier holding the underlying encryption algorithm
+ * @return A reference to the AlgorithmIdentifier instance holding the underlying encryption algorithm
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
const AlgorithmIdentifier& GetEncryptionScheme(void) const;
/**
* Gets the AlgorithmParameters that identifies the underlying parameters such as PbKdf2, PbEs2, PbMac1. @n
- * For this class %AlgorithmParameters will be of PBES2 type.
+ * For this class, %AlgorithmParameters will be of PBES2 type.
*
* @since 2.1
*
*
* @since 2.1
*
- * @return PkcsAlgorithmParameterType holding enum value @c PKCS_ALGO_PARAM_TYPE_PKCS05_PBES02 for PBES2 Parameters
+ * @return The PkcsAlgorithmParameterType instance holding the enum value @c PKCS_ALGO_PARAM_TYPE_PKCS05_PBES02 for PBES2 Parameters
*
*/
virtual PkcsAlgorithmParameterType GetType(void) const;
*
* @return @c true if the specified instance equals the current instance, @n
* else @c false
- * @param[in] rhs An instance of %Pkcs05PbEs2Parameters
+ * @param[in] rhs An instance of %Pkcs05PbEs2Parameters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual bool Equals(const Tizen::Base::Object& rhs) const;
/**
* @class Pkcs05PbKdf2Parameters
- * @brief This class implements the functionalities specified by the PKCS05 KDF2 scheme.
+ * @brief This class provides methods for the functionalities specified by the PKCS05 KDF2 scheme.
*
* @since 2.1
*
- * The %Pkcs05PbKdf2Parameters class implements the functionalities specified by the PKCS05 KDF2 scheme. PBKDF2 applies a pseudo random function to derive
- * keys. The length of the derived key is essentially unbounded. However, the maximum effective search space for the derived key can
- * be limited by the structure of the underlying pseudo random function.
+ * The %Pkcs05PbKdf2Parameters class provides methods for the functionalities specified by the PKCS05 KDF2 scheme. PBKDF2 applies a pseudo
+ * random function to derive keys. The length of the derived key is essentially unbounded. However, the maximum effective search
+ * space for the derived key can be limited by the structure of the underlying pseudo random function.
*
- * This is defined in ASN.1 as demonstrated in the following code:
+ * This is defined in ASN.1 as demonstrated in the following code:
* @code
* PBKDF2-params ::= SEQUENCE {
* salt CHOICE {
virtual ~Pkcs05PbKdf2Parameters(void);
/**
- * Initializes this instance of %Pkcs05PbKdf2Parameters with the encoded Tizen::Base::ByteBuffer that contains Password Based Key Derivation Function parameters structure(PBKDF2) in ASN.1 DER format.
- *
+ * Initializes this instance of %Pkcs05PbKdf2Parameters with the encoded Tizen::Base::ByteBuffer that contains Password
+ * Based Key Derivation Function parameters structure(PBKDF2) in ASN.1 DER format.
+ *
* @since 2.1
*
* @return An error code
- * @param[in] encodedData DER encoded Tizen::Base::ByteBuffer of %Pkcs05PbKdf2Parameters
- * @exception E_SUCCESS The method is successful.
+ * @param[in] encodedData The DER encoded Tizen::Base::ByteBuffer of %Pkcs05PbKdf2Parameters
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& encodedData);
/**
- * Initializes the %Pkcs05PbKdf2Parameters with specified input parameters values.
+ * Initializes the %Pkcs05PbKdf2Parameters with the specified input parameters values.
*
* @since 2.1
*
* @return An error code
- * @param[in] saltBuffer An instance of Tizen::Base::ByteBuffer, holding salt value
- * @param[in] iterationCount Integer value holding the positive integer specifying iteration count
- * for generation of password based key
- * @param[in] derivedKeyLength Positive integer specifying length of password based key to generate
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @param[in] saltBuffer An instance of Tizen::Base::ByteBuffer holding salt value
+ * @param[in] iterationCount The positive integer specifying iteration count for generation of password based key
+ * @param[in] derivedKeyLength The positive integer specifying the length of the password based key
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
* @remarks In this case, when pseudo random function algorithm is not passed, then default HMAC-SHA1 will be used.
*/
result Construct(const Tizen::Base::ByteBuffer& saltBuffer, int iterationCount, int derivedKeyLength = 0);
/**
- * Initializes this %Pkcs05PbKdf2Parameters with supplied input parameters values.
+ * Initializes this %Pkcs05PbKdf2Parameters instance with the specified input parameters values.
*
* @since 2.1
*
* @return An error code
- * @param[in] saltBuffer An instance of Tizen::Base::ByteBuffer, holding salt value
- * @param[in] iterationCount Integer value holding the positive integer specifying iteration count
- * for generation of password based key
- * @param[in] prf An instance of AlgorithIdentifier, holding the underlying pseudo random function to use to generate a password based key
- * @param[in] derivedKeyLength Positive integer specifying length of password based key to generate
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @param[in] saltBuffer An instance of Tizen::Base::ByteBuffer holding salt value
+ * @param[in] iterationCount The positive integer specifying iteration count for generation of password based key
+ * @param[in] prf The AlgorithIdentifier instance holding the underlying pseudo random function to use
+ * to generate a password based key
+ * @param[in] derivedKeyLength The positive integer specifying the length of the password based key
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& saltBuffer, int iterationCount, const AlgorithmIdentifier& prf, int derivedKeyLength = 0);
/**
- * Gets the encoded form of the %Pkcs05PbKdf2Parameters. @n
+ * Gets the encoded form of the %Pkcs05PbKdf2Parameters instance. @n
* It is assumed that each %Pkcs05PbKdf2Parameters will have only a single form of encoding, for example: ASN.1 DER.
*
* @since 2.1
*
- * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
+ * @return A pointer to the Tizen::Base::ByteBuffer instance that contains the output, @n
* else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*
* @since 2.1
*
- * @return A reference to salt Tizen::Base::ByteBuffer containing the specified salt value
+ * @return A reference to the Tizen::Base::ByteBuffer instance containing the specified salt value
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
const Tizen::Base::ByteBuffer& GetSaltValue(void) const;
int GetDerivedKeyLength(void) const;
/**
- * Gets the reference to the AlgorithmIdentifier that identifies the underlying pseudo random function.
+ * Gets a reference to AlgorithmIdentifier that identifies the underlying pseudo random function.
*
* @since 2.1
*
/**
*
- * Gets the pointer to the AlgorithmParameters that identifies the underlying parameters such as PbKdf2,PbEs2,PbMac1. @n
- * For this class %AlgorithmParameters will be of PbKdf2 type.
+ * Gets a pointer to AlgorithmParameters that identifies the underlying parameters such as PbKdf2,PbEs2,PbMac1. @n
+ * For this class, %AlgorithmParameters will be of PbKdf2 type.
*
* @since 2.1
*
- * @return Pointer to IAlgorithmParameters containing the algorithm identifier of underlying pseudo random function, @n
+ * @return A pointer to IAlgorithmParameters containing the algorithm identifier of underlying pseudo random function, @n
* else @c null if an error occurs
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
*
* @since 2.1
*
- * @return PkcsAlgorithmParameterType holding enum value @c PKCS_ALGO_PARAM_TYPE_PKCS05_KDF02 for KDF2 Parameters
+ * @return The PkcsAlgorithmParameterType instance holding the enum value @c PKCS_ALGO_PARAM_TYPE_PKCS05_KDF02 for KDF2 Parameters
*/
virtual PkcsAlgorithmParameterType GetType(void) const;
*
* @return @c true if the specified instance equals the current instance, @n
* else @c false
- * @param[in] rhs An instance of %Pkcs05PbKdf2Parameters
+ * @param[in] rhs An instance of %Pkcs05PbKdf2Parameters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual bool Equals(const Tizen::Base::Object& rhs) const;
/**
* @class Pkcs05PbMacParameters
- * @brief This class implements the functionalities specified by the PKCS05 MAC scheme.
+ * @brief This class provides methods for the functionalities specified by the PKCS05 MAC scheme.
*
* @since 2.1
*
* The %Pkcs05PbMacParameters class implements the functionalities specified by the PKCS05 MAC scheme.
- * PBMAC1 combines a password-based key derivation function, which will be PBKDF2
- * for this version of PKCS #5, with an underlying message authentication
- * scheme. The key length and any other parameters for
- * the underlying message authentication scheme depend on the scheme.
+ * PBMAC1 combines a password-based key derivation function, which will be PBKDF2 for this version of PKCS #5, with an underlying
+ * message authentication scheme. The key length and any other parameters for the underlying message authentication scheme depend
+ * on the scheme.
*
- * This is defined in ASN.1 as demonstrated in the following code:
+ * This is defined in ASN.1 as demonstrated in the following code:
* @code
* PBMAC1-params ::= SEQUENCE {
* keyDerivationFunc AlgorithmIdentifier {{PBMAC1-KDFs}},
virtual ~Pkcs05PbMacParameters(void);
/**
- * Initializes this instance of %Pkcs05PbMacParameters with the Tizen::Base::ByteBuffer instance that contains Password Based Message @n
+ * Initializes this instance of %Pkcs05PbMacParameters with the Tizen::Base::ByteBuffer instance that contains Password Based Message
* Authentication Cryptography parameters structure(PBMAC1) in ASN.1 DER format.
*
* @since 2.1
*
* @return An error code
- * @param[in] encodedData DER encoded Tizen::Base::ByteBuffer contains %Pkcs05PbMacParameters.
- * @exception E_SUCCESS The method is successful.
+ * @param[in] encodedData The DER encoded Tizen::Base::ByteBuffer containing %Pkcs05PbMacParameters.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& encodedData);
* @since 2.1
*
* @return An error code
- * @param[in] keyDerivationFunc An instance of AlgorithmIdentifier, holding key derivation function
- * @param[in] messageAuthScheme An instance of AlgorithmIdentifier, holding message authentication scheme
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @param[in] keyDerivationFunc An instance of AlgorithmIdentifier holding key derivation function
+ * @param[in] messageAuthScheme An instance of AlgorithmIdentifier holding message authentication scheme
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const AlgorithmIdentifier& keyDerivationFunc, const AlgorithmIdentifier& messageAuthScheme);
/**
- * Gets the encoded form of the %Pkcs05PbMacParameters. @n
+ * Gets the encoded form of the %Pkcs05PbMacParameters instance. @n
* It is assumed that each %Pkcs05PbMacParameters will have only a single form of encoding, for example ASN.1 DER.
*
* @since 2.1
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
- * else @c null if an error occurs.
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
Tizen::Base::ByteBuffer* GetEncodedDataN(void) const;
/**
- * Gets the reference to the AlgorithmIdentifier instance that identifies the underlying key derivation function. @n
+ * Gets a reference to the AlgorithmIdentifier instance that identifies the underlying key derivation function. @n
* It will be an algorithm ID with an OID in the set PBES2-KDFs, which for this version of PKCS #5 will consist of ID-PBKDF2.
*
* @since 2.1
*
- * @return A reference to AlgorithmIdentifier holding the underlying key derivation function.
+ * @return A reference to the AlgorithmIdentifier instance holding the underlying key derivation function.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
const AlgorithmIdentifier& GetKeyDerivationAlgorithm(void) const;
/**
- * Gets the algorithm identifier that identifies the underlying
- * MAC algorithm. @n It shall be an OID like OID_HMAC_SHA1 or OID_HMAC_SHA2_224, and so on.
+ * Gets the algorithm identifier that identifies the underlying MAC algorithm. @n
+ * It shall be an OID like ::OID_HMAC_SHA1 or ::OID_HMAC_SHA2_224, and so on.
*
* @since 2.1
*
- * @return A reference to AlgorithmIdentifier holding the underlying MAC algorithm
+ * @return A reference to the AlgorithmIdentifier instance holding the underlying MAC algorithm
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
const AlgorithmIdentifier& GetMacAlgorithm(void) const;
/**
* Gets the AlgorithmParameters that identifies the underlying Parameters such as PbKdf2, PbEs2, PbMac1. @n
- * For this class %AlgorithmParameters will be of PbMac1 type.
+ * For this class, %AlgorithmParameters will be of PbMac1 type.
*
* @since 2.1
*
- * @return A pointer to IAlgorithmParameters containing the algorithm identifier of underlying pseudo random function
+ * @return A pointer to the IAlgorithmParameters instance containing the algorithm identifier of underlying pseudo random function
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual IAlgorithmParameters* CloneN(void) const;
/**
- * Get the PkcsAlgorithmParameterType value.
+ * Gets the PkcsAlgorithmParameterType value.
*
* @since 2.1
*
- * @return PkcsAlgorithmParameterType holding enum value @c PKCS_ALGO_PARAM_TYPE_PKCS05_MAC for PBMAC parameters
+ * @return An instance of PkcsAlgorithmParameterType holding the enum value @c PKCS_ALGO_PARAM_TYPE_PKCS05_MAC for PBMAC parameters
*/
virtual PkcsAlgorithmParameterType GetType(void) const;
* else @c false
* @param[in] rhs An instance of %Pkcs05PbMacParameters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual bool Equals(const Tizen::Base::Object& rhs) const;
/**
* @class Pkcs05Schemes
- * @brief This class implements the functionalities specified by the pkcs05 schemes like key derivation function,
- * encryption and signature schemes.
+ * @brief This class provides methods for the functionalities specified by the pkcs05 schemes like key derivation function,
+ * encryption and signature schemes.
*
* @since 2.1
*
- * The %Pkcs05Schemes class implements the functionalities specified by the pkcs05 schemes like key derivation function,
- * encryption and signature schemes.
+ * The %Pkcs05Schemes class provides methods for the functionalities specified by the pkcs05 schemes like key derivation function,
+ * encryption and signature schemes.
*/
class _OSP_EXPORT_ Pkcs05Schemes
* @since 2.1
*
* @return An error code
- * @param[in] password An instance of Tizen::Base::ByteBuffer holding the password
- * @param[in] derivedKeyLength A positive integer that contains the length of derived key @n
- * It is a variable length in PbEs2 based on the underlying encryption operation.
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @param[in] password An instance of Tizen::Base::ByteBuffer holding the password
+ * @param[in] derivedKeyLength The length of the derived key @n
+ * The length is variable in PbEs2 based on the underlying encryption operation.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& password, int derivedKeyLength);
*
* @return A pointer to Tizen::Base::ByteBuffer that contains the derived key, @n
* else @c null if an error occurs
- * @param[in] params An instance of PbKdf2Parameters containing the Kdf2 parameter,
- * salt value, iteration count, and key length
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] params An instance of PbKdf2Parameters containing the Kdf2 parameter,
+ * salt value, iteration count, and key length
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::ByteBuffer* GenerateKeyKdf2N(const Pkcs05PbKdf2Parameters& params);
/**
- * Encrypts the message M under a password P to produce a ciphertext C, by applying selected key derivation function KDF
- * (which is GenerateKeyKdf2N) and selected underlying encryption scheme (which can be any block chiper).
+ * Encrypts the message M under a password P to produce a ciphertext C, by applying the selected key derivation function KDF
+ * (which is GenerateKeyKdf2N) and the selected underlying encryption scheme (which can be any block chiper).
*
* @since 2.1
*
* @return A pointer to Tizen::Base::ByteBuffer that contains the encrypted message, @n
* else @c null if an error occurs
- * @param[in] params An instance of the PbEs2Parameters parameter structure holding AlgorithmIdentifier for key derivation
- * function and AlgorithmIdentifier for underlying encryption scheme
- * @param[in] message An instance of Tizen::Base::ByteBuffer holding the plain text to encrypt
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] params An instance of PbEs2Parameters holding AlgorithmIdentifier for the key derivation
+ * function and AlgorithmIdentifier for the underlying encryption scheme
+ * @param[in] message An instance of Tizen::Base::ByteBuffer holding the plain text to encrypt
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::ByteBuffer* EncryptionScheme2N(const Pkcs05PbEs2Parameters& params, const Tizen::Base::ByteBuffer& message);
/**
- * Decrypts the ciphertext C, under a password P to recover message M , by applying selected key derivation function KDF(which is GenerateKeyKdf2N)
- * and selected underlying decryption algorithm (which can be any block cipher).
+ * Decrypts the ciphertext C, under a password P to recover message M , by applying the selected key derivation function KDF
+ * (which is GenerateKeyKdf2N) and the selected underlying decryption algorithm (which can be any block cipher).
*
* @since 2.1
*
* @return A pointer to Tizen::Base::ByteBuffer that contains the plain text message
- * @param[in] params An instance of the PbEs2Parameters parameter structure holding AlgorithmIdentifier for key derivation
- * function and AlgorithmIdentifier for underlying encryption scheme
- * @param[in] message An instance of Tizen::Base::ByteBuffer holding the cipher text to decrypt
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] params An instance of PbEs2Parameters holding AlgorithmIdentifier for the key derivation
+ * function and AlgorithmIdentifier for the underlying encryption scheme
+ * @param[in] message An instance of Tizen::Base::ByteBuffer holding the cipher text to decrypt
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::ByteBuffer* DecryptionScheme2N(const Pkcs05PbEs2Parameters& params, const Tizen::Base::ByteBuffer& message);
/**
- * Gets a message M under a password P to generate a message authentication code T,
- * by applying selected key derivation function KDF(which is GenerateKeyKdf2N) and selected underlying message authentication scheme
- * (which can be any HMAC algorithm). @n GenerateMacN combines a password-based key derivation function, which shall be
- * GenerateKeyKdf2N for this version of PKCS #5, with an underlying message authentication scheme
- * The key length and any other parameters for the underlying message authentication scheme
- * depend on the scheme.
+ * Gets the message M under a password P to generate a message authentication code T, by applying the selected key derivation
+ * function KDF(which is GenerateKeyKdf2N) and the selected underlying message authentication scheme (which can be any HMAC algorithm). @n
+ * GenerateMacN combines a password-based key derivation function, which shall be GenerateKeyKdf2N for this version of PKCS #5,
+ * with an underlying message authentication scheme. The key length and any other parameters for the underlying message
+ * authentication scheme depend on the scheme.
*
* @since 2.1
*
* @return A pointer to Tizen::Base::ByteBuffer containing the HMAC generated from message, @n
* else @c null if an error occurs
- * @param[in] params An instance of the PbMacParameters parameter structure holding AlgorithmIdentifier for key derivation
- * function and AlgorithmIdentifier for underlying encryption scheme
- * @param[in] message An instance of Tizen::Base::ByteBuffer holding the message for which MAC needs to generate
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] params An instance of PbMacParameters holding AlgorithmIdentifier for the key derivation
+ * function and AlgorithmIdentifier for the underlying encryption scheme
+ * @param[in] message An instance of Tizen::Base::ByteBuffer holding the message to generate MAC
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::ByteBuffer* GetPbHMacN(const Pkcs05PbMacParameters& params, const Tizen::Base::ByteBuffer& message);
/**
- * Verifies a message M under a password P to verify a message authentication code T,
- * by applying a selected key derivation function KDF2 and a selected underlying message authentication scheme combines a
- * password-based key derivation function, which shall be GenerateKeyKdf2N for this version of PKCS #5, with an underlying
- * message authentication scheme (which can be any SHA-1 or any SHA-2 algorithm). @n The key length and any other parameters
- * for the underlying message authentication scheme depend on the scheme.
+ * Verifies the message M under a password P to verify a message authentication code T, by applying a selected key derivation
+ * function KDF2 and a selected underlying message authentication scheme. This method combines a password-based key derivation function,
+ * which shall be GenerateKeyKdf2N for this version of PKCS #5, with an underlying message authentication scheme (which can
+ * be any SHA-1 or any SHA-2 algorithm). @n
+ * The key length and any other parameters for the underlying message authentication scheme depend on the scheme.
*
* @since 2.1
*
* @return An error code
- * @param[in] params An instance of the PbMacParameters parameter structure holding AlgorithmIdentifier for key derivation
- * function and AlgorithmIdentifier for underlying encryption scheme
- * @param[in] message An instance of Tizen::Base::ByteBuffer holding the message M
- * @param[in] mac An instance of Tizen::Base::ByteBuffer holding the HMAC mac that needs to verify against the message
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] params An instance of PbMacParameters holding AlgorithmIdentifier for the key derivation
+ * function and AlgorithmIdentifier for the underlying encryption scheme
+ * @param[in] message An instance of Tizen::Base::ByteBuffer holding the message M
+ * @param[in] mac An instance of Tizen::Base::ByteBuffer holding the HMAC mac to verify against the message
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
result VerifyPbMac(const Pkcs05PbMacParameters& params, const Tizen::Base::ByteBuffer& message, const Tizen::Base::ByteBuffer& mac);
* @since 2.1
*
* The %Pkcs08Attribute class implements the functionalities specified by the %Pkcs08Attribute class. An Attribute object consists
- * of an attribute type (specified by an object identifier) and one or more attribute values. It acts as a
- * container for adding, inserting, removing, and encoding X.509 AttributeValue.
+ * of an attribute type (specified by an object identifier) and one or more attribute values. It acts as a
+ * container for adding, inserting, removing, and encoding X.509 AttributeValue.
*
*/
virtual ~Pkcs08Attribute(void);
/**
- * Initializes this instance of %Pkcs08Attribute with the Tizen::Base::ByteBuffer that contains the X.509 attribute @n
+ * Initializes this instance of %Pkcs08Attribute with the specified Tizen::Base::ByteBuffer instance that contains the X.509 attribute
* structure in ASN.1 DER format.
*
* @since 2.1
*
* @return An error code
* @param[in] encodedData The DER encoded Tizen::Base::ByteBuffer containing the X.509 attribute structure
- * @exception E_SUCCESS The method is successful.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& encodedData);
* @since 2.1
*
* @return An error code
- * @param[in] attributeType The object identifier of a particular X.509 attribute type @n Object IDs (for example, oid for name is 2.5.4.41) are defined by standard attribute bodies.
- * @exception E_SUCCESS The method is successful.
+ * @param[in] attributeType The object identifier of a particular X.509 attribute type @n
+ * Object IDs (for example, oid for name is 2.5.4.41) are defined by standard attribute bodies.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::String& attributeType);
*
* @since 2.1
*
- * @return Containing the object ID of attribute type in string format like 2.5.4.41
+ * @return The string with the object ID of attribute type like 2.5.4.41
*
*/
Tizen::Base::String GetAttributeType(void) const;
/**
- * Adds an attribute value in the attribute value list.
+ * Adds the attribute value in the attribute value list.
*
* @since 2.1
*
* @return An error code
- * @param[in] attributeValue An instance of Pkcs08AttributeValue to add an attribute in the list
+ * @param[in] attributeValue An instance of Pkcs08AttributeValue
*/
result AddAttributeValue(const Pkcs08AttributeValue& attributeValue);
/**
- * Removes an attribute value from the attribute value list.
+ * Removes the attribute value from the attribute value list.
*
* @since 2.1
*
* @return An error code
- * @param[in] attributeValue An instance of Pkcs08AttributeValue to remove an attribute from the list
+ * @param[in] attributeValue An instance of Pkcs08AttributeValue
*/
result RemoveAttributeValue(const Pkcs08AttributeValue& attributeValue);
/**
- * Returns an array list containing the attribute values of type Pkcs08AttributeValue.
+ * Gets an array list containing the attribute values of type Pkcs08AttributeValue.
*
* @since 2.1
*
* @since 2.1
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
*
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
virtual ~Pkcs08AttributeValue(void);
/**
- * Initializes this instance of %Pkcs08AttributeValue with the Tizen::Base::ByteBuffer that contains the AttributeValue @n
- * (contain tag, that is, Ans1_Type and the value).
+ * Initializes this instance of %Pkcs08AttributeValue with the specified Tizen::Base::ByteBuffer that contains the AttributeValue @n
+ * (contains tag, that is, Ans1_Type and the value).
*
* @since 2.1
*
* @return An error code
* @param[in] encodedData The DER encoded Tizen::Base::ByteBuffer of AttributeValue
- * @exception E_SUCCESS The method is successful.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& encodedData);
*
* @return An error code
* @param[in] value An instance of Tizen::Base::ByteBuffer holding raw value
- * @param[in] tag A tag holding the tag type @n This tag number is assigned by ASN1 standards for @n
- * basic data types.
+ * @param[in] tag A tag holding the tag type @n This tag number is assigned by ASN1 standards for
+ * basic data types.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& value, Pkcs08TagValue tag);
/**
- * Gets a reference to Tizen::Base::ByteBuffer that contains the attribute value.
+ * Gets a reference to the Tizen::Base::ByteBuffer instance that contains the attribute value.
*
* @since 2.1
*
- * @return A reference to Tizen::Base::ByteBuffer containing raw value
+ * @return An instance of Tizen::Base::ByteBuffer containing raw value
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
const Tizen::Base::ByteBuffer& GetValue(void) const;
*
* @since 2.1
*
- * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
- * else @c null if an error occurs
+ * @return A pointer to the Tizen::Base::ByteBuffer instance that contains the output, @n
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @since 2.1
*
* The %Pkcs08EncryptedPrivateKeyInfo class provides methods to encrypt a private key. An encrypted private key structure consist
- * of an encryption algorithm and the encrypted Pkcs08PrivateKeyInfo.
+ * of an encryption algorithm and the encrypted Pkcs08PrivateKeyInfo.
*
- * This is defined in ASN.1 as demonstrated in the following code:
+ * This is defined in ASN.1 as demonstrated in the following code:
* @code
* EncryptedPrivateKeyInfo ::= SEQUENCE {
* encryptionAlgorithm AlgorithmIdentifier {{KeyEncryptionAlgorithms}},
virtual ~Pkcs08EncryptedPrivateKeyInfo(void);
/**
- * Initializes this instance of %Pkcs08EncryptedPrivateKeyInfo with the encoded Tizen::Base::ByteBuffer that contains @n
+ * Initializes this instance of %Pkcs08EncryptedPrivateKeyInfo with the encoded Tizen::Base::ByteBuffer that contains
* the EncryptedPrivateKeyInfo structure(EncryptedPrivateKeyInfo) in ASN.1 DER format.
*
* @since 2.1
*
* @return An error code
- * @param[in] encodedData The DER encoded Tizen::Base::ByteBuffer that contains the Pkcs08 EncryptedPrivateKeyInfo structure
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @param[in] encodedData The DER encoded Tizen::Base::ByteBuffer that contains the Pkcs08 EncryptedPrivateKeyInfo structure
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& encodedData);
* @return An error code
* @param[in] algorithmId An instance of AlgorithmIdentifier
* @param[in] encryptedData An encrypted private key
- * @exception E_SUCCESS The method is successful.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
*/
result Construct(const AlgorithmIdentifier& algorithmId, const Tizen::Base::ByteBuffer& encryptedData);
* @since 2.1
*
* @return An error code
- * @param[in] algorithmId An instance of AlgorithmIdentifier that identifies the secret key algorithm
- * @param[in] key The key for encrypting privateKeyInfo
- * @param[in] encodedPrivateKeyInfo An instance of Tizen::Base::ByteBuffer containing encoded privateKeyInfo
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @param[in] algorithmId An instance of AlgorithmIdentifier that identifies the secret key algorithm
+ * @param[in] key The key for encrypting PrivateKeyInfo
+ * @param[in] encodedPrivateKeyInfo An instance of Tizen::Base::ByteBuffer containing encoded PrivateKeyInfo
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
*
*/
result Construct(const AlgorithmIdentifier& algorithmId, const Tizen::Base::ByteBuffer& key, const Tizen::Base::ByteBuffer& encodedPrivateKeyInfo);
*
* @return A pointer to Tizen::Base::ByteBuffer that contains the decrypted private key of the %Pkcs08EncryptedPrivateKeyInfo object, @n
* else @c null if an error occurs
- * @param[in] key An instance of Tizen::Base::ByteBuffer holding a key to decrypt the private key using a particular @n
- * secret key algorithm
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] key An instance of Tizen::Base::ByteBuffer holding a key to decrypt the private key using a particular
+ * secret key algorithm
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& key);
* @since 2.1
*
* @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
- * else @c null if an error occurs
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * else @c null if an error occurs
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::ByteBuffer* GetEncodedDataN(void) const;
virtual ~Pkcs08PrivateKeyInfo(void);
/**
- * Initializes this instance of %Pkcs08PrivateKeyInfo with the encoded byte buffer that contains @n
- * pkcs08 private key info structure(PrivateKeyInfo) in ASN.1 DER format. @n
+ * Initializes this instance of %Pkcs08PrivateKeyInfo with the encoded byte buffer that contains pkcs08 private key info
+ * structure(PrivateKeyInfo) in ASN.1 DER format. @n
* It parses this encoded buffer and extracts the appropriate values of private key, its algorithm ID, and attributes.
*
* @since 2.1
*
* @return An error code
- * @param[in] encodedData An instance of Tizen::Base::ByteBuffer containing DER encoded PrivateKeyInfo structure
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @param[in] encodedData An instance of Tizen::Base::ByteBuffer containing DER encoded PrivateKeyInfo structure
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& encodedData);
* @since 2.1
*
* @return An error code.
- * @param[in] keyAlgorithmId An instance of AlgorithmIdentifier holding algorithm identifier of the private key algorithm
- * @param[in] privateKey An instance of Tizen::Base::ByteBuffer holding private key
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @param[in] keyAlgorithmId An instance of AlgorithmIdentifier holding the algorithm identifier of the private key algorithm
+ * @param[in] privateKey An instance of Tizen::Base::ByteBuffer holding the private key
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
*/
result Construct(const AlgorithmIdentifier& keyAlgorithmId, const Tizen::Base::ByteBuffer& privateKey);
/**
- * Gets the private key syntax version number of PrivateKeyInfo object @n
- * that is used for storing private key and its related information and default value of this version is @c 0.
+ * Gets the private key syntax version number of PrivateKeyInfo object that is used for storing private key and its related
+ * information and default value of this version is @c 0.
*
* @since 2.1
*
int GetVersion(void) const;
/**
- * Gets the reference to AlgorithmIdentifier that identifies the secret key algorithm.
+ * Gets a reference to AlgorithmIdentifier that identifies the secret key algorithm.
*
* @since 2.1
*
const AlgorithmIdentifier& GetPrivateKeyAlgorithm(void) const;
/**
- * Gets the reference to Tizen::Base::ByteBuffer that contains the private key in binary format.
+ * Gets a reference to Tizen::Base::ByteBuffer that contains the private key in binary format.
*
* @since 2.1
*
const Tizen::Base::ByteBuffer& GetPrivateKey(void) const;
/**
- * Gets the attributes of the type Pkcs08Attribute that are extended information of the private key in context.
+ * Gets the attributes of the type Pkcs08Attribute that are the extended information of the private key in context.
*
* @since 2.1
*
const Tizen::Base::Collection::ArrayList& GetAttributes(void) const;
/**
- * Adds the attributes in private key information that is extended information of the private key in context.
+ * Adds the attributes in private key information that is the extended information of the private key in context.
*
* @since 2.1
*
result AddAttribute(const Pkcs08Attribute& attributes);
/**
- * Removes the attribute in private key information that is extended information of the private key in context.
+ * Removes the attributes from the private key information that is the extended information of the private key in context.
*
* @since 2.1
*
* @param[in] attributes An instance of Pkcs08Attribute
*/
result RemoveAttribute(const Pkcs08Attribute& attributes);
-
+
/**
* Gets the DER encoded %Pkcs08PrivateKeyInfo structure.
*
* @since 2.1
*
* The %Rc2CbcParameters class implements the functionalities specified by the Rc2 Cbc mode parameter.
- * This class represents the Rc2 cbc mode parameter for symmetric ciphers RC2.
- * ASN.1 format for RC2-CBC-Parameter ::= SEQUENCE {
+ * This class represents the Rc2 cbc mode parameter for symmetric ciphers RC2.
+ * ASN.1 format for RC2-CBC-Parameter ::= SEQUENCE {
* rc2ParameterVersion INTEGER OPTIONAL,
* iv OCTET STRING (SIZE(8)) }
*
* @since 2.1
*
* @return An error code
- * @param[in] initialVector An instance of Tizen::Base::ByteBuffer containing the initial vector
- * @param[in] version An integer value that defines the rc2 cbc parameter version @n
- * As per Pkcs 5 standard, possible values can be 160,120,58, or any value
- * greater than or equal to 256.
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @param[in] initialVector An instance of Tizen::Base::ByteBuffer containing the initial vector
+ * @param[in] version An integer value that defines the rc2 cbc parameter version @n
+ * As per Pkcs 5 standard, possible values can be 160,120,58, or any value
+ * greater than or equal to 256.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& initialVector, int version = 0);
* @since 2.1
*
* @return @c true if the specified instance equals the current instance, @n
- * else @c false
+ * else @c false
* @param[in] rhs An instance of %Rc2CbcParameters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual bool Equals(const Tizen::Base::Object& rhs) const;
* @since 2.1
*
* @return A pointer to the DER encoded Tizen::Base::ByteBuffer, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @file FSecPkcsTypes.h
* @brief This is the header file for the declarations of the %PkcsAlgorithmParameterType and %Pkcs08TagValue enumerators and the AttributeType OID List.
*
- * This header file contains the declarations of the %PkcsAlgorithmParameterType and %Pkcs08TagValue enumerators and the AttributeType OID List.
+ * This header file contains the declarations of the PkcsAlgorithmParameterType and Pkcs08TagValue enumerators and the AttributeType OID List.
*/
#ifndef _FSEC_PKCS_TYPES_H_
{
/**
- * @enum PkcsAlgorithmParameterType
+ * @enum PkcsAlgorithmParameterType
*
* Defines the types of parameters.
*
*/
enum PkcsAlgorithmParameterType
{
- PKCS_ALGO_PARAM_TYPE_IV, /**< The parameter type is initial vector */
- PKCS_ALGO_PARAM_TYPE_PKCS05_PBES02, /**< The parameter type is pkcs5 password based encryption scheme2 */
- PKCS_ALGO_PARAM_TYPE_PKCS05_KDF02, /**< The parameter type is pkcs5 password based key derivation scheme2 */
- PKCS_ALGO_PARAM_TYPE_PKCS05_MAC, /**< The parameter type is pkcs5 message authentication scheme */
- PKCS_ALGO_PARAM_TYPE_RC2, /**< The parameter type is rc2 cbc */
- PKCS_ALGO_PARAM_TYPE_UNKOWN = 0xFFFFFFFF /**< An unknown parameter type */
+ PKCS_ALGO_PARAM_TYPE_IV, /**< The parameter type is initial vector */
+ PKCS_ALGO_PARAM_TYPE_PKCS05_PBES02, /**< The parameter type is pkcs5 password based encryption scheme2 */
+ PKCS_ALGO_PARAM_TYPE_PKCS05_KDF02, /**< The parameter type is pkcs5 password based key derivation scheme2 */
+ PKCS_ALGO_PARAM_TYPE_PKCS05_MAC, /**< The parameter type is pkcs5 message authentication scheme */
+ PKCS_ALGO_PARAM_TYPE_RC2, /**< The parameter type is rc2 cbc */
+ PKCS_ALGO_PARAM_TYPE_UNKOWN = 0xFFFFFFFF /**< An unknown parameter type */
}; //PkcsAlgorithmParameterType;
/**
- * @enum Pkcs08TagValue
+ * @enum Pkcs08TagValue
*
* Defines the Asn1 tag type.
*
- * @since 2.1
+ * @since 2.1
*/
enum Pkcs08TagValue
{
- PKCS08_TAG_RESERVED = 0, /**< Reserved for use by the encoding rules */
- PKCS08_TAG_BOOLEAN = 1, /**< An arbitrary bool value */
- PKCS08_TAG_INTEGER = 2, /**< An arbitrary integer value */
- PKCS08_TAG_BITSTRING = 3, /**< An arbitrary string of bits */
- PKCS08_TAG_OCTETSTRING = 4, /**< An arbitrary string of octets */
- PKCS08_TAG_NULL = 5, /**< A null value */
- PKCS08_TAG_OBJECT_ID = 6, /**< An object identifier */
- PKCS08_TAG_OBJECT_DES = 7, /**< An object descriptor providing a brief description of an object */
- PKCS08_TAG_EXTERNAL = 8, /**< An arbitrary external value */
- PKCS08_TAG_REAL = 9, /**< An arbitrary real value */
- PKCS08_TAG_ENUM = 10, /**< An enumerated value */
- PKCS08_TAG_EMBEDDED = 11, /**< An embedded value */
- PKCS08_TAG_UTF8STRING = 12, /**< An arbitrary utf8 string */
- PKCS08_TAG_REL_OBJ_ID = 13, /**< A relative object ID */
- PKCS08_TAG_SEQUENCE = 16, /**< An ordered collection of one or more types */
- PKCS08_TAG_SET = 17, /**< An unordered collection of one or more types */
- PKCS08_TAG_CHAR_STRING = 18, /**< A numeric string */
- PKCS08_TAG_PRINTABLE_STRING = 19, /**< An arbitrary string of printable characters */
- PKCS08_TAG_TELETEXT_STRING = 20, /**< A teletext string, T61 string */
- PKCS08_TAG_VIDEOTEXT_STRING = 21, /**< A videotext string */
- PKCS08_TAG_IA5STRING = 22, /**< An arbitrary string of IA5 (ASCII) characters */
- PKCS08_TAG_UTC_TIME = 23, /**< A coordinated universal time or Greenwich Mean Time (GMT) value */
- PKCS08_TAG_GEN_TIME = 24, /**< A generalized time */
- PKCS08_TAG_GRAPHICS_STRING = 25, /**< A graphic string */
- PKCS08_TAG_VISIBLE_STRING = 26, /**< A visible string, ISO64 string */
- PKCS08_TAG_GENERAL_STRING = 27, /**< A general string */
- PKCS08_TAG_UNIVERSAL_STRING = 28, /**< A universal string */
- PKCS08_TAG_CHARACTER_STRING = 29, /**< An arbitrary character string */
- PKCS08_TAG_BMP_STRING = 30, /**< A bmp string */
- PKCS08_TAG_UNKNOWN = -1 /**< An unknown tag type */
+ PKCS08_TAG_RESERVED = 0, /**< Reserved for use by the encoding rules */
+ PKCS08_TAG_BOOLEAN = 1, /**< An arbitrary bool value */
+ PKCS08_TAG_INTEGER = 2, /**< An arbitrary integer value */
+ PKCS08_TAG_BITSTRING = 3, /**< An arbitrary string of bits */
+ PKCS08_TAG_OCTETSTRING = 4, /**< An arbitrary string of octets */
+ PKCS08_TAG_NULL = 5, /**< A null value */
+ PKCS08_TAG_OBJECT_ID = 6, /**< An object identifier */
+ PKCS08_TAG_OBJECT_DES = 7, /**< An object descriptor providing a brief description of an object */
+ PKCS08_TAG_EXTERNAL = 8, /**< An arbitrary external value */
+ PKCS08_TAG_REAL = 9, /**< An arbitrary real value */
+ PKCS08_TAG_ENUM = 10, /**< An enumerated value */
+ PKCS08_TAG_EMBEDDED = 11, /**< An embedded value */
+ PKCS08_TAG_UTF8STRING = 12, /**< An arbitrary utf8 string */
+ PKCS08_TAG_REL_OBJ_ID = 13, /**< A relative object ID */
+ PKCS08_TAG_SEQUENCE = 16, /**< An ordered collection of one or more types */
+ PKCS08_TAG_SET = 17, /**< An unordered collection of one or more types */
+ PKCS08_TAG_CHAR_STRING = 18, /**< A numeric string */
+ PKCS08_TAG_PRINTABLE_STRING = 19, /**< An arbitrary string of printable characters */
+ PKCS08_TAG_TELETEXT_STRING = 20, /**< A teletext string, T61 string */
+ PKCS08_TAG_VIDEOTEXT_STRING = 21, /**< A videotext string */
+ PKCS08_TAG_IA5STRING = 22, /**< An arbitrary string of IA5 (ASCII) characters */
+ PKCS08_TAG_UTC_TIME = 23, /**< A coordinated universal time or Greenwich Mean Time (GMT) value */
+ PKCS08_TAG_GEN_TIME = 24, /**< A generalized time */
+ PKCS08_TAG_GRAPHICS_STRING = 25, /**< A graphic string */
+ PKCS08_TAG_VISIBLE_STRING = 26, /**< A visible string, ISO64 string */
+ PKCS08_TAG_GENERAL_STRING = 27, /**< A general string */
+ PKCS08_TAG_UNIVERSAL_STRING = 28, /**< A universal string */
+ PKCS08_TAG_CHARACTER_STRING = 29, /**< An arbitrary character string */
+ PKCS08_TAG_BMP_STRING = 30, /**< A bmp string */
+ PKCS08_TAG_UNKNOWN = -1 /**< An unknown tag type */
}; // Pkcs08TagValue;
/*
-- Basic object identifiers in Pkcs05 and Pkcs08
*/
-_OSP_EXPORT_ extern const wchar_t OID_PBKDF2[]; /**< An object identifier for password based key derivation function scheme2 */
-_OSP_EXPORT_ extern const wchar_t OID_PBES2[]; /**< An object identifier for password based encryption scheme2 */
-_OSP_EXPORT_ extern const wchar_t OID_PBMAC1[]; /**< An object identifier for password based message authentication scheme1 */
-_OSP_EXPORT_ extern const wchar_t OID_HMAC_SHA1[]; /**< An object identifier for hmac-sha1 */
-_OSP_EXPORT_ extern const wchar_t OID_HMAC_SHA2_224[]; /**< An object identifier for hmac-sha224 */
-_OSP_EXPORT_ extern const wchar_t OID_HMAC_SHA2_256[]; /**< An object identifier for hmac-sha256 */
-_OSP_EXPORT_ extern const wchar_t OID_HMAC_SHA2_384[]; /**< An object identifier for hmac-sha384 */
-_OSP_EXPORT_ extern const wchar_t OID_HMAC_SHA2_512[]; /**< An object identifier for hmac-sha512 */
-_OSP_EXPORT_ extern const wchar_t OID_DES_CBC[]; /**< An object identifier for des-cbc mode */
-_OSP_EXPORT_ extern const wchar_t OID_DES_CBC_EDE3[]; /**< An object identifier for des-cbc-ede3 mode */
-_OSP_EXPORT_ extern const wchar_t OID_AES_128_CBC[]; /**< An object identifier for aes-128-cbc mode */
-_OSP_EXPORT_ extern const wchar_t OID_AES_192_CBC[]; /**< An object identifier for aes-192-cbc mode */
-_OSP_EXPORT_ extern const wchar_t OID_AES_256_CBC[]; /**< An object identifier for aes-256-cbc mode */
-_OSP_EXPORT_ extern const wchar_t OID_RC2_CBC[]; /**< An object identifier for rc2-cbc mode */
-_OSP_EXPORT_ extern const wchar_t OID_RSA_ENCRYPTION[]; /**< An object identifier for RSA encryption scheme */
+_OSP_EXPORT_ extern const wchar_t OID_PBKDF2[]; /**< An object identifier for password based key derivation function scheme2 */
+_OSP_EXPORT_ extern const wchar_t OID_PBES2[]; /**< An object identifier for password based encryption scheme2 */
+_OSP_EXPORT_ extern const wchar_t OID_PBMAC1[]; /**< An object identifier for password based message authentication scheme1 */
+_OSP_EXPORT_ extern const wchar_t OID_HMAC_SHA1[]; /**< An object identifier for hmac-sha1 */
+_OSP_EXPORT_ extern const wchar_t OID_HMAC_SHA2_224[]; /**< An object identifier for hmac-sha224 */
+_OSP_EXPORT_ extern const wchar_t OID_HMAC_SHA2_256[]; /**< An object identifier for hmac-sha256 */
+_OSP_EXPORT_ extern const wchar_t OID_HMAC_SHA2_384[]; /**< An object identifier for hmac-sha384 */
+_OSP_EXPORT_ extern const wchar_t OID_HMAC_SHA2_512[]; /**< An object identifier for hmac-sha512 */
+_OSP_EXPORT_ extern const wchar_t OID_DES_CBC[]; /**< An object identifier for des-cbc mode */
+_OSP_EXPORT_ extern const wchar_t OID_DES_CBC_EDE3[]; /**< An object identifier for des-cbc-ede3 mode */
+_OSP_EXPORT_ extern const wchar_t OID_AES_128_CBC[]; /**< An object identifier for aes-128-cbc mode */
+_OSP_EXPORT_ extern const wchar_t OID_AES_192_CBC[]; /**< An object identifier for aes-192-cbc mode */
+_OSP_EXPORT_ extern const wchar_t OID_AES_256_CBC[]; /**< An object identifier for aes-256-cbc mode */
+_OSP_EXPORT_ extern const wchar_t OID_RC2_CBC[]; /**< An object identifier for rc2-cbc mode */
+_OSP_EXPORT_ extern const wchar_t OID_RSA_ENCRYPTION[]; /**< An object identifier for RSA encryption scheme */
/*
-- Basic object identifiers in Pkcs08 for AttributeType
*/
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_NAME[]; /**< An object identifier for attribute type name */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_SURNAME[]; /**< An object identifier for attribute type surname */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_GIVEN_NAME[]; /**< An object identifier for attribute type of any given name */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_INITIAL[]; /**< An object identifier for attribute type initial */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_GEN_QUALIFIER[]; /**< An object identifier for attribute type generation qualifier */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_COMMON_NAME[]; /**< An object identifier for attribute type common name */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_LOCALITY_NAME[]; /**< An object identifier for attribute type locality name */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_STATE_OR_PROV_NAME[]; /**< An object identifier for attribute type state/province name */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_ORG_NAME[]; /**< An object identifier for attribute type of any organization name */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_ORG_UNIT_NAME[]; /**< An object identifier for any organization unit name */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_TITLE[]; /**< An object identifier for attribute type title */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_DN_QUALIFIER[]; /**< An object identifier for distinguished name qualifier */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_COUNTRY_NAME[]; /**< An object identifier for attribute type country name */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_SERIAL_NUMBER[]; /**< An object identifier for attribute type serial number */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_PSEUDONYM[]; /**< An object identifier for attribute type pseudonym */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_DOMAIN_COMPONENT[]; /**< An object identifier for any domain component */
-_OSP_EXPORT_ extern const wchar_t OID_ATTR_EMAIL_ADDRESS[]; /**< An object identifier for any email address */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_NAME[]; /**< An object identifier for attribute type name */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_SURNAME[]; /**< An object identifier for attribute type surname */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_GIVEN_NAME[]; /**< An object identifier for attribute type of any given name */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_INITIAL[]; /**< An object identifier for attribute type initial */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_GEN_QUALIFIER[]; /**< An object identifier for attribute type generation qualifier */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_COMMON_NAME[]; /**< An object identifier for attribute type common name */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_LOCALITY_NAME[]; /**< An object identifier for attribute type locality name */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_STATE_OR_PROV_NAME[]; /**< An object identifier for attribute type state/province name */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_ORG_NAME[]; /**< An object identifier for attribute type of any organization name */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_ORG_UNIT_NAME[]; /**< An object identifier for any organization unit name */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_TITLE[]; /**< An object identifier for attribute type title */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_DN_QUALIFIER[]; /**< An object identifier for distinguished name qualifier */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_COUNTRY_NAME[]; /**< An object identifier for attribute type country name */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_SERIAL_NUMBER[]; /**< An object identifier for attribute type serial number */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_PSEUDONYM[]; /**< An object identifier for attribute type pseudonym */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_DOMAIN_COMPONENT[]; /**< An object identifier for any domain component */
+_OSP_EXPORT_ extern const wchar_t OID_ATTR_EMAIL_ADDRESS[]; /**< An object identifier for any email address */
} } } // Tizen::Security::Pkcs
// See the License for the specific language governing permissions and
// limitations under the License.
//
-
+
/**
-* @file FSecPrivacyInfo.h
-* @brief This is the header file for the %PrivacyInfo class.
+* @file FSecPrivacyInfo.h
+* @brief This is the header file for the %PrivacyInfo class.
*
* This header file contains the declarations of the %PrivacyInfo class.
*/
-
+
#ifndef _FSEC_PRIVACY_INFO_H_
#define _FSEC_PRIVACY_INFO_H_
-
+
#include <FBaseObject.h>
-
+
namespace Tizen { namespace Security
{
-
+
/**
* @class PrivacyInfo
-* @brief This class represents the privacy information.
+* @brief This class provides methods for the privacy information.
*
* @since 2.1
*
* The %PrivacyInfo class represents the privacy information.
* This class provides methods to retrieve the name and description of privilege.
*/
-
+
class _OSP_EXPORT_ PrivacyInfo
: public Tizen::Base::Object
{
public:
-
+
/**
* The object is not fully constructed after this constructor is called. @n
* For full construction, the Construct() method must be called right after calling this constructor.
* @since 2.1
*/
PrivacyInfo(void);
-
+
/**
* This destructor overrides Tizen::Base::Object::~Object().
*
*
*/
virtual ~PrivacyInfo(void);
-
+
/**
* Initializes this instance of %PrivacyInfo with the specified parameters.
*
* @return An error code
* @param[in] privacyId The privacy ID
* @param[in] enable Set to @c true to enable the privacy setting, @n
- * else @c false
+ * else @c false
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c privacyId is invalid or the @c privacyId does not exist.
*
*/
result Construct(const Tizen::Base::String& privacyId, bool enable = false);
-
+
/**
- * Gets a privacy ID.
+ * Gets the privacy ID.
*
* @since 2.1
*
*
*/
Tizen::Base::String GetId(void) const;
-
+
/**
* Checks whether the privacy setting is enabled.
*
* @see SetEnabled()
*/
bool IsEnabled(void) const;
-
+
/**
* Enables or disables the privacy setting.
*
* @since 2.1
*
- * @param[in] enable A Boolean value indicating whether the privacy setting is enabled
+ * @param[in] enable @c true if the privacy setting is enabled, @n
+ * else @c false
* @see IsEnabled()
*
*/
void SetEnabled(bool enable);
-
+
/**
- * Gets a localized display name of privacy.
+ * Gets the localized display name of privacy.
*
* @since 2.1
*
*
*/
Tizen::Base::String GetDisplayName(void) const;
-
+
/**
- * Gets a localized description of privacy.
+ * Gets the localized description of privacy.
*
* @since 2.1
*
*
*/
Tizen::Base::String GetDescription(void) const;
-
+
private:
-
+
//
// The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
//
- // @param[in] rhs An instance of %PrivacyInfo
+ // @param[in] rhs An instance of %PrivacyInfo
//
PrivacyInfo(const PrivacyInfo& rhs);
-
+
//
// The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
//
- // @param[in] rhs An instance of %PrivacyInfo
+ // @param[in] rhs An instance of %PrivacyInfo
//
PrivacyInfo& operator =(const PrivacyInfo& rhs);
-
+
private:
-
+
class _PrivacyInfoImpl* __pImpl;
friend class _PrivacyInfoImpl;
-
+
}; // PrivacyInfo
-
+
} } // Tizen::Security
-
+
#endif // _FSEC_PRIVACY_INFO_H_
-
+
// See the License for the specific language governing permissions and
// limitations under the License.
//
-
+
/**
* @file FSecPrivacyManager.h
* @brief This is the header file for the %PrivacyManager class.
*
* This header file contains the declarations of the %PrivacyManager class.
*/
-
+
#ifndef _FSEC_PRIVACY_MANAGER_H_
#define _FSEC_PRIVACY_MANAGER_H_
-
+
#include <FBaseObject.h>
#include <FAppTypes.h>
namespace Tizen { namespace Security
{
-
+
class PrivacyInfo;
-
+
/**
- * @class PrivacyManager
- * @brief This class gets the privacy information and manages an application's privacy settings.
+ * @class PrivacyManager
+ * @brief This class provides methods for managing the privacy information and the application's privacy settings.
*
- * @since 2.1
+ * @since 2.1
*
- * @final This class is not intended for extension.
+ * @final This class is not intended for extension.
*
* The %PrivacyManager class lets an application to get or save application's privacy settings.
*/
-
+
class _OSP_EXPORT_ PrivacyManager
: public Tizen::Base::Object
{
public:
-
+
/**
- * Gets the privacy manager instance.
+ * Gets a pointer to the %PrivacyManager instance.
*
* @since 2.1
*
* @return A pointer to the %PrivacyManager instance, @n
* else @c null if it fails
*
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static PrivacyManager* GetInstance(void);
-
+
/**
- * Gets a list of packages which access user's privacy information.
+ * Gets the list of packages which access user's privacy information.
*
* @since 2.1
* @privlevel platform
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::Collection::IList* GetPrivacyAppPackageListN(void) const;
-
+
/**
- * Gets a list of privacy information of a package.
+ * Gets the list of privacy information of a package.
*
* @since 2.1
* @privlevel platform
Tizen::Base::Collection::IList* GetPrivacyInfoListN(const Tizen::App::PackageId& packageId) const;
/**
- * Sets a specific privacy setting of a package.
+ * Sets the privacy setting of the specified package.
*
* @since 2.1
* @privlevel platform
* @param[in] packageId The package ID
* @param[in] privacyInfo The privacy information to set
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified @c packageId is not found in privacy database or @n
- * the package is not defined to access the privacy information.
+ * @exception E_OBJ_NOT_FOUND Either of the following conditions has occurred:
+ * - The specified @c packageId is not found in privacy database.
+ * - The package is not defined to access the privacy information.
* @exception E_INVALID_ARG The specified @c packageId length is invalid.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
*
*/
result SetAppPackagePrivacy(const Tizen::App::PackageId& packageId, const PrivacyInfo& privacyInfo);
-
+
private:
-
+
//
// This default constructor is intentionally declared as private to implement the %Singleton semantic.
//
- // @since 2.1
+ // @since 2.1
//
PrivacyManager(void);
-
+
//
// The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
//
- // @since 2.1
+ // @since 2.1
//
PrivacyManager(const PrivacyManager& rhs);
-
+
//
// The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
//
- // @since 2.1
+ // @since 2.1
//
PrivacyManager& operator =(const PrivacyManager& rhs);
-
+
//
// This destructor is intentionally declared as private to implement the %Singleton semantic.
//
- // @since 2.1
+ // @since 2.1
//
virtual ~PrivacyManager(void);
-
+
private:
-
+
class _PrivacyManagerImpl* __pPrivacyManagerImpl;
friend class _PrivacyManagerImpl;
-
+
}; // PrivacyManager
-
+
}} // Tizen::Security
-
+
#endif // _FSEC_PRIVACY_MANAGER_H_
//
/**
- * @file FSecPrivateKey.h
+ * @file FSecPrivateKey.h
* @brief This is the header file for the %PrivateKey class.
*
* This header file contains the declarations of the %PrivateKey class.
/**
* @class PrivateKey
- * @brief This class specifies the RSA private key.
+ * @brief This class provides methods to manage the RSA private key.
*
- * @since 2.0
+ * @since 2.0
*
- * The %PrivateKey class manages a private key, which is used in asymmetric ciphers. The RSA algorithm decrypts the data using the private key. @n
+ * The %PrivateKey class manages a private key, which is used in asymmetric ciphers. The RSA algorithm decrypts the data using the private key. @n
*
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
*
* @see IKey
* @see IPrivateKey
/**
* This is the default constructor for this class.
*
- * @since 2.0
+ * @since 2.0
*/
PrivateKey(void);
/**
- * This destructor overrides Tizen::Base::Object::~Object().
+ * This destructor overrides Tizen::Base::Object::~Object().
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~PrivateKey(void);
/**
* Gets the name of the primary encoding format of the current instance of %PrivateKey.
*
- * @since 2.0
+ * @since 2.0
*
- * @return The primary encoding format of a key
+ * @return The primary encoding format of the key
*/
virtual Tizen::Base::String GetFormat(void) const;
/**
* Gets the private key in its primary encoding format.
*
- * @since 2.0
+ * @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetEncodedN(void) const;
/**
* Sets the private key buffer.
*
- * @since 2.0
+ * @since 2.0
*
* @return An error code
* @param[in] keyBuffer An instance of Tizen::Base::ByteBuffer
#ifndef _FSEC_PRIVILEGE_INFO_H_
#define _FSEC_PRIVILEGE_INFO_H_
-
+
#include <FBaseObject.h>
-
+
namespace Tizen { namespace Security
{
/**
* @class PrivilegeInfo
-* @brief This class represents the privilege information.
+* @brief This class provides methods for managing the privilege information.
*
* @since 2.1
*
* The object is not fully constructed after this constructor is called. @n
* For full construction, the Construct() method must be called right after calling this constructor.
*
- * @since 2.1
+ * @since 2.1
*/
PrivilegeInfo(void);
/**
* Initializes this instance of %PrivilegeInfo with the specified parameters.
*
- * @since 2.1
+ * @since 2.1
*
- * @return An error code
- * @param[in] privilegeId The privilege ID
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c privilegeId is invalid.
+ * @return An error code
+ * @param[in] privilegeId The privilege ID
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified @c privilegeId is invalid.
*
*/
result Construct(const Tizen::Base::String& privilegeId);
/**
- * Gets a privilege ID.
+ * Gets the privilege ID.
*
- * @since 2.1
+ * @since 2.1
*
- * @return The privilege ID
+ * @return The privilege ID
*
*/
Tizen::Base::String GetId(void) const;
/**
* Gets the localized display name of privilege.
*
- * @since 2.1
+ * @since 2.1
*
- * @return The display name of privilege, @n
- * else an empty string is returned if there is no value
+ * @return The display name of privilege, @n
+ * else an empty string is returned if there is no value
*
*/
Tizen::Base::String GetDisplayName(void) const;
/**
* Gets the localized description of privilege.
*
- * @since 2.1
+ * @since 2.1
*
- * @return The description of privilege, @n
- * else an empty string is returned if there is no value
+ * @return The description of privilege, @n
+ * else an empty string is returned if there is no value
*
*/
Tizen::Base::String GetDescription(void) const;
//
// The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
//
- // @param[in] rhs An instance of %PrivilegeInfo
+ // @param[in] rhs An instance of %PrivilegeInfo
//
PrivilegeInfo(const PrivilegeInfo& rhs);
//
// The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
//
- // @param[in] rhs An instance of %PrivilegeInfo
+ // @param[in] rhs An instance of %PrivilegeInfo
//
PrivilegeInfo& operator =(const PrivilegeInfo& rhs);
//
/**
- * @file FSecPublicKey.h
+ * @file FSecPublicKey.h
* @brief This is the header file for the %PublicKey class.
*
* This header file contains the declarations of the %PublicKey class.
/**
* @class PublicKey
- * @brief This class specifies the RSA public key.
+ * @brief This class provides methods for managing the RSA public key.
*
- * @since 2.0
+ * @since 2.0
*
* The %PublicKey class manages a public key, which is used in asymmetric ciphers.
* The RSA algorithm encrypts the data using the public key. @n
/**
* This is the default constructor for this class.
*
- * @since 2.0
+ * @since 2.0
*/
PublicKey(void);
/**
* This destructor overrides Tizen::Base::Object::~Object().
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~PublicKey(void);
/**
* Gets the name of the primary encoding format of the current instance of %PublicKey.
*
- * @since 2.0
+ * @since 2.0
*
* @return The primary encoding format of the key
*/
/**
* Gets the public key in its primary encoding format.
*
- * @since 2.0
+ * @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::ByteBuffer* GetEncodedN(void) const;
/**
* Sets the public key buffer.
*
- * @since 2.0
+ * @since 2.0
*
* @return An error code
* @param[in] keyBuffer An instance of Tizen::Base::ByteBuffer
//
// The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
//
- // @since 2.0
+ // @since 2.0
//
PublicKey(const PublicKey& rhs);
//
// The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
//
- // @since 2.0
+ // @since 2.0
//
PublicKey& operator =(const PublicKey& rhs);
//
/**
- * @file FSecRsaKeyConverter.h
+ * @file FSecRsaKeyConverter.h
* @brief This is the header file for the %RsaKeyConverter class.
*
* This header file contains the declarations of the %RsaKeyConverter class.
{
/**
- * @enum RsaKeyFormat
+ * @enum RsaKeyFormat
*
- * Defines the types of rsa key format.
+ * Defines the types of rsa key format.
*
- * @since 2.1
+ * @since 2.1
*/
enum RsaKeyFormat
{
- RSA_KEY_FORMAT_PKCS01_PRIVATE_KEY = 0, /**< The rsa key format is PKCS1 private key */
- RSA_KEY_FORMAT_PKCS01_PUBLIC_KEY = 1, /**< The rsa key format is PKCS1 public key */
- RSA_KEY_FORMAT_PKCS08_PRIVATE_KEY = 2, /**< The rsa key format is PKCS8 private key */
- RSA_KEY_FORMAT_X509_PUBLIC_KEY = 3, /**< The rsa key format is X509 public key */
- RSA_KEY_FORMAT_UNKNOWN = 0xffffffff /**< The rsa key format is unknown */
+ RSA_KEY_FORMAT_PKCS01_PRIVATE_KEY = 0, /**< The rsa key format is PKCS1 private key */
+ RSA_KEY_FORMAT_PKCS01_PUBLIC_KEY = 1, /**< The rsa key format is PKCS1 public key */
+ RSA_KEY_FORMAT_PKCS08_PRIVATE_KEY = 2, /**< The rsa key format is PKCS8 private key */
+ RSA_KEY_FORMAT_X509_PUBLIC_KEY = 3, /**< The rsa key format is X509 public key */
+ RSA_KEY_FORMAT_UNKNOWN = 0xffffffff /**< The rsa key format is unknown */
}; //RsaKeyFormat;
/**
- * @class RsaKeyConverter
- * @brief This class provides support for converting the RSA public/private key in multiple key formats and multiple encoding formats.
+ * @class RsaKeyConverter
+ * @brief This class provides methods for converting the RSA public/private key in multiple key formats and multiple encoding formats.
*
- * @since 2.1
+ * @since 2.1
*
- * The %RsaKeyConverter class provides support for converting the RSA public/private key in multiple key formats and multiple encoding formats. @n
- * Supported RSA key formats are PKCS1/PKCS8/X509. @n
- * Supported encoding formats are DER/PEM.
+ * The %RsaKeyConverter class provides support for converting the RSA public/private key in multiple key formats and multiple encoding formats. @n
+ * The supported RSA key formats are PKCS1/PKCS8/X509. @n
+ * The supported encoding formats are DER/PEM.
*/
class _OSP_EXPORT_ RsaKeyConverter
public:
/**
- * Generates a RSA encoded private key in the passed input RSA key format. @n
+ * Generates an RSA encoded private key in the passed input RSA key format. @n
* If the input private key is in PEM encoded format, then the output RSA private key will be PEM encoded; if it is in DER encoded format,
* then the output RSA private key will be DER encoded.
*
* @since 2.1
*
* @return A pointer to the encoded Tizen::Base::ByteBuffer instance, @n
- * else @c null if the method fails to convert the private key in the passed input format
- * @param[in] format An enum value that contains the RSA private key format @n
- * Valid values for the supported output RSA private key formats are only @c RSA_KEY_FORMAT_PKCS01_PRIVATE_KEY and @c RSA_KEY_FORMAT_PKCS08_PRIVATE_KEY.
- * @param[in] key An instance of IPrivateKey
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * else @c null if the method fails to convert the private key in the passed input format
+ * @param[in] format An enum value that contains the RSA private key format @n
+ * The valid values for the supported output RSA private key formats are only
+ * @c RSA_KEY_FORMAT_PKCS01_PRIVATE_KEY and @c RSA_KEY_FORMAT_PKCS08_PRIVATE_KEY.
+ * @param[in] key An instance of IPrivateKey
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static Tizen::Base::ByteBuffer* ConvertPrivateKeyFormatN(RsaKeyFormat format, const IPrivateKey& key);
/**
- * Generates a RSA encoded public key in the passed input RSA key format. @n
+ * Generates an RSA encoded public key in the passed input RSA key format. @n
* If the input public key is in PEM encoded format, then the output RSA public key will be PEM encoded; if it is in DER encoded format,
* then the output RSA public key will be DER encoded.
*
* @since 2.1
*
* @return A pointer to the encoded Tizen::Base::ByteBuffer instance, @n
- * else @c null if the method fails to convert the public key in the passed input format
- * @param[in] format An enum value that contains the RSA public key format @n
- * Valid values for the supported output RSA public key formats are only @c RSA_KEY_FORMAT_PKCS01_PUBLIC_KEY and @c RSA_KEY_FORMAT_X509_PUBLIC_KEY.
- * @param[in] key An instance of IPublicKey
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * else @c null if the method fails to convert the public key in the passed input format
+ * @param[in] format An enum value that contains the RSA public key format @n
+ * The valid values for the supported output RSA public key formats are only
+ * @c RSA_KEY_FORMAT_PKCS01_PUBLIC_KEY and @c RSA_KEY_FORMAT_X509_PUBLIC_KEY.
+ * @param[in] key An instance of IPublicKey
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static Tizen::Base::ByteBuffer* ConvertPublicKeyFormatN(RsaKeyFormat format, const IPublicKey& key);
* @since 2.1
*
* @return A pointer to the PEM encoded Tizen::Base::ByteBuffer instance, @n
- * else @c null if the method fails to convert the key in the PEM encoded format
- * @param[in] format An enum value that contains the RSA key format of the input key
- * @param[in] key An instance of IKey
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * else @c null if the method fails to convert the key in the PEM encoded format
+ * @param[in] format An enum value that contains the RSA key format of the input key
+ * @param[in] key An instance of IKey
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static Tizen::Base::ByteBuffer* ConvertDerToPemN(RsaKeyFormat format, const IKey& key);
* @since 2.1
*
* @return A pointer to the DER encoded Tizen::Base::ByteBuffer instance, @n
- * else @c null if the method fails to convert the key in the DER encoded format
+ * else @c null if the method fails to convert the key in the DER encoded format
* @param[in] format An enum value that contains the RSA key format of the input key
* @param[in] key An instance of IKey
- * @exception E_SUCCESS The method is successful.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static Tizen::Base::ByteBuffer* ConvertPemToDerN(RsaKeyFormat format, const IKey& key);
class _RsaKeyConverterImpl* __pRsaKeyConverterImpl;
friend class _RsaKeyConverterImpl;
-}; //RsaKeyConverter
+}; //RsaKeyConverter
} } //Tizen::Security
//
/**
- * @file FSecSecretKey.h
+ * @file FSecSecretKey.h
* @brief This is the header file for the %SecretKey class.
*
* This header file contains the declarations of the %SecretKey class.
/**
* @class SecretKey
- * @brief This class specifies a secret key.
+ * @brief This class provides methods for managing a secret key.
*
- * @since 2.0
+ * @since 2.0
*
- * The %SecretKey class manages a secret key, which is used in symmetric ciphers, such as Advanced Encryption Standard (AES), Data Encryption Standard (DES), and Triple Data Encryption Standard (3DES). @n
+ * The %SecretKey class manages a secret key, which is used in symmetric ciphers, such as Advanced Encryption Standard (AES),
+ * Data Encryption Standard (DES), and Triple Data Encryption Standard (3DES). @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
*
- * @see IKey
- * @see ISecretKey
- * @see SecretKeyGenerator
- * @see ISecretKeyGenerator
+ * @see IKey
+ * @see ISecretKey
+ * @see SecretKeyGenerator
+ * @see ISecretKeyGenerator
*/
class _OSP_EXPORT_ SecretKey
: public virtual IKey
/**
* This is the default constructor for this class.
*
- * @since 2.0
+ * @since 2.0
*/
SecretKey(void);
/**
- * This destructor overrides Tizen::Base::Object::~Object().
+ * This destructor overrides Tizen::Base::Object::~Object().
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~SecretKey(void);
/**
* Gets the name of the primary encoding format of the current instance of %SecretKey.
*
- * @since 2.0
+ * @since 2.0
*
* @return The primary encoding format of a key
*/
/**
* Gets the secret key in its primary encoding format.
*
- * @since 2.0
+ * @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer class, @n
- * else @c null if an error occurs
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @remarks The specific error code can be accessed using the GetLastResult() method.
/**
* Sets the secret key buffer.
*
- * @since 2.0
+ * @since 2.0
*
* @return An error code
* @param[in] keyBuffer An instance of Tizen::Base::ByteBuffer
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c keyBuffer is invalid.
+ * @exception E_INVALID_ARG The specified @c keyBuffer is invalid.
*/
virtual result SetKey(const Tizen::Base::ByteBuffer& keyBuffer);
class _SecretKeyImpl* __pSecretKeyImpl;
friend class _SecretKeyImpl;
-}; //SecretKey
+}; //SecretKey
} } // Tizen::Security
/**
* @class SecretKeyGenerator
- * @brief This class is used for generating a secret (symmetric) key.
+ * @brief This class provides methods for generating a secret (symmetric) key.
*
- * @since 2.0
+ * @since 2.0
*
- * The %SecretKeyGenerator class generates a secret key, which is used in symmetric ciphers. The generated secret key is based on an encryption algorithm. @n
+ * The %SecretKeyGenerator class generates a secret key, which is used in symmetric ciphers. The generated secret key
+ * is based on an encryption algorithm. @n
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/key_mgmt_and_csprng.htm">Key Management and CSPRNG</a>.
*
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, @n
- * the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. For full construction, @n
+ * the Construct() method must be called right after calling this constructor.
*
- * @since 2.0
+ * @since 2.0
*/
SecretKeyGenerator(void);
/**
- * This destructor overrides Tizen::Base::Object::~Object().
+ * This destructor overrides Tizen::Base::Object::~Object().
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~SecretKeyGenerator(void);
/**
* Constructs and initializes this instance of %SecretKeyGenerator with the specified key.
*
- * @since 2.0
+ * @since 2.0
*
* @return An error code
* @param[in] keyBytes The key of type Tizen::Base::ByteBuffer
/**
* Constructs and initializes this instance of %SecretKeyGenerator for the specified @c algorithm.
*
- * @since 2.0
+ * @since 2.0
*
* @return An error code
* @param[in] algorithm The name of the secure random generator algorithm @n
- * For example, "AES","DES", or "3DES".
+ * For example, "AES","DES", or "3DES".
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c algorithm is invalid or an empty string.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* Constructs and initializes this instance of %SecretKeyGenerator with the specified key size. @n
* The default algorithm is Advanced Encryption Standard (AES).
*
- * @since 2.0
+ * @since 2.0
*
* @return An error code
* @param[in] keySize The key size
/**
* Generates a new secret key.
*
- * @since 2.0
+ * @since 2.0
*
* @return A pointer to the ISecretKey interface, @n
- * else @c null if it fails to generate a secret key
+ * else @c null if it fails to generate a secret key
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Security::ISecretKey* GenerateKeyN(void);
* @namespace Tizen::Security
* @brief This namespace contains classes and interfaces for security services.
*
- * @since 2.0
+ * @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FSecurity.h> @n
- * @b Library : @b osp-appfw
+ * @b Library: @b osp-appfw
*
*
- * The %Security namespace contains classes for
- * managing certificates, cryptographic keys, signatures, and for generating pseudo-random numbers. @n
+ * The %Security namespace contains classes for managing certificates, cryptographic keys, signatures,
+ * and for generating pseudo-random numbers. @n
*
* For more information on the %Security namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/security/security_namespace.htm">Security Guide</a>. @n
*
{
public:
/**
- * This is the default constructor for this class.
+ * This is the default constructor for this class. @n
+ * The object is not fully constructed after this constructor is called. @n
+ * For full construction, the Construct() method must be called right after calling this constructor.
*
* @since 2.0
*
- * @remarks The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
*/
Alarm(void);
* @privlevel public
* @privilege %http://tizen.org/privilege/alarm
*
- * @return An error code
- * @param[in] duetime The time for the alarm to ring @n Any value with a unit that is less than a second is ignored.
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] duetime The time for the alarm to ring @n
+ * Any value with a unit that is less than a second is ignored.
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_ARG The specified @c duetime is invalid.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks If this %Alarm instance is already registered by this method, existing alarm is cancelled automatically.
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks If this %Alarm instance is already registered by this method, the existing alarm is cancelled automatically.
*/
result Set(const Tizen::Base::DateTime& duetime);
/**
* Sets a repeating alarm.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/alarm
*
- * @return An error code
- * @param[in] start The time for the alarm to ring first @n Any value with a unit that is less than a second is ignored.
- * @param[in] period The interval in minutes between consecutive alarm rings
- * @param[in] pEnd The time for the alarm ring to end @n Any value with a unit that is less than a second is ignored.
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] start The time for the alarm to ring first @n
+ * Any value with a unit that is less than a second is ignored.
+ * @param[in] period The interval in minutes between consecutive alarm rings
+ * @param[in] pEnd The time for the alarm ring to end @n
+ * Any value with a unit that is less than a second is ignored.
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks If this %Alarm instance is already registered by this method, existing alarm is cancelled automatically. @n If @c pEnd is @c null, the alarm repeats forever.
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks
+ * - If this %Alarm instance is already registered by this method, existing alarm is cancelled automatically.
+ * - If @c pEnd is @c null, the alarm repeats forever.
*/
result Set(const Tizen::Base::DateTime& start, int period, const Tizen::Base::DateTime* pEnd = null);
/**
* Cancels the alarm.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/alarm
*
- * @return An error code
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
*/
result Cancel(void);
/**
* Gets the start time for the current instance of %Alarm.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An instance of Tizen::Base::DateTime indicating the start time for the alarm
- * @remarks If this %Alarm instance is not registered by the Set() method, return value is default value of the Tizen::Base::DateTime class.
+ * @return An instance of Tizen::Base::DateTime indicating the start time for the alarm
+ * @remarks If this %Alarm instance is not registered by the Set() method, the return value is the default value of
+ * the Tizen::Base::DateTime instance.
*/
const Tizen::Base::DateTime GetStartTime(void) const;
/**
* Gets the period of the current instance of %Alarm in minutes.
*
- * @since 2.0
+ * @since 2.0
*
- * @return The period of the current instance of %Alarm in minutes
+ * @return The period of the current instance of %Alarm in minutes
* @remarks If this %Alarm instance is not registered by the Set() method, return value is @c 0.
*/
int GetPeriod(void) const;
*
* @since 2.0
*
- * @return A pointer to Tizen::Base::DateTime indicating the end time for the alarm, @n
+ * @return A pointer to Tizen::Base::DateTime indicating the end time for the alarm, @n
* else @c null if the end time has not been set
*/
const Tizen::Base::DateTime* GetEndTime(void) const;
* @deprecated This class is deprecated. Instead of using this class, use the PowerManager class.
* @final This class is not intended for extension.
*
- * The %Battery class provides methods to get the status related to battery levels and
- * determine whether the battery is currently being charged.
- * You cannot create an instance of this class directly.
+ * The %Battery class provides methods to get the status related to battery levels and determine whether the battery is
+ * currently being charged. You cannot create an instance of this class directly.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/system/battery_status.htm">Battery Status</a>.
* @endif
* @compatibility This method has compatibility issues with OSP compatible applications. @n
* For more information, see @ref CompGetCurrentLevelInPercentage "here".
* @endif
- * @return An error code
- * @param[out] level The percentage of the charge remaining in the battery
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[out] level The percentage of the charge remaining in the battery
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The battery service is not available.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The resolution of the level is @c 1% since 2.0. The range of the level is @c 0 (Minimum) to @c 100 (Maximum).
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @remarks The resolution of the level is @c 1% since 2.0. The range of the level is @c 0 (Minimum) to @c 100 (Maximum).
* @endcond
*/
static result GetCurrentLevelInPercentage(int& level);
* @compatibility This method has compatibility issues with OSP compatible applications. @n
* For more information, see @ref CompGetCurrentLevel "here".
* @endif
- * @return An error code
+ * @return An error code
* @param[out] level A value from the enumerator BatteryLevel indicating the current charging level
- * @exception E_SUCCESS The method is successful.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The battery service is not available.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @endcond
*/
static result GetCurrentLevel(BatteryLevel& level);
* @endif
* @return An error code
* @param[out] charging Set to @c true if the charging cable is connected to the phone, @n
- * else @c false
- * @exception E_SUCCESS The method is successful.
+ * else @c false
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The battery service is not available.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @endcond
*/
static result IsCharging(bool& charging);
*
* @final This class is not intended for extension.
*
- * The %DeviceManager class provides listener to handle events for various external device,
- * such as a Bluetooth headset, HDMI, and headphone.
- * This class also gets the current state of the device. You cannot create an instance of this class directly.
+ * The %DeviceManager class provides listeners to handle events for various external device, such as a Bluetooth headset, HDMI,
+ * and headphone. This class also gets the current state of the device. You cannot create an instance of this class directly.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/system/device_management.htm">External Device Management</a>.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
- * @since 2.0
+ * @since 2.0
* @if OSPCOMPAT
* @compatibility This method has compatibility issues with %Tizen API versions @b prior @b to @b 2.0. @n
- * For more information, see @ref DeviceManagerGetStatePage "here".
+ * For more information, see @ref DeviceManagerGetStatePage "here".
* @endif
*
* @param[in] deviceType The value from the enumerator DeviceType indicating the device
* @param[out] state The device <a href="../org.tizen.native.appprogramming/html/guide/system/device_management.htm">state</a> of type Tizen::Base::String
*
- * @return An error code
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_ARG The specified @c deviceType is not valid.
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_INVALID_ARG The specified @c deviceType is not valid.
* @exception E_UNSUPPORTED_OPERATION The specified @c deviceType is not supported on this model.
*/
static result GetState(DeviceType deviceType, Tizen::Base::String& state);
* @page DeviceManagerGetStatePage Compatibility for GetState()
* @section DeviceManagerGetStatePageIssueSection Issues
* Implementation of this method in OSP compatible applications has the following issue: @n
- * The GetState() method does not return E_DEVICE_UNAVAILABLE anymore. The E_DEVICE_UNAVAILABLE exception is removed.
+ * The GetState() method does not return @c E_DEVICE_UNAVAILABLE anymore. The @c E_DEVICE_UNAVAILABLE exception is removed.
* @section DeviceManagerGetStatePageIssueSection Resolutions
- * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE.
+ * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use @c E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE.
* @endif
*/
/**
- * Adds a device event listener.
+ * Adds the device event listener.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
- * @since 2.0
+ * @since 2.0
* @if OSPCOMPAT
* @compatibility This method has compatibility issues with %Tizen API versions @b prior @b to @b 2.0. @n
* For more information, see @ref DeviceManagerAddDeviceEventListenerPage "here".
* @endif
*
- * @return An error code
- * @param[in] deviceType The types of a device
- * @param[in] listener The device event listener
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_ARG The specified @c deviceType is not valid.
- * @exception E_OBJ_ALREADY_EXIST The specified @c deviceType and @c listener are already registered.
+ * @return An error code
+ * @param[in] deviceType The device type
+ * @param[in] listener The device event listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_INVALID_ARG The specified @c deviceType is not valid.
+ * @exception E_OBJ_ALREADY_EXIST The specified @c deviceType and @c listener are already registered.
* @exception E_UNSUPPORTED_OPERATION The specified @c deviceType is not supported on this model.
*/
static result AddDeviceEventListener(DeviceType deviceType, IDeviceEventListener& listener);
* @page DeviceManagerAddDeviceEventListenerPage Compatibility for AddDeviceEventListener()
* @section DeviceManagerAddDeviceEventListenerPageIssueSection Issues
* Implementation of this method in OSP compatible applications has the following issue: @n
- * This AddDeviceEventListener() method does not return E_DEVICE_UNAVAILABLE anymore. The E_DEVICE_UNAVAILABLE exception is removed.
+ * This AddDeviceEventListener() method does not return @c E_DEVICE_UNAVAILABLE anymore. The @c E_DEVICE_UNAVAILABLE exception is removed.
* @section DeviceManagerAddDeviceEventListenerPageIssueSection Resolutions
- * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE.
+ * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use @c E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE.
* @endif
*/
/**
- * Removes a device event listener from all types of devices.
+ * Removes the device event listener from all types of devices.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] deviceType The types of a device
- * @param[in] listener The device event listener
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_ARG The specified @c deviceType is not valid.
- * @exception E_OBJ_NOT_FOUND The specified @c deviceType and @c listener are not registered.
+ * @return An error code
+ * @param[in] deviceType The types of a device
+ * @param[in] listener The device event listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_INVALID_ARG The specified @c deviceType is not valid.
+ * @exception E_OBJ_NOT_FOUND The specified @c deviceType and @c listener are not registered.
* @exception E_UNSUPPORTED_OPERATION The specified @c deviceType is not supported on this model.
*/
static result RemoveDeviceEventListener(DeviceType deviceType, IDeviceEventListener& listener);
* @page DeviceManagerRemoveDeviceEventListenerPage Compatibility for RemoveDeviceEventListener()
* @section DeviceManagerRemoveDeviceEventListenerPageIssueSection Issues
* Implementation of this method in OSP compatible applications has the following issue: @n
- * This RemoveDeviceEventListener() method does not return E_DEVICE_UNAVAILABLE anymore. The E_DEVICE_UNAVAILABLE exception is removed.
+ * This RemoveDeviceEventListener() method does not return @c E_DEVICE_UNAVAILABLE anymore. The @c E_DEVICE_UNAVAILABLE exception is removed.
* @section DeviceManagerRemoveDeviceEventListenerPageIssueSection Resolutions
- * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE.
+ * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use @c E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE.
* @endif
*/
/**
- * Removes all device event listeners.
+ * Removes all the device event listeners.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
*/
public:
/**
- * Gets the path for the media directory that is usually used to store media contents.
+ * Gets the path for the media directory that stores the media contents.
*
* @since 2.0
*
* @return The media directory path
+ * @remarks If the platform policy is changed or the device is different, the returned file path can be different. @n
+ * Rather than changing the returned file path as hard coding, use as it is.
*/
static Tizen::Base::String GetMediaPath(void);
/**
- * Gets the path for the default download directory that is usually used to store downloaded contents by the Tizen::Content::DownloadManager class.
+ * Gets the path for the default download directory that stores the downloaded contents by the Tizen::Content::DownloadManager class.
*
* @since 2.0
*
* @return The default download directory path
+ * @remarks If the platform policy is changed or the device is different, the returned file path can be different. @n
+ * Rather than changing the returned file path as hard coding, use as it is.
*/
static Tizen::Base::String GetDefaultDownloadPath(void);
* @since 2.0
*
* @return The external storage directory path
+ * @remarks If the platform policy is changed or the device is different, the returned file path can be different. @n
+ * Rather than changing the returned file path as hard coding, use as it is.
*/
static Tizen::Base::String GetExternalStoragePath(void);
/**
* Gets the directory path according to the pre-defined directory type.
*
- * @since 2.0
+ * @since 2.0
*
- * @return The pre-defined directory path according to the specified @c dirType, @n
- * else an empty string if the specified @c dirType is invalid
- * @param[in] dirType The pre-defined directory type
- * @remarks The directory path for some directory types such as IMAGES, SOUNDS, VIDEOS, CAMERA, DOWNLOADS, and OTHERS may not yet exist,
- * so you must make sure that it exists before using it.
- * @see Tizen::Io::Directory::Create()
+ * @return The pre-defined directory path according to the specified @c dirType, @n
+ * else an empty string if the specified @c dirType is invalid
+ * @param[in] dirType The pre-defined directory type
+ * @remarks
+ * - The directory path for some directory types such as IMAGES, SOUNDS, VIDEOS, CAMERA, DOWNLOADS, and OTHERS may not yet exist,
+ * so you must make sure that it exists before using it.
+ * - If the platform policy is changed or the device is different, the returned file path can be different. @n
+ * Rather than changing the returned file path as hard coding, use as it is.
+ * @see Tizen::Io::Directory::Create()
*/
static Tizen::Base::String GetPredefinedPath(PredefinedDirectoryType dirType);
/**
* @interface IAlarmEventListener
- * @brief This interface is the listener of the alarm event.
+ * @brief This interface is the listener of the alarm event.
*
* @since 2.0
*
{
public:
/**
- * This is the destructor for this class. This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This is the destructor for this class. @n
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
/**
* @interface IBatteryEventListener
- * @brief This interface is the listener of the battery event.
+ * @brief This interface is the listener of the battery event.
*
* @since 2.0
*
{
public:
/**
- * This is the destructor for this class. This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This is the destructor for this class. @n
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~IBatteryEventListener(void) {}
*
* @since 2.0
*
- * @param[in] percentage The changed battery level
+ * @param[in] percentage The changed battery level
* @remarks The resolution of the level is @c 5%. The range of the level is @c 0 (Minimum) to @c 100 (Maximum).
*/
virtual void OnBatteryLevelChangedInPercentage(int percentage) = 0;
/**
* @interface IBootEventListener
- * @brief This interface is the listener of the boot event.
+ * @brief This interface is the listener of the boot event.
*
* @since 2.1
*
{
public:
/**
- * This is the destructor for this class. This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This is the destructor for this class. @n
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.1
*/
/**
* @interface IChargingEventListener
- * @brief This interface is the listener of the charging event.
+ * @brief This interface is the listener for charging events.
* @since 2.0
*
* The %IChargingEventListener interface must be registered and implemented by an application to
{
public:
/**
- * This is the destructor for this class. This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This is the destructor for this class. @n
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~IChargingEventListener(void) {}
/**
* @interface IDeviceEventListener
- * @brief This interface is the listener of the device state changes.
+ * @brief This interface is the listener of the device state changes.
*
* @since 2.0
*
{
public:
/**
- * This is the destructor for this class. This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This is the destructor for this class. @n
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
*
* @since 2.0
*
- * @param[in] deviceType The types of a device
+ * @param[in] deviceType The device type
* @param[in] state The device state of type Tizen::Base::String
*/
virtual void OnDeviceStateChanged(DeviceType deviceType, const Tizen::Base::String& state) = 0;
{
/**
-* @interface IRuntimeInfoGetIntAsyncResultListener
-* @brief This interface defines the result listener for an asynchronous method call to the %RuntimeInfo class.
+* @interface IRuntimeInfoGetIntAsyncResultListener
+* @brief This interface defines the result listener for an asynchronous method call to the %RuntimeInfo class.
*
* @since 2.0
*
-* The %IRuntimeInfoGetIntAsyncResultListener interface defines the result listener for an asynchronous method call to the RuntimeInfo class. An instance of this interface is removed automatically by platform, after result is notified.
+* The %IRuntimeInfoGetIntAsyncResultListener interface defines the result listener for an asynchronous method call to the
+* RuntimeInfo class. An instance of this interface is removed automatically by the platform, after result is notified.
*
*/
class _OSP_EXPORT_ IRuntimeInfoGetIntAsyncResultListener
{
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are when the destructor of this interface is called.
*
* @since 2.0
*/
*
* @since 2.0
*
- * @param[in] value The @c int type runtime information
- * @param[in] r An error code
- * @exception E_SUCCESS The result is successful.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] value The @c int type runtime information
+ * @param[in] r An error code
+ * @exception E_SUCCESS The result is successful.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
virtual void OnResultReceivedForGetValueAsync(int value, result r) = 0;
{
/**
-* @interface IRuntimeInfoGetLonglongAsyncResultListener
-* @brief This interface defines the result listener for an asynchronous method call to the %RuntimeInfo class.
+* @interface IRuntimeInfoGetLonglongAsyncResultListener
+* @brief This interface defines the result listener for an asynchronous method call to the %RuntimeInfo class.
*
-* @since 2.0
+* @since 2.0
*
-* The %IRuntimeInfoGetLonglongAsyncResultListener interface defines the result listener for an asynchronous method call to the RuntimeInfo class. An instance of this interface is removed automatically by platform, after result is notified.
+* The %IRuntimeInfoGetLonglongAsyncResultListener interface defines the result listener for an asynchronous method call
+* to the RuntimeInfo class. An instance of this interface is removed automatically by the platform, after result is notified.
*
*/
class _OSP_EXPORT_ IRuntimeInfoGetLonglongAsyncResultListener
{
public:
/**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
*
* @since 2.0
*
- * @param[in] value The @c long @c long type runtime information
- * @param[in] r An error code
- * @exception E_SUCCESS The result is successful.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] value The @c long @c long type runtime information
+ * @param[in] r An error code
+ * @exception E_SUCCESS The result is successful.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
virtual void OnResultReceivedForGetValueAsync(long long value, result r) = 0;
/**
* @interface IScreenEventListener
- * @brief This interface is the listener of the screen event.
+ * @brief This interface is the listener of the screen event.
*
* @since 2.0
*
/**
* Called when the screen turns off. @n
- * Unless there is a strong reason to do otherwise, release resources (such as 3D, media, and sensors) to allow the device to enter the sleep mode to save the battery.
- * Invoking a lengthy asynchronous method within this listener method can be risky, because it is not guaranteed to invoke a callback before the device enters the sleep mode.
- * Similarly, do not perform lengthy operations in this listener method. All operations must be quick ones.
+ * Unless there is a strong reason to do otherwise, release the resources (such as 3D, media, and sensors) to allow the device
+ * to enter the sleep mode to save the battery. @n
+ * Invoking a lengthy asynchronous method within this listener method can be risky, because it is not guaranteed to invoke a
+ * callback before the device enters the sleep mode. Similarly, do not perform lengthy operations in this listener method. @n
+ * All operations must be quick ones.
*
*@since 2.0
*/
/**
* @interface ISettingEventListener
- * @brief This interface is the listener of the setting event.
+ * @brief This interface is the listener of the setting event.
*
* @since 2.0
*
{
public:
/**
- * This is the destructor for this class. This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This is the destructor for this class. @n
+ * This polymorphic destructor should be overridden if required. @n This way,
+ * the destructors of the derived classes are called when the destructor of this interface is called.
*
- * @since 2.0
+ * @since 2.0
*/
virtual ~ISettingEventListener(void) {}
/**
- * Called when a certain setting value has been changed.
+ * Called when a setting value has been changed.
*
* @since 2.0
*
- * @param[in] key The key name of the changed setting information
- * @remarks Invokes one of the overloaded getter methods of Tizen::System::SettingInfo to get the changed value corresponding to the given key.
+ * @param[in] key The key name of the changed setting information
+ * @remarks Invokes one of the overloaded getter methods of Tizen::System::SettingInfo to get the changed value
+ * corresponding to the given key.
*/
virtual void OnSettingChanged(Tizen::Base::String& key) = 0;
*
* @since 2.0
*
- * The %ISettingInfoSetValueAsyncResultListener interface must be registered and implemented by an application to receive result for an asynchronous setting change method call.
+ * The %ISettingInfoSetValueAsyncResultListener interface must be registered and implemented by an application
+ * to receive result for an asynchronous setting change method call.
*
*/
class _OSP_EXPORT_ ISettingInfoSetValueAsyncResultListener
{
public:
/**
- * This is the destructor for this class. This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This is the destructor for this class. @n
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
*
* @since 2.0
*
- * @param[in] key The key name of the changed setting information
- * @param[in] r An error code
- * @exception E_SUCCESS The result is successful.
- * @exception E_SYSTEM The method cannot proceed due to severe system error.
+ * @param[in] key The key name of the changed setting information
+ * @param[in] r An error code
+ * @exception E_SUCCESS The result is successful.
+ * @exception E_SYSTEM The method cannot proceed due to severe system error.
*/
virtual void OnResultReceivedForSetValueAsync(const Tizen::Base::String& key, result r) = 0;
BATTERY_LOW, // This enum value is deprecated. Instead of using this enum value, use BATTERY_LEVEL_LOW.
BATTERY_CRITICAL, // This enum value is deprecated. Instead of using this enum value, use BATTERY_LEVEL_CRITICAL.
BATTERY_EMPTY, // This enum value is deprecated. Instead of using this enum value, use BATTERY_LEVEL_EMPTY.
- BATTERY_LEVEL_FULL = BATTERY_FULL,/**< The battery is fully charged */
- BATTERY_LEVEL_HIGH = BATTERY_HIGH,/**< The battery has plenty of charge */
- BATTERY_LEVEL_LOW = BATTERY_LOW,/**< The battery has little charge */
- BATTERY_LEVEL_CRITICAL = BATTERY_CRITICAL,/**< The battery charge is at a critical state @n It is strongly recommended to stop using all multimedia features because they are not guaranteed to work correctly at this level. */
- BATTERY_LEVEL_EMPTY = BATTERY_EMPTY, /**< The battery is empty @n It is strongly recommended to prepare for the safe termination of the application because the device will start a shutdown process soon after entering this level. */
+ BATTERY_LEVEL_FULL = BATTERY_FULL, /**< The battery is fully charged */
+ BATTERY_LEVEL_HIGH = BATTERY_HIGH, /**< The battery has plenty of charge */
+ BATTERY_LEVEL_LOW = BATTERY_LOW, /**< The battery has little charge */
+ BATTERY_LEVEL_CRITICAL = BATTERY_CRITICAL, /**< The battery charge is at a critical state @n
+ It is strongly recommended to stop using all multimedia features because they are not guaranteed to work correctly at this level. */
+ BATTERY_LEVEL_EMPTY = BATTERY_EMPTY, /**< The battery is empty @n
+ It is strongly recommended to prepare for the safe termination of the application because the device will start a shutdown process soon after entering this level. */
};
/**
* @enum PowerMode
*
- * Defines the representation of the charge remaining in the battery.
+ * Defines the representation of the power mode.
*
* @since 2.0
*/
{
POWER_STANDBY, // This enum value is deprecated. Instead of using this enum value, use POWER_MODE_STANDBY.
POWER_SLEEP, // This enum value is deprecated. Instead of using this enum value, use POWER_MODE_SLEEP.
- POWER_MODE_STANDBY = POWER_STANDBY, /**< The battery is fully charged */
- POWER_MODE_SLEEP = POWER_SLEEP, /**< The battery has plenty of charge */
+ POWER_MODE_STANDBY = POWER_STANDBY, /**< The standby power mode */
+ POWER_MODE_SLEEP = POWER_SLEEP, /**< The sleep power mode */
};
/**
/**
* Changes the policy of the screen power management.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/power
*
- * @return An error code
- * @param[in] keepOn Set to @c true if the screen remains in the 'ON' state until the application goes to the background(inactivated), @n
- * else @c false if the state of the screen is controlled by the default power control policy of the system
- * @param[in] dimming Set to @c true if the screen is dimmed when there is no user input for a certain amount of time, @n
- * else @c false if the screen is not dimmed
- * @exception E_SUCCESS The method is successful.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks This screen power control is available only when an application is active. To check the events that are active, use the Tizen::Ui::Controls::IFrameEventListener::OnFrameActivated() method.
+ * @return An error code
+ * @param[in] keepOn Set to @c true for the screen to remain in the 'ON' state until the application goes to the background(inactivated), @n
+ * else @c false for the state of the screen to be controlled by the default power control policy of the system
+ * @param[in] dimming Set to @c true to dim the screen when there is no user input for a certain amount of time, @n
+ * else @c false to not dim the screen
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks The screen power control is available only when an application is active. @n
+ * To check the events that are active, use the Tizen::Ui::Controls::IFrameEventListener::OnFrameActivated() method.
*/
static result KeepScreenOnState(bool keepOn, bool dimming = true);
/**
* Restores the screen brightness control.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE The brightness is never changed.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see SetScreenBrightness()
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE The brightness is never changed.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @see SetScreenBrightness()
*/
static result RestoreScreenBrightness(void);
/**
* Sets the screen brightness level for an application.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/power
*
- * @return An error code
- * @param[in] brightness The brightness level to set between @c 1 (minimum) and @c 10 (maximum).
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] brightness The brightness level to set between @c 1 (minimum) and @c 10 (maximum).
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_OUT_OF_RANGE The specified @c brightness is out of range.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks This brightness level change is available only when an application is active. To check the events that are active, use the Tizen::Ui::Controls::IFrameEventListener::OnFrameActivated() method. Even if the brightness is set to level 1, a black screen is not displayed. Level 1 is the minimum brightness level that can be set for an application. To know more about screen off, see the TurnScreenOff() method.
- * @see RestoreScreenBrightness()
- * @see TurnScreenOff()
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @remarks The brightness level change is available only when an application is active. @n
+ * To check the events that are active, use the Tizen::Ui::Controls::IFrameEventListener::OnFrameActivated() method. @n
+ * Even if the brightness is set to level 1, a black screen is not displayed.
+ * Level 1 is the minimum brightness level that can be set for an application. @n
+ * To know more about turning the screen off, see the TurnScreenOff() method.
+ * @see RestoreScreenBrightness()
*/
static result SetScreenBrightness(int brightness);
/**
* Gets the screen brightness level of an application.
*
- * @since 2.0
+ * @since 2.0
*
- * @return The brightness level of the current application
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks This method returns the screen brightness level set for an application. If the brightness level is not set, it will return the default system brightness level. @n
- * In case of error, this method returns @c -1.
+ * @return The brightness level of the current application, @n
+ * else @c -1 in case of error
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks
+ * - This method returns the screen brightness level set for an application. If the brightness level is not set,
+ * it will return the default system brightness level.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
static int GetScreenBrightness(void);
/**
* Checks whether the screen is on.
*
- * @since 2.0
+ * @since 2.0
*
- * @return @c true if the screen is on, @n
- * else @c false
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks This method returns @c true when the screen is in the dimming state, and @c false in case of an error.
+ * @return @c true if the screen is on, @n
+ * else @c false
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks
+ * - This method returns @c true when the screen is in the dimming state, and @c false in case of an error.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
static bool IsScreenOn(void);
/**
- * Turns on the screen.
+ * Turns the screen on.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/power
*
- * @return An error code
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
*/
static result TurnScreenOn(void);
/**
- * Turns off the screen.
+ * Turns the screen off.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/power
*
- * @return An error code
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM A system error has occurred.
+ * @exception E_SYSTEM A system error has occurred.
*/
static result TurnScreenOff(void);
/**
- * Changes the policy of the CPU (Central Processing Unit) power management.
+ * Sets the policy of the CPU (Central Processing Unit) power management.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/power
*
- * @return An error code
+ * @return An error code
* @param[in] enable Set to @c true to prevent the CPU from going into sleep mode, @n
- * else @c false to let the state of the CPU follow the system default power management policy
- * @exception E_SUCCESS The method is successful.
+ * else @c false to let the state of the CPU follow the system default power management policy
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM A system error has occurred.
- * @remarks This method keeps CPU power state only. Screen state or lock screen is not managed by this method.
+ * @exception E_SYSTEM A system error has occurred.
+ * @remarks This method only manages the CPU power state. The screen state or lock screen is not managed by this method.
*/
static result KeepCpuAwake(bool enable);
/**
* Sets the screen event listener.
*
- * @brief <i>[Deprecated]</i>
+ * @brief <i>[Deprecated]</i>
* @deprecated This method is deprecated. @n
- * Instead of using this method, use AddScreenEventListener() and RemoveScreenEventListener().
- * @since 2.0
+ * Instead of using this method, use AddScreenEventListener() and RemoveScreenEventListener().
+ * @since 2.0
*
* @param[in] listener The screen event listener
- * @remarks This method always overwrites the first element of internal IScreenEventListener list.
- * The first element added by AddScreenEventListener() may be overwritten by this method,
- * which may not be an expected behavior by API users. So, it is not recommended to use this method.
+ * @remarks This method always overwrites the first element of internal IScreenEventListener list. @n
+ * The first element added by AddScreenEventListener() may be overwritten by this method,
+ * which may not be an expected behavior by API users. So, it is not recommended to use this method.
*/
static void SetScreenEventListener(IScreenEventListener& listener);
*
* @since 2.1
*
- * @param[in] listener The screen event listener
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_ALREADY_EXIST The listener has already been added.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see IScreenEventListener
+ * @param[in] listener The screen event listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_ALREADY_EXIST The listener has already been added.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @see RemoveScreenEventListener()
*/
static result AddScreenEventListener(IScreenEventListener& listener);
/**
- * Removes the screen event listener.
+ * Removes the specified screen event listener.
*
* @since 2.1
*
- * @param[in] listener The screen event listener
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified listener cannot be found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see IScreenEventListener
+ * @param[in] listener The screen event listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The specified listener cannot be found.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @see AddScreenEventListener()
*/
static result RemoveScreenEventListener(IScreenEventListener& listener);
/**
* Sets the charging event listener.
*
- * @brief <i>[Deprecated]</i>
+ * @brief <i>[Deprecated]</i>
* @deprecated This method is deprecated. @n
- * Instead of using this method, use AddChargingEventListener() and RemoveChargingEventListener().
- * @since 2.0
+ * Instead of using this method, use AddChargingEventListener() and RemoveChargingEventListener().
+ * @since 2.0
*
* @param[in] listener The charging event listener
- * @remarks This method always overwrites the first element of internal IChargingEventListener list.
- * The first element added by AddChargingEventListener() may be overwritten by this method,
- * which may not be an expected behavior by API users. So, it is not recommended to use this method.
+ * @remarks
+ * - This method always overwrites the first element of internal IChargingEventListener list.
+ * - The first element added by AddChargingEventListener() may be overwritten by this method,
+ * which may not be the expected behavior. So, it is not recommended to use this method.
*/
static void SetChargingEventListener(IChargingEventListener& listener);
/**
* Adds the charging event listener.
*
- * @since 2.1
+ * @since 2.1
*
- * @param[in] listener The charging event listener
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_ALREADY_EXIST The listener has already been added.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see IChargingEventListener
- * @see RemoveChargingEventListener()
+ * @param[in] listener The charging event listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_ALREADY_EXIST The listener has already been added.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @see RemoveChargingEventListener()
*/
static result AddChargingEventListener(IChargingEventListener& listener);
/**
* Removes the charging event listener.
*
- * @since 2.1
+ * @since 2.1
*
- * @param[in] listener The charging event listener
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified listener cannot be found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see IChargingEventListener
- * @see AddChargingEventListener()
+ * @param[in] listener The charging event listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The specified listener cannot be found.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @see AddChargingEventListener()
*/
static result RemoveChargingEventListener(IChargingEventListener& listener);
* @param[in] pListener The battery event listener
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @remarks If @c pListener is set to @c null, the pre-registered listener is unregistered.
+ * @remarks If @c pListener is set to @c null, the current listener is unregistered.
*/
static result SetBatteryEventListener(IBatteryEventListener* pListener);
*
* @since 2.0
*
- * @return The percentage of the charge remaining in the battery.
- * @exception E_SUCCESS The method is successful.
- * @exception E_UNSUPPORTED_OPERATION The method is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks The resolution of the level is @c 1 percentage. The range of the level is minimum @c 0 to maximum @c 100.
+ * @return The percentage of the charge remaining in the battery.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_UNSUPPORTED_OPERATION The method is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @remarks
+ * - The resolution of the level is @c 1 percentage. The range of the level is minimum @c 0 to maximum @c 100.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
static int GetCurrentBatteryLevelInPercentage(void);
*
* @since 2.0
*
- * @return A value from the enumerator BatteryLevel indicating the current charging level
- * @exception E_SUCCESS The method is successful.
- * @exception E_UNSUPPORTED_OPERATION The method is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @return A value from the enumerator BatteryLevel indicating the current charging level
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_UNSUPPORTED_OPERATION The method is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static BatteryLevel GetCurrentBatteryLevel(void);
/**
* Checks whether the battery is currently charging.
*
- * @since 2.0
+ * @since 2.0
*
- * @return @c true if the charging cable is connected to the phone, @n
- * else @c false
- * @exception E_SUCCESS The method is successful.
- * @exception E_UNSUPPORTED_OPERATION The method is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @return @c true if the charging cable is connected to the phone, @n
+ * else @c false
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_UNSUPPORTED_OPERATION The method is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static bool IsCharging(void);
* @since 2.1
*
* @return An error code
- * @param[in] listener The boot event listener
- * @exception E_SUCCESS The method is successful.
+ * @param[in] listener The boot event listener
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_ALREADY_EXIST The listener is already added.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result AddBootEventListener(IBootEventListener& listener);
/**
* Removes the boot event listener.
*
- * @since 2.1
+ * @since 2.1
*
* @return An error code
- * @param[in] listener The boot event listener
- * @exception E_SUCCESS The method is successful.
+ * @param[in] listener The boot event listener
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_ALREADY_EXIST The listener is not added.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result RemoveBootEventListener(IBootEventListener& listener);
*
* @final This class is not intended for extension.
*
- * The %RuntimeInfo class provides runtime information, such as the allocated memory used by the application storage, memory, and CPU utilization. To get the information, you must provide the <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">RuntimeInfo key</a>.
+ * The %RuntimeInfo class provides runtime information, such as the allocated memory used by the application storage, memory, and CPU utilization.
+ * To get the information, you must provide the <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">RuntimeInfo key</a>.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">Runtime Information</a>.
*
public:
/**
- * Gets the specific Tizen::Base::String type runtime information based on the specified
- * designators (key).
+ * Gets the Tizen::Base::String type runtime information based on the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
- * @param[out] value The runtime information of type Tizen::Base::String
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
+ * @param[out] value The runtime information of type Tizen::Base::String
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, Tizen::Base::String& value);
/**
- * Gets the specific integer type runtime information based on the specified
- * designators (key).
+ * Gets the integer type runtime information based on the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information @n
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information @n
* @if OSPCOMPAT
* The following key values are updated: @n
* - Since Tizen, refer <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">here</a>.
* - @b Deprecated All the key values provided prior to %Tizen are deprecated. For more detailed information, refer
* <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info_deprecated.htm">here</a>.
* @endif
- * @param[out] value The integer type runtime information
- * @exception E_SUCCESS The method is successful.
+ * @param[out] value The integer type runtime information
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, int& value);
/**
- * Gets the specific @c long @c long type runtime information based on the specified
- * designators (key).
+ * Gets the @c long @c long type runtime information based on the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information @n
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information @n
* @if OSPCOMPAT
* The following key values are updated: @n
* - Since Tizen, refer <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">here</a>.
* <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info_deprecated.htm">here</a>.
* @xmlonly <pcheck kind="value" since="1.0" deprecated="yes"> @endxmlonly MaxAllocatableMemory, AvailableVideoMemory @xmlonly </pcheck> @endxmlonly
* @endif
- * @param[out] value The @c long @c long type runtime information
- * @exception E_SUCCESS The method is successful.
+ * @param[out] value The @c long @c long type runtime information
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, long long& value);
/**
- * Gets the specific double type runtime information based on the specified
- * designators (key).
+ * Gets the double type runtime information based on the specified designators (key).
*
* @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
- * @param[out] value The @c double type runtime information
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
+ * @param[out] value The @c double type runtime information
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, double& value);
/**
- * Gets the specific @c bool type runtime information based on the specified
- * designators (key).
+ * Gets the @c bool type runtime information based on the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
- * @param[out] value The @c bool type runtime information
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
+ * @param[out] value The @c bool type runtime information
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, bool& value);
/**
- * Gets the specific UuId type runtime information based on the specified
- * designators (key).
+ * Gets the UuId type runtime information based on the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
- * @param[out] value The UuId type runtime information
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
+ * @param[out] value The UuId type runtime information
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, Tizen::Base::UuId& value);
/**
- * Gets the specific @c long @c long type runtime information based on specified designators (key) asynchronously.
+ * Gets the @c long @c long type runtime information based on specified designators (key) asynchronously.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
- * @param[in] listener The result listener
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
+ * @param[in] listener The result listener
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValueAsync(const Tizen::Base::String& key, IRuntimeInfoGetLonglongAsyncResultListener* listener);
/**
- * Gets the specific @c int type runtime information based on specified designators (key) asynchronously.
+ * Gets the @c int type runtime information based on specified designators (key) asynchronously.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
- * @param[in] listener The result listener
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/runtime_info.htm">key name</a> of the runtime information
+ * @param[in] listener The result listener
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValueAsync(const Tizen::Base::String& key, IRuntimeInfoGetIntAsyncResultListener* listener);
/**
* @class SettingInfo
- * @brief This class provides methods for managing setting information.
+ * @brief This class provides methods to manage the setting information.
*
* @since 2.0
*
* @final This class is not intended for extension.
*
- * The %SettingInfo class provides methods to managing the variety user setting elements. Please refer <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">SettingInfo key</a>.
+ * The %SettingInfo class provides methods to manage the user setting elements. @n
+ * To get the system information, you must provide the <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">SettingInfo key</a>.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">Settings Information</a>.
*
public:
/**
- * Gets the specific Tizen::Base::String type setting information based on the specified
- * designators (key).
+ * Gets the Tizen::Base::String type setting information for the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information @n
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information @n
* @if OSPCOMPAT
* The following key values are updated: @n
* - Since Tizen, refer <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">here</a>.
* - @b Deprecated All the key values provided prior to %Tizen 2.0 are deprecated. For more detailed information, refer
* <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info_deprecated.htm">here</a>.
* @endif
- * @param[out] value The setting information of type Tizen::Base::String
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[out] value The setting information of type Tizen::Base::String
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, Tizen::Base::String& value);
/**
- * Gets the specific integer type setting information based on the specified
- * designators (keys).
+ * Gets the specific integer type setting information for the specified designators (keys).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information @n
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information @n
* @if OSPCOMPAT
* The following key values are updated: @n
* - Since Tizen, refer <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">here</a>.
* - @b Deprecated All the key values provided prior to %Tizen 2.0 are deprecated. For more detailed information, refer
* <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info_deprecated.htm">here</a>.
* @endif
- * @param[out] value The setting information of type integer
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[out] value The setting information of type @c int
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, int& value);
/**
- * Gets the specific @c long @c long type setting information based on the specified
- * designators (key).
+ * Gets the @c long @c long type setting information for the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
* @param[out] value The setting information of type @c long @c long
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, long long& value);
/**
- * Gets the specific double type setting information based on the specified
- * designators (key).
+ * Gets the double type setting information for the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
- * @param[out] value The setting information of type double
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
+ * @param[out] value The setting information of type @c double
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, double& value);
/**
- * Gets the specific @c bool type setting information based on the specified
- * designators (key).
+ * Gets the @c bool type setting information for the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information @n
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information @n
* @if OSPCOMPAT
* The following key values are updated: @n
* - Since Tizen, refer <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">here</a>.
* - @b Deprecated All the key values provided prior to %Tizen 2.0 are deprecated. For more detailed information, refer
* <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info_deprecated.htm">here</a>.
* @endif
- * @param[out] value The setting information of type bool
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[out] value The setting information of type @c bool
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, bool& value);
/**
- * Gets the specific UuId type setting information based on the specified
- * designators (key).
+ * Gets the UuId type setting information for the specified designators (key).
*
* @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
- * @param[out] value The setting information of type UuId
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
+ * @param[out] value The setting information of type UuId
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, Tizen::Base::UuId& value);
/**
- * Checks whether specific designator(key) is supported or not.
+ * Checks whether specific designator(key) is supported.
*
- * @since 2.0
+ * @since 2.0
*
- * @return @c true if the key is supported, @n
- * else @c false
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
+ * @return @c true if the key is supported, @n
+ * else @c false
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
*
*/
static bool HasKey(const Tizen::Base::String& key);
/**
- * Sets the specific @c bool type setting information based on the specified designators (key).
+ * Sets the specified @c bool type setting information for the specified designators (key).
*
* @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/setting
*
- * @return An error code
+ * @return An error code
* @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
- * @param[in] value The setting information of type bool
- * @exception E_SUCCESS The method is successful.
- * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
- * @exception E_INVALID_ARG The specified @c value is invalid value.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] value The setting information of type @c bool
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
+ * @exception E_INVALID_ARG The specified @c value is invalid.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result SetValue(const Tizen::Base::String& key, bool value);
/**
- * Sets the specific @c int type setting information based on the specified designators (key).
+ * Sets the specified @c int type setting information for the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/setting
*
- * @return An error code
+ * @return An error code
* @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
- * @param[in] value The setting information of type int
- * @exception E_SUCCESS The method is successful.
- * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
- * @exception E_INVALID_ARG The specified @c value is invalid value.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] value The setting information of type @c int
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
+ * @exception E_INVALID_ARG The specified @c value is invalid.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result SetValue(const Tizen::Base::String& key, int value);
/**
* Sets the specific Tizen::Base::String type setting information based on the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/setting
*
- * @return An error code
+ * @return An error code
* @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
- * @param[in] value The setting information of type Tizen::Base::String
- * @exception E_SUCCESS The method is successful.
- * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
- * @exception E_INVALID_ARG The specified @c value is invalid value.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] value The setting information of type Tizen::Base::String
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
+ * @exception E_INVALID_ARG The specified @c value is invalid.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result SetValue(const Tizen::Base::String& key, Tizen::Base::String value);
* @privlevel public
* @privilege %http://tizen.org/privilege/setting
*
- * @return An error code
- * @param[in] filePath The file path of the wallpaper
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] filePath The file path of the wallpaper
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_FILE_NOT_FOUND The entry for the specified wallpaper file or the file path cannot be found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result SetWallpaper(const Tizen::Base::String& filePath);
* @privlevel public
* @privilege %http://tizen.org/privilege/setting
*
- * @return An error code
- * @param[in] filePath The file path of the ringtone
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] filePath The file path of the ringtone
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_FILE_NOT_FOUND The entry for the specified wallpaper file or the file path cannot be found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result SetRingtone(const Tizen::Base::String& filePath);
* @privlevel public
* @privilege %http://tizen.org/privilege/setting
*
- * @return An error code
+ * @return An error code
* @param[in] soundCategory The sound volume category
- * @param[in] level The sound volume level of the designated category
- * @exception E_SUCCESS The method is successful.
+ * @param[in] level The sound volume level of the designated category
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_ARG The specified @c soundCategory is invalid.
* @exception E_OUT_OF_RANGE The specified @c level is outside the bounds of @c soundCategory.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result SetVolume(const Tizen::Base::String& soundCategory, int level);
* Adds the setting event listener. @n
* This listener is called when a setting value is changed.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] listener The setting event listener
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_ALREADY_EXIST The listener is already added.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see RemoveSettingEventListener()
+ * @return An error code
+ * @param[in] listener The setting event listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_ALREADY_EXIST The listener is already added.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @see RemoveSettingEventListener()
*/
static result AddSettingEventListener(ISettingEventListener& listener);
/**
* Removes the setting event listener.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] listener The setting event listener
- * @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The listener is not added.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @see AddSettingEventListener()
+ * @return An error code
+ * @param[in] listener The setting event listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OBJ_NOT_FOUND The listener is not added.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @see AddSettingEventListener()
*/
static result RemoveSettingEventListener(ISettingEventListener& listener);
/**
- * Gets the specific @c bool type setting information based on the specified designators (key).
+ * Gets the @c bool type setting information for the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel platform
* @privilege %http://tizen.org/privilege/settingmanager.read @n
- * (%http://tizen.org/privilege/systemsetting.read is deprecated.)
- *
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
- * @param[out] value The setting information of type bool
- * @exception E_SUCCESS The method is successful.
- * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * (%http://tizen.org/privilege/systemsetting.read is deprecated.)
+ *
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
+ * @param[out] value The setting information of type @c bool
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValueForPrivilegedKey(const Tizen::Base::String& key, bool& value);
/**
- * Sets the specific @c bool type setting information based on the specified designators (key).
+ * Sets the @c bool type setting information for the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel platform
* @privilege %http://tizen.org/privilege/settingmanager.write @n
- * (%http://tizen.org/privilege/systemsetting.write is deprecated.)
- *
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
- * @param[in] value The setting information of type bool
- * @exception E_SUCCESS The method is successful.
- * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
- * @exception E_INVALID_ARG The specified @c value is invalid value.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * (%http://tizen.org/privilege/systemsetting.write is deprecated.)
+ *
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
+ * @param[in] value The setting information of type @c bool
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
+ * @exception E_INVALID_ARG The specified @c value is invalid value.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
* @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result SetValueForPrivilegedKey(const Tizen::Base::String& key, bool value);
/**
- * Sets the specific @c bool type setting information based on the specified designators (key) asynchronously.
+ * Sets the @c bool type setting information for the specified designators (key) asynchronously.
*
- * @since 2.0
+ * @since 2.0
* @privlevel platform
* @privilege %http://tizen.org/privilege/settingmanager.write @n
- * (%http://tizen.org/privilege/systemsetting.write is deprecated.)
+ * (%http://tizen.org/privilege/systemsetting.write is deprecated.)
*
- * @return An error code
+ * @return An error code
* @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
- * @param[in] value The setting information of type bool
- * @param[in] listener The result listener.
- * @exception E_SUCCESS The method is successful.
- * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
- * @exception E_INVALID_ARG The specified @c value is invalid value.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key is existed, However it is not supported by this device.
- * @exception E_IN_PROGRESS The specified key is under processing or invalid state.
- * @exception E_SYSTEM Either of the following conditions has occured:
- * - The method cannot proceed due to a severe system error.
- * - This error can occur and Wi-Fi Direct™ is not activated if the @c key is %http://tizen.org/setting/network.wifi.direct and Wi-Fi is activated.-
-Direct™ is not activated if the @c key is %http://tizen.org/setting/network.wifi.direct and Wi-Fi is activated.
-
+ * @param[in] value The setting information of type @c bool
+ * @param[in] listener The result listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
+ * @exception E_INVALID_ARG The specified @c value is invalid.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However it is not supported by this device.
+ * @exception E_IN_PROGRESS The specified key is under processing or is in an invalid state.
+ * @exception E_SYSTEM Either of the following conditions has occured:
+ * - The method cannot proceed due to a severe system error.
+ * - Wi-Fi Direct™ is not activated if the @c key is %http://tizen.org/setting/network.wifi.direct and Wi-Fi is
+ * activated.
*/
static result SetValueAsyncForPrivilegedKey(const Tizen::Base::String& key, bool value, ISettingInfoSetValueAsyncResultListener* listener);
/**
- * Sets the specific @c bool type setting information based on the specified designators (key) asynchronously.
+ * Sets the @c bool type setting information for the specified designators (key) asynchronously.
*
- * @since 2.0
+ * @since 2.0
* @privlevel platform
* @privilege %http://tizen.org/privilege/setting
*
- * @return An error code
+ * @return An error code
* @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
- * @param[in] value The setting information of type bool
- * @param[in] listener The result listener.
- * @exception E_SUCCESS The method is successful.
- * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
- * @exception E_INVALID_ARG The specified @c value is invalid value.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_UNSUPPORTED_OPERATION The specified @c key is existed, However it is not supported by this device.
- * @exception E_IN_PROGRESS The specified key is under processing or invalid state.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @param[in] value The setting information of type @c bool
+ * @param[in] listener The result listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
+ * @exception E_INVALID_ARG The specified @c value is invalid value.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However it is not supported by this device.
+ * @exception E_IN_PROGRESS The specified key is under processing or is in an invalid state.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result SetValueAsync(const Tizen::Base::String& key, bool value, ISettingInfoSetValueAsyncResultListener* listener);
*
* @privlevel platform
* @privilege %http://tizen.org/privilege/settingmanager.write @n
- * (%http://tizen.org/privilege/systemsetting.write is deprecated.)
+ * (%http://tizen.org/privilege/systemsetting.write is deprecated.)
*
- * @return An error code
+ * @return An error code
* @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/settings_info.htm">key name</a> of the setting information
- * @param[in] value The setting information of type Tizen::Base::String
- * @exception E_SUCCESS The method is successful.
- * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
- * @exception E_INVALID_ARG The specified @c value is invalid value.
- * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
+ * @param[in] value The setting information of type Tizen::Base::String
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
+ * @exception E_INVALID_ARG The specified @c value is invalid.
+ * @exception E_OBJ_NOT_FOUND The specified @c key is not found.
* @exception E_UNSUPPORTED_OPERATION The specified @c key exists. However, it is not supported by this device.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result SetValueForPrivilegedKey(const Tizen::Base::String& key, Tizen::Base::String value);
/**
- * Resets current device. @n
+ * Resets the current device to the default factory settings. @n
* All data is removed and device is initialized.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel platform
* @privilege %http://tizen.org/privilege/settingmanager.write @n
- * (%http://tizen.org/privilege/systemsetting.write is deprecated.)
+ * (%http://tizen.org/privilege/systemsetting.write is deprecated.)
*
- * @return An error code
- * @exception E_SUCCESS The method is successful.
- * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGED_DENIED The application does not have the privilege to call this method.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result ResetToFactoryDefault(void);
/**
* @if OSPCOMPAT
* @if OSPDEPREC
- * Sets the setting event listener.
+ * Sets the specified setting event listener.
*
- * @deprecated This method is provided only for backward compatibility and will be deleted in the near future. Instead of using this method, it is recommended to use AddSettingEventListener() and RemoveSettingEventListener().
- * @since 2.0
+ * @deprecated This method is provided only for backward compatibility and will be deleted in the near future. Instead of using this method, it is
+ * recommended to use AddSettingEventListener() and RemoveSettingEventListener().
+ * @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] pListener The setting event listener
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks If the value of the listener object (pListener) is @c null, the setting event listener is not called.
+ * @remarks If the value of the listener object (pListener) is @c null, the setting event listener is not called.
* @endif
* @endif
*/
*
* The %SystemInfo class provides system information, such as the API and platform versions, supported device features,
* and screen dimensions.
- * To get the information, you must provide the <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">SystemInfo key</a>.
+ * To get the system information, you must provide the <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">SystemInfo key</a>.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">System Information</a>.
*
public:
/**
- * Gets the specific Tizen::Base::String type system information based on the specified designators (key).
+ * Gets the Tizen::Base::String type system information based on the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information @n
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information @n
* @if OSPCOMPAT
* The following key values are updated: @n
* - Since Tizen, refer <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">here</a>.
* - @b Deprecated All the key values provided prior to %Tizen 2.0 are deprecated. For more detailed information, refer
* <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo_deprecated.htm">here</a>.
* @endif
- * @param[out] value The system information of type Tizen::Base::String
- * @exception E_SUCCESS The method is successful.
+ * @param[out] value The system information of type Tizen::Base::String
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, Tizen::Base::String& value);
/**
- * Gets the specific integer type system information based on the specified designators (key).
+ * Gets the integer type system information based on the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information @n
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information @n
* @if OSPCOMPAT
* The following key values are updated: @n
* - Since Tizen, refer <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">here</a>.
* - @b Deprecated All the key values provided prior to %Tizen 2.0 are deprecated. For more detailed information, refer
* <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo_deprecated.htm">here</a>.
* @endif
- * @param[out] value The integer type system information
- * @exception E_SUCCESS The method is successful.
+ * @param[out] value The integer type system information
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, int& value);
/**
- * Gets the specific double type system information based on the specified designators (key).
+ * Gets the @c double type system information based on the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information
- * @param[out] value The @c double type system information
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information
+ * @param[out] value The @c double type system information
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, double& value);
/**
- * Gets the specific UuId type system information based on the specified designators (key).
+ * Gets the UuId type system information based on the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information
- * @param[out] value The UuId type system information
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information
+ * @param[out] value The UuId type system information
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, Tizen::Base::UuId& value);
/**
- * Gets the specific system information based on the specified key and data type of the information.
+ * Gets the system information based on the specified key and data type of the information.
*
- * @since 2.0
+ * @since 2.0
*
- * @return A system information list
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information @n
+ * @return The system information list
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information @n
* @if OSPCOMPAT
* The following key values are updated @n
* - @b Deprecated All the key values provided prior to %Tizen 2.0 are deprecated. For more detailed information, refer
* <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo_deprecated.htm">here</a>.
* @endif
- * @param[in] type The data type of the information
- * @exception E_SUCCESS The method is successful.
+ * @param[in] type The data type of the information
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
*/
static Tizen::Base::Collection::IList* GetValuesN(const Tizen::Base::String& key, SystemInfoValueType type);
/**
- * Gets the specific boolean type system information based on the specified designators (key).
+ * Gets the @c bool type system information based on the specified designators (key).
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information @n
+ * @return An error code
+ * @param[in] key The <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">key name</a> of the system information @n
* @if OSPCOMPAT
* The following key values are updated: @n
* - Since Tizen, refer <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo.htm">here</a>.
* - @b Deprecated All the key values provided prior to %Tizen 2.0 are deprecated. For more detailed information, refer
* <a href="../org.tizen.native.appprogramming/html/guide/system/sysinfo_deprecated.htm">here</a>.
* @endif
- * @param[out] value The @c bool type system information
- * @exception E_SUCCESS The method is successful.
+ * @param[out] value The @c bool type system information
+ * @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The specified @c key is not found.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetValue(const Tizen::Base::String& key, bool& value);
/**
* Gets the platform version in the "[Major].[Minor].[Patch Version]" format.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/system @n
- * (%http://tizen.org/privilege/platforminfo is deprecated.)
+ * (%http://tizen.org/privilege/platforminfo is deprecated.)
*
- * @return An error code
+ * @return An error code
* @param[out] platformVersion The platform version
- * @exception E_SUCCESS The method is successful.
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetPlatformVersion(Tizen::Base::String& platformVersion);
/**
- * Gets the Native API version in the "[Major].[Minor]" format.
+ * Gets the native API version in the "[Major].[Minor]" format.
*
* @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/system @n
- * (%http://tizen.org/privilege/platforminfo is deprecated.)
+ * (%http://tizen.org/privilege/platforminfo is deprecated.)
*
- * @return An error code
- * @param[out] nativeApiVersion The Native API version
- * @exception E_SUCCESS The method is successful.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @return An error code
+ * @param[out] nativeApiVersion The native API version
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetNativeApiVersion(Tizen::Base::String& nativeApiVersion);
/**
* Gets the WEB API version in the "[Major].[Minor]" format.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel public
* @privilege %http://tizen.org/privilege/system @n
- * (%http://tizen.org/privilege/platforminfo is deprecated.)
+ * (%http://tizen.org/privilege/platforminfo is deprecated.)
*
- * @return An error code
+ * @return An error code
* @param[out] webApiVersion The %Tizen API version
- * @exception E_SUCCESS The method is successful.
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetWebApiVersion(Tizen::Base::String& webApiVersion);
/**
* Gets the platform build information.
*
- * @since 2.1
+ * @since 2.1
*
* @privlevel public
* @privilege %http://tizen.org/privilege/system @n
- * (%http://tizen.org/privilege/platforminfo is deprecated.)
+ * (%http://tizen.org/privilege/platforminfo is deprecated.)
*
- * @return An error code
- * @param[out] buildInfo The %Tizen build information
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[out] buildInfo The %Tizen build information
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetBuildInfo(Tizen::Base::String& buildInfo);
/**
* Gets the International Mobile Equipment Identity (IMEI) of the device.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel partner
* @privilege %http://tizen.org/privilege/systemmanager @n
- * (%http://tizen.org/privilege/useridentity is deprecated.)
+ * (%http://tizen.org/privilege/useridentity is deprecated.)
*
- * @return An error code
- * @param[out] imei The IMEI of the device
- * @exception E_SUCCESS The method is successful.
+ * @return An error code
+ * @param[out] imei The IMEI of the device
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result GetImei(Tizen::Base::String& imei);
UTC_TIME, // This enum value is deprecated. Instead of using this enum value, use UTC_TIME.
STANDARD_TIME, // This enum value is deprecated. Instead of using this enum value, use STANDARD_TIME.
WALL_TIME, // This enum value is deprecated. Instead of using this enum value, use TIME_MODE_WALL.
- TIME_MODE_UTC = UTC_TIME, /**< The UTC Time */
- TIME_MODE_STANDARD = STANDARD_TIME, /**< The Standard Time */
- TIME_MODE_WALL = WALL_TIME, /**< The Wall Time */
+ TIME_MODE_UTC = UTC_TIME, /**< The UTC Time */
+ TIME_MODE_STANDARD = STANDARD_TIME, /**< The Standard Time */
+ TIME_MODE_WALL = WALL_TIME, /**< The Wall Time */
};
class _OSP_EXPORT_ SystemTime
* @since 2.0
*
* @return An error code
- * @param[in] timeMode The time mode @c TIME_MODE_UTC, @c TIME_MODE_STANDARD, or @c TIME_MODE_WALL
+ * @param[in] timeMode The time mode which can be @c TIME_MODE_UTC, @c TIME_MODE_STANDARD, or @c TIME_MODE_WALL
* @param[out] currentTime The current system time
* @exception E_SUCCESS The method is successful.
*/
*
* @privlevel platform
* @privilege %http://tizen.org/privilege/settingmanager.write @n
- * (%http://tizen.org/privilege/systemsetting.write is deprecated.)
+ * (%http://tizen.org/privilege/systemsetting.write is deprecated.)
*
* @return An error code
- * @param[in] currentTime The current system time in UTC
- * @exception E_SUCCESS The method is successful.
+ * @param[in] currentTime The current system time in UTC
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
*/
static result SetCurrentTime(const Tizen::Base::DateTime& currentTime);
private:
*
* @since 2.0
*
- * The %Vibrator class handles the vibration functionality of a device. It allows you to manage the device's vibrator parameters, such as vibration count and level.
+ * The %Vibrator class handles the vibration functionality of a device. It allows the management of the device's vibrator parameters, such as the vibration count and level.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/system/vibrator_mgmt.htm">Vibrator Management</a>.
*
/**
* @struct IntensityDurationVibrationPattern
- * @brief This struct has the specified duration and a vibration intensity level.
+ * @brief This struct represents the specified duration and vibration intensity level.
*
- * The %IntensityDurationVibrationPattern struct has the specified duration and a vibration intensity level. This can be used with Vibrator::Start(IntensityDurationVibrationPattern[] patterns, int length, int repeatCount) as a custom pattern.
+ * The %IntensityDurationVibrationPattern struct represents the specified duration and vibration intensity level. This struct can be used with Vibrator::Start(IntensityDurationVibrationPattern[] patterns, int length, int repeatCount) as a custom pattern.
*
* @since 2.1
*/
struct _OSP_EXPORT_ IntensityDurationVibrationPattern
{
- int duration; /**< The duration in milliseconds when the vibrator is on @n
- * The @c duration is not allowed a negative value.
- */
+ int duration; /**< The duration in milliseconds when the vibrator is on @n
+ * The @c duration does not allow a negative value.
+ */
int intensity; /**< The vibration intensity [@c -1~ @c 100]: @n
- * @li The system default vibration intensity (-1)
- * @li The silent vibration intensity (0)
- * @li The minimum vibration intensity (1)
- * @li The maximum vibration intensity (100)
- */
+ * @li The system default vibration intensity (-1)
+ * @li The silent vibration intensity (0)
+ * @li The minimum vibration intensity (1)
+ * @li The maximum vibration intensity (100)
+ */
};
public:
/**
- * This is the default constructor for this class.
- *
+ * This is the default constructor for this class. @n
+ * The object is not fully constructed after this constructor is called.
+ * For full construction, the Construct() method must be called right after calling this constructor.
* @since 2.0
*
- * @remarks The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
*/
Vibrator(void);
/**
- * Vibrates the device with a specified array pattern that has vibration intensity and duration. @n
+ * Vibrates the device with a specified array pattern that has a vibration intensity and duration. @n
* The %Start() method returns the result immediately so that the vibration occurs simultaneously as the device runs. @n
- * If this method is called again before the previous vibration stops, the previous vibration is canceled and the new vibration starts immediately. @n
+ * If this method is called again before the previous vibration stops, the previous vibration is cancelled and the new vibration starts immediately. @n
* If a new vibrator instance triggers the vibration, the vibrator merges the previous vibration pattern with the new one in the overlapped time. @n
- * If the system alert occurs such as ring vibration and a system event notification, the vibration can be interrupted. @n
- * If the application is terminated, the vibration is canceled.
+ * If a system alert occurs such as a ring vibration or a system event notification, the vibration can be interrupted. @n
+ * If the application is terminated, the vibration is cancelled.
*
* @since 2.1
- * @privlevel public
+ * @privlevel public
* @privilege %http://tizen.org/privilege/vibrator
*
* @return An error code
*
- * @param[in] patterns An array of @c IntensityDurationVibrationPattern
- * @param[in] length The length of @c patterns
- * @param[in] repeatCount The number of times the pattern repeats @n This value must be between @c 1 to @c 100.
- * @exception E_SUCCESS The method is successful.
+ * @param[in] patterns The array of @c IntensityDurationVibrationPattern
+ * @param[in] length The length of @c patterns
+ * @param[in] repeatCount The number of times the pattern repeats @n
+ * This value must be between @c 1 to @c 100.
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_OPERATION_FAILED The device operation has failed.
- * @remarks The vibration intensity does not apply the change, even if the system default vibration intensity is changed after starting vibration.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @exception E_OPERATION_FAILED The device operation has failed.
+ * @remarks The vibration intensity does not apply the change, even if the system default vibration intensity is changed after starting the vibration.
* @see IntensityDurationVibrationPattern
*/
result Start(IntensityDurationVibrationPattern* patterns, int length, int repeatCount = 1);
/**
* Vibrates the device with the specified pattern and level. @n
* The %Start() method returns the result immediately so that the vibration occurs simultaneously as the device runs.
- * If this method is called again before the previous vibration stops, the previous vibration is canceled and the new vibration starts immediately.
+ * If this method is called again before the previous vibration stops, the previous vibration is cancelled and the new vibration starts immediately.
*
- * @brief <i>[Deprecated]</i>
- * @deprecated This method is deprecated. Instead of using this method, use Start(IntensityDurationVibrationPattern*, int, int).
+ * @brief <i>[Deprecated]</i>
+ * @deprecated This method is deprecated. Instead of using this method, use Start(IntensityDurationVibrationPattern*, int, int).
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/vibrator
*
* @return An error code
- * @param[in] onPeriod The period in milliseconds when the vibrator is on @n
- * It should be greater than @c 0.
- * @param[in] offPeriod The period in milliseconds when the vibrator is off @n
- * It should be equal to or greater than @c 0.
- * @param[in] count The number of times to execute the given pattern @n
- * It should be greater than @c 0.
- * @param[in] level The vibration level @n
- * Ranges from [@c 0~ @c 100], where '@c 0' is a special case indicating the system default level.
+ * @param[in] onPeriod The period in milliseconds when the vibrator is on @n
+ * It should be greater than @c 0.
+ * @param[in] offPeriod The period in milliseconds when the vibrator is off @n
+ * It should be equal to or greater than @c 0.
+ * @param[in] count The number of times to execute the given pattern @n
+ * It should be greater than @c 0.
+ * @param[in] level The vibration level @n
+ * It ranges from [@c 0~ @c 100], where '@c 0' is a special case indicating the system default level.
* @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_DEVICE_BUSY The device cannot be approached because of other operations.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @remarks Various devices may have different vibration capabilities.
- * If the device supports only one level of vibration, then a level value between [@c 0~ @c 100] results in the default vibration.
- * If the device supports many levels of vibration, then a level value @c 0 results in the system default vibration, value @c 1 results in the lowest frequency vibration, value @c 100 results in the highest frequency vibration, and intermediate values result in intermediate vibration levels. @n
- * Devices have implementation-specific limits for the total duration of the vibration, and vibration cuts off at that limit even if the duration parameter is greater than the limit.
+ * @remarks Various devices may have different vibration capabilities. @n
+ * If the device supports only one level of vibration, then a level value between [@c 0~ @c 100] results in the default vibration. @n
+ * If the device supports many levels of vibration, then a level value @c 0 results in the system default vibration,
+ * value @c 1 results in the lowest frequency vibration, value @c 100 results in the highest frequency vibration, and intermediate values result in
+ * intermediate vibration levels. @n
+ * Devices have implementation-specific limits for the total duration of the vibration, and vibration cuts off at that limit even if the duration parameter is
+ * greater than the limit.
*
*/
result Start(long onPeriod, long offPeriod, int count, int level = 0);
/**
- * Vibrates the device for the specified duration at the specified @c level. @n
+ * Vibrates the device for the specified duration at the specified level. @n
* The %Start() method returns the result immediately so that the vibration occurs simultaneously as the device runs.
- * If this method is called again before the previous vibration stops, the previous vibration is canceled and the new vibration starts immediately.
+ * If this method is called again before the previous vibration stops, the previous vibration is cancelled and the new vibration starts immediately.
*
- * @brief <i>[Deprecated]</i>
- * @deprecated This method is deprecated. Instead of using this method, use Start(IntensityDurationVibrationPattern*, int, int).
+ * @brief <i>[Deprecated]</i>
+ * @deprecated This method is deprecated. Instead of using this method, use Start(IntensityDurationVibrationPattern*, int, int).
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/vibrator
*
* @return An error code
- * @param[in] milliseconds The duration for the vibration in milliseconds @n
- * It should be greater than @c 0.
- * @param[in] level The vibration level @n
- * Ranges from [@c 0~ @c 100], where ' @c 0' is a special case indicating the system default level.
- * @exception E_SUCCESS The method is successful.
+ * @param[in] milliseconds The duration for the vibration in milliseconds @n
+ * It should be greater than @c 0.
+ * @param[in] level The vibration level @n
+ * It ranges from [@c 0~ @c 100], where ' @c 0' is a special case indicating the system default level.
+ * @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_DEVICE_BUSY The device cannot be approached because of other operations.
* @exception E_DEVICE_FAILED The device operation has failed.
* @remarks Various devices have different vibration capabilities. @n
- * If the device supports only one level of vibration, then a level value between [@c 0~ @c 100] results in the default vibration.
- * If the device supports many levels of vibration, then a level value @c 0 results in the system default vibration, value @c 1 results in the lowest frequency vibration, value @c 100 results in the highest frequency vibration, and intermediate values result in intermediate vibration levels. @n
- * Devices have implementation-specific limits for the total duration of the vibration, and vibration cuts off at that limit even if the duration parameter is greater than the limit.
+ * If the device supports only one level of vibration, then a level value between [@c 0~ @c 100] results in the default vibration. @n
+ * If the device supports many levels of vibration, then a level value @c 0 results in the system default vibration, value @c 1 results in the lowest
+ * frequency vibration, value @c 100 results in the highest frequency vibration, and intermediate values result in intermediate vibration levels. @n
+ * Devices have implementation-specific limits for the total duration of the vibration, and vibration cuts off at that limit even if the duration parameter is
+ * greater than the limit.
*
*/
result Start(long milliseconds, int level = 0);
/**
* Turns the vibrator off.
*
- * @since 2.0
+ * @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/vibrator
*
{
/**
* @namespace Tizen::System
- * @brief This namespace contains classes and interfaces for %System.
- * @since 2.0
+ * @brief This namespace contains classes and interfaces for %System.
+ * @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FSystem.h> @n
- * @b Library : @b osp-appfw
+ * @b Library: @b osp-appfw
*
* The %System namespace provides system management features, such as system time, alarm, vibrator, power, and device management.
* It also provides the system, setting, and runtime information.
/**
* @namespace Tizen::Text
- * @brief This namespace contains classes that encode and decode characters.
+ * @brief This namespace contains classes that encode and decode characters.
*
* @since 2.0
*
* @remarks @b Header @b %file: @b \#include @b <FText.h> @n
- * @b Library: @b osp-appfw
+ * @b Library: @b osp-appfw
*
- * The %Text namespace contains the Encoding class, which is the base class for encoding and decoding many character encodings, such as UTF-8, UCS-2, Latin-1, GSM, and ASCII. It also contains the Decoder and Encoder classes for converting text blocks. The main purpose of this namespace is to support inter-
+ *
+ * The %Text namespace contains the Encoding class, which is the base class for encoding and decoding different character encodings, such as UTF-8, UCS-2, Latin-1, GSM, and ASCII.
+ * It also contains the Decoder and Encoder classes for converting text blocks. The main purpose of this namespace is to support inter-
* operability between the various existing languages and scripts.
* %Text is a data consisting of a sequence of characters.
- * It is also defined as a series of characters that can be displayed on a
- * display terminal or printed on paper for human reading.
+ * It is also defined as a series of characters that can be displayed on a display terminal or printed on a paper for human reading.
*
* For more information on the %Text namespace features, see <a href="../org.tizen.native.appprogramming/html/guide/text/text.htm">Text Guide</a>.
*
* @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c chars is empty or invalid.
* @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
- * @param[in] str A string to encode
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
+ * @param[in] str The string to encode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c str is empty or invalid.
* @since 2.0
*
* @return An error code
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
- * @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
- * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
+ * @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
+ * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetChars()
*/
* @since 2.0
*
* @return An error code
- * @param[in] str A string to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
- * @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
- * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c str or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c bytes does not contain sufficient space to store the encoded characters.
- * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
+ * @param[in] str The string to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
+ * @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
+ * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c str or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetString()
*/
virtual result GetBytes(const Tizen::Base::String& str, int charIndex, int charCount,
* @since 2.0
*
* @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last decoded byte plus one and the starting position is zero.
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last decoded byte plus one and the starting position is zero.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c bytes is empty or invalid.
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
- * @param[in] byteCount The total number of bytes to decode
- * @param[out] chars The Tizen::Base::WcharBuffer instance where the resultant decoded string is stored
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes or @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c chars does not contain sufficient space to store the decoded bytes.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] byteIndex The index from where the decoding begins
+ * @param[in] byteCount The total number of bytes to decode
+ * @param[out] chars The Tizen::Base::WcharBuffer instance where the resultant decoded string is stored
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes or @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c chars does not contain sufficient space to store the decoded bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytes()
*/
virtual result GetChars(const Tizen::Base::ByteBuffer& bytes, int byteIndex, int byteCount, Tizen::Base::WcharBuffer& chars, int charIndex = 0) const;
/**
- * Gets a string containing the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * Gets a string that contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[out] str A Tizen::Base::String instance @n
- * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[out] str A Tizen::Base::String instance @n
+ * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks This method assumes that the Tizen::Base::ByteBuffer instance contains all the bytes necessary to generate the entire string.
- * If the bytes are in multiple byte arrays, use the Decoder class, which maintains state consistency
- * between multiple calls.
+ * @remarks
+ * - This method assumes that the Tizen::Base::ByteBuffer instance contains all the bytes necessary to generate the entire string.
+ * - If the bytes are in the multiple byte arrays, use the Decoder class, which maintains state consistency
+ * between multiple calls.
* @see GetBytesN()
*/
virtual result GetString(const Tizen::Base::ByteBuffer& bytes, Tizen::Base::String& str) const;
/**
- * Gets a string containing the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * Gets a string that contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] index The index from where decoding begins
- * @param[in] count The total number of bytes to decode
- * @param[out] str A Tizen::Base::String instance @n
- * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] index The index from where the decoding begins
+ * @param[in] count The total number of bytes to decode
+ * @param[out] str A Tizen::Base::String instance @n
+ * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks This method assumes that the Tizen::Base::ByteBuffer instance contains all the bytes necessary to generate the entire string.
- * If the bytes are in multiple byte arrays, use the Decoder class, which maintains state consistency
- * between multiple calls.
+ * @remarks
+ * - This method assumes that the Tizen::Base::ByteBuffer instance contains all the bytes necessary to generate the entire string.
+ * - If the bytes are in multiple byte arrays, use the Decoder class, which maintains state consistency
+ * between multiple calls.
* @see GetBytes()
*/
virtual result GetString(const Tizen::Base::ByteBuffer& bytes, int index, int count, Tizen::Base::String& str) const;
/**
- * Gets the maximum number of bytes required for encoding a given number of characters.
+ * Gets the maximum number of bytes required for encoding the given number of characters.
*
* @since 2.0
*
- * @return The maximum number of bytes required for encoding a given number of characters
- * @param[in] charCount The total number of characters to encode
- * @remarks This method determines an appropriate buffer size for the byte arrays passed to GetBytes() for encoding.
- * @see Encoding::GetByteCount()
- * @see GetBytes()
+ * @return The maximum number of bytes required for encoding the given number of characters
+ * @param[in] charCount The total number of characters to encode
+ * @remarks This method determines an appropriate buffer size for the byte arrays passed to GetBytes() for encoding.
+ * @see Encoding::GetByteCount()
*/
virtual int GetMaxByteCount(int charCount) const;
* @since 2.0
*
* @return The maximum number of characters that are generated by decoding the specified number of bytes
- * @param[in] byteCount The total number of bytes to encode
- * @remarks This method determines an appropriate buffer size for character arrays passed to
- * GetChars() or a decoder for encoding.
- * @see Encoding::GetCharCount()
- * @see GetChars()
+ * @param[in] byteCount The total number of bytes to encode
+ * @remarks This method determines an appropriate buffer size for character arrays passed to
+ * GetChars() or a decoder for encoding.
+ * @see Encoding::GetCharCount()
*/
virtual int GetMaxCharCount(int byteCount) const;
*
* @since 2.0
*
- * @return A pointer to the Encoder instance for the current encoding
- * @remarks Contrary to GetBytes(), an encoder can convert partial sequences of characters into
- * partial sequences of bytes by maintaining the appropriate state between the conversions. @n
- * At present, only the Utf8Encoding class supports this method. Other classes return @c null.
- * @see GetBytes()
+ * @return A pointer to the Encoder instance for the current encoding
+ * @remarks
+ * - Contrary to GetBytes(), an encoder can convert partial sequences of characters into
+ * partial sequences of bytes by maintaining the appropriate state between the conversions.
+ * - At present, only the Utf8Encoding class supports this method. Other classes return @c null.
*/
virtual Encoder* GetEncoderN(void) const;
*
* @since 2.0
*
- * @return A pointer to the Decoder instance for the current encoding
- * @remarks Contrary to GetChars(), a decoder can convert partial sequences of bytes
- * into partial sequences of characters by maintaining the appropriate state between the conversions. @n
- * At present, only the Utf8Encoding class supports this method. Other classes return @c null.
- *
- * @see GetChars()
+ * @return A pointer to the Decoder instance for the current encoding
+ * @remarks
+ * - Contrary to GetChars(), a decoder can convert partial sequences of bytes
+ * into partial sequences of characters by maintaining the appropriate state between the conversions.
+ * - At present, only the Utf8Encoding class supports this method. Other classes return @c null.
*/
virtual Decoder* GetDecoderN(void) const;
*
* @since 2.0
*
- * @return An encoding type
+ * @return The encoding type
*/
virtual Tizen::Base::String GetEncodingType(void) const;
*
* The %Decoder class converts blocks of encoded bytes into blocks of Unicode characters
* through successive calls to the GetCharsN() method. This class maintains state consistency information between
- * successive calls to %GetCharsN(), enabling it to decode a sequence of bytes that span adjacent blocks.
+ * successive calls to %GetCharsN() and enables it to decode a sequence of bytes that span adjacent blocks.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/text/converting_text_data_separate_blocks.htm">Converting Text Data in Separate Blocks</a>.
*
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
- * @param[in] byteCount The total number of bytes to decode
- * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
- * else @c false
- * @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] byteIndex The index from where the decoding begins
+ * @param[in] byteCount The total number of bytes to decode
+ * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
+ * else @c false
+ * @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see Encoder::GetByteCount()
*/
virtual result GetCharCount(const Tizen::Base::ByteBuffer& bytes,
* @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
* else @c null if an exception occurs @n
* The buffer limit is the position of the last decoded byte plus one in the buffer and the starting position is zero.
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
- * else @c false
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
+ * else @c false
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Encoder::GetBytesN()
* @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
* else @c null if an exception occurs @n
* The buffer limit is the position of the last decoded byte in the buffer and the starting position is zero.
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
- * @param[in] byteCount The total number of bytes to decode
- * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
- * else @c false
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] byteIndex The index from where the decoding begins
+ * @param[in] byteCount The total number of bytes to decode
+ * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
+ * else @c false
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks This method maintains state consistency between conversions.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks The pointer to the Tizen::Base::WcharBuffer instance is not terminated by a @c null character.
+ * @remarks
+ * - This method maintains state consistency between conversions.
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - The pointer to the Tizen::Base::WcharBuffer instance is not terminated by a @c null character.
* @see Encoder::GetBytesN()
*/
virtual Tizen::Base::WcharBuffer* GetCharsN(const Tizen::Base::ByteBuffer& bytes, int byteIndex, int byteCount,
*
* The %Encoder class converts blocks of characters to blocks of encoded bytes
* through successive calls to the GetBytesN() method. This class maintains the state consistency information between
- * successive calls to %GetBytesN(), enabling it to encode a character into a sequence of bytes,
+ * successive calls to %GetBytesN() and enables it to encode a character into a sequence of bytes,
* such as surrogate pairs, that span adjacent blocks.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/text/converting_text_data_separate_blocks.htm">Converting Text Data in Separate Blocks</a>.
* @since 2.0
*
* @return An error code
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
- * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
- * else @c false
- * @param[out] byteCount The total number of bytes required to encode the specified range of characters
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
+ * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
+ * else @c false
+ * @param[out] byteCount The total number of bytes required to encode the specified range of characters
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see Decoder::GetCharCount()
*/
* @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte plus one in the buffer and the starting position is zero.
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
- * else @c false
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars is empty.
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte plus one in the buffer and the starting position is zero.
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
+ * else @c false
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Decoder::GetCharsN()
* @since 2.0
*
* @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte in the buffer and the starting position is zero.
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
- * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
- * else @c false
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte in the buffer and the starting position is zero.
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
+ * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
+ * else @c false
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks The pointer to the Tizen::Base::ByteBuffer instance is not terminated by a @c null character.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - The pointer to the Tizen::Base::ByteBuffer instance is not terminated by a @c null character.
* @see Decoder::GetCharsN()
*/
virtual Tizen::Base::ByteBuffer* GetBytesN(const Tizen::Base::WcharBuffer& chars, int charIndex, int charCount,
* @param[in] str The string to encode
* @param[out] byteCount The total number of bytes that are required to encode the specified string
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c str is an empty string.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c str is an empty string.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the total number of bytes
* that are generated when the specified string is encoded.
* @since 2.0
*
* @return An error code
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[out] byteCount The total number of bytes required to encode the specified range of characters
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c chars is empty.
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[out] byteCount The total number of bytes required to encode the specified range of characters
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the total number of bytes
* that are generated when the specified array of characters are encoded.
*
* @return An error code
* @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
* @param[out] byteCount The total number of bytes that are required to encode the specified range of characters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the total number of bytes
* that are generated when the specified array of characters are encoded.
* @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
* else @c null if an exception occurs @n
* The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c chars is invalid or empty.
* @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
* else @c null if an exception occurs @n
* The buffer limit is the position of the last encoded byte plus one and the position is zero.
- * @param[in] str The string to encode
+ * @param[in] str The string to encode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c str is invalid or is an empty string.
* @since 2.0
*
* @return An error code
- * @param[in] chars The buffer containing the character array to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] chars The buffer that contains the character array to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
* @param[in] charCount The total number of characters to encode
* @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
* @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c chars or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or the specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input paramter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method encodes a range of characters in Tizen::Base::WcharBuffer into a range of bytes in Tizen::Base::ByteBuffer.
* @see GetChars()
* @since 2.0
*
* @return An error code
- * @param[in] str The string to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
- * @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
- * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
+ * @param[in] str The string to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
+ * @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
+ * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c str or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or the specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c str or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetString()
*/
* @param[out] charCount The total number of characters that are generated by decoding a range of bytes in the specified Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c bytes is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the total number of characters
* that are generated when the specified range of bytes are encoded.
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
+ * @param[in] byteIndex The index from where the decoding begins
* @param[in] byteCount The total number of bytes to decode
* @param[out] charCount The total number of characters that are generated by decoding a range of bytes in the specified Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the total number of characters
* that are generated when the specified range of bytes are encoded.
* @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
* else @c null if an exception occurs @n
* The buffer limit is the position of the last decoded byte plus one and the starting position is zero.
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c bytes is invalid or empty.
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
- * @param[in] byteCount The total number of bytes to decode
- * @param[out] chars The Tizen::Base::WcharBuffer instance where the resultant decoded data is stored
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] byteIndex The index from where the decoding begins
+ * @param[in] byteCount The total number of bytes to decode
+ * @param[out] chars The Tizen::Base::WcharBuffer instance where the resultant decoded data is stored
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or the specified @c chars does not contain sufficient space to store the decoded bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c chars does not contain sufficient space to store the decoded bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytes()
*/
* It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c bytes is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
*
* @see GetBytesN()
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] index The index from where decoding begins
+ * @param[in] index The index from where the decoding begins
* @param[in] count The total number of bytes to decode
- * @param[out] str A Tizen::Base::String instance @n
- * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * @param[out] str A Tizen::Base::String instance @n
+ * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytes()
* @see GetString()
* @param[in] charCount The total number of characters to encode
* @remarks This method determines an appropriate buffer size for the byte arrays passed to GetBytes() for encoding.
* @see GetByteCount()
- * @see GetBytes()
*/
virtual int GetMaxByteCount(int charCount) const = 0;
* @remarks This method determines an appropriate buffer size for character arrays passed to
* GetChars() or a decoder for encoding.
* @see GetCharCount()
- * @see GetChars()
*/
virtual int GetMaxCharCount(int byteCount) const = 0;
* @since 2.0
*
* @return A pointer to the Encoder instance for the current encoding
- * @remarks Contrary to GetBytes(), an encoder can convert partial sequences of characters into
- * partial sequences of bytes by maintaining an appropriate state between the conversions.
- * Currently, only UTF-8 encoding supports this method. The other classes return a value of @c null.
- * @see GetBytes()
+ * @remarks
+ * - Contrary to GetBytes(), an encoder can convert partial sequences of characters into
+ * partial sequences of bytes by maintaining an appropriate state between the conversions.
+ * - Currently, only UTF-8 encoding supports this method. The other classes return a @c null value.
*/
virtual Encoder* GetEncoderN(void) const = 0;
* @since 2.0
*
* @return A pointer to the Decoder instance for the current encoding
- * @remarks Contrary to GetChars(), a decoder can convert partial sequences of bytes
- * into partial sequences of characters by maintaining an appropriate state between the conversions.
- * Currently, only UTF-8 encoding supports this method. The other classes return a value of @c null.
- * @see GetChars()
+ * @remarks
+ * - Contrary to GetChars(), a decoder can convert partial sequences of bytes
+ * into partial sequences of characters by maintaining an appropriate state between the conversions.
+ * - Currently, only UTF-8 encoding supports this method. The other classes return a @c null value.
*/
virtual Decoder* GetDecoderN(void) const = 0;
*
* @since 2.0
*
- * @return An encoding type
+ * @return The encoding type
*/
virtual Tizen::Base::String GetEncodingType(void) const = 0;
/**
- * Gets an encoding for the UTF-8 format.
+ * Gets the encoding for the UTF-8 format.
*
* @since 2.0
*
- * @return An encoding for the UTF-8 format
+ * @return The encoding for the UTF-8 format
*
- * @see Tizen::Text::Utf8Encoding
*/
static Utf8Encoding& GetUtf8Encoding(void);
/**
- * Gets an encoding for the UCS-2 format.
+ * Gets the encoding for the UCS-2 format.
*
* @since 2.0
*
- * @return An encoding for the UCS-2 format
+ * @return The encoding for the UCS-2 format
-*
- * @see Tizen::Text::Ucs2Encoding
*/
static Ucs2Encoding& GetUcs2Encoding(void);
/**
- * Gets an encoding for the GSM format.
+ * Gets the encoding for the GSM format.
*
* @since 2.0
*
- * @return An encoding for the GSM format
+ * @return The encoding for the GSM format
*
- * @see Tizen::Text::GsmEncoding
*/
static GsmEncoding& GetGsmEncoding(void);
/**
- * Gets an encoding for the Latin1 format.
+ * Gets the encoding for the Latin1 format.
*
* @since 2.0
*
- * @return An encoding for the Latin1 format
+ * @return The encoding for the Latin1 format
*
- * @see Tizen::Text::Latin1Encoding
*/
static Latin1Encoding& GetLatin1Encoding(void);
/**
- * Gets an encoding for the ASCII format.
+ * Gets the encoding for the ASCII format.
*
* @since 2.0
*
- * @return An encoding for the ASCII format
+ * @return The encoding for the ASCII format
*
- * @see Tizen::Text::AsciiEncoding
*/
static AsciiEncoding& GetAsciiEncoding(void);
*
* @since 2.0
*
- * @return An instance of %Encoding, @n
- * else @c null if the method fails
- * @param[in] encodingType An encoding type
+ * @return An instance of %Encoding, @n
+ * else @c null if it fails
+ * @param[in] encodingType The encoding type
* @exception E_SUCCESS The method is successful.
* @exception E_UNSUPPORTED_TYPE The specified encoding type is not supported.
- * @remarks The specific error code can be accessed using the GetLastResult() method. @n
- * The supported encoding types are ASCII, GSM, UCS-2, UCS-2LE, UCS-2BE, UCS-4, UCS-4LE, UCS-4BE, UTF-8, UTF-16, UTF-16LE, UTF-16BE, @n
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - The supported encoding types are ASCII, GSM, UCS-2, UCS-2LE, UCS-2BE, UCS-4, UCS-4LE, UCS-4BE, UTF-8, UTF-16, UTF-16LE, UTF-16BE, @n
* UTF-32, UTF-32LE, UTF-32BE, ISO-8859-1~16 (except ISO-8859-12), Windows-874, Windows-1250 ~ Windows-1258, @n
* KSC5601, BIG5, GB2312, Shift-JIS and ISO-2022-JP. @n
- * For more information on the supported encoding types, see <a href="../org.tizen.native.appprogramming/html/guide/text/text.htm">Encoding standards in %Tizen</a>.
+ * For more information on the supported encoding types, see
+ * <a href="../org.tizen.native.appprogramming/html/guide/text/text.htm">Encoding standards in %Tizen</a>.
* @see Tizen::Text::Encoding::GetAvailableEncodingsN()
*/
static Encoding* GetEncodingN(const Tizen::Base::String& encodingType);
*
* @since 2.0
*
- * @return An encoding type
+ * @return The encoding type
* @param[in] encoding An instance of %Encoding
*/
static Tizen::Base::String GetEncodingType(const Encoding& encoding);
*
* @since 2.0
*
- * @return A list of Tizen::Base::String instances (ASCII, UTF-8, ISO-8859-1, ISO-8859-2, Windows-1254, and so on), @n
- * else @c null if the method fails
+ * @return The list of Tizen::Base::String instances (ASCII, UTF-8, ISO-8859-1, ISO-8859-2, Windows-1254, and so on), @n
+ * else @c null if it fails
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*
* @since 2.0
*
- * @return A new buffer for storing the result of the conversion, @n
+ * @return The new buffer for storing the result of the conversion, @n
* else @c null if an exception occurs @n
- * The buffer limit is the position of the last converted byte plus one and the starting position is zero.
+ * The buffer limit is the position of the last converted byte plus one and the starting position is zero.
* @param[in] src The source of the encoding
* @param[in] dst The destination of the encoding
* @param[in] srcBytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c srcBytes is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c srcBytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see GetBytes()
*
* @return A new buffer for storing result of the conversion, @n
* else @c null if an exception occurs @n
- * The buffer limit is the position of the last converted byte plus one and the starting position is zero.
+ * The buffer limit is the position of the last converted byte plus one and the starting position is zero.
* @param[in] src The source of the encoding
* @param[in] dst The destination of the encoding
* @param[in] srcBytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
* @param[in] count The total number of bytes to convert
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c srcBytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the specified @c index or @c count is greater than the length of the specified @c srcBytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c index and @c count is greater than the length of the specified @c srcBytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c srcBytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The specified @c index or @c count is greater than the length of the specified @c srcBytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c srcBytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see GetBytes()
* @since 2.0
*
* @return An error code
- * @param[in] str A string to encode
- * @param[out] byteCount The total number of bytes required to encode the specified string
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c str is empty.
+ * @param[in] str The string to encode
+ * @param[out] byteCount The total number of bytes required to encode the specified string
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c str is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the total number of bytes
* that are generated when the specified string is encoded.
* @since 2.0
*
* @return An error code
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[out] byteCount The total number of bytes required to encode the specified range of characters
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[out] byteCount The total number of bytes required to encode the specified range of characters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c chars is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the total number of bytes
* that are generated when the specified array of characters is encoded.
* @since 2.0
*
* @return An error code
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
- * @param[out] byteCount The total number of bytes required to encode the specified range of characters
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
+ * @param[out] byteCount The total number of bytes required to encode the specified range of characters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the total number of bytes
* that are generated when the specified array of characters is encoded.
*
* @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
* else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c chars is invalid or empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks The pointer to the Tizen::Base::ByteBuffer instance is not terminated by a @c null character.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - The pointer to the Tizen::Base::ByteBuffer instance is not terminated by a @c null character.
* @see GetCharsN()
*/
virtual Tizen::Base::ByteBuffer* GetBytesN(const Tizen::Base::WcharBuffer& chars) const;
* @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
* else @c null if an exception occurs @n
* The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
- * @param[in] str A string to encode
+ * @param[in] str The string to encode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c str is invalid or empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks The pointer to the Tizen::Base::ByteBuffer instance is not terminated by a @c null character.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - The pointer to the Tizen::Base::ByteBuffer instance is not terminated by a @c null character.
* @see GetString()
*/
virtual Tizen::Base::ByteBuffer* GetBytesN(const Tizen::Base::String& str) const;
* @since 2.0
*
* @return An error code
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
* @param[in] charCount The total number of characters to encode
* @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
* @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c chars or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or the specified @c bytes does not contain sufficient space to store the encoded characters.
- * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method encodes a range of characters in Tizen::Base::WcharBuffer into a range of bytes in Tizen::Base::ByteBuffer.
* @see GetChars()
*/
* @since 2.0
*
* @return An error code
- * @param[in] str A string to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
- * @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
- * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
+ * @param[in] str The string to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
+ * @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
+ * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c str or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or the specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c str or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetString()
*/
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c bytes is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks This method determines the total number of characters
- * that are generated when the specified range of bytes are decoded.
+ * @remarks This method determines the total number of characters that are generated when the specified range of bytes are decoded.
* @see GetMaxCharCount()
*/
virtual result GetCharCount(const Tizen::Base::ByteBuffer& bytes, int& charCount) const;
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
- * @param[in] byteCount The total number of bytes to decode
- * @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] byteIndex The index from where the decoding begins
+ * @param[in] byteCount The total number of bytes to decode
+ * @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the total number of characters
* that are generated when the specified range of bytes are decoded.
*
* @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
* else @c null if an exception occurs @n
- * The buffer limit is the position of the last decoded byte plus one and the starting position is zero.
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * The buffer limit is the position of the last decoded byte plus one and the starting position is zero.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c bytes is invalid or empty.
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
- * @param[in] byteCount The total number of bytes to decode
- * @param[out] chars The Tizen::Base::WcharBuffer instance where the resultant decoded data is stored
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] byteIndex The index from where the decoding begins
+ * @param[in] byteCount The total number of bytes to decode
+ * @param[out] chars The Tizen::Base::WcharBuffer instance where the resultant decoded data is stored
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c bytes or @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or the specified @c chars does not contain sufficient space to store the decoded bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes or @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c chars does not contain sufficient space to store the decoded bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytes()
*/
Tizen::Base::WcharBuffer& chars, int charIndex = 0) const;
/**
- * Gets a string containing the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * Gets a string that contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[out] str A Tizen::Base::String instance @n
- * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c bytes is empty.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[out] str A Tizen::Base::String instance @n
+ * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytesN()
*/
virtual result GetString(const Tizen::Base::ByteBuffer& bytes, Tizen::Base::String& str) const;
/**
- * Gets a string containing the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * Gets a string that contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] index The index from where decoding begins
- * @param[in] count The total number of bytes to decode
- * @param[out] str A Tizen::Base::String instance @n
- * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] index The index from where the decoding begins
+ * @param[in] count The total number of bytes to decode
+ * @param[out] str A Tizen::Base::String instance @n
+ * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parmater is outside the valid range defined by the method.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytes()
*/
*
* @since 2.0
*
- * @return A pointer to the Encoder instance for the current encoding
- * @remarks Contrary to GetBytes(), an encoder can convert partial sequences of characters into
- * partial sequences of bytes by maintaining the appropriate state between the conversions.
- * Currently only UTF-8 encoding supports this method. The other classes return a value of @c null.
- * @see GetBytes()
+ * @return A pointer to the Encoder instance for the current encoding
+ * @remarks
+ * - Contrary to GetBytes(), an encoder can convert partial sequences of characters into
+ * partial sequences of bytes by maintaining the appropriate state between the conversions.
+ * - Currently only UTF-8 encoding supports this method. The other classes return a @c null value.
*/
virtual Encoder* GetEncoderN(void) const;
*
* @since 2.0
*
- * @return A pointer to the Decoder instance for the current encoding
- * @remarks Contrary to GetChars(), a decoder can convert partial sequences of bytes
- * into partial sequences of characters by maintaining the appropriate state between the conversions.
- * Currently only UTF-8 encoding supports this method. The other classes return a value of @c null.
- * @see GetChars()
+ * @return A pointer to the Decoder instance for the current encoding
+ * @remarks
+ * - Contrary to GetChars(), a decoder can convert partial sequences of bytes
+ * into partial sequences of characters by maintaining the appropriate state between the conversions.
+ * - Currently only UTF-8 encoding supports this method. The other classes return a @c null value.
*/
virtual Decoder* GetDecoderN(void) const;
*
* @since 2.0
*
- * @return An encoding type
+ * @return The encoding type
*/
virtual Tizen::Base::String GetEncodingType(void) const;
* though the two are not identical.
* Latin1 also serves as the basis for the ANSI character set of MS Windows.
* Only the characters in ISO Latin-1 are guaranteed to be supported on an Internet website.
- * When a %Web browser, such as Internet Explorer or Firefox formats a %Web page on a client system, such as
- * Windows, it maps the ISO Latin-1 characters as best it can into the default character set.
+ * When a %Web browser, such as Internet Explorer or Firefox formats a Web page on a client system, such as
+ * Windows, it maps the ISO Latin-1 characters to the default character set in the best possible way.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/text/converting_all_text_data.htm">Converting All Text Data at Once</a>.
*
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
+ * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
* @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
- * @param[in] str A string to encode
+ * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
+ * @param[in] str The string to encode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c str is empty or invalid.
*
* @return An error code
* @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
* @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
* @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method encodes a range of characters in Tizen::Base::WcharBuffer into a range of bytes in Tizen::Base::ByteBuffer.
* @see GetChars()
* @since 2.0
*
* @return An error code
- * @param[in] str A string to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
+ * @param[in] str The string to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
* @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
- * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
+ * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c str or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c str or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parmater is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetString()
*/
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last decoded byte plus one and the starting position is zero.
+ * @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last decoded byte plus one and the starting position is zero.
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
+ * @param[in] byteIndex The index from where the decoding begins
* @param[in] byteCount The total number of bytes to decode
* @param[out] chars The Tizen::Base::WcharBuffer instance where the resultant decoded data is stored
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes or @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c chars does not contain sufficient space to store the decoded bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes or @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c chars does not contain sufficient space to store the decoded bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytes()
*/
Tizen::Base::WcharBuffer& chars, int charIndex = 0) const;
/**
- * Gets a string containing the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * Gets a string that contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
*
* @since 2.0
*
* It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytesN()
*/
virtual result GetString(const Tizen::Base::ByteBuffer& bytes, Tizen::Base::String& str) const;
/**
- * Gets a string containing the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * Gets a string that contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] index The index from where decoding begins
- * @param[in] count The total number of bytes to decode
- * @param[out] str A Tizen::Base::String instance @n
- * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] index The index from where the decoding begins
+ * @param[in] count The total number of bytes to decode
+ * @param[out] str A Tizen::Base::String instance @n
+ * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytes()
*/
*
* @since 2.0
*
- * @return The maximum number of bytes required for encoding a given number of characters
+ * @return The maximum number of bytes required for encoding the given number of characters
* @param[in] charCount The total number of characters to encode
- * @remarks This method determines an appropriate buffer size for the byte arrays passed to GetBytes() for encoding.
+ * @remarks This method determines an appropriate buffer size for the byte arrays passed to GetBytes() for encoding.
* @see Encoding::GetByteCount()
*/
virtual int GetMaxByteCount(int charCount) const;
*
* @since 2.0
*
- * @return The maximum number of characters generated by decoding the specified number of bytes
+ * @return The maximum number of characters generated by decoding the specified number of bytes
* @param[in] byteCount The total number of bytes to encode
- * @remarks This method determines an appropriate buffer size for character arrays passed to
+ * @remarks This method determines an appropriate buffer size for character arrays passed to
* GetChars() or a decoder for encoding.
* @see Encoding::GetByteCount()
*/
*
* @since 2.0
*
- * @return A pointer to the Encoder instance for the current encoding
- * @remarks Contrary to GetBytes(), an encoder can convert partial sequences of characters into
- * partial sequences of bytes by maintaining the appropriate state between the conversions.
- * Currently only Utf8Encoding supports this method. Other classes return @c null.
- * @see GetBytes()
+ * @return A pointer to the Encoder instance for the current encoding
+ * @remarks
+ * - Contrary to GetBytes(), an encoder can convert partial sequences of characters into
+ * partial sequences of bytes by maintaining the appropriate state between the conversions.
+ * - Currently only Utf8Encoding supports this method. Other classes return @c null.
*/
virtual Encoder* GetEncoderN(void) const;
* @since 2.0
*
* @return A pointer to the Decoder instance for the current encoding
- * @remarks Contrary to GetChars(), a decoder can convert partial sequences of bytes
- * into partial sequences of characters by maintaining the appropriate state between the conversions.
- * Currently only Utf8Encoding supports this method. Other classes return @c null.
- * @see GetChars()
+ * @remarks
+ * - Contrary to GetChars(), a decoder can convert partial sequences of bytes
+ * into partial sequences of characters by maintaining the appropriate state between the conversions.
+ * - Currently only Utf8Encoding supports this method. Other classes return @c null.
*/
virtual Decoder* GetDecoderN(void) const;
*
* @since 2.0
*
- * @return An encoding type
+ * @return The encoding type
*/
virtual Tizen::Base::String GetEncodingType(void) const;
* @since 2.0
*
* @return An error code
- * @param[in] str A string to encode
+ * @param[in] str The string to encode
* @param[out] byteCount The total number of bytes required to encode the string
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c str is an empty string.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c str is an empty string.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the exact number of bytes
* that are produced if the given string is encoded.
* @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
* @param[out] byteCount The total number of bytes required to encode the specified range of characters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the exact number of bytes
* that are produced if the given array of characters is encoded.
* @since 2.0
*
* @return An error code
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
- * @param[out] byteCount The total number of bytes required to encode the specified range of characters
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
+ * @param[out] byteCount The total number of bytes required to encode the specified range of characters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified inout parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the exact number of bytes
* that are produced if the given array of characters is encoded.
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
+ * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
* @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
- * @param[in] str A string to encode
- * @exception E_SUCCESS The method is successful.
+ * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
+ * @param[in] str The string to encode
+ * @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c str is empty or invalid.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @return An error code
* @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
* @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
+ * @param[in] charCount The total number of characters to encode
* @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
- * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
+ * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method encodes a range of characters in a Tizen::Base::WcharBuffer into a range of bytes in a Tizen::Base::ByteBuffer.
* @see GetChars()
* @since 2.0
*
* @return An error code
- * @param[in] str A string to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
+ * @param[in] str The string to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
* @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
- * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c str or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c str or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetString()
*/
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
+ * @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the exact number of characters
* that are produced if the given range of bytes is converted.
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
+ * @param[in] byteIndex The index from where the decoding begins
* @param[in] byteCount The total number of bytes to decode
* @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks This method determines the exact number of characters
* that are produced if the given range of bytes is converted.
virtual result GetCharCount(const Tizen::Base::ByteBuffer& bytes, int byteIndex, int byteCount, int& charCount) const;
/**
- *Decodes an instance of Tizen::Base::ByteBuffer into an instance of Tizen::Base::WcharBuffer.
+ * Decodes an instance of Tizen::Base::ByteBuffer into an instance of Tizen::Base::WcharBuffer.
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last decoded byte plus one and the starting position is zero.
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last decoded byte plus one and the starting position is zero.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c bytes is empty or invalid.
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
+ * @param[in] byteIndex The index from where the decoding begins
* @param[in] byteCount The total number of bytes to decode
* @param[out] chars The Tizen::Base::WcharBuffer instance where the resultant decoded data is stored
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes or @ chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c chars does not contain sufficient space to store the decoded bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes or @ chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c chars does not contain sufficient space to store the decoded bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytes()
*/
Tizen::Base::WcharBuffer& chars, int charIndex = 0) const;
/**
- * Gets a string containing the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * Gets a string that contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
*
* @since 2.0
*
* @return An error code
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[out] str A Tizen::Base::String instance @n
- * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[out] str A Tizen::Base::String instance @n
+ * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytesN()
*/
virtual result GetString(const Tizen::Base::ByteBuffer& bytes, Tizen::Base::String& str) const;
/**
- * Gets a string containing the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * Gets a string that contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
*
* @since 2.0
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] index The index from where decoding begins
+ * @param[in] index The index from where the decoding begins
* @param[in] count The total number of bytes to decode
* @param[out] str A Tizen::Base::String instance @n
- * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytesN()
*/
/**
- * Gets the maximum number of bytes required for encoding a given number of characters.
+ * Gets the maximum number of bytes required for encoding the given number of characters.
*
* @since 2.0
*
* @return The maximum number of bytes required for encoding the given number of characters
* @param[in] charCount The total number of characters to encode
- * @remarks This method determines an appropriate buffer size for the byte arrays passed to GetBytes() for encoding.
+ * @remarks This method determines an appropriate buffer size for the byte arrays passed to GetBytes() for encoding.
* @see GetByteCount()
- * @see GetBytes()
*/
virtual int GetMaxByteCount(int charCount) const;
*
* @return The maximum number of characters generated by decoding the specified number of bytes
* @param[in] byteCount The total number of bytes to encode
- * @remarks This method determines an appropriate buffer size for the character arrays passed to
- * GetChars() or a decoder for encoding.
+ * @remarks This method determines an appropriate buffer size for the character arrays passed to
+ * GetChars() or a decoder for encoding.
* @see GetByteCount()
- * @see GetChars()
*/
virtual int GetMaxCharCount(int byteCount) const;
*
* @since 2.0
*
- * @return A pointer to the Encoder instance for the current encoding
- * @remarks Contrary to GetBytes(), an encoder can convert partial sequences of characters into
- * partial sequences of bytes by maintaining the appropriate state between the conversions.
- * Currently only Utf8Encoding supports this method. Other classes return @c null.
- * @see GetBytes()
+ * @return A pointer to the Encoder instance for the current encoding
+ * @remarks
+ * - Contrary to GetBytes(), an encoder can convert partial sequences of characters into
+ * partial sequences of bytes by maintaining the appropriate state between the conversions.
+ * - Currently only Utf8Encoding supports this method. Other classes return @c null.
*/
virtual Encoder* GetEncoderN(void) const;
*
* @since 2.0
*
- * @return A pointer to the Decoder instance for the current encoding
- * @remarks Contrary to GetChars(), a decoder can convert partial sequences of bytes
- * into partial sequences of characters by maintaining the appropriate state between the conversions.
- * Currently only Utf8Encoding supports this method. Other classes return @c null.
- *
- * @see GetChars()
+ * @return A pointer to the Decoder instance for the current encoding
+ * @remarks
+ * - Contrary to GetChars(), a decoder can convert partial sequences of bytes
+ * into partial sequences of characters by maintaining the appropriate state between the conversions.
+ * - Currently only Utf8Encoding supports this method. Other classes return @c null.
*/
virtual Decoder* GetDecoderN(void) const;
*
* @since 2.0
*
- * @return An encoding type
+ * @return The encoding type
*/
virtual Tizen::Base::String GetEncodingType(void) const;
*
* The %Utf8Decoder class converts blocks of bytes into decoded blocks of characters.
* Universal Transformation Format-8 (UTF-8) is a translated language that is used on the internet.
- * It converts the unicode into 8-bit bytes.
- * UTF-8 encoding supports all unicode character values and surrogates.
+ * It converts the Unicode into 8-bit bytes.
+ * UTF-8 encoding supports all Unicode character values and surrogates.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/text/converting_text_data_separate_blocks.htm">Converting Text Data in Separate Blocks</a>.
*
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
+ * @param[in] byteIndex The index from where the decoding begins
* @param[in] byteCount The total number of bytes to decode
* @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
* @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
* else @c false
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_INVALID_ENCODING_RANGE The conversion has failed due to invalid encoding range.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_INVALID_ENCODING_RANGE The conversion has failed due to an invalid encoding range.
*/
virtual result GetCharCount(const Tizen::Base::ByteBuffer& bytes, int byteIndex, int byteCount, int& charCount, bool flush = false) const;
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last decoded byte plus one and the starting position is zero.
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
- * else @c false
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
- * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
+ * @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last decoded byte plus one and the starting position is zero.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
+ * else @c false
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual Tizen::Base::WcharBuffer* GetCharsN(const Tizen::Base::ByteBuffer& bytes, bool flush = false) const;
* Decodes an instance of Tizen::Base::ByteBuffer into an instance of Tizen::Base::WcharBuffer as per the specified range.
*
* @since 2.0
- * @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last decoded byte and the starting position is zero.
+ * @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last decoded byte and the starting position is zero.
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
+ * @param[in] byteIndex The index from where the decoding begins
* @param[in] byteCount The total number of bytes to decode
* @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
* else @c false
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks This method maintains state consistency between conversions.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks The pointer to the Tizen::Base::ByteBuffer instance is not terminated by a @c null character.
- *
+ * @remarks
+ * - This method maintains state consistency between conversions.
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - The pointer to the Tizen::Base::ByteBuffer instance is not terminated by a @c null character.
*/
virtual Tizen::Base::WcharBuffer* GetCharsN(const Tizen::Base::ByteBuffer& bytes, int byteIndex, int byteCount,
bool flush = false) const;
*
* The %Utf8Encoder class converts the blocks of characters into encoded blocks of bytes.
* Universal Transformation Format-8 (UTF-8) is a translated language that is used on the internet. It converts the
- * unicode into 8-bit bytes. @n UTF-8 encoding supports all unicode character values and surrogates.
- * Note that %Utf8Encoder is not used in reality, because keeping the internal state of encoding from unicode
+ * Unicode into 8-bit bytes. @n UTF-8 encoding supports all Unicode character values and surrogates.
+ * Note that %Utf8Encoder is not used in reality, because keeping the internal state of encoding from Unicode
* to UTF-8 can be avoided if the translation unit is even.
* This means that the real implementation of %Utf8Encoder is the same as that of Utf8Encoding in this state.
*
* @since 2.0
*
* @return An error code
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
- * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
- * else @c false
- * @param[out] byteCount The total number of bytes required to encode the specified range of characters
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
+ * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
+ * else @c false
+ * @param[out] byteCount The total number of bytes required to encode the specified range of characters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid, or
+ * - The specified @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see Utf8Decoder::GetCharCount()
*/
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
- * else @c false
+ * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
+ * else @c false
* @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars is empty.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see Utf8Decoder::GetCharsN()
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte and the starting position is zero.
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
+ * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte and the starting position is zero.
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
* @param[in] flush Set to @c true to allow this instance to flush its state at the end of the conversion, @n
* else @c false
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
- * @remarks The pointer to the Tizen::Base::ByteBuffer instance is not terminated by a @c null character.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - The pointer to the Tizen::Base::ByteBuffer instance is not terminated by a @c null character.
* @see Utf8Decoder::GetCharsN()
*/
virtual Tizen::Base::ByteBuffer* GetBytesN(const Tizen::Base::WcharBuffer& chars, int charIndex, int charCount,
virtual ~Utf8Encoding(void);
/**
- * Gets the total number of bytes that are generated by encoding an instance of specified string. @n
+ * Gets the total number of bytes that are generated by encoding an instance of the specified string. @n
* The %GetByteCount() method determines the total number of bytes that are generated when the specified string is encoded.
*
* @since 2.0
* @param[in] str The string to encode
* @param[out] byteCount The total number of bytes required to encode the string
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c str is an empty string.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c str is an empty string.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetMaxByteCount()
*/
* @since 2.0
*
* @return An error code
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[out] byteCount The total number of bytes required to encode the specified range of characters
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars is empty.
- * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @param[out] byteCount The total number of bytes required to encode the specified range of characters
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
+ * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetMaxByteCount()
*/
virtual result GetByteCount(const Tizen::Base::WcharBuffer& chars, int& byteCount) const;
*
* @return An error code
* @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
- * @param[out] byteCount The total number of bytes required to encode the specified range of characters
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
+ * @param[out] byteCount The total number of bytes required to encode the specified range of characters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetMaxByteCount()
*/
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
- * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG The specified @c chars is empty or invalid.
+ * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
+ * @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG The specified @c chars is empty or invalid.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see GetCharsN()
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
- * @param[in] str A string to encode
- * @exception E_SUCCESS The method is successful.
+ * @return A pointer to the Tizen::Base::ByteBuffer instance where the resultant encoded string is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last encoded byte plus one and the starting position is zero.
+ * @param[in] str The string to encode
+ * @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c str is an empty string.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c str is an empty string.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see GetString()
*
* @return An error code
* @param[in] chars An instance of Tizen::Base::WcharBuffer to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
* @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
* @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c chars or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c chars or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c chars.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c chars.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetChars()
*/
* @since 2.0
*
* @return An error code
- * @param[in] str A string to encode
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
- * @param[in] charCount The total number of characters to encode
+ * @param[in] str The string to encode
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charCount The total number of characters to encode
* @param[out] bytes The Tizen::Base::ByteBuffer instance where the resultant encoded string is stored
- * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c str or @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c bytes does not contain sufficient space to store the encoded characters.
- * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
+ * @param[in] byteIndex The starting index of the resultant encoding in the Tizen::Base::ByteBuffer instance
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c str or @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c charIndex or @c charCount is greater than the length of the specified @c str.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c charIndex and @c charCount is greater than the length of the specified @c str.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c bytes does not contain sufficient space to store the encoded characters.
+ * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetString()
*/
virtual result GetBytes(const Tizen::Base::String& str, int charIndex, int charCount,
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
* @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetMaxCharCount()
*/
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
+ * @param[in] byteIndex The index from where the decoding begins
* @param[in] byteCount The total number of bytes to decode
- * @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @param[out] charCount The total number of characters that are generated by decoding the specified Tizen::Base::ByteBuffer instance
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetMaxCharCount()
*/
*
* @since 2.0
*
- * @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
- * else @c null if an exception occurs @n
- * The buffer limit is the position of the last decoded byte plus one and the position is zero.
- * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
+ * @return A pointer to the Tizen::Base::WcharBuffer instance where the resultant decoded data is stored, @n
+ * else @c null if an exception occurs @n
+ * The buffer limit is the position of the last decoded byte plus one and the position is zero.
+ * @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c bytes is empty or invalid.
- * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
+ * @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @remarks The specific error code can be accessed using the GetLastResult() method.
* @see GetBytesN()
*/
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] byteIndex The index from where decoding begins
+ * @param[in] byteIndex The index from where the decoding begins
* @param[in] byteCount The total number of bytes to decode
* @param[out] chars The Tizen::Base::WcharBuffer instance where the resultant decoded data is stored
- * @param[in] charIndex The index from where encoding begins in the Tizen::Base::WcharBuffer instance
+ * @param[in] charIndex The index from where the encoding begins in the Tizen::Base::WcharBuffer instance
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes or @c chars is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
- * @exception E_OVERFLOW This operation has caused the memory to overflow, or
- * the specified @c chars does not contain sufficient space to store the decoded bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes or @c chars is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The length of the specified @c byteIndex or @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c byteIndex and @c byteCount is greater than the length of the specified @c bytes.
+ * @exception E_OVERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to overflow.
+ * - The specified @c chars does not contain sufficient space to store the decoded bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytes()
*/
Tizen::Base::WcharBuffer& chars, int charIndex = 0) const;
/**
- * Gets a string containing the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * Gets a string that contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
*
* @since 2.0
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[out] str A Tizen::Base::String instance @n
- * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * @param[out] str A Tizen::Base::String instance @n
+ * It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytesN()
*/
virtual result GetString(const Tizen::Base::ByteBuffer& bytes, Tizen::Base::String& str) const;
/**
- * Gets a string containing the decoded representation of the specified Tizen::Base::ByteBuffer instance.
+ * Gets a string that contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
*
* @since 2.0
*
* @return An error code
* @param[in] bytes An instance of Tizen::Base::ByteBuffer to decode
- * @param[in] index The index from where decoding begins
+ * @param[in] index The index from where the decoding begins
* @param[in] count The total number of bytes to decode
* @param[out] str A Tizen::Base::String instance @n
* It contains the decoded representation of the specified Tizen::Base::ByteBuffer instance.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_INVALID_ARG A specified input parameter is invalid, or
- * the specified @c bytes is empty.
- * @exception E_OUT_OF_RANGE The value of an argument is outside the valid range defined by the method, or
- * the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
- * @exception E_UNDERFLOW This operation has caused the memory to underflow, or
- * the sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - A specified input parameter is invalid.
+ * - The specified @c bytes is empty.
+ * @exception E_OUT_OF_RANGE Either of the following conditions has occurred:
+ * - A specified input parameter is outside the valid range defined by the method.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
+ * @exception E_UNDERFLOW Either of the following conditions has occurred:
+ * - This operation has caused the memory to underflow.
+ * - The sum of the length of the specified @c index and @c count is greater than the length of the specified @c bytes.
* @exception E_INVALID_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
* @see GetBytes()
*/
/**
- * Gets the maximum number of bytes required for encoding a given number of characters.
+ * Gets the maximum number of bytes required for encoding the given number of characters.
*
* @since 2.0
*
- * @return The maximum number of bytes required for encoding a given number of characters
+ * @return The maximum number of bytes required for encoding the given number of characters
* @param[in] charCount The total number of characters to encode
* @remarks This method determines an appropriate buffer size for the byte arrays passed to GetBytes() for encoding.
* @see GetByteCount()
- * @see GetBytes()
*/
virtual int GetMaxByteCount(int charCount) const;
*
* @since 2.0
*
- * @return The maximum number of characters generated by decoding the specified number of bytes
- * @param[in] byteCount The total number of bytes to encode
+ * @return The maximum number of characters generated by decoding the specified number of bytes
+ * @param[in] byteCount The total number of bytes to encode
* @remarks This method determines an appropriate buffer size for the character arrays passed to
* GetChars() or a decoder for encoding.
* @see GetCharCount()
- * @see GetChars()
*/
virtual int GetMaxCharCount(int byteCount) const;
*
* @since 2.0
*
- * @return A pointer to the Encoder instance for the current encoding
+ * @return A pointer to the Encoder instance for the current encoding
* @remarks Contrary to GetBytes(), an encoder can convert partial sequences of characters into
* partial sequences of bytes by maintaining the appropriate states between the conversions.
- * @see GetBytes()
*/
virtual Encoder* GetEncoderN(void) const;
*
* @since 2.0
*
- * @return A pointer to the Decoder instance for the current encoding
+ * @return A pointer to the Decoder instance for the current encoding
* @remarks Contrary to GetChars(), a decoder can convert partial sequences of bytes
* into partial sequences of characters by maintaining the appropriate states between the conversions.
- * @see GetChars()
*/
virtual Decoder* GetDecoderN(void) const;
*
* @since 2.0
*
- * @return An encoding type
+ * @return The encoding type
*/
virtual Tizen::Base::String GetEncodingType(void) const;
prefix=@PREFIX@
exec_prefix=/usr
libdir=/usr/lib/osp-server
-includedir=/usr/include/osp/server
+includedir=/usr/include/osp/server/appfw
Name: @PC_NAME@
Description: @PACKAGE_DESCRIPTION@
<domain name="_"/>
</request>
<assign>
- <filesystem path="/usr/lib/osp-server" label="osp::system-server-res" exec_label="none"/>
- <filesystem path="/usr/lib/osp-server/*" label="osp::system-server-res" exec_label="none"/>
+ <filesystem path="/usr/bin/nativeinfologctrl" label="_" exec_label="none"/>
</assign>
</manifest>
prefix=@PREFIX@
exec_prefix=/usr
libdir=/usr/lib/osp-server
-includedir=/usr/include/osp/server
+includedir=/usr/include/osp/server/system
Name: @PC_NAME@
Description: @PACKAGE_DESCRIPTION@
--- /dev/null
+#!/bin/sh
+MODE=none
+OBJ=none
+VAL=none
+#echo "tizen_platform_dlog_logging_ctrl"
+case "$1" in
+get)
+ MODE=get
+;;
+set)
+ MODE=set
+;;
+
+*)
+echo "Usage: nativeinfologctrl {get|set} {platformlog} {1|0}"
+exit 1
+esac
+
+case "$2" in
+platformlog)
+ OBJ=platformlog
+;;
+*)
+ echo "Usage: nativeinfologctrl {get|set} {platformlog} {1|0}"
+exit 1
+esac
+
+if [ "$MODE" = "set" ]; then
+ case "$3" in
+ 1)
+ VAL=1
+ ;;
+ 0)
+ VAL=0
+ ;;
+ *)
+ echo "Usage: nativeinfologctrl {get|set} {platformlog} {1|0}"
+ exit 1
+ esac
+fi
+
+if [ "$MODE" = "set" ]; then
+ if [ "$OBJ" = "platformlog" ] && [ "$VAL" = "1" ] ; then
+ echo 1 > /opt/etc/platformlog.conf 2>/dev/null
+ /bin/touch /home/developer/.platforminfologgingmode 2>/dev/null
+ elif [ "$OBJ" = "platformlog" ] && [ "$VAL" = "0" ] ; then
+ echo 0 > /opt/etc/platformlog.conf 2>/dev/null
+ /bin/rm /home/developer/.platforminfologgingmode 2>/dev/null
+ fi
+ echo "You must reboot this target to apply the change!"
+else
+ if [ "$OBJ" = "platformlog" ]; then
+ /bin/cat /opt/etc/platformlog.conf 2>/dev/null
+ fi
+fi
+
+exit 0
)
FOREACH(flag ${pkgs_CFLAGS})
- SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} ${flag}")
+ SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} ${flag} -Wall -Wno-unused")
ENDFOREACH(flag)
## Add SubModules
ADD_SUBDIRECTORY(text)
ADD_SUBDIRECTORY(appfw)
ADD_SUBDIRECTORY(osp-string)
-ADD_SUBDIRECTORY(server osp-appfw-server)
-ADD_SUBDIRECTORY(system-server osp-system-server)
+ADD_SUBDIRECTORY(server)
+ADD_SUBDIRECTORY(server/system osp-system-server)
result
AppControl::Stop(void)
{
+ result r = _AccessController::CheckUserPrivilege(_PRV_APPLICATION_LAUNCH);
+ SysTryReturnResult(NID_APP, !IsFailed(r), E_PRIVILEGE_DENIED, "The application does not have the privilege to call this method.");
+
SysAssertf(__pAppControlImpl != null, "Instance is not constructed properly.");
return __pAppControlImpl->Stop();
}
#include <pthread.h>
#include <FAppAppSetting.h>
#include <FBaseSysLog.h>
+#include <FSec_AccessController.h>
#include "FApp_AppSettingImpl.h"
using namespace Tizen::Base::Collection;
+using namespace Tizen::Security;
namespace Tizen { namespace App
{
AppSetting*
AppSetting::GetInstanceByAppId(const AppId& appId)
{
- //TODO: Add privilege checking code
+ result r = _AccessController::CheckUserPrivilege(_PRV_APPSETTING);
+ SysTryReturn(NID_APP, !IsFailed(r), null, E_PRIVILEGE_DENIED,
+ "[%s] The application does not have the privilege to call this method.", GetErrorMessage(E_PRIVILEGE_DENIED));
+
return _AppSettingImpl::GetInstanceByAppId(appId);
}
result
AppSetting::ReleaseInstanceByAppId(const AppId& appId)
{
+ result r = _AccessController::CheckUserPrivilege(_PRV_APPSETTING);
+ SysTryReturnResult(NID_APP, !IsFailed(r), E_PRIVILEGE_DENIED,
+ "[%s] The application does not have the privilege to call this method.", GetErrorMessage(E_PRIVILEGE_DENIED));
+
return _AppSettingImpl::ReleaseInstanceByAppId(appId);
}
#include <FBase_NativeError.h>
#include "FApp_MapDataControlImpl.h"
+#include <FSec_AccessController.h>
using namespace Tizen::Base;
using namespace Tizen::Base::Collection;
using namespace Tizen::App;
+using namespace Tizen::Security;
namespace Tizen { namespace App {
MapDataControl::GetValue(const String& dataId, const String& key,
RequestId& reqId, int pageNo, int countPerPage)
{
+ result r = _AccessController::CheckUserPrivilege(_PRV_DATACONTROL_CONSUMER);
+ SysTryReturnResult(NID_APP, !IsFailed(r), E_PRIVILEGE_DENIED, "The application does not have the privilege to call this method.");
+
SysTryReturnResult(NID_APP, __pMapDataControlImpl, E_INVALID_STATE,
"This instance has not been properly constructed yet.");
MapDataControl::AddValue(const String& dataId, const String& key,
const String& value, RequestId& reqId)
{
+ result r = _AccessController::CheckUserPrivilege(_PRV_DATACONTROL_CONSUMER);
+ SysTryReturnResult(NID_APP, !IsFailed(r), E_PRIVILEGE_DENIED, "The application does not have the privilege to call this method.");
+
SysTryReturnResult(NID_APP, __pMapDataControlImpl, E_INVALID_STATE,
"This instance has not been properly constructed yet.");
MapDataControl::SetValue(const String& dataId, const String& key,
const String& oldValue, const String& newValue, RequestId& reqId)
{
+ result r = _AccessController::CheckUserPrivilege(_PRV_DATACONTROL_CONSUMER);
+ SysTryReturnResult(NID_APP, !IsFailed(r), E_PRIVILEGE_DENIED, "The application does not have the privilege to call this method.");
+
SysTryReturnResult(NID_APP, __pMapDataControlImpl, E_INVALID_STATE,
"This instance has not been properly constructed yet.");
MapDataControl::RemoveValue(const String& dataId, const String& key,
const String& value, RequestId& reqId)
{
+ result r = _AccessController::CheckUserPrivilege(_PRV_DATACONTROL_CONSUMER);
+ SysTryReturnResult(NID_APP, !IsFailed(r), E_PRIVILEGE_DENIED, "The application does not have the privilege to call this method.");
+
SysTryReturnResult(NID_APP, __pMapDataControlImpl, E_INVALID_STATE,
"This instance has not been properly constructed yet.");
#include <FBase_NativeError.h>
#include "FApp_SqlDataControlImpl.h"
+#include <FSec_AccessController.h>
using namespace Tizen::Base;
using namespace Tizen::Base::Collection;
+using namespace Tizen::Security;
namespace Tizen { namespace App
{
SqlDataControl::Select(const String& dataId, const IList* pColumnList, const String* pWhere,
const String *pOrder, RequestId& reqId, int pageNo, int countPerPage)
{
+ result r = _AccessController::CheckUserPrivilege(_PRV_DATACONTROL_CONSUMER);
+ SysTryReturnResult(NID_APP, !IsFailed(r), E_PRIVILEGE_DENIED, "The application does not have the privilege to call this method.");
+
SysTryReturnResult(NID_APP, __pSqlDataControlImpl, E_INVALID_STATE,
"This instance has not been properly constructed.");
SqlDataControl::Insert(const Tizen::Base::String& dataId, const Tizen::Base::Collection::IMap& insertMap,
RequestId& reqId)
{
+ result r = _AccessController::CheckUserPrivilege(_PRV_DATACONTROL_CONSUMER);
+ SysTryReturnResult(NID_APP, !IsFailed(r), E_PRIVILEGE_DENIED, "The application does not have the privilege to call this method.");
+
SysTryReturnResult(NID_APP, __pSqlDataControlImpl, E_INVALID_STATE,
"This instance has not been properly constructed.");
SqlDataControl::Update(const Tizen::Base::String& dataId, const Tizen::Base::Collection::IMap& updateMap,
const Tizen::Base::String* pWhere, RequestId& reqId)
{
+ result r = _AccessController::CheckUserPrivilege(_PRV_DATACONTROL_CONSUMER);
+ SysTryReturnResult(NID_APP, !IsFailed(r), E_PRIVILEGE_DENIED, "The application does not have the privilege to call this method.");
+
SysTryReturnResult(NID_APP, __pSqlDataControlImpl, E_INVALID_STATE, "This instance has not been properly constructed.");
return __pSqlDataControlImpl->Update(dataId, updateMap, pWhere, reqId);
result
SqlDataControl::Delete(const Tizen::Base::String& dataId, const Tizen::Base::String* pWhere, RequestId& reqId)
{
+ result r = _AccessController::CheckUserPrivilege(_PRV_DATACONTROL_CONSUMER);
+ SysTryReturnResult(NID_APP, !IsFailed(r), E_PRIVILEGE_DENIED, "The application does not have the privilege to call this method.");
+
SysTryReturnResult(NID_APP, __pSqlDataControlImpl, E_INVALID_STATE,
"This instance has not been properly constructed.");
namespace
{
-static const int _REQ_ID_INVALID = -1;
const wchar_t ACTL_IMPLICIT_PLUGIN[] = L"libosp-ac-implicit.so";
+const wchar_t TIZEN_ALIAS_APPID_PREFIX[] = L"tizen.";
}
_AppControlImpl::_AppControlImpl(const AppControl& value)
: _appControl(value)
- , _reqId(_REQ_ID_INVALID)
+ , _reqId(APPCONTROL_REQUEST_ID_INVALID)
, _property(_APPCONTROL_PROPERTY_NONE)
- , _processId(_REQ_ID_INVALID)
+ , _processId(APPCONTROL_REQUEST_ID_INVALID)
{
__appControlResponseEventList.Construct();
}
{
SysTryReturn(NID_APP, !path.IsEmpty(), null, E_INVALID_ARG, "[E_INVALID_ARG] Path is empty.");
SysTryReturn(NID_APP, !aId.IsEmpty(), null, E_INVALID_ARG, "[E_INVALID_ARG] Provider Id is empty.");
- SysTryReturn(NID_APP, !oId.IsEmpty(), null, E_INVALID_ARG, "[E_INVALID_ARG] Operation Id is empty.");
- const AppId& actualAppId = _AppControlRegistry::GetInstance()->GetAliasAppId(aId);
+ String actualAppId = aId;
+ if (aId.StartsWith(TIZEN_ALIAS_APPID_PREFIX, 0))
+ {
+ // little bit of performance tweak
+ actualAppId = _AppControlRegistry::GetInstance()->GetAliasAppId(aId);
+ }
+
const bool isInstalled = _Aul::IsInstalled(actualAppId);
SysTryReturn(NID_APP, isInstalled, null, E_OBJ_NOT_FOUND, "[E_OBJ_NOT_FOUND] %ls not installed.", actualAppId.GetPointer());
pImpl->_path = path;
pImpl->_appId = aId;
- pImpl->_opId = oId;
+ pImpl->_opId = (oId.IsEmpty()) ? TIZEN_OPERATION_MAIN : oId;
pImpl->_property = prop;
return pAc;
}
-const _AppControlImpl*
-_AppControlImpl::GetInstance(const AppControl& ac)
-{
- return ac.__pAppControlImpl;
-}
-
-_AppControlImpl*
-_AppControlImpl::GetInstance(AppControl& ac)
-{
- return ac.__pAppControlImpl;
-}
-
_IAppControlPluginProvider*
_AppControlImpl::GetAppControlPluginProvider(const String& path)
{
if (pDataType)
{
- String mimeType = *pDataType;
-
- if ((*pDataType)[0] == L'.')
- {
- SysLog(NID_APP, "Extension to MIME conversion for %ls", pDataType->GetPointer());
-
-#if 0
- String ext;
- pDataType->SubString(1, ext);
-
- result r = _AppControlManager::GetMimeFromExt(ext, mimeType);
-
- SysTryReturn(NID_APP, !IsFailed(r), null, r, "[%s] MIME type conversion failure for %ls.", GetErrorMessage(r), ext.GetPointer());
-
- pMimeType = &mimeType;
-
- SysLog(NID_APP, "Conversion : %ls -> %ls.", pDataType->GetPointer(), pMimeType->GetPointer());
-#endif
- }
+ const String& mimeType = _AppControlManager::GetMimeTypeFromDataType(*pDataType);
_AppMessageImpl::SetMime(pBundle.get(), mimeType);
}
_AppControlImpl::StartImplicit(const _AppMessageImpl& msg, IEventListener* pListener, bool isLegacy)
{
SysLog(NID_APP, "Enter");
- int req = _REQ_ID_INVALID;
+ int req = APPCONTROL_REQUEST_ID_INVALID;
_IAppControlPluginProvider* pProvider = GetAppControlPluginProvider(ACTL_IMPLICIT_PLUGIN);
if (pProvider == null)
_InProcessInfo* pInfo = _AppControlManager::GetInstance()->__inAppManager.FindItem(_reqId);
SysTryReturnResult(NID_APP, pInfo == null, E_IN_PROGRESS, "Request ID %d is already in progress.", _reqId);
- int req = _REQ_ID_INVALID;
+ int req = APPCONTROL_REQUEST_ID_INVALID;
_IAppControlPluginProvider* pProvider = GetAppControlPluginProvider(_path);
if (pProvider == null)
_InProcessInfo* pInfo = _AppControlManager::GetInstance()->__inAppManager.FindItem(_reqId);
SysTryReturnResult(NID_APP, pInfo == null, E_IN_PROGRESS, "Request ID %d is already in progress.", _reqId);
- int req = _REQ_ID_INVALID;
+ int req = APPCONTROL_REQUEST_ID_INVALID;
result r = E_SUCCESS;
_IAppControlPluginProvider* pProvider = GetAppControlPluginProvider(_path);
req = _AppControlManager::GetInstance()->__inAppManager.InsertItem(pItem);
}
- if (_ThreadImpl::GetCurrentThreadImpl()->GetThreadType() == THREAD_TYPE_EVENT_DRIVEN)
+ const _ThreadImpl* pThreadImpl = _ThreadImpl::GetCurrentThreadImpl();
+ if (pThreadImpl && pThreadImpl->GetThreadType() == THREAD_TYPE_EVENT_DRIVEN)
{
_AppControlResponseEvent* pAppControlResponseEvent = new (std::nothrow) _AppControlResponseEvent();
result
_AppControlImpl::InvokeStartAppControl(_IAppControlPluginProvider* pProvider, int req, const String& appId, const String& oId, const String* pUri, const String* pMime, const IMap* pMap)
{
- _AppMessageImpl msg(appId, oId, pUri, pMime, pMap);
+ String data;
+
+ if (pMime)
+ {
+ data = _AppControlManager::GetMimeTypeFromDataType(*pMime);
+ }
+
+ _AppMessageImpl msg(appId, oId, pUri, &data, pMap);
return InvokeStartAppControl(pProvider, req, appId, msg);
}
}
-static bool
-IsValidAppControl(const String& appcontrolID)
-{
- return ((appcontrolID == L"osp.appcontrol.provider.audio")
- || (appcontrolID == L"osp.appcontrol.provider.bluetooth")
- || (appcontrolID == L"osp.appcontrol.provider.calendar")
- || (appcontrolID == L"osp.appcontrol.provider.camera")
- || (appcontrolID == L"osp.appcontrol.provider.contact")
- || (appcontrolID == L"osp.appcontrol.provider.certificatemanager")
- || (appcontrolID == L"osp.appcontrol.provider.email")
- || (appcontrolID == L"osp.appcontrol.provider.image")
- || (appcontrolID == L"osp.appcontrol.provider.media")
- || (appcontrolID == L"osp.appcontrol.provider.message")
- || (appcontrolID == L"osp.appcontrol.provider.video")
- || (appcontrolID == L"osp.appcontrol.provider.imageeditor")
- || (appcontrolID == L"osp.appcontrol.provider.allshare")
- || (appcontrolID == L"tizen.filemanager")
- || (appcontrolID == L"tizen.camera")
- || (appcontrolID == L"tizen.gallery")
- || (appcontrolID == L"tizen.imageviewer")
- || (appcontrolID == L"tizen.videoplayer")
- || (appcontrolID == L"tizen.memo")
- || (appcontrolID == L"tizen.contacts")
- || (appcontrolID == L"tizen.calendar")
- || (appcontrolID == L"tizen.todo")
- || (appcontrolID == L"tizen.email")
- || (appcontrolID == L"tizen.settings")
- || (appcontrolID == L"tizen.messages")
- || (appcontrolID == L"tizen.musicplayer")
- || (appcontrolID == L"tizen.bluetooth")
- || (appcontrolID == L"samsung.snote")
- || (appcontrolID == L"0pnxz8hbsr.MyFiles")
- || (appcontrolID == L"hdufar9ycj.Camera")
- || (appcontrolID == L"ijudt7w61q.Gallery")
- || (appcontrolID == L"jysyv9o1dc.ImageViewer")
- || (appcontrolID == L"npwf0scb88.VideoPlayer")
- || (appcontrolID == L"zunqjlsnce.Memo")
- || (appcontrolID == L"f9uev8hsyo.Contacts")
- || (appcontrolID == L"ph1vq2phrp.Calendar")
- || (appcontrolID == L"vxqbrefica.Email")
- || (appcontrolID == L"kto5jikgul.Settings")
- || (appcontrolID == L"8r4r5ddzzn.Messages")
- || (appcontrolID == L"dhrul6qzj3.MusicPlayer")
- || (appcontrolID == L"smemo-efl"));
-}
-
result
_AppControlImpl::Stop(void)
{
- const String appcontrolID(GetAppControlProviderId());
- SysTryReturnResult(NID_APP, IsValidAppControl(appcontrolID), E_INVALID_OPERATION, "Invalid appcontrolID(%ls)", appcontrolID.GetPointer());
-
+ result r = E_SUCCESS;
result (*pStop)(int req) = null;
- if (_reqId != _REQ_ID_INVALID)
+ if (_reqId != APPCONTROL_REQUEST_ID_INVALID)
{
_InProcessInfo* pInfo = _AppControlManager::GetInstance()->__inAppManager.FindItem(_reqId);
SysTryReturnResult(NID_APP, pInfo != null, E_INVALID_OPERATION, "Request ID %d is not found.", _reqId);
if (pInfo->pProvider)
{
- pInfo->pProvider->StopAppControlPlugin(_reqId);
+ r = pInfo->pProvider->StopAppControlPlugin(_reqId);
}
_AppControlManager::GetInstance()->__inAppManager.RemoveItem(_reqId);
- _reqId = _REQ_ID_INVALID;
+ _reqId = APPCONTROL_REQUEST_ID_INVALID;
}
else
{
_IAppControlPluginProvider* pProvider = GetAppControlPluginProvider(_path);
if (pProvider)
{
- pProvider->StopAppControlPlugin(-1);
- SysLog(NID_APP, "Request is stopped.");
+ r = pProvider->StopAppControlPlugin(-1);
pProvider->Release();
}
}
- return E_SUCCESS;
+ SysLog(NID_APP, "[%s] Request is stopped.", GetErrorMessage(r));
+
+ return r;
}
String
-_AppControlImpl::GetAppName(void)
+_AppControlImpl::GetAppName(void) const
{
if (_appName.IsEmpty())
{
AppId appId = GetAppId();
- AppId aliasAppId = _AppControlRegistry::GetInstance()->GetAliasAppId(appId);
+ const AppId& aliasAppId = _AppControlRegistry::GetInstance()->GetAliasAppId(appId);
if (!aliasAppId.IsEmpty())
{
appId = aliasAppId;
}
+ appId = _Aul::GetRealAppId(appId);
+
std::unique_ptr<PackageAppInfo> pInfo(_PackageManagerImpl::GetInstance()->GetPackageAppInfoN(appId));
if (pInfo.get())
{
- SysLog(NID_APP, "PackageInfo of appId(%ls) exists", appId.GetPointer());
- const String& name = pInfo->GetAppName();
- if (name == L"_AppControl")
- {
- // workaround for special case: requery with actual appId
- const PackageId& packageId = _PackageManagerImpl::GetPackageIdByAppId(appId);
- const String& defaultName = _PackageManagerImpl::GetInstance()->GetDefaultAppExecutableName(packageId);
-
- const String& convertedAppId = packageId + L'.' + defaultName;
-
- std::unique_ptr<PackageAppInfo> pNewInfo(_PackageManagerImpl::GetInstance()->GetPackageAppInfoN(convertedAppId));
-
- if (pNewInfo.get())
- {
- _appName = pNewInfo->GetAppDisplayName();
- }
- else
- {
- SysLog(NID_APP, "No default applicaiton information, possible database error.");
- }
- }
- else
- {
- _appName = pInfo->GetAppDisplayName();
- }
+ SysLog(NID_APP, "PackageInfo of [%ls] exists.", appId.GetPointer());
+ _appName = pInfo->GetAppDisplayName();
}
else
{
- SysLog(NID_APP, "PackageInfo of appId(%ls) does not exist", appId.GetPointer());
+ SysLog(NID_APP, "PackageInfo of [%ls] does not exist.", appId.GetPointer());
}
}
return _appName;
}
-String
-_AppControlImpl::GetAppId(void) const
-{
- return _appId;
-}
-
-const String&
-_AppControlImpl::GetAppControlProviderId(void) const
-{
- return _appId;
-}
-
-const String&
-_AppControlImpl::GetOperationId(void) const
-{
- return _opId;
-}
IList*
_AppControlImpl::GetCategoryListN(void) const
AppId appId = GetAppId();
SysTryReturn(NID_APP, !appId.IsEmpty(), null, E_SYSTEM, "[E_SYSTEM] Empty appId.");
- AppId aliasAppId = _AppControlRegistry::GetInstance()->GetAliasAppId(appId);
+ const AppId& aliasAppId = _AppControlRegistry::GetInstance()->GetAliasAppId(appId);
if (!aliasAppId.IsEmpty())
{
appId = aliasAppId;
#include <FAppSqlDataControl.h>
#include <FAppMapDataControl.h>
#include <FAppPkgPackageInfo.h>
+#include <FAppPkgPackageAppInfo.h>
#include <FBaseSysLog.h>
#include <FBase_StringConverter.h>
return E_SUCCESS;
}
+
+String
+_AppControlManager::GetMimeTypeFromDataType(const String& data)
+{
+ // Data type is either MIME type or .[extension]
+
+ if (data.IsEmpty() || data[0] != L'.')
+ {
+ return data;
+ }
+
+ // .[extension]
+ String ext;
+ data.SubString(1, ext);
+
+ String res;
+ result r = _AppControlManager::GetMimeFromExt(ext, res);
+ SysTryReturn(NID_APP, !IsFailed(r), L"", r, "[%s] MIME type conversion failed for %ls.", GetErrorMessage(r), ext.GetPointer());
+
+ SysLog(NID_APP, "Conversion from %ls into %ls.", data.GetPointer(), res.GetPointer());
+ return res;
+}
+
+
void
_AppControlManager::OnAppControlEventReceivedN(int reqId, _AppArg* pAppArg, int res)
{
_InProcessInfo* pInfo = __inAppManager.FindItem(reqId);
SysTryReturnVoidResult(NID_APP, pInfo != null, E_OBJ_NOT_FOUND, "[E_OBJ_NOT_FOUND] request Id %d not found.", reqId);
- // at least listener
IAppControlResponseListener* pListener = dynamic_cast<IAppControlResponseListener*>(pInfo->pListener);
- SysTryReturnVoidResult(NID_APP, pListener != null, E_SYSTEM, "[E_SYSTEM] Invalid result callback for req %d, app %ls.", reqId, appId.GetPointer());
+ if (pListener == null)
+ {
+ SysLog(NID_APP, "Empty AppControl listener callback for req %d, app %ls.", reqId, appId.GetPointer());
+ return;
+ }
result r = E_SUCCESS;
- if (pListener)
+ AppId actualAppId = appId;
+ if (appId == L'c')
{
- AppId actualAppId = appId;
- if (appId == L'c')
- {
- actualAppId.Clear();
- r = E_OPERATION_CANCELED;
- }
- SysLog(NID_APP, "Invoking callback 0x%x.", pListener);
+ actualAppId.Clear();
+ r = E_OPERATION_CANCELED;
+ }
+ SysLog(NID_APP, "Invoking callback 0x%x.", pListener);
- _AppControlResponseEvent* pResponseEvent = null;
- __appControlResponseEventContainer.GetValue(reqId, pResponseEvent);
- SysLog(NID_APP, "StartResponseReceived Request Id(%d), ResponseEvent 0x%x.", reqId, pResponseEvent);
- if (pResponseEvent != null)
- {
- String oId(operationId);
- _AppControlResponseEventArg* pResponseEventArg = new (std::nothrow) _AppControlResponseEventArg(pListener, _APPCONTROL_RESPONSETYPE_START, actualAppId, oId, r, APP_CTRL_RESULT_SUCCEEDED, null, reqId, false);
+ _AppControlResponseEvent* pResponseEvent = null;
+ __appControlResponseEventContainer.GetValue(reqId, pResponseEvent);
+ SysLog(NID_APP, "StartResponseReceived Request Id(%d), ResponseEvent 0x%x.", reqId, pResponseEvent);
+ if (pResponseEvent != null)
+ {
+ String oId(operationId);
+ _AppControlResponseEventArg* pResponseEventArg = new (std::nothrow) _AppControlResponseEventArg(pListener, _APPCONTROL_RESPONSETYPE_START, actualAppId, oId, r, APP_CTRL_RESULT_SUCCEEDED, null, reqId, false);
- if (pResponseEventArg != null)
- {
- pResponseEvent->Fire(*pResponseEventArg);
- SysLog(NID_APP, "pResponseEvent is Fired");
- }
- }
- else
+ if (pResponseEventArg != null)
{
- pListener->OnAppControlStartResponseReceived(actualAppId, operationId, r);
- SysLog(NID_APP, "OnAppControlStartResponseReceived called directly");
+ pResponseEvent->Fire(*pResponseEventArg);
+ SysLog(NID_APP, "pResponseEvent is Fired");
}
}
else
{
- SysLog(NID_APP, "No listener registered.");
+ pListener->OnAppControlStartResponseReceived(actualAppId, operationId, r);
+ SysLog(NID_APP, "OnAppControlStartResponseReceived called directly");
}
if (r == E_OPERATION_CANCELED)
}
else
{
- SysLogException(NID_APP, E_SYSTEM, "Invalid AppControl listener.");
+ SysLog(NID_APP, "Empty AppControl listener.");
}
-#if 0
- // [FIXME] following logic is not needed.
- // call TerminateAppControl
- if (pInfo->pProvider)
- {
- pInfo->pProvider->StopAppControlPlugin(pInfo->reqId);
- SysLog(NID_APP, "AppControl stopped for req %d.", pInfo->reqId);
- }
-#endif
// remove from list and unload dll
__inAppManager.RemoveItem(reqId);
_InProcessInfo* pProcInfo = __inAppManager.FindItemWithListener(IsMatchingProcListener, pListener);
if (pProcInfo)
{
- __inAppManager.RemoveItem(pProcInfo);
+ pProcInfo->pListener = null;
SysLog(NID_APP, "Listener 0x%x is removed from in-process stub list.", pListener);
}
}
result
-_AppControlManager::LaunchPkg(const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data)
-{
- _AppMessageImpl msg;
-
- return LaunchPkg(msg, pkg_name, op, mime, uri, pCb, data);
-}
-
-result
-_AppControlManager::LaunchAppWithCondition(const AppId& appId, const String& condition, IList* pArrayArgs)
-{
- result r = E_SUCCESS;
- _AppArg * pArg = new (std::nothrow) _AppArg();
- SysTryCatch(NID_APP, pArg != null, r = E_OUT_OF_MEMORY, E_OUT_OF_MEMORY, "[E_OUT_OF_MEMORY]");
-
- r = pArg->ConstructForAppLaunchCondition(condition, pArrayArgs);
- SysTryCatch(NID_APP, !IsFailed(r), , r, "[%s] ConstructForAppLaunchCondition(%ls, .. ) fails", GetErrorMessage(r), condition.GetPointer());
-
- r = _AppControlManager::LaunchApp(appId, pArg);
-CATCH:
- delete pArg;
- return r;
-}
-
-result
_AppControlManager::LaunchApp(const AppId& appId, _AppArg* pArg, int req)
{
SysTryReturnResult(NID_APP, pArg != null, E_INVALID_ARG, "Invalid launch argument");
SysLog(NID_APP, "App: %ls.", appId.GetPointer());
String actualAppId = appId;
+#if 0
+ // This logic is only for very old legacy code to support "pkgid" launch and should be removed
if (appId.GetLength() == 10)
{
const String& name = _PackageManagerImpl::GetInstance()->GetDefaultAppExecutableName(appId);
actualAppId.Append(name);
}
}
+#endif
pArg->UpdateRequestId(req);
int pid = -1;
bundle* kb = NULL;
- String tempId;
- actualAppId.SubString(0, 10, tempId);
- tempId += L'.';
- tempId += L"_AppControl";
- // [INFO] Ugly solution for submode support
- pArg->UpdateAppId(tempId);
- kb = pArg->GetBundle();
-
- pid = appsvc_run_service(kb, req, LaunchResultCb, this);
- if (pid >= 0)
- {
- SysLog(NID_APP, "Submode launch successful");
- return E_SUCCESS;
- }
- else if (pid == APPSVC_RET_EINVAL)
+ std::unique_ptr< PackageAppInfo > pAppInfo(_PackageManagerImpl::GetInstance()->GetPackageAppInfoN(appId));
+ SysTryReturn(NID_APP, pAppInfo != null, E_SYSTEM, GetLastResult(), "[%s] Getting AppInfo failed.", GetErrorMessage(GetLastResult()));
+ _PackageAppInfoImpl* pAppInfoImpl = _PackageAppInfoImpl::GetInstance(pAppInfo.get());
+ SysTryReturnResult(NID_APP, pAppInfoImpl != null , E_SYSTEM, "Severe system error");
+
+ if (pAppInfoImpl->IsServiceApp() == false)
{
- SysLog(NID_APP, "Argument overflow");
- return E_MAX_EXCEEDED;
+ String tempId;
+ actualAppId.SubString(0, 10, tempId);
+ tempId += L'.';
+ tempId += String(SUBMODE_NAME);
+
+ // [INFO] Ugly solution for submode support
+ pArg->UpdateAppId(tempId);
+ kb = pArg->GetBundle();
+
+ pid = appsvc_run_service(kb, req, LaunchResultCb, this);
+ if (pid >= 0)
+ {
+ SysLog(NID_APP, "Submode launch successful");
+ return E_SUCCESS;
+ }
+ else if (pid == APPSVC_RET_EINVAL)
+ {
+ SysLog(NID_APP, "Argument overflow");
+ return E_MAX_EXCEEDED;
+ }
}
pArg->UpdateAppId(actualAppId);
if ((!(type & _APP_TYPE_SERVICE_APP)) && _IsDefaultApplication(tempId, appId))
{
tempId += L'.';
- tempId += L"_AppControl";
+ tempId += String(SUBMODE_NAME);
// [INFO] Ugly solution for submode support
pArg->UpdateAppId(tempId);
result r = resArg.ConstructResult(arg, pResultList);
if (IsFailed(r))
{
+ // erase _AppArg after sending the result back to the caller
+ pAppMgr->__resultManager.RemoveItem(reqId);
+
SysPropagate(NID_APP, r);
return r;
}
- const bool isService = _AppInfo::GetAppType() & _APP_TYPE_SERVICE_APP;
-
- //resArg.Print();
- r = _Aul::SendResult(resArg.GetBundle(), static_cast<appsvc_result_val>(0), _AppInfo::IsSubMode(), isService);
- SysLog(NID_APP, "Sent AppControl event for %d.", reqId);
+ r = SendAppControlResultPrimitive(reqId, resArg, 0);
// erase _AppArg after sending the result back to the caller
pAppMgr->__resultManager.RemoveItem(reqId);
result r = resArg.ConstructResult(arg, pResultMap);
if (IsFailed(r))
{
+ // erase _AppArg after sending the result back to the caller
+ pAppMgr->__resultManager.RemoveItem(reqId);
+
SysPropagate(NID_APP, r);
return r;
}
break;
}
- const bool isService = _AppInfo::GetAppType() & _APP_TYPE_SERVICE_APP;
-
- //resArg.Print();
- r = _Aul::SendResult(resArg.GetBundle(), static_cast<appsvc_result_val>(res), _AppInfo::IsSubMode(), isService);
- SysLog(NID_APP, "Sent AppControl event for %d.", reqId);
+ r = SendAppControlResultPrimitive(reqId, resArg, res);
// erase _AppArg after sending the result back to the caller
pAppMgr->__resultManager.RemoveItem(reqId);
return r;
}
+
+result
+_AppControlProviderManagerImpl::SendAppControlResultPrimitive(RequestId reqId, _AppArg& arg, int ret)
+{
+ static bool firstRequestSent = false;
+
+ if (reqId == 0 && firstRequestSent)
+ {
+ SysLog(NID_APP, "Sent main AppControl request already.");
+
+ return E_SUCCESS;
+ }
+ else
+ {
+ if (reqId == 0)
+ {
+ firstRequestSent = true;
+ }
+
+ const bool isService = _AppInfo::GetAppType() & _APP_TYPE_SERVICE_APP;
+
+ //resArg.Print();
+ result r = _Aul::SendResult(arg.GetBundle(), static_cast<appsvc_result_val>(ret), _AppInfo::IsSubMode(), isService);
+ SysLog(NID_APP, "Sent AppControl event for %d.", reqId);
+
+ return r;
+ }
+}
+
+
AppId
_AppControlProviderManagerImpl::GetClientAppId(RequestId reqId) const
{
#include <FOspConfig.h>
#include <FBaseObject.h>
#include <FBaseDataType.h>
-#include <FBaseColIListT.h>
namespace Tizen { namespace Base
{
}}
namespace Tizen { namespace Base { namespace Collection { class IList; } } }
+namespace Tizen { namespace Base { namespace Collection { class IMap; } } }
namespace Tizen { namespace App
{
class AppControlProviderManager;
class IAppControlProviderEventListener;
+class _AppArg;
/**
* @class _AppControlProviderManagerImpl
* The %_AppControlProviderManagerImpl class manages all the application controls.
*/
class _AppControlProviderManagerImpl
- : public Tizen::Base::Object
{
public:
/**
* This is the destructor for this class.
*/
- virtual ~_AppControlProviderManagerImpl(void);
+ ~_AppControlProviderManagerImpl(void);
/**
* This is the default copy constructor for this class.
*/
_AppControlProviderManagerImpl& operator =(const _AppControlProviderManagerImpl& rhs);
+ result SendAppControlResultPrimitive(RequestId reqId, _AppArg& arg, int ret);
+
friend class AppControlProviderManager;
};
const wchar_t ACTL_LEGACY_FILE[] = L"/usr/etc/app-control-alias.ini";
const wchar_t ACTL_DEFAULT_PLUGIN[] = L"libosp-ac-platform.so";
-const wchar_t TIZEN_ALIAS_APPID_PREFIX[] = L"tizen.";
-
const String ACTL_REGISTRY_PATH = L"Path";
const String ACTL_REGISTRY_ALIAS_PROVIDER = L"PROVIDER_ALIAS";
-const int PKG_APPID_LEN = 256;
const int REG_VALUE_BUFFER_LEN = 256;
}
}
free(pBuf);
}
- else
- {
- SysLog(NID_APP, "It is failed to get multi-window value: %d", errVal);
- }
// call for callbacks
// ptr to member function
#include <FBase_StringConverter.h>
#include "FAppPkg_PackageInfoImpl.h"
+#include "FApp_Aul.h"
#include "FApp_AppInfo.h"
using namespace Tizen::App::Package;
: __appState(TERMINATED)
, __appType(_APP_TYPE_NONE)
, __appRootDirFd(-1)
+ , __appSdDirFd(-1)
, __appHandlerType(_APP_HANDLER_NONE)
, __parentWindowHandle(-1)
, __pAppName(null)
// closing may or may not succeed
close(__appRootDirFd);
+ close(__appSdDirFd);
}
_AppInfo*
const char* pPackageId = appinfo_get_packageid();
const char* pExecName = appinfo_get_execname();
-
if (strncmp(pExecName, SUBMODE_NAME, strlen(SUBMODE_NAME)) == 0)
{
SysLog(NID_APP, "Handling for submode.");
- const String& name = _PackageManagerImpl::GetInstance()->GetDefaultAppExecutableName(String(pPackageId));
-
- __isSubMode = true;
- std::unique_ptr<char[]> pActualExec(_StringConverter::CopyToCharArrayN(name));
- appinfo_update_submode_execname_and_appid(pActualExec.get());
- SysLog(NID_APP, "Executable name is changed to %s.", pActualExec.get());
+ const char* pAppId = appinfo_get_appid();
+ const String& mainId = _Aul::GetMainAppId(pAppId);
+ if (!mainId.IsEmpty())
+ {
+ std::unique_ptr<char[]> pMainId(_StringConverter::CopyToCharArrayN(mainId));
+ appinfo_update_submode_appid(pMainId.get());
+
+ __isSubMode = true;
+
+ SysLog(NID_APP, "Executable name is changed to %s.", pMainId.get());
+ }
}
result r = E_SUCCESS;
pFile = fdopen(fd, "r");
SysTryCatch(NID_APP, pFile != NULL, r = E_SYSTEM, E_SYSTEM, "[E_SYSTEM] Opening appinfo file (%s) failed : %s.", appInfoPath, strerror(errno));
+ // sdcard
+ char sdInfoPath[PATH_MAX] = {0, };
+ strncpy(sdInfoPath, "/opt/storage/sdcard/app2sd/", strlen("/opt/storage/sdcard/app2sd/"));
+ strncat(sdInfoPath, pPackageId, MAX_APPID);
+
+ __appSdDirFd = open(sdInfoPath, O_RDONLY);
+ SysLog(NID_APP, "sd root directory (%s:%d) open.", sdInfoPath, __appSdDirFd);
+
char apiVersion[MAX_APIVERSION] = {0, };
char* pRet = fgets(apiVersion, MAX_APIVERSION - 1, pFile);
SysTryCatch(NID_APP, pRet != NULL, r = E_SYSTEM, E_SYSTEM, "[E_SYSTEM] Reading appinfo file (%s) failed : %s.", appInfoPath, strerror(errno));
if (pDataType)
{
- if ((*pDataType)[0] == L'.')
- {
- SysLog(NID_APP, "Extension to MIME conversion for %ls", pDataType->GetPointer());
-
- String ext;
- pDataType->SubString(1, ext);
-
- result r = _AppControlManager::GetMimeFromExt(ext, mimeType);
-
- SysTryReturn(NID_APP, !IsFailed(r), null, r, "[%s] MIME type conversion failure for %ls.", GetErrorMessage(r), ext.GetPointer());
-
- pMimeType = &mimeType;
-
- SysLog(NID_APP, "Conversion : %ls -> %ls.", pDataType->GetPointer(), pMimeType->GetPointer());
- }
+ mimeType = _AppControlManager::GetMimeTypeFromDataType(*pDataType);
}
if (pUriScheme)
if (pDataType)
{
- String mimeType = *pDataType;
-
- if ((*pDataType)[0] == L'.')
- {
- SysLog(NID_APP, "Extension to MIME conversion for %ls", pDataType->GetPointer());
-
-#if 0
- String ext;
- pDataType->SubString(1, ext);
-
- result r = _AppControlManager::GetMimeFromExt(ext, mimeType);
-
- SysTryReturn(NID_APP, !IsFailed(r), null, r, "[%s] MIME type conversion failure for %ls.", GetErrorMessage(r), ext.GetPointer());
-
- pMimeType = &mimeType;
-
- SysLog(NID_APP, "Conversion : %ls -> %ls.", pDataType->GetPointer(), pMimeType->GetPointer());
-#endif
- }
+ const String& mimeType = _AppControlManager::GetMimeTypeFromDataType(*pDataType);
_AppMessageImpl::SetMime(pBundle.get(), mimeType);
}
_IAppEventListener* pListener = null;
pEnum->GetCurrent(pListener);
- pListener->OnApplicationLaunched(tmp, pid);
+ if (pListener && _AppInfo::GetAppState() == RUNNING)
+ {
+ pListener->OnApplicationLaunched(tmp, pid);
+ }
}
}
_IAppEventListener* pListener = null;
pEnum->GetCurrent(pListener);
- pListener->OnApplicationTerminated(tmp, pid);
+ if (pListener && _AppInfo::GetAppState() == RUNNING)
+ {
+ pListener->OnApplicationTerminated(tmp, pid);
+ }
}
}
r = E_SUCCESS;
}
+ reg.Flush();
delete pReglock;
}
return r;
#include <FAppPkgPackageInfo.h>
#include <FAppPkgPackageManager.h>
#include <FAppIAppSettingEventListener.h>
-#include <FSec_AccessController.h>
#include "FApp_AppSettingImpl.h"
#include "FApp_AppInfo.h"
#include "FAppPkg_PackageManagerImpl.h"
using namespace Tizen::Base;
using namespace Tizen::Base::Collection;
using namespace Tizen::Io;
-using namespace Tizen::Security;
using namespace Tizen::App;
AppSetting* pAppSettingInstance = null;
String* pKeyStr = null;
- r = _AccessController::CheckUserPrivilege(_PRV_APPSETTING);
- SysTryReturn(NID_APP, !IsFailed(r), null, E_PRIVILEGE_DENIED,
- "[%s] The application does not have the privilege to call this method.", GetErrorMessage(E_PRIVILEGE_DENIED));
-
// Convert AppId to package type id.
String packageId;
appId.SubString(0, APP_ID_LENTH, packageId);
result
_AppSettingImpl::_MutiInstanceManager::ReleaseInstanceByAppId(const AppId& appId)
{
- result r = _AccessController::CheckUserPrivilege(_PRV_APPSETTING);
- SysTryReturnResult(NID_APP, !IsFailed(r), E_PRIVILEGE_DENIED,
- "The application does not have the privilege to call this method.");
-
// Convert AppId to package type id.
String packageId;
appId.SubString(0, APP_ID_LENTH, packageId);
#include <bundle.h>
#include <appsvc/appsvc.h>
#include <vconf.h>
+#include <pkgmgr-info.h>
#include <FBaseObject.h>
#include <FBaseString.h>
}
+String
+_Aul::GetMainAppId(const char* appid)
+{
+ pkgmgrinfo_appinfo_h handle = NULL;
+ int ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
+ if (ret != PMINFO_R_OK)
+ {
+ return String();
+ }
+
+ char* mainid = NULL;
+ ret = pkgmgrinfo_appinfo_get_submode_mainid(handle, &mainid);
+ SysTryLog(NID_APP, ret == PMINFO_R_OK, "Cannot get main id for %s.", appid);
+
+ const String tmp = String(mainid);
+ pkgmgrinfo_appinfo_destroy_appinfo(handle);
+ return tmp;
+}
+
+
AppId
_Aul::GetRealAppId(const AppId& appId)
{
String temp;
- // [INFO] ugly code for submode callee
appId.SubString(11, temp);
- if (temp == L"_AppControl")
+ if (temp == String(SUBMODE_NAME))
{
- String id;
- appId.SubString(0, 10, id);
- const String& name = _PackageManagerImpl::GetInstance()->GetDefaultAppExecutableName(id);
-
- const String retVal = id + L'.' + name;
- SysLog(NID_APP, "Converted caller Id is %ls", retVal.GetPointer());
-
- return retVal;
- }
- else
- {
- return appId;
+ std::unique_ptr<char[]> pAppId(_StringConverter::CopyToCharArrayN(appId));
+ const String& main = GetMainAppId(pAppId.get());
+ if (!main.IsEmpty())
+ {
+ SysLog(NID_APP, "main Id is %ls", main.GetPointer());
+ return main;
+ }
}
+
+ return appId;
}
} } // Tizen::App
#include "FApp_NotificationManagerImpl.h"
#include "FApp_INotificationManagerImpl.h"
+#include "FAppNotificationManager.h"
using namespace Tizen::Base;
using namespace Tizen::Base::Runtime;
{
SysTryReturn(NID_APP, __pNotiImpl != null, -1, E_SYSTEM, "[E_SYSTEM] Notification interface error.");
- return __pNotiImpl->GetBadgeNumber();
+ int res = __pNotiImpl->GetBadgeNumber();
+ if (GetLastResult() == E_OPERATION_FAILED)
+ {
+ SetLastResult(E_SUCCESS);
+ return -1;
+ }
+ return res;
}
_NotificationManagerImpl::Notify(int badgeNumber) const
{
SysTryReturnResult(NID_APP, __pNotiImpl != null, E_SYSTEM, "Notification interface error.");
+ SysTryReturnResult(NID_APP, badgeNumber >= 0, E_INVALID_ARG, "badgeNumber is less than 0.");
String messageText = String(L"");
String appMessage = String(L"");
_NotificationManagerImpl::Notify(const String& messageText, int badgeNumber) const
{
SysTryReturnResult(NID_APP, __pNotiImpl != null, E_SYSTEM, "Notification interface error.");
+ SysTryReturnResult(NID_APP, badgeNumber >= 0, E_INVALID_ARG, "badgeNumber is less than 0.");
String appMessage = String(L"");
_NotificationManagerImpl::Notify(const String& messageText, int badgeNumber, const String& launchArguments) const
{
SysTryReturnResult(NID_APP, __pNotiImpl != null, E_SYSTEM, "Notification interface error.");
+ SysTryReturnResult(NID_APP, badgeNumber >= 0, E_INVALID_ARG, "badgeNumber is less than 0.");
return __pNotiImpl->Notify(messageText, badgeNumber, launchArguments);
}
{
SysTryReturn(NID_APP, __pNotiImpl != null, -1, E_SYSTEM, "[E_SYSTEM] Notification interface error.");
- return __pNotiImpl->GetBadgeNumber(appId);
+
+ const int ret = __pNotiImpl->GetBadgeNumber(appId);
+ result r = GetLastResult();
+ if (r == E_APP_NOT_INSTALLED)
+ {
+ SetLastResult(E_OBJ_NOT_FOUND);
+ }
+
+ if (GetLastResult() == E_OPERATION_FAILED)
+ {
+ SetLastResult(E_SUCCESS);
+ return -1;
+ }
+ return ret;
}
_NotificationManagerImpl::NotifyOnBehalf(const AppId& appId, const String& messageText, const String& launchArguments) const
{
SysTryReturnResult(NID_APP, __pNotiImpl != null, E_SYSTEM, "Notification interface error.");
+ SysTryReturnResult(NID_APP, launchArguments.GetLength() <= MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH, E_INVALID_ARG,
+ "launchArguments is greater than MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.");
return __pNotiImpl->NotifyByAppId(appId, messageText, -1, launchArguments);
}
SysTryReturnResult(NID_APP, __pNotiImpl != null, E_SYSTEM, "Notification interface error.");
SysTryReturnResult(NID_APP, badgeNumber >= 0, E_INVALID_ARG, "BadgeNumber is less than 0.");
+ SysTryReturnResult(NID_APP, launchArguments.GetLength() <= MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH, E_INVALID_ARG,
+ "launchArguments is greater than MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.");
+
return __pNotiImpl->NotifyByAppId(appId, messageText, badgeNumber, launchArguments);
}
{
SysTryReturnResult(NID_APP, __pNotiImpl != null, E_SYSTEM, "Notification interface error.");
- return __pNotiImpl->NotifyOngoingActivity(messageText, String(L""));
+ return __pNotiImpl->NotifyOngoingActivity(messageText);
}
_NotificationManagerImpl::NotifyOngoingActivity(const String& messageText, const String& launchArguments) const
{
SysTryReturnResult(NID_APP, __pNotiImpl != null, E_SYSTEM, "Notification interface error.");
+ SysTryReturnResult(NID_APP, launchArguments.GetLength() <= MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH, E_INVALID_ARG,
+ "launchArguments is greater than MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.");
return __pNotiImpl->NotifyOngoingActivity(messageText, launchArguments);
}
_NotificationManagerImpl::NotifyOngoingActivityOnBehalf(const AppId& appId, const String& messageText) const
{
SysTryReturnResult(NID_APP, __pNotiImpl != null, E_SYSTEM, "Notification interface error.");
+ SysTryReturnResult(NID_APP, !messageText.IsEmpty(), E_INVALID_ARG, "MessageText is less than 0.");
return __pNotiImpl->NotifyOngoingActivityByAppId(appId, messageText, String(L""));
}
const String& launchArguments) const
{
SysTryReturnResult(NID_APP, __pNotiImpl != null, E_SYSTEM, "Notification interface error.");
+ SysTryReturnResult(NID_APP, !messageText.IsEmpty(), E_INVALID_ARG, "MessageText is less than 0.");
return __pNotiImpl->NotifyOngoingActivityByAppId(appId, messageText, launchArguments);
}
bool OnCategoryValue(const char* pCharacters);
bool ParseAppAttribute(_PackageXmlAttribute* pAttr, bool isUiApp);
+ bool FindElement(const char* pName);
+ result GetLocale(Tizen::Base::String& value);
private:
_PackageInfoImpl* __pPackageInfoImpl;
/**
* Internal GetImpl() method.
*/
- static const _AppControlImpl* GetInstance(const AppControl& ac);
+ static const _AppControlImpl* GetInstance(const AppControl& ac)
+ {
+ return ac.__pAppControlImpl;
+ }
/**
* Internal GetImpl() method.
*/
- static _AppControlImpl* GetInstance(AppControl& ac);
+ static _AppControlImpl* GetInstance(AppControl& ac)
+ {
+ return ac.__pAppControlImpl;
+ }
/**
* Starts the resolved application control. @n
*
* @return The name of the application providing this %_AppControlImpl instance
*/
- Tizen::Base::String GetAppName(void);
+ Tizen::Base::String GetAppName(void) const;
/**
* Gets the associated application ID. @n
*
* @return The application control ID
*/
- Tizen::Base::String GetAppId(void) const;
+ Tizen::Base::String GetAppId(void) const
+ {
+ return _appId;
+ }
/**
* Gets the associated application control provider ID. @n
*
* @return The application control provider ID
*/
- const Tizen::Base::String& GetAppControlProviderId(void) const;
+ Tizen::Base::String GetAppControlProviderId(void) const
+ {
+ return _appId;
+ }
/**
* Gets the associated operation ID. @n
*
* @return The operation ID
*/
- const Tizen::Base::String& GetOperationId(void) const;
+ Tizen::Base::String GetOperationId(void) const
+ {
+ return _opId;
+ }
/**
* Returns the associated application control categories.
virtual void OnAppControlResponseEventReceivedN(const Tizen::Base::Runtime::IEventArg* arg);
private:
- _AppControlImpl(const AppControl& value);
+ explicit _AppControlImpl(const AppControl& value);
/**
* This is the default constructor for this class.
Tizen::Base::String _path;
Tizen::Base::String _appId;
Tizen::Base::String _opId;
- Tizen::Base::String _appName;
+ mutable Tizen::Base::String _appName;
int _reqId;
int _property;
int _processId;
int Launch(const _AppMessageImpl& msg, AppSvcResFn pCb, void* pData, int req = -1);
/**
- * Launch with pkgname.(osp-app-service : AppService.cpp)
- */
- result LaunchPkg(const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
-
- /**
* Launch with pkgname.(osp-uifw : FUiCtrl_EditCopyPasteManager.cpp)
*/
result LaunchPkg(_AppMessageImpl& msg, const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
int Launch(_AppMessageImpl& msg, const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
- result LaunchAppWithCondition(const AppId& appId, const Tizen::Base::String& condition, Tizen::Base::Collection::IList* pArgs);
-
result SendAppControlStartResponse(int req, const char* pValue, const char* pOp);
+ _OSP_LOCAL_ static Tizen::Base::String GetMimeTypeFromDataType(const Tizen::Base::String& dataType);
+
static result GetMimeFromExt(const Tizen::Base::String& ext, Tizen::Base::String& out);
void RemoveLaunchRequest(int req);
AppState __appState;
int __appType;
int __appRootDirFd;
+ int __appSdDirFd;
int __appHandlerType;
int __parentWindowHandle;
Tizen::Base::String __appRootPath;
static bool IsInstalled(const AppId& appId);
+ _OSP_LOCAL_ static Tizen::Base::String GetMainAppId(const char* appid);
+
_OSP_LOCAL_ static AppId GetRealAppId(const AppId& appId);
public:
virtual result RemoveNotification(void) = 0;
/**
+ * Notifies the user about the ongoing activity using a message.
+ *
+ * @return An error code
+ * @param[in] messageText The notification message
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid, or
+ * the length of @c messageText is greater than Shell::MAX_NOTIFICATION_MESSAGE_LENGTH.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_INVALID_OPERATION The type of application calling this method is invalid as per the Tizen platform policy.
+ * @exception E_INVALID_STATE This instance is in an invalid state. @n
+ * The Construct() method is not called.
+ */
+ virtual result NotifyOngoingActivity(const Tizen::Base::String& messageText) = 0;
+
+ /**
* Notifies the user about the ongoing activity using a message. @n
* @c launchArguments is specified as input parameter for Application::OnUserEventReceivedN() or can be obtained by
* invoking Application::GetAppArgumentListN(), especially within Application::OnAppInitializing().
const int APPSVC_OSP_RES_TERMINATE = -14;
const int LAUNCH_ARG_META_COUNT = 3;
+const int APPCONTROL_REQUEST_ID_INVALID = -1;
_OSP_LOCAL_ extern const wchar_t LEGACY_LAUNCH_REASON_NORMAL[];
_OSP_LOCAL_ extern const wchar_t LEGACY_LAUNCH_REASON_CONDITIONAL[];
_OSP_LOCAL_ extern const wchar_t TIZEN_OPERATION_MAIN[];
_OSP_EXPORT_ extern const wchar_t TIZEN_OPERATION_PICK[];
_OSP_LOCAL_ extern const char TIZEN_NOTIFICATION_DATA[];
+_OSP_LOCAL_ extern const char SUBMODE_NAME[];
+
+_OSP_EXPORT_ extern const char IPC_SERVER_NAME[];
+_OSP_EXPORT_ extern const char CONDITION_MANAGER_IPC_NAME[];
+_OSP_EXPORT_ extern const char PACKAGE_MANAGER_IPC_NAME[];
_OSP_EXPORT_ extern const char IPC_SERVER_NAME[];
_OSP_EXPORT_ extern const char CONDITION_MANAGER_IPC_NAME[];
namespace Tizen { namespace App { namespace Package
{
-PackageManager* pPackageManagerInstance = null;
-
Tizen::Base::Collection::HashMap _PackageManagerImpl::__installationList;
void
{
SysTryReturn(NID_APP, appId.IsEmpty() == false, L"", E_INVALID_ARG, "appId is empty");
- String packageId;
-
- if (appId.StartsWith(L".", 10) == true)
- {
- appId.SubString(0, 10, packageId);
- }
- else
- {
- int result = 0;
- char* pPackageId = null;
- pkgmgrinfo_appinfo_h pAppInfoHandle = null;
+ PackageId packageId;
+ int result = 0;
+ char* pPackageId = null;
+ pkgmgrinfo_appinfo_h pAppInfoHandle = null;
- std::unique_ptr<char[]> pAppId(_StringConverter::CopyToCharArrayN(appId));
- SysTryReturn(NID_APP, pAppId, L"", E_OUT_OF_MEMORY, "pAppId is null");
+ std::unique_ptr<char[]> pAppId(_StringConverter::CopyToCharArrayN(appId));
+ SysTryReturn(NID_APP, pAppId, L"", E_OUT_OF_MEMORY, "pAppId is null");
- result = pkgmgrinfo_appinfo_get_appinfo(pAppId.get(), &pAppInfoHandle);
- SysTryReturn(NID_APP, result == 0, L"", E_PKG_NOT_INSTALLED, "pkgmgrinfo_appinfo_get_appinfo() failed. result=[%d], app=[%s]", result, pAppId.get());
+ result = pkgmgrinfo_appinfo_get_appinfo(pAppId.get(), &pAppInfoHandle);
+ SysTryReturn(NID_APP, result == 0, L"", E_PKG_NOT_INSTALLED, "pkgmgrinfo_appinfo_get_appinfo() failed. result=[%d], app=[%s]", result, pAppId.get());
- result = pkgmgrinfo_appinfo_get_pkgname(pAppInfoHandle, &pPackageId);
+ result = pkgmgrinfo_appinfo_get_pkgname(pAppInfoHandle, &pPackageId);
- packageId.Append(pPackageId);
+ packageId.Append(pPackageId);
- if(pAppInfoHandle)
- {
- pkgmgrinfo_appinfo_destroy_appinfo(pAppInfoHandle);
- }
+ if(pAppInfoHandle)
+ {
+ pkgmgrinfo_appinfo_destroy_appinfo(pAppInfoHandle);
}
SysLog(NID_APP, "app = [%ls], package = [%ls]", appId.GetPointer(), packageId.GetPointer());
SysTryReturn(NID_APP, false, null, E_UNSUPPORTED_FORMAT, "invalid extension! - packagePath = [%s], extension = [%s]", pPackagePath.get(), pExtension.get());
}
+ SetLastResult(E_SUCCESS);
return pPackageInfo.release();
}
res = false;
}
+ SetLastResult(E_SUCCESS);
return res;
}
{
result r = E_SUCCESS;
bool install = true;
+ bool move = false;
if (strcmp(pEventKey, "start") == 0)
{
- if ((strcmp(pEventValue, "install") == 0) || (strcmp(pEventValue, "uninstall") == 0))
+ if ((strcmp(pEventValue, "install") == 0)
+ || (strcmp(pEventValue, "update") == 0)
+ ||(strcmp(pEventValue, "uninstall") == 0)
+ ||(strcmp(pEventValue, "move") == 0))
{
- String* pAppId = new (std::nothrow) String(packageId);
- SysTryReturnVoidResult(NID_APP, pAppId != null, E_OUT_OF_MEMORY, "pAppId instance must not be null.");
+ PackageId* pPackageId = new (std::nothrow) String(packageId);
+ SysTryReturnVoidResult(NID_APP, pPackageId != null, E_OUT_OF_MEMORY, "pPackageId is null.");
String* pOperation = new (std::nothrow) String(pEventValue);
- SysTryReturnVoidResult(NID_APP, pOperation != null, E_OUT_OF_MEMORY, "pOperation instance must not be null.");
+ SysTryReturnVoidResult(NID_APP, pOperation != null, E_OUT_OF_MEMORY, "pOperation is null.");
- r = __installationList.Add(*pAppId, *pOperation);
+ r = __installationList.Add(*pPackageId, *pOperation);
if (IsFailed(r))
{
- delete pAppId;
+ delete pPackageId;
delete pOperation;
SysLog(NID_APP, "Failed to add installation condition.");
SetLastResult(E_SYSTEM);
else if (strcmp(pEventKey, "end") == 0)
{
String* pOperation = static_cast <String*>(__installationList.GetValue(packageId));
- if (pOperation)
- {
- if (pOperation->Equals("uninstall", true) == true)
- {
- install = false;
- }
+ SysTryReturnVoidResult(NID_APP, pOperation != null, E_SYSTEM, "pOperation is null.");
- r = __installationList.Remove(packageId, true);
- if (IsFailed(r))
- {
- SysLogException(NID_APP, r, "[%s] Remove Element [%ls] is failed from installing list.", GetErrorMessage(r), packageId.GetPointer());
- }
+ if (pOperation->Equals("uninstall", true) == true)
+ {
+ install = false;
}
+ else if (pOperation->Equals("move", true) == true)
+ {
+ move = true;
+ }
+
+ r = __installationList.Remove(packageId, true);
+ SysTryReturnVoidResult(NID_APP, !IsFailed(r), E_SYSTEM, "installationList.Remove(%ls) failed. (%s)", packageId.GetPointer(), GetErrorMessage(r));
+ }
+
+ if ((strcmp(pEventValue, "move") == 0) || (move == true))
+ {
+ SysLog(NID_APP, "Skip move event.");
+ return;
}
std::unique_ptr< IEnumeratorT<_PackageManagerEvent*> > pEnum(__packageEventListenerList.GetEnumeratorN());
bool
_PackageManagerImpl::IsAppInstalled(const AppId& appId)
{
- if (appId == _AppInfo::GetPackageId())
- {
- return true;
- }
+ SysTryReturn(NID_APP, appId.IsEmpty() == false, false, E_INVALID_ARG, "appId is empty.");
int result = 0;
- pkgmgrinfo_pkginfo_h pPackageInfoHandle = null;
+ pkgmgrinfo_appinfo_h pAppInfoHandle = null;
- std::unique_ptr<char[]> pPackageId(_StringConverter::CopyToCharArrayN(appId));
- SysTryReturn(NID_APP, pPackageId, false, E_OUT_OF_MEMORY, "pPackageId is null");
+ std::unique_ptr<char[]> pAppId(_StringConverter::CopyToCharArrayN(appId));
+ SysTryReturn(NID_APP, pAppId, false, E_OUT_OF_MEMORY, "pAppId is null.");
- result = pkgmgrinfo_pkginfo_get_pkginfo(pPackageId.get(), &pPackageInfoHandle);
- SysTryReturn(NID_APP, result == 0, false, E_APP_NOT_INSTALLED, "pkgmgrinfo_pkginfo_get_pkginfo() failed. result=[%d], package=[%s]", result, pPackageId.get());
+ result = pkgmgrinfo_appinfo_get_appinfo(pAppId.get(), &pAppInfoHandle);
+ if (result != 0)
+ {
+ SysLog(NID_APP, "pkgmgrinfo_appinfo_get_appinfo() failed. result=[%d], app=[%s]", result, pAppId.get());
+ return false;
+ }
- if(pPackageInfoHandle)
+ if(pAppInfoHandle)
{
- pkgmgrinfo_pkginfo_destroy_pkginfo(pPackageInfoHandle);
+ pkgmgrinfo_appinfo_destroy_appinfo(pAppInfoHandle);
}
+ SysLog(NID_APP, "app = [%ls] is installed.", appId.GetPointer());
+
return true;
}
#include <libxml/parserInternals.h>
#include <system_info.h>
+#include <runtime_info.h>
+#include <unicode/locid.h>
#include <FAppPkgPackageAppInfo.h>
#include <FBaseSysLog.h>
#include <FAppPkg_PackageParser.h>
#include <FBase_StringConverter.h>
+using namespace Tizen::App;
using namespace Tizen::Base;
using namespace Tizen::Base::Collection;
using namespace Tizen::Base::Utility;
-using namespace Tizen::App;
using namespace Tizen::Io;
using namespace Tizen::System;
namespace Tizen { namespace App { namespace Package
{
+struct charDeleter
+{
+ void operator()(char* pValue)
+ {
+ if(pValue != null)
+ {
+ free(pValue);
+ pValue = null;
+ }
+ }
+};
+
_PackageXmlAttribute::_PackageXmlAttribute(void)
:__pName(null)
,__pValue(null)
}
__pName = new (std::nothrow) char[strlen(pName)+1];
- SysTryReturn(NID_APP, __pName, false, E_OUT_OF_MEMORY, "__pName is null");
+ SysTryReturn(NID_APP, __pName, false, E_OUT_OF_MEMORY, "__pName is null.");
strcpy(__pName, pName);
__pValue = new (std::nothrow) char[strlen(pValue)+1];
- SysTryReturn(NID_APP, __pValue, false, E_OUT_OF_MEMORY, "__pValue is null");
+ SysTryReturn(NID_APP, __pValue, false, E_OUT_OF_MEMORY, "__pValue is null.");
strcpy(__pValue, pValue);
return true;
else
{
__pNext = new (std::nothrow) _PackageXmlAttribute();
- SysTryReturn(NID_APP, __pNext, false, E_OUT_OF_MEMORY, "__pNext is null");
+ SysTryReturn(NID_APP, __pNext, false, E_OUT_OF_MEMORY, "__pNext is null.");
__pNext->Construct(pName, pValue);
}
TryCatch(size > 0, ret = false, "size is invalid. [%s]", pFilepath);
pBuf = new (std::nothrow) char[size+1];
- TryCatch(pBuf, ret = false, "pBuf is null");
+ TryCatch(pBuf, ret = false, "pBuf is null.");
pNormalizedBuf = new (std::nothrow) char[size+1];
- TryCatch(pNormalizedBuf, ret = false, "pNormalizedBuf is null");
+ TryCatch(pNormalizedBuf, ret = false, "pNormalizedBuf is null.");
memset(pBuf, 0, size+1);
memset(pNormalizedBuf, 0, size+1);
TryCatch(ctxt, ret = false, "invalid xml file, %s", pFilepath);
pSAXHandler = new (std::nothrow) xmlSAXHandler;
- TryCatch(pSAXHandler, ret = false, "pSAXHandler is null");
+ TryCatch(pSAXHandler, ret = false, "pSAXHandler is null.");
memset(pSAXHandler, 0, sizeof(xmlSAXHandler));
ctxt->userData = (void *)this;
bool
_PackageXmlHandler::SetElementName(const char* pElementName)
{
- SysTryReturn(NID_APP, pElementName, false, E_SYSTEM, "pElementName is null");
+ SysTryReturn(NID_APP, pElementName, false, E_SYSTEM, "pElementName is null.");
if (__pElementName)
{
}
__pElementName = new (std::nothrow) char[strlen(pElementName)+1];
- SysTryReturn(NID_APP, __pElementName, false, E_OUT_OF_MEMORY, "__pElementName is null");
+ SysTryReturn(NID_APP, __pElementName, false, E_OUT_OF_MEMORY, "__pElementName is null.");
strcpy(__pElementName, pElementName);
__elementStack.Push(*new (std::nothrow) String(pElementName));
bool
_PackageXmlHandler::SetCharacters(const char* pCharacter)
{
- SysTryReturn(NID_APP, pCharacter, false, E_SYSTEM, "pCharacter is null");
+ SysTryReturn(NID_APP, pCharacter, false, E_SYSTEM, "pCharacter is null.");
if (__pCharacters == null)
{
__pCharacters = new (std::nothrow) char[4096];
- SysTryReturn(NID_APP, __pCharacters, false, E_OUT_OF_MEMORY, "__pCharacters is null");
+ SysTryReturn(NID_APP, __pCharacters, false, E_OUT_OF_MEMORY, "__pCharacters is null.");
memset(__pCharacters, 0, 4096);
}
SysTryReturn(NID_APP, pPackageAppInfoImpl, false, E_SYSTEM, "pPackageAppInfoImpl is null.");
_PackageXmlAttribute* pAttr = GetAttribute();
- SysTryReturn(NID_APP, pAttr, true, E_SYSTEM, "pAttr is null");
+ SysTryReturn(NID_APP, pAttr, true, E_SYSTEM, "pAttr is null.");
ParseAppAttribute(pAttr, true);
SysTryReturn(NID_APP, pPackageAppInfoImpl, false, E_SYSTEM, "pPackageAppInfoImpl is null.");
_PackageXmlAttribute* pAttr = GetAttribute();
- SysTryReturn(NID_APP, pAttr, true, E_SYSTEM, "pAttr is null");
+ SysTryReturn(NID_APP, pAttr, true, E_SYSTEM, "pAttr is null.");
ParseAppAttribute(pAttr, false);
bool
_PackageParser::OnDisplayNamesEndElement(void)
{
- // fall-back
+ if ((FindElement("Accounts") == true) || (FindElement("AppWidgets") == true))
+ {
+ AppLog("Skip display name.");
+ return true;
+ }
+ else
+ {
+ AppLog("It's display name for UiApp, ServiceApp");
+ }
+
+ _PackageAppInfoImpl* pPackageAppInfoImpl = _PackageAppInfoImpl::GetInstance(__pAppInfo);
+ SysTryReturn(NID_APP, pPackageAppInfoImpl, false, E_SYSTEM, "pPackageAppInfoImpl is null.");
+
+ HashMap* pNameList = pPackageAppInfoImpl->GetNameList();
+ SysTryReturn(NID_APP, pNameList, false, E_SYSTEM, "pNameList is null.");
+
+ String locale;
+ result r = GetLocale(locale);
+ SysTryReturn(NID_APP, !IsFailed(r), false, E_SYSTEM, "GetValue(http://tizen.org/setting/locale.language) failed.");
+
+ locale.Replace(L"_", L"-");
+ SysLog(NID_APP, "system locale = [%ls]", locale.GetPointer());
+
+ if (pNameList->ContainsKey(locale) == true)
+ {
+ String* pValue = static_cast< String* > (pNameList->GetValue(locale));
+ SysTryReturn(NID_APP, pValue, false, E_SYSTEM, "pValue is null.");
+
+ pPackageAppInfoImpl->SetAppDisplayName(*pValue);
+ if (__isDefaultName == true)
+ {
+ __pPackageInfoImpl->SetDisplayName(*pValue);
+ }
+ SysLog(NID_APP, "Exact - DisplayName = [%ls][%ls]", locale.GetPointer(), pValue->GetPointer());
+ }
+ else
+ {
+ std::unique_ptr< IList > pKeys(pNameList->GetKeysN());
+ SysTryReturn(NID_APP, pKeys, false, E_SYSTEM, "pKeys is null.");
+
+ for (int i = 0; i < pKeys->GetCount(); i++)
+ {
+ String* pKey = dynamic_cast < String* >(pKeys->GetAt(i));
+ if (pKey)
+ {
+ String language;
+ r = pKey->SubString(0, 3, language);
+ SysTryReturn(NID_APP, !IsFailed(r), false, E_SYSTEM, "SubString(%ls) failed.", pKey->GetPointer());
+
+ AppLog("language = [%ls]", language.GetPointer());
+
+ if (locale.Contains(language) == true)
+ {
+ String* pValue = static_cast< String* > (pNameList->GetValue(*pKey));
+ SysTryReturn(NID_APP, pValue, false, E_SYSTEM, "pValue is null.");
+
+ pPackageAppInfoImpl->SetAppDisplayName(*pValue);
+ if (__isDefaultName == true)
+ {
+ __pPackageInfoImpl->SetDisplayName(*pValue);
+ }
+ SysLog(NID_APP, "Fallback - DisplayName = [%ls][%ls]", language.GetPointer(), pValue->GetPointer());
+
+ break;
+ }
+ }
+ }
+ }
return true;
}
bool
_PackageParser::OnIconValue(const char* pCharacters)
{
- SysTryReturn(NID_APP, __pDefaultIconType, false, E_SYSTEM, "__pDefaultIconType is null");
+ SysTryReturn(NID_APP, __pDefaultIconType, false, E_SYSTEM, "__pDefaultIconType is null.");
_PackageAppInfoImpl* pPackageAppInfoImpl = _PackageAppInfoImpl::GetInstance(__pAppInfo);
SysTryReturn(NID_APP, pPackageAppInfoImpl, false, E_SYSTEM, "pPackageAppInfoImpl is null.");
_PackageXmlAttribute* pAttr = GetAttribute();
- SysTryReturn(NID_APP, pAttr, true, E_SYSTEM, "pAttr is null");
+ SysTryReturn(NID_APP, pAttr, true, E_SYSTEM, "pAttr is null.");
+
+ if ((FindElement("Accounts") == true) || (FindElement("AppWidgets") == true))
+ {
+ AppLog("Skip icon value.");
+ return true;
+ }
+ else
+ {
+ AppLog("It's icon value for UiApp, ServiceApp");
+ }
char* pSection = pAttr->Find("Section");
- SysTryReturn(NID_APP, pSection, true, E_SYSTEM, "pSection is null");
+ SysTryReturn(NID_APP, pSection, true, E_SYSTEM, "pSection is null.");
String iconRelPath;
String tempIconPath;
result r = unzipper.Construct(__packagePath);
SysTryReturn(NID_APP, !IsFailed(r), false, E_SYSTEM, "unzipper.Construct() failed.");
+ ZipEntry entry;
+ r = unzipper.GetEntry(iconRelPath, entry);
+ if (IsFailed(r))
+ {
+ AppLog("fallback, old path = [%ls]", iconRelPath.GetPointer());
+
+ String densityXhigh("screen-density-xhigh/");
+ String densityHigh("screen-density-high/");
+
+ if (iconRelPath.Contains(densityXhigh) == true)
+ {
+ iconRelPath.Replace(densityXhigh, densityHigh);
+ }
+ else if (iconRelPath.Contains(densityHigh) == true)
+ {
+ iconRelPath.Replace(densityHigh, densityXhigh);
+ }
+ else
+ {
+ AppLog("invalid icon [%ls]", iconRelPath.GetPointer());
+ return false;
+ }
+
+ AppLog("fallback, new path = [%ls]", iconRelPath.GetPointer());
+ }
+
r = unzipper.UnzipTo(tmp, iconRelPath);
if (!IsFailed(r))
{
}
else
{
- SysLog(NID_APP, "file.Construct() failed.", tempIconPath.GetPointer());
+ SysLog(NID_APP, "file.Construct(%ls) failed.", tempIconPath.GetPointer());
}
}
else
{
- SysLog(NID_APP, "UnzipTo() is failed.");
+ SysLog(NID_APP, "UnzipTo(%ls) is failed.", iconRelPath.GetPointer());
}
}
pAttr = GetAttribute();
SysTryReturn(NID_APP, pAttr, true, E_SYSTEM, "pAttr is null");
+ if ((FindElement("Accounts") == true) || (FindElement("AppWidgets") == true))
+ {
+ AppLog("Skip display name.");
+ return true;
+ }
+ else
+ {
+ AppLog("It's display name for UiApp, ServiceApp");
+ }
+
pAttrValue = pAttr->Find("Locale");
SysTryReturn(NID_APP, pAttrValue, true, E_SYSTEM, "pAttrValue is null");
- if (strcasecmp(pAttrValue, "eng-GB") == 0 || strcasecmp(pAttrValue, "eng-US") == 0)
+ if (strcasecmp(pAttrValue, "eng-GB") == 0)
{
pPackageAppInfoImpl->SetAppDisplayName(pCharacters);
return true;
}
+bool
+_PackageParser::FindElement(const char* pName)
+{
+ bool res = false;
+ IEnumerator* pEnum = GetElementEnumeratorN();
+
+ if (pEnum)
+ {
+ while(pEnum->MoveNext() == E_SUCCESS)
+ {
+ String* pStr = static_cast< String* >(pEnum->GetCurrent());
+ if (pStr)
+ {
+ if (pStr->Equals(pName, false) == true)
+ {
+ AppLog("[%s] is matched.", pName);
+ res = true;
+ break;
+ }
+ }
+ }
+
+ delete pEnum;
+ }
+
+ return res;
+}
+
+result
+_PackageParser::GetLocale(String& value)
+{
+ int errorCode = 0;
+ result r = E_SUCCESS;
+ char* pTemp = null;
+ std::unique_ptr<char, charDeleter> pLocale(null);
+
+ errorCode = runtime_info_get_value_string(RUNTIME_INFO_KEY_LANGUAGE, &pTemp);
+ SysTryReturnResult(NID_APP, (errorCode == RUNTIME_INFO_ERROR_NONE) && (pTemp != null), E_SYSTEM, "runtime_info_get_value_string() failed.");
+
+ pLocale.reset(pTemp);
+ icu::Locale icuLocale(pLocale.get());
+ String localeString(icuLocale.getISO3Language());
+ String languageScriptTmp(icuLocale.getScript());
+
+ if (!languageScriptTmp.IsEmpty())
+ {
+ String languageScript;
+ languageScriptTmp.ToLowerCase(languageScript);
+ localeString.Append(L"-");
+ localeString.Append(languageScript);
+ }
+ localeString.Append("_");
+ localeString.Append(icuLocale.getCountry());
+
+ value = localeString;
+
+ return r;
+}
+
} } } // Tizen::App::Package
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "متابعة"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "اختر اللون"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "اختر التاريخ"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "ضبط التاريخ والوقت"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "اختر الشهر"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "اختر الوقت"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "إلغاء تفعيل قارئ الشاشة"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "صفحة الويب هذه"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "حفظ كلمة المرور؟"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "متابعة"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "بقاء"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "مغادرة"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Davam et"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Rəngi təyin et"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Tarixi təyin et"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Tarixi və vaxtı təyin et"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Ayı təyin et"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Vaxtı təyin et"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Ekran oxuyucsnu deaktiv et"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Bu veb-səhifə"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Parol saxlansın?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Davam edin"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Qal"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Çıxın"
+
msgstr "Вход"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Flash съдържание: %s опитва достъп до отдалечено място: %s. Разрешаване? Ако изберете Да, трябва да рестартирате приложението"
+msgstr "Flash съдържание: %s опитва достъп до отдалечено място: %s. Разрешаване? Ако изберете Да, трябва да рестартирате приложението."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Потребителско име"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Продължи"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Избор на цвят"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Задаване на дата"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Настройка на дата и час"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Задаване на месец"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Задаване на час"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Деактивир. екранен четец"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Тази уеб страница"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Запаметяване на паролата?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Продължи"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Оставане"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Напускане"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continuar"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Definir color"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Definir data"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Definir data i hora"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Definir mes"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Definir hora"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Deshab lector pantalla"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Aquesta pàgina web"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Desar la contrasenya?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continuar"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Mantenir"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Deixar"
+
msgstr "Přihl"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Obsah flash: %s se pokouší použít vzdálené umístění: %s. Povolit? Pokud ano, musíte restartovat aplikaci"
+msgstr "Obsah flash: %s se pokouší použít vzdálené umístění: %s. Povolit? Pokud ano, musíte restartovat aplikaci."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Uživatelské jméno"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Pokračovat"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Nastavit barvu"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Nastavit datum"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Nastavit datum a čas"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Nastavit měsíc"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Nastavit čas"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Vypnout čtečku obrazovky"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Tato webová stránka"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Uložit heslo?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Pokračovat"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Zůstat"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Opustit"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Fortsæt"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Angiv farve"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Angiv dato"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Angiv dato og tid"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Angiv måned"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Angiv tid"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Deaktivér skærmlæser"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Denne hjemmeside"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Gem adgangskode?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Fortsæt"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Forbliv"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Forlad"
+
msgstr "Sicherheitszertifikat"
msgid "IDS_TPLATFORM_BUTTON2_CANCEL"
-msgstr "Abbre-chen"
+msgstr "Abbrechen"
msgid "IDS_TPLATFORM_BODY_SERIAL_NUMBER_C"
msgstr "Seriennummer:"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Weiter"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Farbe einstellen"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Datum einstellen"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Datum und Uhrzeit festlegen"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Monat einstellen"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Uhrzeit einstellen"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Bildschirmlesepr. deakt."
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Diese Webseite"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Passwort speichern?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Fortsetzen"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Hier bleiben"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Verlassen"
+
msgstr "Σύνδεση"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Περιεχόμενο Flash: Η εφαρμογή %s προσπαθεί να αποκτήσει πρόσβαση στην τοποθεσία: %s. Να επιτραπεί; Εάν ναι, θα πρέπει να επανεκκινήσετε την εφαρμογή"
+msgstr "Περιεχόμενο Flash: Η εφαρμογή %s προσπαθεί να αποκτήσει πρόσβαση στην τοποθεσία: %s. Να επιτραπεί; Εάν ναι, θα πρέπει να επανεκκινήσετε την εφαρμογή."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Όνομα χρήστη"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Συνέχεια;"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Ορισμός χρώματος"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Ορισμός ημερομηνίας"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Ρύθμιση ώρας και ημερομηνίας"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Ορισμός μήνα"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Ορισμός ώρας"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Απεν. ανάγνωσης οθόνης"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Αυτή η ιστοσελίδα"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Αποθήκευση κωδικού;"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Συνέχεια"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Παραμονή"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Αποχώρηση"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continue"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Set colour"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Set date"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Set date and time"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Set month"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Set time"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Disable screen reader"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "This webpage"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Save password?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continue"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Stay"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Leave"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continue"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Set color"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Set date"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Set date and time"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Set month"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Set time"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Disable screen reader"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "This webpage"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Save password?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continue"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Stay"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Leave"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continue"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Set color"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Set date"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Set date and time"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Set month"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Set time"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Turn off screen reader"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "This webpage"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Save password?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continue"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Stay"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Leave"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continuar"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Definir color"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Definir fecha"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Definir fecha y hora"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Definir mes"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Definir hora"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Desactivar lector pantalla"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Esta página web"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "¿Guardar contraseña?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continuar"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Permanecer"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Salir"
+
msgstr "Portapapeles"
msgid "IDS_TPLATFORM_OPT_COPY"
-msgstr "Copiando"
+msgstr "Copiar"
msgid "IDS_TPLATFORM_OPT_CUT"
msgstr "Cortar"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continuar"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Definir color"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Definir fecha"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Ajustar fecha y hora"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Definir mes"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Definir hora"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Desact. lector de pantalla"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Esta página web"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "¿Guardar contraseña?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continuar"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Permanecer"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Salir"
+
msgstr "Sisselogimine"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Välksisu: %s proovib juurde pääseda kaugasukohale: %s. Kas lubate? Kui jah, peate taaskäivitama rakenduse"
+msgstr "Välksisu: %s proovib juurde pääseda kaugasukohale: %s. Kas lubate? Kui jah, peate taaskäivitama rakenduse."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Kasutajanimi"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Jätka"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Määrake värv"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Määrake kuupäev"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Määra kuupäev ja kellaaeg"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Määrake kuu"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Määrake kellaaeg"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Desaktiv. ekraanilugeja"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "See veebileht"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Kas salvestada parool?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Jätka"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Jää"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Lahku"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Jarraitu"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Ezarri kolorea"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Ezarri data"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Ezarri eguna eta ordua"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Ezarri hila"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Ezarri ordua"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Ezgaitu pant. irakurgailua"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Web orri hau"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Gorde pasahitza?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Jarraitu"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Geratu"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Irten"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "ادامه"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "تنظیم رنگ"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "تنظیم تاریخ"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "تنظیم تاریخ و زمان"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "تنظیم ماه"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "تنظيم ساعت"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "غیرفعال کردن صفحه خوان"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "این صفحه وب"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "ذخیره رمز عبور؟"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "ادامه"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "ماندن"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "ترک"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Jatka"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Aseta väri"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Aseta päivämäärä"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Määritä päiväys ja kellonaika"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Aseta kuukausi"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Aseta aika"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Poista näytönluk. käytöstä"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Tämä verkkosivu"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Tallennetaanko salasana?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Jatka"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Jää"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Poistu"
+
msgstr "Annuler"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB"
-msgstr "Cont."
+msgstr "Continuer"
msgid "IDS_TPLATFORM_BUTTON_DONE"
msgstr "OK"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continuer"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Définir la couleur"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Définir la date"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Définir la date et l'heure"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Définir le mois"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Définir l'heure"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Désactiver lecteur d'écran"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Cette page Web"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Enreg. mot de passe ?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continuer"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Rester"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Quitter"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continuer"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Définir la couleur"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Définir la date"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Définir la date et l'heure"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Définir le mois"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Définir l'heure"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Désactiver lecteur d'écran"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Cette page Web"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Enreg. mot de passe ?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continuer"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Rester"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Quitter"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Ar aghaidh"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Socraigh dath"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Socraigh dáta"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Socraigh dáta agus am"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Socraigh mí"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Socraigh am"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Díchumasaigh léith. scáil."
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "An leathanach gréasáin seo"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Sábháil pasfhocal?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Ar aghaidh"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Fan"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Imigh as"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continuar"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Definir cor"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Definir data"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Definir data e hora"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Definir mes"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Definir hora"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Desactivar lector pantalla"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Esta páxina web"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Gardar contrasinal?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continuar"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Permanecer"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Abandonar"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "המשך"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "הגדר צבע"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "הגדר תאריך"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "הגדר תאריך ושעה"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "הגדר חודש"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "הגדר שעה"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "השבת קורא מסך"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "דף אינטרנט זה"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "לשמור סיסמה?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "המשך"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "הישאר"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "עזוב"
+
msgstr "NFC"
msgid "IDS_TPLATFORM_OPT_WI_FI_DIRECT_ABB"
-msgstr "Wi-Fi डायरेक्ट"
+msgstr "Wi-Fi Direct"
msgid "IDS_COM_BUTTON_LOGIN"
msgstr "लॉगिन"
msgstr "रद्द करें"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB"
-msgstr "जारी रखें"
+msgstr "जारी"
msgid "IDS_TPLATFORM_BUTTON_DONE"
msgstr "हुआ"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "जारी रखें"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "रंग सेट करें"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "तिथि सेट करें"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "तिथि और समय सेट करें"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "महीना सेट करें"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "समय सेट करें"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "स्क्रीन रीडर अक्षम करें"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "यह वेबपेज"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "पासवर्ड सेव करें?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "जारी"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "ठहरें"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "छोड़ें"
+
msgstr "Prijava"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Flash sadržaj: %s pokušava pristupiti udaljenoj lokaciji: %s. Dopustiti? Ako je odgovor da, morate ponovno pokrenuti aplikaciju"
+msgstr "Flash sadržaj: %s pokušava pristupiti udaljenoj lokaciji: %s. Dopustiti? Ako je odgovor da, morate ponovno pokrenuti aplikaciju."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Korisničko ime"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Nastavak"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Postavi boju"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Postavi datum"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Postavi datum i vrijeme"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Postavi mjesec"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Postavi vrijeme"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Isključi čitač zaslona"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Ova web-stranica"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Spremiti lozinku?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Nastavi"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Ostani"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Napusti"
+
msgstr "Bejelentkezés"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "A(z) %s Flash-tartalom a(z) %s távoli helyhez próbál hozzáférni. Engedélyezi ezt? Ha igen, akkor újra kell indítania az alkalmazást"
+msgstr "A(z) %s Flash-tartalom a(z) %s távoli helyhez próbál hozzáférni. Engedélyezi ezt? Ha igen, akkor újra kell indítania az alkalmazást."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Felhasználónév"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Folytatás"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Szín beállítása"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Dátum beállítása"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Dátum és idő beállítása"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Hónap beállítása"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Idő beállítása"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Képernyőolvasó letiltása"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Ez a weboldal"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Menti a jelszót?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Folytatás"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Marad"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Kilép"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Շարունակել"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Դնել գույն"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Դնել թվական"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Նախադրել թվական և ժամ"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Դնել ամիս"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Դնել ժամ"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Կասեցնել էկրանի ընթերցիչը"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Այս կայքէջը"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Պահպանե՞լ գաղտնաբառը:"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Շարունակել"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Մնալ"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Թողնել"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Halda áfram"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Veldu lit"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Veldu dag"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Stilla dag og tíma"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Veldu mánuð"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Stilltu tíma"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Slökkva á skjálesara"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Þessi vefsíða"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Viltu vista lykilorð?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Halda áfram"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Vera áfram"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Yfirgefa"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continua"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Imposta colore"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Imposta data"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Imposta data e ora"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Imposta mese"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Imposta ora"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Disattiva lettura schermo"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Questa pagina Web"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Salvare password?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continua"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Resta"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Esci"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "続行"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "色を設定"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "日付を設定"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "日付と時刻を設定"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "月を設定"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "時刻を設定"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "スクリーンリーダーを無効にする"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "このWebページ"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "暗証番号を保存しますか?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "続行"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "保持する"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "離れる"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "გაგრძელება"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "ფერის დაყენება"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "თარიღის დაყენება"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "თარიღისა და დროის დაყენება"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "თვის დაყენება"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "საათის დაყენება"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "გამორთე ეკრანის წამკითხვ."
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "ეს ვებსაიტი"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "შეინახავთ პაროლს?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "გაგრძელება"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "დაჩენა"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "დატოვება"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Жалғастыру"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Түсін орнату"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Күнді орнату"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Күні мен уақытын оранту"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Айды орнату"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Уақытты орнату"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Экран оқу құралын өшіру"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Бұл веб-бет"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Құпиясөзді сақтау керек пе?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Жалғастыру"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Қалу"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Қалдыру"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "계속"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "색상 설정"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "날짜 설정"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "날짜 및 시간 설정"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "월 설정"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "시간 설정"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "스크린 리더 해제"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "이 웹페이지"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "비밀번호를 저장할까요?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "계속"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "남기"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "나가기"
+
msgstr "Prisijungimas"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "„Flash“ turinys: %s bando pasiekti nutolusią vietą: %s. Leisti? Jei taip, turite iš naujo paleisti programą"
+msgstr "„Flash“ turinys: %s bando pasiekti nutolusią vietą: %s. Leisti? Jei taip, turite iš naujo paleisti programą."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Naudotojo vardas"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Tęsti"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Nustatykite spalvą"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Nustatykite datą"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Nustatyti datą ir laiką"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Nustatykite mėnesį"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Nustatykite laiką"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Išjungti ekrano skaitytuvą"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Ši svetainė"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Išsaugoti slaptažodį?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Tęsti"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Likti"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Išeiti"
+
msgstr "Pieteikšanās"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Zibatmiņas saturs: %s mēģina piekļūt attālajai atrašanās vietai: %s. Vai atļaut? Ja jā, programmu ir jārestartē"
+msgstr "Zibatmiņas saturs: %s mēģina piekļūt attālajai atrašanās vietai: %s. Vai atļaut? Ja jā, programmu ir jārestartē."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Lietotājvārds"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Turpināt"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Iestatīt krāsu"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Iestatīt datumu"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Iestatīt datumu un laiku"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Iestatīt mēnesi"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Iestatīt laiku"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Deaktivizēt ekr. lasītāju"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Šī tīmekļa vietne"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Vai saglabāt paroli?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Turpināt"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Palikt"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Iziet"
+
msgstr "Најава"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Содржина Flash: %s се обидува да пристапи до оддалечена локација: %s. Дозволи? Ако да, треба да ја рестартирате апликацијата"
+msgstr "Содржина Flash: %s се обидува да пристапи до оддалечена локација: %s. Дозволи? Ако да, треба да ја рестартирате апликацијата."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Корисничко име"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Продолжи"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Одреди боја"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Одреди датум"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Постави датум и време"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Одреди месец"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Одреди час"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Исклучи екрански читач"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Оваа интернет-страница"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Сочувај лозинка?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Продолжи"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Остани"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Напушти"
+
msgstr "Standardprogram"
msgid "IDS_COM_POP_SELECT_DEFAULT_APPLICATION"
-msgstr "Velg standardprogram"
+msgstr "Velg standardapp"
msgid "IDS_TPLATFORM_BODY_NO_IMAGES"
msgstr "Ingen bilder"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Fortsett"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Angi farge"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Angi dato"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Angi dato og tid"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Angi måned"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Angi klokkeslett"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Deaktiver skjermleser"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Denne nettsiden"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Lagre passord?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Fortsett"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Bli"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Lukk"
+
msgstr "Tonen"
msgid "IDS_BR_OPT_CANCEL"
-msgstr "Annuleren"
+msgstr "Annul."
msgid "IDS_BR_BODY_PS_REQUESTS_YOUR_LOCATION"
msgstr "%s vraagt om uw locatie"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Doorgaan"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Kleur instellen"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Datum instellen"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Datum en tijd instellen"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Maand instellen"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Tijd instellen"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Schermlezer uitschakelen"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Deze webpagina"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Wachtwoord opslaan?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Doorgaan"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Blijven"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Verlaten"
+
msgstr "Logowanie"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Zawartość Flash: %s próbuje uzyskać dostęp do lokalizacji zdalnej: %s. Zezwolić? Jeśli tak, musisz ponownie uruchomić aplikację"
+msgstr "Zawartość Flash: %s próbuje uzyskać dostęp do lokalizacji zdalnej: %s. Zezwolić? Jeśli tak, musisz ponownie uruchomić aplikację."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Nazwa użytkownika"
msgstr "Hasło"
msgid "IDS_TPLATFORM_OPT_LOCATION"
-msgstr "Miejsce"
+msgstr "Lokalizacja"
msgid "IDS_COM_SK_CANCEL"
msgstr "Anuluj"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Kontynuuj"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Ustaw kolor"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Ustaw datę"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Ustaw datę i godzinę"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Ustaw miesiąc"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Ustaw godzinę"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Wyłącz czytnik ekranu"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Ta strona WWW"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Zapisać hasło?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Kontynuuj"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Pozostań"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Opuść"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continuar"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Definir cor"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Definir data"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Definir data e hora"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Definir mês"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Definir hora"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Desativar leitor de tela"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Esta página"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Salvar senha?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continuar"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Ficar"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Sair"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continuar"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Definir cor"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Definir data"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Definir data e hora"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Definir mês"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Definir hora"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Desactivar leitor de ecrã"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Esta página Web"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Guardar palavra-passe?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continuar"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Ficar"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Sair"
+
msgstr "Conect."
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Conţinut Flash: %s încearcă să acceseze o locaţie de la distanţă: %s. Permiteţi? În caz afirmativ, trebuie să reporniţi aplicaţia"
+msgstr "Conţinut Flash: %s încearcă să acceseze o locaţie de la distanţă: %s. Permiteţi? În caz afirmativ, trebuie să reporniţi aplicaţia."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Nume utilizator"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Continuare"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Setaţi culoarea"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Setaţi data"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Setare dată şi oră"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Setaţi luna"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Setaţi ora"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Dezactivare cititor ecran"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Această pagină web"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Salvaţi parola?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Continuare"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Rămâneţi"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Părăsiţi"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Продолжить"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Выберите цвет"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Выберите дату"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Задать дату и время"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Выберите месяц"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Выберите время"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Отключить чтение с экрана"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Эта веб-страница"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Сохранить пароль?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Продолжить"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Не закрывать"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Покинуть"
+
msgstr "Prihlásenie"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Obsah s formátom Flash: %s sa pokúša o prístup k vzdialenému umiestneniu: %s. Povoliť? Ak áno, musíte reštartovať aplikáciu"
+msgstr "Obsah s formátom Flash: %s sa pokúša o prístup k vzdialenému umiestneniu: %s. Povoliť? Ak áno, musíte reštartovať aplikáciu."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Užívateľské meno"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Pokračovať"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Nastavte farbu"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Nastavte dátum"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Nastaviť dátum a čas"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Nastavte mesiac"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Nastavte čas"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Vypnúť čítačku obrazovky"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Táto webová stránka"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Uložiť heslo?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Pokračovať"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Zostať"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Opustiť"
+
msgstr "Prijava"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Vsebina Flash: %s poskuša dostopati na oddaljeno lokacijo: %s. Želite dovoliti? Če da, morate znova zagnati program"
+msgstr "Vsebina Flash: %s poskuša dostopati na oddaljeno lokacijo: %s. Želite dovoliti? Če da, morate znova zagnati program."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Uporabniško ime"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Nadaljuj"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Nastavite barvo"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Nastavite datum"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Nastavitev datuma in ure"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Nastavite mesec"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Nastavite čas"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Onemogoči bralnik zaslona"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Ta spletna stran"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Shranim geslo?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Nadaljuj"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Ostani"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Zapusti"
+
msgstr "Prijava"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Flash sadržaj: %s pokušava da pristupi udaljenoj lokaciji: %s. Dozvoliti? Ukoliko dozvoljavaš, moraš da restartuješ aplikaciju"
+msgstr "Flash sadržaj: %s pokušava da pristupi udaljenoj lokaciji: %s. Dozvoliti? Ukoliko dozvoljavaš, moraš da restartuješ aplikaciju."
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "Korisničko ime"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Nastavi"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Podesi boju"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Podesi datum"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Podesi datum i vreme"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Podesi mesec"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Podesi vreme"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Onemogući čitač ekrana"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Ova web stranica"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Sačuvaj šifru?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Nastavi"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Ostani"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Napusti"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Fortsätt"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Ställ in färg"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Ställ in datum"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Ange datum och tid"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Ställ in månad"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Ställ in tid"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Inaktivera skärmläsare"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Den här webbplatsen"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Spara lösenord?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Fortsätt"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Stanna"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Lämna"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "ดำเนินการ"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "ตั้งค่าสี"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "ตั้งวันที่"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "ตั้งค่าวันที่และเวลา"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "ตั้งเดือน"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "ตั้งเวลา"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "ปิดใช้งานตัวอ่านหน้าจอ"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "เว็บเพจนี้"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "บันทึกรหัสผ่าน?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "ดำเนินการต่อ"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "พัก"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "ออก"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Devam"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Renk ata"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Tarihi ayarla"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Tarih ve saati ayarla"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Ay ayarla"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Süreyi ayarla"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Ekran okuyucuyu kapat"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Bu web sayfası"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Şifre kaydedilsin mi?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Devam"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Kal"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Ayrıl"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Продовжити"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Виберіть колір"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Оберіть дату"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Встановити дату й час"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Оберіть місяць"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Встановіть час"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Вимкнути читання з екрана"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Дана веб-сторінка"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Зберегти пароль?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Продовжити"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Залишитися"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Залишити"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "جاری"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "رنگ سیٹ کریں"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "تاریخ سیٹ کریں"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "تاریخ اور وقت سیٹ کریں"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "مہینہ سیٹ کریں"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "وقت سیٹ کریں"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "اسکرین ریڈر نا اہل بنائیں۔"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "یہ ویب صفحہ"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "پاس ورڈ محفوظ کریں؟"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "جاری رکھیں"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "ٹھہریں"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "چھوڑ دیں"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "Davom ettirish"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "Rangni sozlash"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "Sana o‘rnat"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "Sana va vaqtni o‘rnatish"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "Oy o‘rnat"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "Vaqtni o‘rnat"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "Ekran o‘qish vos-ni o‘chir"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "Ushbu veb-sahifa"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "Parol saqlansinmi?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "Davom etish"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "Turish"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "Tark etish"
+
msgstr "登录"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Flash内容:%s正尝试访问远程位置:%s。允许吗?如果是,必须重启应用程序"
+msgstr "Flash内容:%s正尝试访问远程位置:%s。允许吗?如果是,必须重启应用程序。"
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "用户名"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "继续"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "设置颜色"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "设置日期"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "设置日期与时间"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "设置月份"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "设置时间"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "禁用屏幕阅读器"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "该网页"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "储存密码?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "继续"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "保持"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "离开"
+
msgstr "登入"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Flash 內容:%s 正嘗試存取遠端位置:%s。 允許嗎?若是,必須重新啟動應用程式"
+msgstr "Flash 內容:%s 正嘗試存取遠端位置:%s。 允許嗎?若是,必須重新啟動應用程式。"
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "用戶名稱"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "繼續"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "設定顏色"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "設定日期"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "設定日期與時間"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "設定月份"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "設定時間"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "停用螢幕閱讀器"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "此網頁"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "儲存密碼嗎?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "繼續"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "保留"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "離開"
+
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "继续"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "设置颜色"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "设置日期"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "设置日期与时间"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "设置月份"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "设置时间"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "关闭屏幕阅读器"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "该网页"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "储存密码?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "继续"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "保持"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "离开"
+
msgstr "登入"
msgid "IDS_COM_BODY_FLASH_CONTENT_C_PS_IS_TRYING_TO_ACCESS_REMOTE_LOCATION_C_PS_MSG"
-msgstr "Flash 內容:%s 正在嘗試存取遠端位置:%s。允許嗎?如果是,必須重新啟動應用程式"
+msgstr "Flash 內容:%s 正在嘗試存取遠端位置:%s。允許嗎?如果是,必須重新啟動應用程式。"
msgid "IDS_BR_BODY_AUTHUSERNAME"
msgstr "使用者名稱"
msgid "IDS_TPLATFORM_BUTTON_CONTINUE"
msgstr "繼續"
+msgid "IDS_TPLATFORM_HEADER_SET_COLOUR"
+msgstr "設定顏色"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE"
+msgstr "設定日期"
+
+msgid "IDS_TPLATFORM_HEADER_SET_DATE_AND_TIME_ABB"
+msgstr "設定日期與時間"
+
+msgid "IDS_TPLATFORM_HEADER_SET_MONTH"
+msgstr "設定月份"
+
+msgid "IDS_TPLATFORM_HEADER_SET_TIME"
+msgstr "設定時間"
+
msgid "IDS_TPLATFORM_OPT_DISABLE_SCREEN_READER_ABB"
msgstr "停用螢幕閱讀器"
msgid "IDS_BR_BODY_THIS_WEBPAGE"
msgstr "此網頁"
+msgid "IDS_TPLATFORM_POP_SAVE_PASSWORD_Q"
+msgstr "儲存密碼?"
+
+msgid "IDS_TPLATFORM_BUTTON_CONTINUE_ABB2"
+msgstr "繼續"
+
+msgid "IDS_TPLATFORM_BUTTON_STAY"
+msgstr "保留"
+
+msgid "IDS_TPLATFORM_BUTTON_LEAVE"
+msgstr "離開"
+
#include <FBaseSysLog.h>
#include <FBaseString.h>
#include <FBaseColArrayList.h>
+#include <FBaseColArrayListT.h>
+#include <FBaseColIEnumeratorT.h>
#include <FIoFile.h>
#include <FIo_IpcClient.h>
#include <FSecAccessController.h>
std::unique_ptr<String> pChecksum(new (std::nothrow) String());
SysTryReturnVoidResult(NID_SEC, pChecksum != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
- std::unique_ptr<ArrayList> pPrivilegeList(new ArrayList());
- SysTryReturnVoidResult(NID_SEC, pPrivilegeList != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
+ std::unique_ptr< ArrayListT< String > > pPrivilegeListT(new ArrayListT< String >());
+ SysTryReturnVoidResult(NID_SEC, pPrivilegeListT != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
- pPrivilegeList->Construct();
+ pPrivilegeListT->Construct();
- std::unique_ptr<IPC::Message> pCipherPrivilegeMessage(new (std::nothrow) PrivilegeManagerMsg_retrieve(pEncryptedPrivileges.get(), pChecksum.get(), pPrivilegeList.get(), &r));
+ std::unique_ptr<IPC::Message> pCipherPrivilegeMessage(new (std::nothrow) PrivilegeManagerMsg_retrieve(pEncryptedPrivileges.get(), pChecksum.get(), pPrivilegeListT.get(), &r));
SysTryReturnVoidResult(NID_SEC, pCipherPrivilegeMessage != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
result ipcResult = pIpcClient->SendRequest(pCipherPrivilegeMessage.get());
SysTryReturnVoidResult(NID_SEC, ipcResult == E_SUCCESS, E_SYSTEM, "Failed to send IPC message.");
SysTryReturnVoidResult(NID_SEC, r == E_SUCCESS, r, "Failed to retrieve privilege information");
+ std::unique_ptr<ArrayList> pPrivilegeList(new ArrayList());
+ SysTryReturnVoidResult(NID_SEC, pPrivilegeList != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
+
+ pPrivilegeList->Construct();
+
+ std::unique_ptr<IEnumeratorT< String > > pEnum(pPrivilegeListT->GetEnumeratorN());
+ while (pEnum->MoveNext() == E_SUCCESS)
+ {
+ String tempString;
+ pEnum->GetCurrent(tempString);
+ pPrivilegeList->Add(new String(tempString));
+ }
+ pPrivilegeListT->RemoveAll();
+
std::unique_ptr<String> pEncryptedVisibility(new (std::nothrow) String());
SysTryReturnVoidResult(NID_SEC, pEncryptedVisibility != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
if (isPemFormat == true)
{
PublicKey nKey;
- r = nKey.SetKey(*pOutBuffer);
+ r = nKey.SetKey(*pOutBuffer.get());
SysTryCatch(NID_SEC, !IsFailed(r), r = E_INVALID_ARG, E_INVALID_ARG, "[E_INVALID_ARG] The specified input parameter is invalid.");
- pOutBuffer.reset(ConvertDerToPemN(format, nKey));
- //pOutBuffer = std::unique_ptr< ByteBuffer >(ConvertDerToPemN(format, nKey));
+ pOutBuffer = std::unique_ptr< ByteBuffer >(ConvertDerToPemN(format, nKey));
SysTryCatch(NID_SEC, pOutBuffer != null, r = GetLastResult(), GetLastResult(), "[%s] Failed to convert der to pem encoded byte buffer");
}
#include <FBaseSysLog.h>
#include <FBaseString.h>
#include <FBaseColArrayList.h>
+#include <FBaseColArrayListT.h>
#include <FBase_StringConverter.h>
#include <FIoFile.h>
#include <FIo_IpcClient.h>
pChecksum.reset(new (std::nothrow) String());
SysTryReturnVoidResult(NID_SEC, pChecksum != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
- pPrivilegeList.reset(new ArrayList());
- SysTryReturnVoidResult(NID_SEC, pPrivilegeList != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
- pPrivilegeList->Construct();
+ std::unique_ptr< ArrayListT< String > > pPrivilegeListT(new ArrayListT< String >());
+ SysTryReturnVoidResult(NID_SEC, pPrivilegeListT != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
+
+ pPrivilegeListT->Construct();
- std::unique_ptr<IPC::Message> pCipherPrivilegeMessage(new (std::nothrow) PrivilegeManagerMsg_retrieve(pEncryptedPrivileges.get(), pChecksum.get(), pPrivilegeList.get(), &r));
+ std::unique_ptr<IPC::Message> pCipherPrivilegeMessage(new (std::nothrow) PrivilegeManagerMsg_retrieve(pEncryptedPrivileges.get(), pChecksum.get(), pPrivilegeListT.get(), &r));
SysTryReturnVoidResult(NID_SEC, pCipherPrivilegeMessage != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
result ipcResult = pIpcClient->SendRequest(pCipherPrivilegeMessage.get());
SysTryReturnVoidResult(NID_SEC, ipcResult == E_SUCCESS, E_SYSTEM, "Failed to send IPC message.");
SysTryReturnVoidResult(NID_SEC, r == E_SUCCESS, r, "Failed to retrieve privilege information");
+ pPrivilegeList.reset(new ArrayList(SingleObjectDeleter));
+ SysTryReturnVoidResult(NID_SEC, pPrivilegeList != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
+ pPrivilegeList->Construct();
+
+ std::unique_ptr<IEnumeratorT< String > > pEnum(pPrivilegeListT->GetEnumeratorN());
+ while (pEnum->MoveNext() == E_SUCCESS)
+ {
+ String tempString;
+ pEnum->GetCurrent(tempString);
+ pPrivilegeList->Add(new String(tempString));
+ }
+ pPrivilegeListT->RemoveAll();
+
pEncryptedVisibility.reset(new (std::nothrow) String());
SysTryReturnVoidResult(NID_SEC, pEncryptedVisibility != null, E_OUT_OF_MEMORY, "The memory is insufficient.");
if (ret != PRIV_MGR_ERROR_SUCCESS)
{
r = E_USER_NOT_CONSENTED;
- SysLog(NID_SEC, "Result : FALSE [Privacy]");
+ SysLog(NID_SEC, "Result: FALSE [Privacy]");
}
return r;
if (ret != PRIV_MGR_ERROR_SUCCESS)
{
r = E_USER_NOT_CONSENTED;
- SysLog(NID_SEC, "Result : FALSE [Privacy]");
+ SysLog(NID_SEC, "Result: FALSE [Privacy]");
}
return r;
byte bitwiseTargetPrivilege = 0;
byte tempBitwisePrivilege = 0;
- if (__apiVisibility != _API_VISIBILITY_NONE) // To be removed
+ if (visibilityLevelListTable[privilege] > __apiVisibility)
{
- if (visibilityLevelListTable[privilege] > __apiVisibility)
- {
- SysLog(NID_SEC, "Result : FALSE [Visibility]");
- return ret;
- }
+ SysLog(NID_SEC, "Result : FALSE [Visibility]");
+ return ret;
}
bitwiseTargetPrivilege = bitwiseTargetPrivilege | (1 << privilegeBit);
byte bitwiseTargetPrivilege = 0;
byte tempBitwisePrivilege = 0;
- if (__apiVisibility != _API_VISIBILITY_NONE) // To be removed
+ if (visibilityLevelListTable[privilege] > __apiVisibility)
{
- if (visibilityLevelListTable[privilege] > __apiVisibility)
- {
- return ret;
- }
+ return ret;
}
bitwiseTargetPrivilege = bitwiseTargetPrivilege | (1 << privilegeBit);
ret = __privilegeList.ContainsKey(privilege);
if (ret)
{
- if (__apiVisibility != _API_VISIBILITY_NONE) // To be removed
+ const String* pPrivilegeLevel = static_cast< const String* >(__privilegeList.GetValue(privilege));
+ SysTryReturn(NID_SEC, pPrivilegeLevel != null, E_SYSTEM, E_SYSTEM, "[E_SYSTEM] An unexpected system error occurred.");
+
+ int privilegeLevel = GetPrivilegeLevel(*pPrivilegeLevel);
+ if (privilegeLevel > __apiVisibility)
{
- const String* pPrivilegeLevel = static_cast< const String* >(__privilegeList.GetValue(privilege));
- SysTryReturn(NID_SEC, pPrivilegeLevel != null, E_SYSTEM, E_SYSTEM, "[E_SYSTEM] An unexpected system error occurred.");
-
- int privilegeLevel = GetPrivilegeLevel(*pPrivilegeLevel);
- if (privilegeLevel > __apiVisibility)
- {
- SysLog(NID_SEC, "Result : FALSE [Visibility]");
- return false;
- }
+ SysLog(NID_SEC, "Result : FALSE [Visibility]");
+ return false;
}
SysLog(NID_SEC, "Result : TRUE");
_X509CertificateStoreImpl::~_X509CertificateStoreImpl(void)
{
- if ((__certType > _CERT_TYPE_NOT_BOUNDED) && (__certType < _CERT_TYPE_MAX))
+ int prevIndex = GetIndexFromCertType(__certType);
+ if (__certType == _CERT_TYPE_USER_CERT)
{
__pCertServiceProxy->CloseCertificateStore(__certType);
}
+ else if (prevIndex > -1 && __context[prevIndex] != 0)
+ {
+ _CertServer::CloseCertificateStore(reinterpret_cast< CertificateStoreCtx >(__context[prevIndex]));
+ __context[prevIndex] = 0;
+ }
}
result
oldBufferLen = pOldEncodedData->GetRemaining();
SysTryReturnResult(NID_SEC_CERT, oldBufferLen > 0, E_INVALID_ARG, "Input old certificate length is not positive.");
+ //pOldEncodedData.reset(null);
+
std::unique_ptr< ByteBuffer > pNewEncodedData(newCert.GetEncodedDataN());
SysTryReturnResult(NID_SEC_CERT, pNewEncodedData != null, E_INVALID_ARG, "Failed to get encoded data on new input certificate.");
}
-} } } // Tizen::Security::Cert
+} } } // Tizen::Security::Cert
Tizen::Base::_API_VISIBILITY_PLATFORM, // settingmanager.read
Tizen::Base::_API_VISIBILITY_PLATFORM, // settingmanager.write
Tizen::Base::_API_VISIBILITY_PARTNER, // appmanager.certificate
- Tizen::Base::_API_VISIBILITY_PARTNER, // datacontrol.consumer
+ Tizen::Base::_API_VISIBILITY_PUBLIC, // datacontrol.consumer
Tizen::Base::_API_VISIBILITY_PUBLIC, // datasync
Tizen::Base::_API_VISIBILITY_PUBLIC, // filesystem.read
Tizen::Base::_API_VISIBILITY_PUBLIC, // filesystem.write
true, // calendar.read
true, // calendar.write
false, // callforward
- false, // callhistory.read
- false, // callhistory.write
+ true, // callhistory.read
+ true, // callhistory.write
false, // camera
false, // cellbroadcast
false, // certificate.read
#define IPC_MESSAGE_START PrivilegeManagerMsgStart
-IPC_SYNC_MESSAGE_CONTROL0_4(PrivilegeManagerMsg_retrieve, Tizen::Base::String, Tizen::Base::String, Tizen::Base::Collection::ArrayList, result)
+IPC_SYNC_MESSAGE_CONTROL0_4(PrivilegeManagerMsg_retrieve, Tizen::Base::String, Tizen::Base::String, Tizen::Base::Collection::ArrayListT< Tizen::Base::String >, result)
IPC_SYNC_MESSAGE_CONTROL0_3(PrivilegeManagerMsg_retrieveEx, Tizen::Base::String, Tizen::Base::String, result)
-SET (this_target osp-appfw-server)
-
-INCLUDE_DIRECTORIES (
- ${SLP_INCLUDE_DIRS}
- ${CMAKE_SOURCE_DIR}/inc
- ${CMAKE_SOURCE_DIR}/src/base/inc
- ${CMAKE_SOURCE_DIR}/src/io/inc
- ${CMAKE_SOURCE_DIR}/src/system/inc
- ${CMAKE_SOURCE_DIR}/src/security/inc
- ${CMAKE_SOURCE_DIR}/src/security
- ${CMAKE_SOURCE_DIR}/src/app/inc
- inc
- )
-
-SET (${this_target}_SOURCE_FILES
- app/FApp_AulServer.cpp
- app/FApp_AppLaunchCondition.cpp
- app/FApp_AppLaunchConditionHandlerBase.cpp
- app/FApp_AppManagerEvent.cpp
- app/package/FAppPkg_PackageManagerServer.cpp
- io/FIo_IpcServer.cpp
- security/FSec_PrivilegeManagerServer.cpp
- )
-
-INCLUDE(FindPkgConfig)
-pkg_check_modules(server_pkgs REQUIRED
- appsvc
- chromium
- dukgenerator
- glib-2.0
- pkgmgr-info
-)
-
-FOREACH(flag ${server_pkgs_CFLAGS})
- SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} ${flag}")
-ENDFOREACH(flag)
-
-## SET EXTRA COMPILER FLAGS
-SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} -fPIC -Wall -Wno-unused")
-
-## SET C COMPILER FLAGS
-SET(CMAKE_C_FLAGS "${OSP_DEBUG_FLAGS} ${OSP_OPT_FLAGS} ${CMAKE_C_FLAGS} ${EXTRA_CFLAGS} ${OSP_COMPILER_FLAGS}")
-
-## SET CPP COMPILER FLAGS
-SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fvisibility=hidden")
-SET(CMAKE_CXX_FLAGS "${OSP_DEBUG_FLAGS} ${OSP_OPT_FLAGS} ${CMAKE_CXX_FLAGS} ${EXTRA_CFLAGS} ${OSP_COMPILER_FLAGS}")
-
-## Create Library
-ADD_LIBRARY (${this_target} SHARED ${${this_target}_SOURCE_FILES})
-
-SET(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -Wl,--no-undefined -Wl,--as-needed")
-
-TARGET_LINK_LIBRARIES(${this_target} osp-appfw)
-TARGET_LINK_LIBRARIES(${this_target} ${server_pkgs_LDFLAGS})
-
-
-SET_TARGET_PROPERTIES(${this_target}
- PROPERTIES
- VERSION ${FULLVER}
- SOVERSION ${MAJORVER}
- CLEAN_DIRECT_OUTPUT 1
-)
-
-SET(PC_NAME ${this_target})
-SET(PC_REQUIRED ${pc_requires})
-SET(PC_LDFLAGS -l${this_target})
-SET(VERSION ${FULLVER})
-
-# pkgconfig file
-CONFIGURE_FILE(${CMAKE_SOURCE_DIR}/${this_target}.pc.in ${CMAKE_SOURCE_DIR}/${this_target}.pc @ONLY)
-
+## Add SubModules
+ADD_SUBDIRECTORY(appfw)
+++ /dev/null
-//
-// Copyright (c) 2012 Samsung Electronics Co., Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the License);
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-//
-
-/**
- * @file FApp_AulServer.cpp
- * @brief This is the implementation for the _AulServer.cpp class.
- */
-#include <cstdio>
-#include <cstdlib>
-#include <new>
-#include <unistd.h>
-#include <sys/prctl.h>
-#include <signal.h>
-#include <unique_ptr.h>
-
-#include <aul.h>
-#include <bundle.h>
-#include <appsvc/appsvc.h>
-
-#include <FBaseObject.h>
-#include <FBaseString.h>
-#include <FBaseUtil.h>
-#include <FBaseSysLog.h>
-#include <FBaseColHashMapT.h>
-#include <FAppPkgPackageInfo.h>
-
-#include <FBaseRt_Process.h>
-#include <FBase_StringConverter.h>
-#include "FAppPkg_PackageManagerImpl.h"
-#include "FApp_Types.h"
-#include "FApp_AulServer.h"
-#include "FApp_TemplateUtil.h"
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-extern int aul_listen_app_dead_signal(int (* func)(int, void*), void* data);
-#ifdef __cplusplus
-}
-#endif
-
-using namespace Tizen::App::Package;
-using namespace Tizen::Base;
-using namespace Tizen::Base::Collection;
-using namespace Tizen::Base::Runtime;
-using namespace Tizen::Base::Utility;
-
-namespace
-{
-
-const char _DESKTOP_FILE_PATH[] = "/opt/share/applications";
-const char _DESKTOP_FILE_PATH_FORMAT[] = "%s/%s.desktop";
-
-const char _X_TIZEN_SVC[] = "x-tizen-svc"; //X-TIZEN-SVC=[operation1] | [URI1] | [MIME1] ; [operation2] | [URI2] | [MIME2]
-const int _MAX_TIZEN_SVC_DESC_LEN = 1024;
-
-const int _MAX_CATEGORY = 12;
-const int _MAX_PACKAGE_ID_LENGTH = 10;
-
-const char _APP_PATH_FORMAT[] = "/opt/usr/apps/0000000000/bin/%ls";
-const char _APP_PATH_FORMAT2[] = "/opt/apps/0000000000/bin/%ls";
-const char PATH_ROOT[] = "/opt/usr/apps/";
-const char PATH_ROOT2[] = "/opt/apps/";
-
-}
-
-namespace Tizen { namespace App
-{
-
-struct _CategoryList
-{
- const char category[_MAX_CATEGORY];
- _AppType type;
-};
-
-static const _CategoryList _CATEGORY_LIST[] =
-{
- {"home-screen", _APP_TYPE_HOME_APP},
- {"lock-screen", _APP_TYPE_LOCK_APP},
- {"ime", _APP_TYPE_IME_APP},
-};
-
-static const int _NUM_CATEGORY = sizeof(_CATEGORY_LIST) / sizeof(_CategoryList);
-
-
-result
-_AulServer::SendResult(bundle* b, appsvc_result_val res)
-{
- result r = E_SUCCESS;
-
- int ret = appsvc_send_result(b, res);
-
- switch (ret)
- {
- case AUL_R_EINVAL:
- r = E_INVALID_ARG;
- SysLogException(NID_APP, r, "Invalid result bundle.");
- break;
-
- case AUL_R_ECOMM:
- r = E_SYSTEM;
- SysLogException(NID_APP, r, "Internal IPC error.");
- break;
-
- case AUL_R_ERROR:
- r = E_SYSTEM;
- SysLogException(NID_APP, r, "General error.");
- break;
-
- default:
- break;
- }
-
- SysLog(NID_APP, "SendResult() ok");
-
- return r;
-}
-
-
-bool
-_AulServer::IsRunning(const AppId& appId, const String& exeName)
-{
- char slpPackageName[MAX_SLP_PACKAGE_ID] = {0, };
-
- _PackageManagerImpl* pPackageManagerImpl = _PackageManagerImpl::GetInstance();
- SysTryReturn(NID_APP, pPackageManagerImpl != null, false, E_INVALID_STATE, "[E_INVALID_STATE] Invalid package instance.");
-
- pPackageManagerImpl->GetPackageName(appId, &exeName, slpPackageName, MAX_SLP_PACKAGE_ID);
-
- const bool isRunning = (aul_app_is_running(slpPackageName) > 0);
-
- SysLog(NID_APP, "'%s' %s running now.", slpPackageName, (isRunning) ? "is" : "is NOT");
-
- return isRunning;
-}
-
-bool
-_AulServer::IsRunning(const String& packageName)
-{
- std::unique_ptr<char[]> pPackageId(_StringConverter::CopyToCharArrayN(packageName));
-
- const bool isRunning = (aul_app_is_running(pPackageId.get()) > 0);
-
- SysLog(NID_APP, "'%ls' %s running now.", packageName.GetPointer(), (isRunning) ? "is" : "is NOT");
- return isRunning;
-}
-
-
-void
-_AulServer::SetOnAppTerminatedCb(int (* pf_app_dead_handler)(int pid, void* pData), void* pData)
-{
- aul_listen_app_dead_signal(pf_app_dead_handler, pData);
- SysLog(NID_APP, "'app_dead_handler is set.");
-}
-
-
-result
-_AulServer::TerminateApplicationByPid(int pid)
-{
- int ret_aul = aul_subapp_terminate_request_pid(pid);
- result r = E_SUCCESS;
-
- switch (ret_aul)
- {
- case AUL_R_EINVAL:
- r = E_INVALID_ARG;
- SysLogException(NID_APP, r, "invaild pid.\n");
- break;
-
- case AUL_R_ECOMM:
- r = E_SYSTEM;
- SysLogException(NID_APP, r, "internal AUL IPC error.\n");
- break;
-
- case AUL_R_ERROR:
- r = E_SYSTEM;
- SysLogException(NID_APP, r, "general error.\n");
- break;
-
- default:
- SysLog(NID_APP, "'%d' is terminated.", pid);
- break;
- }
-
- return r;
-}
-
-result
-_AulServer::SetOomAdj(int pid, int adj)
-{
- // set oom_adj to -17 for system service
- result r = E_SUCCESS;
- char buf[FILENAME_MAX];
- FILE *fP = NULL;
-
- snprintf(buf, FILENAME_MAX, "/proc/%d/oom_adj", pid);
- fP = fopen(buf, "w");
- SysTryReturnResult(NID_APP, fP != NULL, E_SYSTEM, "oom_adj change failed with %s.", strerror(errno));
-
- fprintf(fP, "%d", adj);
- fclose(fP);
-
- return r;
-}
-
-int
-_AulServer::GetAppType(const String& category)
-{
- int ret = 0;
-
- HashMapT<String, int> map;
- map.Construct();
-
- StringTokenizer strTok(category, L';');
-
- String token;
- while (strTok.HasMoreTokens())
- {
- result r = strTok.GetNextToken(token);
- if (r == E_SUCCESS)
- {
- map.Add(token, 0);
- }
- }
-
- SysLog(NID_APP, "%d category items .", map.GetCount());
-
- String key;
-
- for (int i = 0; i < _NUM_CATEGORY; i++)
- {
- bool b = false;
- key = _CATEGORY_LIST[i].category;
- result r = map.ContainsKey(key, b);
- if (r == E_SUCCESS && b)
- {
- ret |= _CATEGORY_LIST[i].type;
- }
- }
-
- return ret;
-}
-
-bool _AulServer::IsInstalled(const AppId& appId)
-{
- String packageId;
- packageId = _PackageManagerImpl::GetPackageIdByAppId(appId);
-
- return _PackageManagerImpl::GetInstance()->IsPackageInstalled(packageId);
-}
-
-int _AulServer::CreateProcess(const AppId& appId)
-{
- SysTryReturn(NID_APP, appId.GetLength() > 10 && appId[10] == L'.', -1, E_INVALID_ARG, "[E_INVALID_ARG] Wrong appId %ls.", appId.GetPointer());
-
- int pid = fork();
-
- if (pid == -1)
- {
- return -1;
- }
- else if (pid == 0)
- {
- char path[FILENAME_MAX];
- memset(path, '\0', FILENAME_MAX);
-
-#if 0
- snprintf(path, FILENAME_MAX, _APP_PATH_FORMAT2, appId.GetPointer() + 11);
-
- int ret = wcstombs(path + strlen(PATH_ROOT2), appId.GetPointer(), 10);
- if (ret == -1)
- {
- SysLogException(NID_APP, E_SYSTEM, "Launching service (%ls)(%s) failed with [%s].", appId.GetPointer(), path, strerror(errno));
- _Process::Exit(1);
- }
-#else
- snprintf(path, FILENAME_MAX, _APP_PATH_FORMAT2, appId.GetPointer() + 11);
-
- int ret = wcstombs(path + strlen(PATH_ROOT2), appId.GetPointer(), 10);
- if (ret == -1)
- {
- SysLogException(NID_APP, E_SYSTEM, "Launching service (%ls)(%s) failed with [%s].", appId.GetPointer(), path, strerror(errno));
- _Process::Exit(1);
- }
-
- if (euidaccess(path, R_OK) != 0)
- {
- snprintf(path, FILENAME_MAX, _APP_PATH_FORMAT, appId.GetPointer() + 11);
-
- ret = wcstombs(path + strlen(PATH_ROOT), appId.GetPointer(), 10);
- if (ret == -1)
- {
- SysLogException(NID_APP, E_SYSTEM, "Launching service (%ls)(%s) failed with [%s].", appId.GetPointer(), path, strerror(errno));
- _Process::Exit(1);
- }
- }
-#endif
-
- SysLog(NID_APP, "Launching %s.", path);
-
- int currentPid = getpid();
-
- //SetOomAdj(currentPid, -17); // set oom_adj to -17 for system service
-
- prctl(PR_SET_PDEATHSIG, SIGTERM);
-
- setpgid(currentPid, currentPid);
-
- ret = execl(path, path, static_cast<char*>(NULL));
- if (ret < 0)
- {
- SysLogException(NID_APP, E_SYSTEM, "Launching service (%ls)(%s) failed with [%s].", appId.GetPointer(), path, strerror(errno));
- _Process::Exit(1);
- }
- }
-
- return pid;
-
-}
-
-bool
-_AulServer::IsUserPreferredAppForAppControlResolution(const AppId& appId)
-{
- std::unique_ptr<char[]> pAppId(_StringConverter::CopyToCharArrayN(appId));
-
- int ret = appsvc_is_defapp(pAppId.get());
- SysTryReturn(NID_APP, ret == 1, false, E_SUCCESS,"%ls is not an UserPreferredAppForAppControlResolution. ret(%d)", appId.GetPointer(), ret);
-
- SysLog(NID_APP, "%ls is an UserPreferredAppForAppControlResolution.", appId.GetPointer());
- return true;
-}
-
-result
-_AulServer::ClearUserPreferenceForAppControlResolution(const AppId& appId)
-{
- std::unique_ptr<char[]> pAppId(_StringConverter::CopyToCharArrayN(appId));
-
- int ret_aul = appsvc_unset_defapp(pAppId.get());
- SysTryReturnResult(NID_APP, ret_aul == APPSVC_RET_OK, E_SYSTEM, "Fail to clear UserPreferredAppForAppControlResolution of %ls. ret_aul(%d)", appId.GetPointer(), ret_aul);
-
- SysLog(NID_APP, "Succeed to clear UserPreferredAppForAppControlResolution of %ls.", appId.GetPointer());
- return E_SUCCESS;
-}
-
-result
-_AulServer::_DesktopFile::MakePath(const AppId& appId, const String* pExeName, char* path, int size)
-{
- SysTryReturnResult(NID_APP, path != null, E_INVALID_ARG, "");
-
- char packageName[MAX_SLP_PACKAGE_ID] = {0, };
- result r = E_SUCCESS;
- _PackageManagerImpl* pPackageManagerImpl = _PackageManagerImpl::GetInstance();
- SysTryReturnResult(NID_APP, pPackageManagerImpl, E_INVALID_STATE, "Invalid package manager instance.");
-
- r = pPackageManagerImpl->GetPackageName(appId, pExeName, packageName, MAX_SLP_PACKAGE_ID);
- SysTryReturn(NID_APP, !IsFailed(r), r, r, "%s", GetErrorMessage(r));
-
- snprintf(path, size, _DESKTOP_FILE_PATH_FORMAT, _DESKTOP_FILE_PATH, packageName);
-
- return r;
-}
-
-result
-_AulServer::_DesktopFile::UpdateService(const AppId& appId, const char* value)
-{
- char path[FILENAME_MAX] = {0, };
- MakePath(appId, null, path, FILENAME_MAX);
-
- return UpdateField(path, _X_TIZEN_SVC, value);
-}
-
-
-result
-_AulServer::_DesktopFile::RemoveService(const AppId& appId, const char* operationOnlyValue)
-{
- char path[FILENAME_MAX] = {0, };
- MakePath(appId, null, path, FILENAME_MAX);
-
- return UpdateField(path, _X_TIZEN_SVC, operationOnlyValue, true);
-}
-
-
-//
-// Update value of specified field.
-// currently only "x-slp-svc" field is supported.
-//
-#define BUFFER_SIZE 1024
-result
-_AulServer::_DesktopFile::UpdateField(const char* path, const char* fieldName, const char* value, bool isRemove)
-{
- SysTryReturnResult(NID_APP, path != null, E_INVALID_ARG, "path should not be null.");
- SysTryReturnResult(NID_APP, fieldName != null, E_INVALID_ARG, "fieldName should not be null.");
- SysTryReturnResult(NID_APP, value != null, E_INVALID_ARG, "value should not be null.");
-
- FILE* fp = fopen(path, "r+");
- SysTryReturnResult(NID_APP, fp != null, E_SYSTEM, "falied to open '%s' due to %s", path, strerror(errno));
-
- char buffer[BUFFER_SIZE] = {0, };
- bool found = false;
- int len = 0;
- int pos = 0;
- int foundpos = 0;
- result r = E_SUCCESS;
- int remains = 0;
-
- ArrayListT<char*> buffers;
- buffers.Construct();
-
- char* pCurrent = null;
-
- while (fgets(buffer, BUFFER_SIZE, fp) != NULL)
- {
- len = strlen(buffer);
- SysTryCatch(NID_APP, len < BUFFER_SIZE, , r = E_INVALID_ARG, "strlen returns invalid value. (%d)", len );
-
- if (found)
- {
- pCurrent = new (std::nothrow) char[len + 1];
- SysTryCatch(NID_APP, pCurrent != null, , r = E_OUT_OF_MEMORY, "failed to allocate mem pCurrent");
-
- strncpy(pCurrent, buffer, len);
- buffers.Add(pCurrent);
- }
- else
- {
- if (strncmp(buffer, fieldName, len) == 0)
- {
- int fieldNameLen = strlen(fieldName);
- SysTryCatch(NID_APP, len > fieldNameLen, , E_INVALID_ARG, "[E_INVALID_ARG] fieldName(%s)", fieldName);
-
- pCurrent = UpdateServiceValueN(buffer + fieldNameLen, value, isRemove);
- SysTryCatch(NID_APP, pCurrent != null, , r = GetLastResult(), "[%s] UpdateServiceValue failed", GetErrorMessage(GetLastResult()));
-
- buffers.Add(pCurrent);
-
- foundpos = pos;
- found = true;
- }
- }
-
- pos += len;
- }
-
- if (found)
- {
- fsetpos(fp, (fpos_t*) &foundpos);
-
- remains = buffers.GetCount(); // prevent infinite loop
- while (buffers.GetCount() > 0 && remains-- > 0)
- {
- pCurrent = null;
- buffers.GetAt(0, pCurrent);
- buffers.RemoveAt(0);
- SysTryCatch(NID_APP, pCurrent != null, , r = E_INVALID_STATE, "");
-
- fputs(pCurrent, fp);
- len = strlen(pCurrent);
- pos += len;
- delete[] pCurrent;
- }
-
- int ret = truncate(path, pos);
- SysTryLog(NID_APP, ret == 0, "Truncate failure (%s).", strerror(errno));
- }
- else
- {
- char svctext[_MAX_TIZEN_SVC_DESC_LEN] = {0, };
- snprintf(svctext, _MAX_TIZEN_SVC_DESC_LEN, "%s=%s\n", fieldName, value);
- fputs(svctext, fp);
- }
- fclose(fp);
-
- return E_SUCCESS;
-
-CATCH:
-
- remains = buffers.GetCount(); // prevent infinite loop
- while (buffers.GetCount() > 0 && remains-- > 0)
- {
- pCurrent = null;
- buffers.GetAt(0, pCurrent);
- buffers.RemoveAt(0);
- if (pCurrent != null)
- {
- delete[] pCurrent;
- }
- }
-
- fclose(fp);
-
- return r;
-}
-
-//
-// Tizen service string example
-// X-TIZEN-SVC= http://tizen.org/appcontrol/operation/pick|NULL|image/jpge; http://tizen.org/appcontrol/operation/pick|NULL|video/mp4; http://tizen.org/appcontrol/operation/pick|NULL|NULL; http://tizen.org/appcontrol/operation/pview|NULL|NULL
-//
-char*
-_AulServer::_DesktopFile::UpdateServiceValueN(char* buffer, const char* newValue, bool isRemove)
-{
- SysTryReturn(NID_APP, buffer != null, null, E_INVALID_ARG, "");
- SysTryReturn(NID_APP, newValue != null, null, E_INVALID_ARG, "");
-
- SysLog(NID_APP, "current(%s), new(%s), isRemove(%s)", buffer, newValue, (isRemove) ? "true" : "false");
-
- String buf(buffer);
- bool found = false;
-
- const String& servicePattern(L"([A-Za-z&=:/\\.\\-]*);?");
-
- ArrayList services;
- String resultString;
-
- Utility::RegularExpression regex;
- result r = regex.Construct(servicePattern);
- SysTryReturn(NID_APP, !IsFailed(r), null, r, "");
-
- String newOperation;
- String newUrl;
- String newMimeType;
- String newService(newValue);
-
- if (isRemove == false)
- {
- ParseService(newService, newOperation, newUrl, newMimeType);
- }
- else
- {
- newOperation = newValue;
- }
-
- services.Construct();
-
- while (regex.Consume(buf, &services) == true)
- {
- String* pCurrentService = (String*) services.GetAt(1);
- services.RemoveAll(false);
-
- String operation;
- String url;
- String mimeType;
-
- ParseService(*pCurrentService, operation, url, mimeType);
-
- if (operation == newOperation)
- {
- if (isRemove == true)
- {
- SysLog(NID_APP, "opreration '%ls' will be removed", operation.GetPointer());
- }
- else
- {
- SysAssertf(found == false, "It's assumed that service doesn't have duplicated operation in tizen desktop file. But it isn't, so now we have to check this case.");
- // replace operation.
- if (found == false) // ( if duplicated operation is already exist, It will be keeped.
- {
- // update value
- AppendServiceValueToString(resultString, newService);
- SysLog(NID_APP, "opreration '%ls;%ls;%ls' will be updated to ;%ls;%ls", operation.GetPointer(), url.GetPointer(), mimeType.GetPointer(), newUrl.GetPointer(), mimeType.GetPointer());
- }
- }
- found = true;
- }
- else
- {
- // add not specified service.
- AppendServiceValueToString(resultString, *pCurrentService);
- }
-
- delete pCurrentService;
- }
-
- if (found == false && isRemove == false)
- {
- AppendServiceValueToString(resultString, newService);
- SysLog(NID_APP, "opreration '%ls;%ls;%ls' will be added", newOperation.GetPointer(), newUrl.GetPointer(), newMimeType.GetPointer());
- }
-
- SysLog(NID_APP, "updated string is '%ls'", resultString.GetPointer());
- return _StringConverter::CopyToCharArrayN(resultString);
-}
-
-
-void
-_AulServer::_DesktopFile::AppendServiceValueToString(String& serviceString, const String& newVaue)
-{
- if (serviceString.GetLength() > 0)
- {
- serviceString += ";";
- }
-
- serviceString += newVaue;
-}
-
-
-result
-_AulServer::_DesktopFile::ParseService(const String& service, String& operation, String& url, String& mimeType)
-{
- SysLog(NID_APP, "service(%ls)", service.GetPointer());
-
- const String& serviceDetailPattern(L"([A-Za-z&=/\\.\\-]*):(.*://[A-Za-z&=/\\.\\-]*|[A-Za-z&=/\\.\\-]*):([A-Za-z&=/\\.\\-]*)");
-
- Utility::RegularExpression regexDetail;
- result r = regexDetail.Construct(serviceDetailPattern);
- SysTryReturn(NID_APP, !IsFailed(r), null, r, "[%s] RegularExpression::Construct(L\"%ls\") failed.", GetErrorMessage(r), serviceDetailPattern.GetPointer());
-
- ArrayList matchedItems;
- matchedItems.Construct();
- regexDetail.Match(service, true, &matchedItems);
-
- int matchedCount = matchedItems.GetCount();
- SysTryLog(NID_APP, matchedCount == 4, "It's assumed that x-slp-svc value always have operation:url:mime in tizen desktop file. But it isn't or our parser is invalid. so now we have to check this case. %d", matchedItems.GetCount());
-
- if (matchedCount > 1)
- {
- operation = *(String*) matchedItems.GetAt(1);
- }
-
- if (matchedCount > 2)
- {
- url = *(String*) matchedItems.GetAt(2);
- }
-
- if (matchedCount > 3)
- {
- mimeType = *(String*) matchedItems.GetAt(3);
- }
-
- SysLog(NID_APP, "matched(%d) : (%ls;%ls;%ls)", matchedItems.GetCount(), operation.GetPointer(), url.GetPointer(), mimeType.GetPointer());
- matchedItems.RemoveAll(true);
-
- return E_SUCCESS;
-}
-
-} } // Tizen::App
--- /dev/null
+SET (this_target osp-appfw-server)
+
+INCLUDE_DIRECTORIES (
+ ${SLP_INCLUDE_DIRS}
+ ${CMAKE_SOURCE_DIR}/inc
+ ${CMAKE_SOURCE_DIR}/src/base/inc
+ ${CMAKE_SOURCE_DIR}/src/io/inc
+ ${CMAKE_SOURCE_DIR}/src/system/inc
+ ${CMAKE_SOURCE_DIR}/src/security/inc
+ ${CMAKE_SOURCE_DIR}/src/security
+ ${CMAKE_SOURCE_DIR}/src/app/inc
+ inc
+ )
+
+SET (${this_target}_SOURCE_FILES
+ app/FApp_AulServer.cpp
+ app/FApp_AppLaunchCondition.cpp
+ app/FApp_AppLaunchConditionHandlerBase.cpp
+ app/FApp_AppManagerEvent.cpp
+ app/package/FAppPkg_PackageManagerServer.cpp
+ io/FIo_IpcServer.cpp
+ security/FSec_PrivilegeManagerServer.cpp
+ )
+
+INCLUDE(FindPkgConfig)
+pkg_check_modules(server_pkgs REQUIRED
+ appsvc
+ chromium
+ dukgenerator
+ glib-2.0
+ pkgmgr-info
+)
+
+FOREACH(flag ${server_pkgs_CFLAGS})
+ SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} ${flag}")
+ENDFOREACH(flag)
+
+## SET EXTRA COMPILER FLAGS
+SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} -fPIC -Wall -Wno-unused")
+
+## SET C COMPILER FLAGS
+SET(CMAKE_C_FLAGS "${OSP_DEBUG_FLAGS} ${OSP_OPT_FLAGS} ${CMAKE_C_FLAGS} ${EXTRA_CFLAGS} ${OSP_COMPILER_FLAGS}")
+
+## SET CPP COMPILER FLAGS
+SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fvisibility=hidden")
+SET(CMAKE_CXX_FLAGS "${OSP_DEBUG_FLAGS} ${OSP_OPT_FLAGS} ${CMAKE_CXX_FLAGS} ${EXTRA_CFLAGS} ${OSP_COMPILER_FLAGS}")
+
+## Create Library
+ADD_LIBRARY (${this_target} SHARED ${${this_target}_SOURCE_FILES})
+
+SET(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -Wl,--no-undefined -Wl,--as-needed")
+
+TARGET_LINK_LIBRARIES(${this_target} osp-appfw)
+TARGET_LINK_LIBRARIES(${this_target} ${server_pkgs_LDFLAGS})
+
+
+SET_TARGET_PROPERTIES(${this_target}
+ PROPERTIES
+ VERSION ${FULLVER}
+ SOVERSION ${MAJORVER}
+ CLEAN_DIRECT_OUTPUT 1
+)
+ADD_CUSTOM_COMMAND(TARGET ${this_target}
+ POST_BUILD
+ COMMAND ${CMAKE_COMMAND} -E copy ${LIBRARY_OUTPUT_PATH}/${CMAKE_SHARED_LIBRARY_PREFIX}${this_target}${CMAKE_SHARED_LIBRARY_SUFFIX} ${LIBRARY_OUTPUT_PATH}/debug/${CMAKE_SHARED_LIBRARY_PREFIX}${this_target}${CMAKE_SHARED_LIBRARY_SUFFIX}.${FULLVER}
+ COMMAND ${CMAKE_COMMAND} -E create_symlink ${CMAKE_SHARED_LIBRARY_PREFIX}${this_target}${CMAKE_SHARED_LIBRARY_SUFFIX}.${FULLVER} ${LIBRARY_OUTPUT_PATH}/debug/${CMAKE_SHARED_LIBRARY_PREFIX}${this_target}${CMAKE_SHARED_LIBRARY_SUFFIX}.${MAJORVER}
+ COMMAND ${CMAKE_STRIP} --strip-unneeded ${LIBRARY_OUTPUT_PATH}/${CMAKE_SHARED_LIBRARY_PREFIX}${this_target}${CMAKE_SHARED_LIBRARY_SUFFIX}
+ COMMENT "strip ${this_target}"
+)
+
+SET(PC_NAME ${this_target})
+SET(PC_REQUIRED ${pc_requires})
+SET(PC_LDFLAGS -l${this_target})
+SET(VERSION ${FULLVER})
+
+# pkgconfig file
+CONFIGURE_FILE(${CMAKE_SOURCE_DIR}/${this_target}.pc.in ${CMAKE_SOURCE_DIR}/${this_target}.pc @ONLY)
+
--- /dev/null
+//
+// Copyright (c) 2012 Samsung Electronics Co., Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the License);
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+/**
+ * @file FApp_AulServer.cpp
+ * @brief This is the implementation for the _AulServer.cpp class.
+ */
+#include <cstdio>
+#include <cstdlib>
+#include <new>
+#include <unistd.h>
+#include <sys/prctl.h>
+#include <signal.h>
+#include <unique_ptr.h>
+
+#include <aul.h>
+#include <bundle.h>
+#include <appsvc/appsvc.h>
+
+#include <FBaseObject.h>
+#include <FBaseString.h>
+#include <FBaseUtil.h>
+#include <FBaseSysLog.h>
+#include <FBaseColHashMapT.h>
+#include <FAppPkgPackageInfo.h>
+
+#include <FBaseRt_Process.h>
+#include <FBase_StringConverter.h>
+#include "FAppPkg_PackageManagerImpl.h"
+#include "FApp_Types.h"
+#include "FApp_AulServer.h"
+#include "FApp_TemplateUtil.h"
+
+
+using namespace Tizen::App::Package;
+using namespace Tizen::Base;
+using namespace Tizen::Base::Collection;
+using namespace Tizen::Base::Runtime;
+using namespace Tizen::Base::Utility;
+
+namespace
+{
+
+const int _MAX_CATEGORY = 12;
+const int _MAX_PACKAGE_ID_LENGTH = 10;
+
+const char _APP_PATH_FORMAT[] = "/opt/usr/apps/0000000000/bin/%ls";
+const char _APP_PATH_FORMAT2[] = "/opt/apps/0000000000/bin/%ls";
+const char PATH_ROOT[] = "/opt/usr/apps/";
+const char PATH_ROOT2[] = "/opt/apps/";
+
+}
+
+namespace Tizen { namespace App
+{
+
+struct _CategoryList
+{
+ const char category[_MAX_CATEGORY];
+ _AppType type;
+};
+
+static const _CategoryList _CATEGORY_LIST[] =
+{
+ {"home-screen", _APP_TYPE_HOME_APP},
+ {"lock-screen", _APP_TYPE_LOCK_APP},
+ {"ime", _APP_TYPE_IME_APP},
+};
+
+static const int _NUM_CATEGORY = sizeof(_CATEGORY_LIST) / sizeof(_CategoryList);
+
+
+result
+_AulServer::SendResult(bundle* b, appsvc_result_val res)
+{
+ result r = E_SUCCESS;
+
+ int ret = appsvc_send_result(b, res);
+
+ switch (ret)
+ {
+ case AUL_R_EINVAL:
+ r = E_INVALID_ARG;
+ SysLogException(NID_APP, r, "Invalid result bundle.");
+ break;
+
+ case AUL_R_ECOMM:
+ r = E_SYSTEM;
+ SysLogException(NID_APP, r, "Internal IPC error.");
+ break;
+
+ case AUL_R_ERROR:
+ r = E_SYSTEM;
+ SysLogException(NID_APP, r, "General error.");
+ break;
+
+ default:
+ break;
+ }
+
+ SysLog(NID_APP, "SendResult() ok");
+
+ return r;
+}
+
+
+bool
+_AulServer::IsRunning(const AppId& appId, const String& exeName)
+{
+ char slpPackageName[MAX_SLP_PACKAGE_ID] = {0, };
+
+ _PackageManagerImpl* pPackageManagerImpl = _PackageManagerImpl::GetInstance();
+ SysTryReturn(NID_APP, pPackageManagerImpl != null, false, E_INVALID_STATE, "[E_INVALID_STATE] Invalid package instance.");
+
+ pPackageManagerImpl->GetPackageName(appId, &exeName, slpPackageName, MAX_SLP_PACKAGE_ID);
+
+ const bool isRunning = (aul_app_is_running(slpPackageName) > 0);
+
+ SysLog(NID_APP, "'%s' %s running now.", slpPackageName, (isRunning) ? "is" : "is NOT");
+
+ return isRunning;
+}
+
+bool
+_AulServer::IsRunning(const String& packageName)
+{
+ std::unique_ptr<char[]> pPackageId(_StringConverter::CopyToCharArrayN(packageName));
+
+ const bool isRunning = (aul_app_is_running(pPackageId.get()) > 0);
+
+ SysLog(NID_APP, "'%ls' %s running now.", packageName.GetPointer(), (isRunning) ? "is" : "is NOT");
+ return isRunning;
+}
+
+
+result
+_AulServer::Launch(const String& appId)
+{
+ std::unique_ptr<char[]> pPackageName(_StringConverter::CopyToCharArrayN(appId));
+
+ int ret = aul_launch_app(pPackageName.get(), NULL);
+ if (ret < 0)
+ {
+ result r = E_SYSTEM;
+ switch (ret)
+ {
+ case AUL_R_EILLACC:
+ r = E_ILLEGAL_ACCESS;
+ break;
+ case AUL_R_EINVAL:
+ r = E_MAX_EXCEEDED;
+ break;
+ default:
+ break;
+ }
+
+ SysLogException(NID_APP, r, "[%s] Error occurred.", GetErrorMessage(r));
+ return r;
+ }
+
+ return E_SUCCESS;
+}
+
+
+void
+_AulServer::SetOnAppTerminatedCb(int (* pf_app_dead_handler)(int pid, void* pData), void* pData)
+{
+ aul_listen_app_dead_signal(pf_app_dead_handler, pData);
+ SysLog(NID_APP, "'app_dead_handler is set.");
+}
+
+
+result
+_AulServer::TerminateApplicationByPid(int pid)
+{
+ int ret_aul = aul_terminate_pid(pid);
+ result r = E_SUCCESS;
+
+ switch (ret_aul)
+ {
+ case AUL_R_EINVAL:
+ r = E_INVALID_ARG;
+ SysLogException(NID_APP, r, "invaild pid.\n");
+ break;
+
+ case AUL_R_ECOMM:
+ r = E_SYSTEM;
+ SysLogException(NID_APP, r, "internal AUL IPC error.\n");
+ break;
+
+ case AUL_R_ERROR:
+ r = E_SYSTEM;
+ SysLogException(NID_APP, r, "general error.\n");
+ break;
+
+ default:
+ SysLog(NID_APP, "'%d' is terminated.", pid);
+ break;
+ }
+
+ return r;
+}
+
+result
+_AulServer::SetOomAdj(int pid, int adj)
+{
+ // set oom_adj to -17 for system service
+ result r = E_SUCCESS;
+ char buf[FILENAME_MAX];
+ FILE *fP = NULL;
+
+ snprintf(buf, FILENAME_MAX, "/proc/%d/oom_adj", pid);
+ fP = fopen(buf, "w");
+ SysTryReturnResult(NID_APP, fP != NULL, E_SYSTEM, "oom_adj change failed with %s.", strerror(errno));
+
+ fprintf(fP, "%d", adj);
+ fclose(fP);
+
+ return r;
+}
+
+int
+_AulServer::GetAppType(const String& category)
+{
+ int ret = 0;
+
+ HashMapT<String, int> map;
+ map.Construct();
+
+ StringTokenizer strTok(category, L';');
+
+ String token;
+ while (strTok.HasMoreTokens())
+ {
+ result r = strTok.GetNextToken(token);
+ if (r == E_SUCCESS)
+ {
+ map.Add(token, 0);
+ }
+ }
+
+ SysLog(NID_APP, "%d category items .", map.GetCount());
+
+ String key;
+
+ for (int i = 0; i < _NUM_CATEGORY; i++)
+ {
+ bool b = false;
+ key = _CATEGORY_LIST[i].category;
+ result r = map.ContainsKey(key, b);
+ if (r == E_SUCCESS && b)
+ {
+ ret |= _CATEGORY_LIST[i].type;
+ }
+ }
+
+ return ret;
+}
+
+bool _AulServer::IsInstalled(const AppId& appId)
+{
+ String packageId;
+ packageId = _PackageManagerImpl::GetPackageIdByAppId(appId);
+
+ return _PackageManagerImpl::GetInstance()->IsPackageInstalled(packageId);
+}
+
+int _AulServer::CreateProcess(const AppId& appId)
+{
+ SysTryReturn(NID_APP, appId.GetLength() > 10 && appId[10] == L'.', -1, E_INVALID_ARG, "[E_INVALID_ARG] Wrong appId %ls.", appId.GetPointer());
+
+ int pid = fork();
+
+ if (pid == -1)
+ {
+ return -1;
+ }
+ else if (pid == 0)
+ {
+ char path[FILENAME_MAX];
+ memset(path, '\0', FILENAME_MAX);
+
+#if 0
+ snprintf(path, FILENAME_MAX, _APP_PATH_FORMAT2, appId.GetPointer() + 11);
+
+ int ret = wcstombs(path + strlen(PATH_ROOT2), appId.GetPointer(), 10);
+ if (ret == -1)
+ {
+ SysLogException(NID_APP, E_SYSTEM, "Launching service (%ls)(%s) failed with [%s].", appId.GetPointer(), path, strerror(errno));
+ _Process::Exit(1);
+ }
+#else
+ snprintf(path, FILENAME_MAX, _APP_PATH_FORMAT2, appId.GetPointer() + 11);
+
+ int ret = wcstombs(path + strlen(PATH_ROOT2), appId.GetPointer(), 10);
+ if (ret == -1)
+ {
+ SysLogException(NID_APP, E_SYSTEM, "Launching service (%ls)(%s) failed with [%s].", appId.GetPointer(), path, strerror(errno));
+ _Process::Exit(1);
+ }
+
+ if (euidaccess(path, R_OK) != 0)
+ {
+ snprintf(path, FILENAME_MAX, _APP_PATH_FORMAT, appId.GetPointer() + 11);
+
+ ret = wcstombs(path + strlen(PATH_ROOT), appId.GetPointer(), 10);
+ if (ret == -1)
+ {
+ SysLogException(NID_APP, E_SYSTEM, "Launching service (%ls)(%s) failed with [%s].", appId.GetPointer(), path, strerror(errno));
+ _Process::Exit(1);
+ }
+ }
+#endif
+
+ SysLog(NID_APP, "Launching %s.", path);
+
+ int currentPid = getpid();
+
+ //SetOomAdj(currentPid, -17); // set oom_adj to -17 for system service
+
+ prctl(PR_SET_PDEATHSIG, SIGTERM);
+
+ setpgid(currentPid, currentPid);
+
+ ret = execl(path, path, static_cast<char*>(NULL));
+ if (ret < 0)
+ {
+ SysLogException(NID_APP, E_SYSTEM, "Launching service (%ls)(%s) failed with [%s].", appId.GetPointer(), path, strerror(errno));
+ _Process::Exit(1);
+ }
+ }
+
+ return pid;
+
+}
+
+bool
+_AulServer::IsUserPreferredAppForAppControlResolution(const AppId& appId)
+{
+ std::unique_ptr<char[]> pAppId(_StringConverter::CopyToCharArrayN(appId));
+
+ int ret = appsvc_is_defapp(pAppId.get());
+ SysTryReturn(NID_APP, ret == 1, false, E_SUCCESS,"%ls is not an UserPreferredAppForAppControlResolution. ret(%d)", appId.GetPointer(), ret);
+
+ SysLog(NID_APP, "%ls is an UserPreferredAppForAppControlResolution.", appId.GetPointer());
+ return true;
+}
+
+result
+_AulServer::ClearUserPreferenceForAppControlResolution(const AppId& appId)
+{
+ std::unique_ptr<char[]> pAppId(_StringConverter::CopyToCharArrayN(appId));
+
+ int ret_aul = appsvc_unset_defapp(pAppId.get());
+ SysTryReturnResult(NID_APP, ret_aul == APPSVC_RET_OK, E_SYSTEM, "Fail to clear UserPreferredAppForAppControlResolution of %ls. ret_aul(%d)", appId.GetPointer(), ret_aul);
+
+ SysLog(NID_APP, "Succeed to clear UserPreferredAppForAppControlResolution of %ls.", appId.GetPointer());
+ return E_SUCCESS;
+}
+
+} } // Tizen::App
static bool IsRunning(const Tizen::Base::String& packageName);
+ static result Launch(const Tizen::Base::String& appId);
+
static void SetOnAppTerminatedCb(int (* pf_app_dead_handler)(int pid, void* pData), void* pData);
static result SetOomAdj(int pid, int adj);
static result ClearUserPreferenceForAppControlResolution(const AppId& appId);
public:
- /**
- * This is static helper class for desktop file.
- */
- class _DesktopFile
- {
- public:
- /**
- * Updates the service value
- * @param[in] appId The application's ID to be executed
- * @param[in] value value to be added or updated.
- *
- * @remark If operations is new, it will be appended.
- * but, if same operation is already exist, 'url' and 'mimeType' will be updated.
- */
- static result UpdateService(const AppId& appId, const char* value);
-
- /**
- * Removes the service value by operation
- * @param[in] appId The application's ID to be executed
- * @param[in] operationOnlyValue operationId of service to be removed
- */
- static result RemoveService(const AppId& appId, const char* operationOnlyValue);
-
- private:
- /**
- * Updates value of specified field
- */
- static result UpdateField(const char* path, const char* key, const char* value, bool isRemove = false);
-
- /**
- * Makes desktop file path from appId (retrives appName using _PackageMamagerImpl)
- */
- static result MakePath(const AppId& appId, const Tizen::Base::String* pExeName, char* path, int size);
-
- /**
- * Update service value of input buffer with specified value
- */
- static char* UpdateServiceValueN(char* buffer, const char* newValue, bool isRemove = false);
-
- /**
- * Extracts each informations from one service string.
- */
- static result ParseService(const Tizen::Base::String& service, Tizen::Base::String& operation, Tizen::Base::String& url, Tizen::Base::String& mimeType);
-
- static void AppendServiceValueToString(Tizen::Base::String& string, const Tizen::Base::String& newVaue);
-
- friend class UTs_AulServer;
- }; // _DesktopFile
-
friend class UTs_AulServer;
}; // _AulServer
_PrivilegeManagerServer(void);
virtual ~_PrivilegeManagerServer(void);
- static result RetrievePrivilege(const Tizen::App::AppId& appId, Tizen::Base::String* pEncryptedBitwise, Tizen::Base::String* pHmac, Tizen::Base::Collection::ArrayList*& pPrivilegeList);
+ static result RetrievePrivilege(const Tizen::App::AppId& appId, Tizen::Base::String* pEncryptedBitwise, Tizen::Base::String* pHmac, Tizen::Base::Collection::ArrayListT < Tizen::Base::String >*& pPrivilegeList);
static result GenerateVisibilityString(Tizen::App::AppId appId, Tizen::Base::String* pEncryptedVisibility, Tizen::Base::String* pHmac);
static result GetEncryptedVisibility(int visibility, Tizen::Base::String& encryptedVisibility);
static result GetChecksum(Tizen::App::AppId appId, int visibility, Tizen::Base::String& checksum);
}
result
-_PrivilegeManagerServer::RetrievePrivilege(const AppId& appId, String* pEncryptedBitwise, String* pHmac, ArrayList*& pPrivilegeList)
+_PrivilegeManagerServer::RetrievePrivilege(const AppId& appId, String* pEncryptedBitwise, String* pHmac, ArrayListT < String >*& pPrivilegeList)
{
result r = E_SUCCESS;
String encryptedBitwise;
while (pEnum->MoveNext() == E_SUCCESS)
{
String* tempString = static_cast<String*>(pEnum->GetCurrent());
- pPrivilegeList->Add(new String(*tempString));
+ pPrivilegeList->Add(*tempString);
}
delete pEnum;
${CMAKE_SOURCE_DIR}/inc
${CMAKE_SOURCE_DIR}/src/app/inc
${CMAKE_SOURCE_DIR}/src/base/inc
- ${CMAKE_SOURCE_DIR}/src/system-server/inc
+ ${CMAKE_SOURCE_DIR}/src/server/system/inc
${CMAKE_SOURCE_DIR}/src/io/inc
${CMAKE_SOURCE_DIR}/src/server/inc
${CMAKE_SOURCE_DIR}/src/system/inc
--- /dev/null
+//
+// Copyright (c) 2012 Samsung Electronics Co., Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the License);
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+/**
+ * @file FSys_DeviceManager.cpp
+ * @brief This is the implementation file for _DeviceManager class.
+ */
+
+#include <new>
+#include <system/media_key.h>
+#include <bluetooth.h>
+#include <vconf.h>
+
+#include <FBaseSysLog.h>
+#include <FSys_DeviceManagerEventProvider.h>
+#include "FSys_DeviceManager.h"
+
+using namespace Tizen::App;
+using namespace Tizen::Io;
+using namespace Tizen::System;
+using namespace Tizen::Base;
+using namespace Tizen::Base::Collection;
+
+namespace {
+ const static wchar_t* DEVICE_MANAGER_SERVICE_ID = L"osp.devicemanager.service";
+ const static wchar_t* DEVICE_MANAGER_BLUETOOTH = L"osp.devicemanager.bluetooth";
+
+ const static wchar_t* BLUETOOTH_A2DP_CONNECTED = L"Connected";
+ const static wchar_t* BLUETOOTH_A2DP_DISCONNECTED = L"Disconnected";
+ const static wchar_t* BLUETOOTH_A2DP_PLAY = L"Play";
+ const static wchar_t* BLUETOOTH_A2DP_STOP = L"Stop";
+ const static wchar_t* BLUETOOTH_A2DP_PAUSE = L"Pause";
+ const static wchar_t* BLUETOOTH_A2DP_RESUME = L"Resume";
+ const static wchar_t* BLUETOOTH_A2DP_FORWARD = L"Forward";
+ const static wchar_t* BLUETOOTH_A2DP_FASTFORWARD = L"FastForward";
+ const static wchar_t* BLUETOOTH_A2DP_BACKWARD = L"Backward";
+ const static wchar_t* BLUETOOTH_A2DP_REWIND = L"Rewind";
+}
+
+Tizen::System::_DeviceManager* Tizen::System::_DeviceManager::__pDeviceManager = null;
+
+void bluetooth_connection_state_changed(int result, bool connected, const char* remote_address, bt_audio_profile_type_e type, void* user_data)
+{
+ SysLog(NID_SYS, "Bluetooth headset[%s] connection[%d] event", remote_address, connected);
+ String bt_event;
+ _DeviceManager* pDeviceManager = _DeviceManager::GetInstance();
+ SysTryReturn(NID_SYS, pDeviceManager, ,E_SYSTEM, "DeviceManager is not created");
+
+ IDeviceEventListener* pDeviceEventListener = pDeviceManager->GetEventListener();
+
+ if(pDeviceEventListener)
+ {
+ if(connected == true)
+ {
+ bt_event = BLUETOOTH_A2DP_CONNECTED;
+ }
+ else
+ {
+ bt_event = BLUETOOTH_A2DP_DISCONNECTED;
+ }
+
+ pDeviceEventListener->OnDeviceStateChanged(DEVICE_TYPE_BLUETOOTH_HEADSET, bt_event);
+ }
+ pDeviceManager->SetBluetoothStatus(connected);
+}
+
+void app_media_key_handler(media_key_e key, media_key_event_e status, void* pUserData)
+{
+ String event;
+ SysLog(NID_SYS, "Bluetooth headset event is occured %d, %d", (int)key, (int)status);
+ _DeviceManager* pDeviceManager = _DeviceManager::GetInstance();
+ SysTryReturn(NID_SYS, pDeviceManager, ,E_SYSTEM, "DeviceManager is not created");
+
+ if(status == MEDIA_KEY_STATUS_RELEASED)
+ {
+ switch(key)
+ {
+ case MEDIA_KEY_PLAY:
+ event = BLUETOOTH_A2DP_PLAY;
+ break;
+ case MEDIA_KEY_STOP:
+ event = BLUETOOTH_A2DP_STOP;
+ break;
+ case MEDIA_KEY_PAUSE:
+ event = BLUETOOTH_A2DP_PAUSE;
+ break;
+ case MEDIA_KEY_PREVIOUS:
+ event = BLUETOOTH_A2DP_BACKWARD;
+ break;
+ case MEDIA_KEY_NEXT:
+ event = BLUETOOTH_A2DP_FORWARD;
+ break;
+ case MEDIA_KEY_FASTFORWARD:
+ event = BLUETOOTH_A2DP_FASTFORWARD;
+ break;
+ case MEDIA_KEY_REWIND:
+ event = BLUETOOTH_A2DP_REWIND;
+ break;
+ case MEDIA_KEY_UNKNOWN:
+ default:
+ SysLog(NID_SYS, "Unsupported key[%d] is occured.", key);
+ return;
+ }
+
+ IDeviceEventListener* pDeviceEventListener = pDeviceManager->GetEventListener();
+ if (pDeviceEventListener)
+ {
+ pDeviceEventListener->OnDeviceStateChanged(DEVICE_TYPE_BLUETOOTH_HEADSET, event);
+ }
+ }
+}
+
+_DeviceManager::_DeviceManager()
+ : isBluetoothHeadSetConnected(false)
+ , isInitBluetooth(false)
+ , __pDeviceManagerListener(null)
+{
+}
+
+_DeviceManager::~_DeviceManager()
+{
+ if(isInitBluetooth == true)
+ {
+ int btResult = 0;
+ media_key_release();
+ btResult = bt_audio_unset_connection_state_changed_cb();
+ SysTryReturnVoidResult(NID_SYS, btResult == BT_ERROR_NONE, E_SYSTEM, "It is failed to unregister bluetooth headset connection event");
+
+ btResult = bt_audio_deinitialize();
+ SysTryReturnVoidResult(NID_SYS, btResult == BT_ERROR_NONE, E_SYSTEM, "It is failed to close bluetooth");
+
+ btResult = bt_deinitialize();
+ SysTryReturnVoidResult(NID_SYS, btResult == BT_ERROR_NONE, E_SYSTEM, "It is failed to init bluetooth module");
+ isInitBluetooth = false;
+ }
+}
+
+_DeviceManager*
+_DeviceManager::GetInstance(void)
+{
+ static pthread_once_t onceBlock = PTHREAD_ONCE_INIT;
+ if(__pDeviceManager == null)
+ {
+ pthread_once(&onceBlock, InitSingleton);
+ }
+ return __pDeviceManager;
+}
+
+void
+_DeviceManager::InitSingleton(void)
+{
+ SysLog(NID_SYS,"InitSingleton");
+ __pDeviceManager = new (std::nothrow) _DeviceManager();
+ SysTryReturn(NID_SYS, __pDeviceManager, , E_OUT_OF_MEMORY, "It is not enough memory.");
+ atexit(DestroySingleton);
+}
+
+
+void
+_DeviceManager::DestroySingleton(void)
+{
+ SysLog(NID_SYS,"DestorySingleton");
+ if (__pDeviceManager)
+ {
+ delete __pDeviceManager;
+ __pDeviceManager = null;
+ }
+}
+result
+_DeviceManager::InitializeDevice(void)
+{
+ result r = E_SUCCESS;
+
+ if(isInitBluetooth == false)
+ {
+ int btResult = 0;
+ btResult = bt_initialize();
+ SysTryReturnResult(NID_SYS, btResult == BT_ERROR_NONE, E_SYSTEM, "It is failed to init bluetooth module");
+
+ btResult = bt_audio_initialize();
+ SysTryReturnResult(NID_SYS, btResult == BT_ERROR_NONE, E_SYSTEM, "It is failed to init bluetooth audio module");
+
+ btResult = bt_audio_set_connection_state_changed_cb(bluetooth_connection_state_changed, null);
+ SysTryReturnResult(NID_SYS, btResult == BT_ERROR_NONE, E_SYSTEM, "It is failed to register bluetooth audio event");
+ isInitBluetooth = true;
+ }
+
+ media_key_reserve(app_media_key_handler, null);
+ return r;
+}
+
+
+result
+_DeviceManager::DeinitializeDevice(void)
+{
+ result r = E_SUCCESS;
+ media_key_release();
+ return r;
+}
+
+
+result
+_DeviceManager::RegisterListner(IDeviceEventListener &listener)
+{
+ __pDeviceManagerListener = &listener;
+ return E_SUCCESS;
+}
+
+result
+_DeviceManager::UnregisterListner(IDeviceEventListener &listener)
+{
+ __pDeviceManagerListener = null;
+ return E_SUCCESS;
+}
+
+IDeviceEventListener*
+_DeviceManager::GetEventListener()
+{
+ return __pDeviceManagerListener;
+}
+
+String
+_DeviceManager::GetId(void)
+{
+ return DEVICE_MANAGER_SERVICE_ID;
+}
+
+bool
+_DeviceManager::GetBluetoothStatus(void)
+{
+ int ret = -1;
+ int errorCode = vconf_get_int(VCONFKEY_BT_DEVICE, &ret);
+ SysTryReturn(NID_SYS, errorCode == 0, isBluetoothHeadSetConnected, E_SYSTEM, "It is failed to get bt status. errorCode [%d]", errorCode);
+
+ if (ret & VCONFKEY_BT_DEVICE_HEADSET_CONNECTED || ret & VCONFKEY_BT_DEVICE_A2DP_HEADSET_CONNECTED)
+ {
+ isBluetoothHeadSetConnected = true;
+ }
+ else
+ {
+ isBluetoothHeadSetConnected = false;
+ }
+ return isBluetoothHeadSetConnected;
+}
+void
+_DeviceManager::SetBluetoothStatus(bool status)
+{
+ isBluetoothHeadSetConnected = status;
+}
--- /dev/null
+//
+// Copyright (c) 2012 Samsung Electronics Co., Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the License);
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+/**
+ * @file FSys_DeviceManager.h
+ * @brief This is the header file of the _DeviceManager class.
+ *
+ * This header file contains the declarations of the _DeviceManager class.
+ */
+#include <FApp.h>
+#include <FBase.h>
+#include <FSys_IDeviceManagerEventListener.h>
+#include <FSysIDeviceEventListener.h>
+
+#ifndef _FSYS_INTERNAL_DEVICE_MANAGER_H_
+#define _FSYS_INTERNAL_DEVICE_MANAGER_H_
+
+namespace Tizen { namespace System {
+
+/**
+ * @class _DeviceManager
+ * @brief This class contains implementaion of device control.
+ * @since 2.1
+ */
+class _OSP_EXPORT_ _DeviceManager
+{
+private:
+ _DeviceManager(void);
+ virtual ~_DeviceManager(void);
+public:
+ virtual result InitializeDevice(void);
+ virtual result DeinitializeDevice(void);
+ virtual result RegisterListner(IDeviceEventListener &listener);
+ virtual result UnregisterListner(IDeviceEventListener &listener);
+ IDeviceEventListener* GetEventListener();
+
+ virtual Tizen::Base::String GetId(void);
+ void SetBluetoothStatus(bool status);
+ virtual bool GetBluetoothStatus(void);
+ static _DeviceManager* GetInstance(void);
+private:
+ static void InitSingleton(void);
+ static void DestroySingleton(void);
+private:
+ static _DeviceManager* __pDeviceManager;
+ bool isBluetoothHeadSetConnected;
+ bool isInitBluetooth;
+ IDeviceEventListener* __pDeviceManagerListener;
+}; //_DeviceManager
+
+}} //Tizen::System
+#endif /* _FSYS_INTERNAL_DEVICE_MANAGER_H_ */
--- /dev/null
+//
+// Copyright (c) 2012 Samsung Electronics Co., Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the License);
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+/**
+ * @file FSys_PowerManager.h
+ * @brief This is the header file for the _PowerManager class.
+ */
+
+#ifndef _FSYS_SERVICE_SYS_POWER_MANAGER__H_
+#define _FSYS_SERVICE_SYS_POWER_MANAGER__H_
+
+#include <FApp.h>
+#include <FBase.h>
+
+namespace Tizen { namespace System
+{
+class _OSP_EXPORT_ _PowerManager
+{
+public:
+ static result ChangeBrightness(int brightness);
+private:
+ _PowerManager();
+ virtual ~_PowerManager();
+};
+
+} } // Tizen::System
+
+#endif // _FSYS_SERVICE_SYS_POWER_MANAGER__H_
--- /dev/null
+//
+// Copyright (c) 2012 Samsung Electronics Co., Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the License);
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+/**
+ * @file FSys_RuntimeInfo.h
+ * @brief This is the header file for the _RuntimeInfo class.
+ */
+
+#ifndef _FSYS_SERVICE_SYS_RUNTIME_INFO__H_
+#define _FSYS_SERVICE_SYS_RUNTIME_INFO__H_
+
+#include <pthread.h>
+
+#include <FApp.h>
+#include <FBase.h>
+
+namespace Tizen { namespace System
+{
+class _OSP_EXPORT_ _RuntimeInfo
+{
+public:
+ static _RuntimeInfo* GetInstance(void);
+
+public:
+ long long GetDirectorySize(const char* path);
+
+private:
+ _RuntimeInfo();
+ virtual ~_RuntimeInfo();
+
+ bool IsMounted(const char* path);
+ long long GetDirectorySizeIteratively(const char* path);
+
+private:
+ static _RuntimeInfo* __pRuntimeInfo;
+
+ pthread_mutex_t __directory;
+};
+
+} } // Tizen::System
+
+#endif // _FSYS_SERVICE_SYS_RUNTIME_INFO__H_
--- /dev/null
+//
+// Copyright (c) 2012 Samsung Electronics Co., Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the License);
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+/**
+ * @file FSys_PowerManager.cpp
+ * @brief This is the implementation file for _PowerManager class.
+ */
+
+#include <device.h>
+#include <system_info.h>
+
+#include <FBaseSysLog.h>
+#include "FSys_PowerManager.h"
+
+using namespace Tizen::Base;
+
+namespace Tizen { namespace System
+{
+
+_PowerManager::_PowerManager()
+{
+}
+
+_PowerManager::~_PowerManager()
+{
+}
+
+result
+_PowerManager::ChangeBrightness(int brightness)
+{
+ int ret = DEVICE_ERROR_NONE;
+ int maxBrightness;
+
+ ret = device_get_max_brightness(0, &maxBrightness);
+ SysTryReturnResult(NID_SYS, ret == DEVICE_ERROR_NONE, E_SYSTEM, "It failed to get the device max brightness");
+ SysTryReturnResult(NID_SYS, (brightness >= 0 && brightness <= maxBrightness), E_OUT_OF_RANGE,
+ "[E_OUT_OF_RANGE] The specified brightness is out of range.[%d]", brightness);
+
+ if (brightness == 0)
+ {
+ ret = device_set_brightness_from_settings(0);
+ }
+ else
+ {
+ ret = device_set_brightness(0, brightness);
+ }
+
+ SysTryReturnResult(NID_SYS, ret == DEVICE_ERROR_NONE, E_SYSTEM, "It is failed to change brightness. error code [%d]", ret);
+
+ return E_SUCCESS;
+}
+} } // Tizen::System
--- /dev/null
+//
+// Copyright (c) 2012 Samsung Electronics Co., Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the License);
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+/**
+ * @file FSys_RuntimeInfo.cpp
+ * @brief This is the implementation file for _RuntimeInfo class.
+ */
+
+#include <pthread.h>
+#include <errno.h>
+#include <string.h>
+#include <stdio.h>
+#include <dirent.h>
+#include <sys/stat.h>
+#include <mntent.h>
+
+#include <FBaseSysLog.h>
+#include "FSys_RuntimeInfo.h"
+
+using namespace Tizen::Base;
+
+namespace Tizen { namespace System
+{
+
+_RuntimeInfo* _RuntimeInfo::__pRuntimeInfo = null;
+
+_RuntimeInfo::_RuntimeInfo()
+{
+ pthread_mutex_init(&__directory, NULL);
+}
+
+_RuntimeInfo::~_RuntimeInfo()
+{
+ pthread_mutex_destroy(&__directory);
+}
+
+_RuntimeInfo*
+_RuntimeInfo::GetInstance(void)
+{
+ if(__pRuntimeInfo == null)
+ {
+ __pRuntimeInfo = new (std::nothrow) _RuntimeInfo();
+ }
+
+ return __pRuntimeInfo;
+}
+
+long long
+_RuntimeInfo::GetDirectorySize(const char* path)
+{
+ long long size = 0;
+
+ pthread_mutex_lock(&__directory);
+ size = GetDirectorySizeIteratively(path);
+ pthread_mutex_unlock(&__directory);
+
+ return size;
+}
+
+bool
+_RuntimeInfo::IsMounted(const char* path)
+{
+ FILE* fp = null;
+ result r = E_SUCCESS;
+ bool mounted = false;
+ const char* table = "/etc/mtab";
+ struct mntent mnt;
+ char buf[256];
+
+ fp = setmntent(table, "r");
+ SysTryCatch(NID_SYS, fp != null, r = E_SYSTEM, r, "It is failed to open mount table.");
+
+ SysLog(NID_SYS, "path: %s", path);
+ while(getmntent_r(fp, &mnt, buf, sizeof(buf)))
+ {
+ SysLog(NID_SYS, "mnt_dir: %s", mnt.mnt_dir);
+ if(strcmp(mnt.mnt_dir, path) == 0)
+ {
+ mounted = true;
+ break;
+ }
+ }
+
+CATCH:
+ if(fp != null)
+ {
+ endmntent(fp);
+ }
+ return mounted;
+}
+
+long long
+_RuntimeInfo::GetDirectorySizeIteratively(const char* path)
+{
+ struct dirent *de;
+ struct stat buf;
+ DIR* d = opendir(path);
+ long long total_size = 0;
+ if(d == null)
+ {
+ return 0;
+ }
+ SysLog(NID_SYS, "path %s", path);
+ for (de = readdir(d); de != null; de = readdir(d))
+ {
+ char filePath[1024] = {0,};
+ int length = strlen(path) + strlen(de->d_name);
+ SysTryReturn(NID_SYS, length > 0 && length < 1023, 0, E_INVALID_ARG, "The file path is invalid");
+ sprintf(filePath, "%s%s", path, de->d_name);
+
+ if (lstat(filePath, &buf) == 0)
+ {
+ if (S_ISLNK(buf.st_mode) == true)
+ {
+ total_size += buf.st_size;
+ }
+ else // reg file
+ {
+ if(stat(filePath, &buf) == 0)
+ {
+ if(S_ISDIR(buf.st_mode) == true)
+ {
+ char directoryName[1024] = {0,};
+ sprintf(directoryName, "%s%s/", path, de->d_name);
+ if(strcmp(de->d_name, ".") != 0 && strcmp(de->d_name, "..") != 0)
+ {
+ if(IsMounted(filePath) == false)
+ {
+ total_size += GetDirectorySizeIteratively(directoryName);
+ }
+ }
+ total_size += buf.st_size;
+ }
+ else
+ {
+ total_size += buf.st_size;
+ }
+ }
+ }
+ }
+ }
+ closedir(d);
+ return total_size;
+}
+} } // Tizen::System
result
SettingInfo::GetValueForPrivilegedKey(const String& key, bool& value)
{
+ result r = _AccessController::CheckUserPrivilege(_PRV_SETTINGMANAGER_READ);
+ SysTryReturn(NID_SYS, r == E_SUCCESS, E_PRIVILEGE_DENIED, E_PRIVILEGE_DENIED, ("[E_PRIVILEGE_DENIED] The application does not have the privilege to call this method."));
+
return _SettingInfoImpl::GetValueForPrivilegedKey(key, value);
}
alarm_cancel_all();
}
+int alarm_callback(alarm_id_t alarmId, void *user_param)
+{
+ _AlarmManager* pAlarmManager = _AlarmManager::GetInstance();
+ SysTryReturn(NID_SYS, pAlarmManager, -1, E_SYSTEM, "It is fail to get AlarmManager.");
+ pAlarmManager->OnAlarmExpired((int)alarmId);
+ return 0;
+}
+
+result
+_AlarmManager::Construct(void)
+{
+ int errorCode;
+ Tizen::App::App* pApp = null;
+ pApp = Tizen::App::App::GetInstance();
+ SysTryReturnResult(NID_SYS, pApp, E_SYSTEM, "It is failed to get app instance.");
+ String appId = pApp->GetAppId();
+ std::unique_ptr<char[]> pAppId(_StringConverter::CopyToCharArrayN(appId));
+ errorCode = alarmmgr_init(pAppId.get());
+ SysTryReturnResult(NID_SYS, errorCode == ALARMMGR_RESULT_SUCCESS, E_SYSTEM, "It is failed to init alarmmgr. error [%d]", errorCode);
+ errorCode = alarmmgr_set_cb(alarm_callback, null);
+ SysTryReturnResult(NID_SYS, errorCode == ALARMMGR_RESULT_SUCCESS, E_SYSTEM, "It is failed to set cb to alarmmgr. error [%d]", errorCode);
+ return E_SUCCESS;
+}
+
_AlarmManager*
_AlarmManager::GetInstance(void)
{
void
_AlarmManager::InitSingleton(void)
{
- _AlarmManager* pAlarmManager = new (std::nothrow) _AlarmManager();
+ result r = E_SUCCESS;
+ std::unique_ptr<_AlarmManager> pAlarmManager(new (std::nothrow) _AlarmManager());
SysTryReturnVoidResult(NID_SYS, pAlarmManager, E_OUT_OF_MEMORY, "[%s] Memory allocation failed.",
GetErrorMessage(E_OUT_OF_MEMORY));
-
- __pAlarmManager = pAlarmManager;
+ r = pAlarmManager->Construct();
+ SysTryReturnVoidResult(NID_SYS, r == E_SUCCESS, E_SYSTEM, "It is failed to construct alarm manager.");
+ __pAlarmManager = pAlarmManager.release();
std::atexit(DestroySingleton);
}
ret = alarmmgr_set_type(pAlarmInfo, ALARM_TYPE_NOLAUNCH);
SysTryCatch(NID_SYS, ret == ALARMMGR_RESULT_SUCCESS, r = E_SYSTEM, r, "It is failed to set repeat mode");
- ret = alarmmgr_add_alarm_appsvc_with_localtime(pAlarmInfo,(void *)pBundle, &reservedAlarmId);
+ ret = alarmmgr_add_alarm_with_localtime(pAlarmInfo, null, &reservedAlarmId);
SysTryCatch(NID_SYS, ret == ALARMMGR_RESULT_SUCCESS, r = E_SYSTEM, r, "Alarm creation failed!!! Alrmgr error code is %d", ret);
CATCH:
_AlarmImpl* pAlarmImpl = null;
SysTryCatch(NID_SYS, __pAlarmHashMap != null, r = E_SYSTEM, r, "Alarm list does not initialized");
+
+ ret = pthread_mutex_lock(&__lock);
+ SysTryReturnVoidResult(NID_SYS, ret == 0, E_SYSTEM, "It is failed to lock mutex.");
+
pValueEnum.reset(__pAlarmHashMap->GetValuesN(reservedAlarmId));
SysLog(NID_SYS, "Alarm expire event is delivered. alarm id is %d", alarmId);
if(pValueEnum != null)
{
- ret = pthread_mutex_lock(&__lock);
- SysTryCatch(NID_SYS, ret == 0, r = E_SYSTEM, r, "It is failed to lock mutex.");
-
SysLog(NID_SYS, "Matching Alarm Id is %d \n", alarmId);
+
r = pValueEnum->MoveNext();
SysTryCatch(NID_SYS, r == E_SUCCESS, r = E_SYSTEM, r, "Alarm enum value is not valid.");
pAppId = static_cast< String* >(pValueEnum->GetCurrent());
pValueEnum->Reset();
}
- ret = pthread_mutex_unlock(&__lock);
}
+ ret = pthread_mutex_unlock(&__lock);
+
if(pAlarmImpl != null)
{
pAlarmImpl->OnAlarmExpired(alarmId);
SetLastResult(r);
}
+ return;
+
CATCH:
ret = pthread_mutex_unlock(&__lock);
SysTryReturnVoidResult(NID_SYS, ret == 0, E_SYSTEM, "It is failed to unlock mutex.");
static const wchar_t _MEDIA_IMAGES_PATH[] = L"/opt/usr/media/Images/";
static const wchar_t _MEDIA_SOUNDS_PATH[] = L"/opt/usr/media/Sounds/";
static const wchar_t _MEDIA_VIDEOS_PATH[] = L"/opt/usr/media/Videos/";
-static const wchar_t _MEDIA_CAMERA_PATH[] = L"/opt/usr/media/Camera/";
+static const wchar_t _MEDIA_CAMERA_PATH[] = L"/opt/usr/media/DCIM/Camera/";
static const wchar_t _MEDIA_DOWNLOADS_PATH[] = L"/opt/usr/media/Downloads/";
static const wchar_t _MEDIA_OTHERS_PATH[] = L"/opt/usr/media/Others/";
static const wchar_t _EXTERNAL_MMC_IMAGES_PATH[] = L"/opt/storage/sdcard/Images/";
static const wchar_t _EXTERNAL_MMC_SOUNDS_PATH[] = L"/opt/storage/sdcard/Sounds/";
static const wchar_t _EXTERNAL_MMC_VIDEOS_PATH[] = L"/opt/storage/sdcard/Videos/";
-static const wchar_t _EXTERNAL_MMC_CAMERA_PATH[] = L"/opt/storage/sdcard/Camera/";
+static const wchar_t _EXTERNAL_MMC_CAMERA_PATH[] = L"/opt/storage/sdcard/DCIM/Camera/";
static const wchar_t _EXTERNAL_MMC_DOWNLOADS_PATH[] = L"/opt/storage/sdcard/Downloads/";
static const wchar_t _EXTERNAL_MMC_OTHERS_PATH[] = L"/opt/storage/sdcard/Others/";
-static const wchar_t _RINGTONE_PATH[] = L"/opt/share/settings/Ringtones";
+static const wchar_t _RINGTONE_PATH[] = L"/opt/share/settings/Ringtones/";
static const wchar_t _APPLICATIONS_PATH[] = L"/opt/usr/apps/";
static const wchar_t _EXTERNAL_APPLICATIONS_PATH[] = L"/opt/storage/sdcard/app2sd/";
#endif
bool _activeApp = false;
+unsigned int _dimmingFlag = GOTO_STATE_NOW;
+unsigned int _screenOnState = LCD_DIM;
bool _deviceCpuPowerOn = false;
bool _keepCpuAwake = false;
bool _keepScreenOnState = false;
_ActiveEventListener::OnActiveAppChanged(const Tizen::App::AppId& appId)
{
int ret = 0;
- SysLog(NID_SYS, "Active App is %ls.", appId.GetPointer());
+ SysLog(NID_SYS, "Active App is %ls. GetApp id %ls", appId.GetPointer(), _AppInfo::GetApplicationId().GetPointer());
if(appId == _AppInfo::GetApplicationId())
{
_activeApp = true;
+ if (_keepScreenOnState == true)
+ {
+ int ret = -1;
+ ret = pm_lock_state(_screenOnState, _dimmingFlag, 0);
+ SysTryReturnVoidResult(NID_SYS, ret == 0,E_SYSTEM, "[E_SYSTEM] It failed to lock the screen state. error code [%d]", ret);
+ SysLog(NID_SYS, "Screen on state is recoveryed.");
+ }
}
else
{
{
ret = pm_unlock_state(LCD_NORMAL, GOTO_STATE_NOW);
SysTryReturnVoidResult(NID_SYS, ret == 0, E_SYSTEM, "[E_SYSTEM] It failed to unlock the power state");
- _keepScreenOnState = false;
}
if (_keepCpuAwake == true || _deviceCpuPowerOn == true) //In case of CPU power control, it has to be keep despite of deactive state.
{
state = LCD_NORMAL;
}
+ _dimmingFlag = flag;
+ _screenOnState = state;
ret = pm_lock_state(state, flag, 0);
SysTryReturnResult(NID_SYS, ret == 0, E_SYSTEM, "[E_SYSTEM] It failed to lock the screen state");
_keepScreenOnState = true;
}
String appId(pApp->GetAppId());
- unique_ptr <char> appIdPath(_StringConverter::CopyToCharArrayN(appId));
+ unique_ptr <char[]> appIdPath(_StringConverter::CopyToCharArrayN(appId));
fileLength = strlen(appIdPath.get()) + 29;
pFileName = (char*)malloc(fileLength);
+ SysTryCatch(NID_SYS, pFileName, E_OUT_OF_MEMORY, E_OUT_OF_MEMORY, "It is not enough memory.");
+
ret = sprintf(pFileName, "/tmp/size_of_directory_%s.tmp", appIdPath.get());
SysTryCatch(NID_SYS, ret > 0, E_SYSTEM, E_SYSTEM, "It is failed to write file path.");
commandLength = strlen(pFileName) + 8;
pCommand = (char*) malloc(commandLength);
+ SysTryCatch(NID_SYS, pCommand, E_OUT_OF_MEMORY, E_OUT_OF_MEMORY, "It is not enough memory.");
+
ret = sprintf(pCommand, "rm -rf %s", pFileName);
SysTryCatch(NID_SYS, ret > 0, E_SYSTEM, E_SYSTEM, "It is failed to write remove pCommand.");
commandLength = strlen(pFileName) + strlen(path) + 16;
pCommand = (char*)malloc(commandLength);
+ SysTryCatch(NID_SYS, pCommand, E_OUT_OF_MEMORY, E_OUT_OF_MEMORY, "It is not enough memory.");
+
ret = sprintf(pCommand, "du -skb -P %s >> %s", path, pFileName);
SysTryCatch(NID_SYS, ret > 0, E_SYSTEM, E_SYSTEM, "It is failed to write du pCommand.");
}
if (pCommand)
{
- free(pFileName);
+ free(pCommand);
}
if (pFile)
{
if(__pSettingClient == null)
{
pthread_once(&once_block, InitSettingClient);
+
+ result r = GetLastResult();
+ if (IsFailed(r))
+ {
+ once_block = PTHREAD_ONCE_INIT;
+ }
}
return __pSettingClient;
}
#include <FBaseUtilStringUtil.h>
#include <FIoFile.h>
+#include <FIo_FileImpl.h>
#include <FApp_AppInfo.h>
#include <FBase_StringConverter.h>
#include <FBase_NativeError.h>
if(key == _FONTSIZE)
{
- if(_AppInfo::GetApiVersion() == _API_VERSION_2_0 && _AppInfo::IsOspCompat() == true)
+ if(_AppInfo::GetApiVersion() == _API_VERSION_2_0 && _AppInfo::IsOspCompat())
{
if(value == _FONT_SIZE_GIANT || value == _FONT_SIZE_HUGE)
{
InitSettingClient();
SysTryReturnResult(NID_SYS, pSettingClient != null, E_SYSTEM, "It is failed to intialize setting manager");
r = pSettingClient->GetValue(key, value);
+
+ if(key == L"Wallpaper")
+ {
+ if(_AppInfo::GetApiVersion() == _API_VERSION_2_0 && _AppInfo::IsOspCompat())
+ {
+ String physicalFilePath = value;
+ r = Tizen::Io::_FileImpl::ConvertPhysicalToVirtualPath(physicalFilePath, value);
+ SysTryReturn(NID_SYS, r == E_SUCCESS, r, r, "[%s] It is failed to converting virtual path", GetErrorMessage(r));
+ }
+ }
}
return r;
}
result r = E_SUCCESS;
SysTryReturnResult(NID_SYS, pSettingClient != null, E_SYSTEM, "It is failed to intialize setting manager");
- r = pSettingClient->SetValue(_SETTING_SCREEN_WALLPAPER, filePath);
+
+ String physicalFilePath = filePath;
+
+ if(Tizen::App::_AppInfo::GetApiVersion() == _API_VERSION_2_0 && Tizen::App::_AppInfo::IsOspCompat())
+ {
+ r = Tizen::Io::_FileImpl::ConvertVirtualToPhysicalPath(filePath, physicalFilePath);
+ SysTryReturn(NID_SYS, r == E_SUCCESS, r, r, "[%s] It is failed to converting physical path", GetErrorMessage(r));
+ }
+
+ r = pSettingClient->SetValue(_SETTING_SCREEN_WALLPAPER, physicalFilePath);
if(r == E_INVALID_ARG)
r = E_FILE_NOT_FOUND;
{
result r = E_SUCCESS;
if (key == _FONT_SIZE || key == _FONT_TYPE)
- {
+ {
r = SetValueForFont(key, value);
- }
+ }
else
{
InitSettingClient();
SysTryReturnResult(NID_SYS, pSettingClient != null, E_SYSTEM, "It is failed to intialize setting manager");
+
+ if(key == _SETTING_SCREEN_WALLPAPER)
+ {
+ if(_AppInfo::GetApiVersion() == _API_VERSION_2_0 && _AppInfo::IsOspCompat())
+ {
+ String virtualFilePath = value;
+ r = Tizen::Io::_FileImpl::ConvertVirtualToPhysicalPath(virtualFilePath, value);
+ SysTryReturn(NID_SYS, r == E_SUCCESS, r, r, "[%s] It is failed to converting physical path", GetErrorMessage(r));
+ }
+ }
return pSettingClient->SetValue(key, value);
}
return r;
{
r = GetFromRegistry(tizenKey, value);
- if(r != E_SUCCESS)
+ if(r != E_SUCCESS || value == L"ERROR")
{
ArrayList requestMessage;
ArrayList responseMessage;
SysTryReturn(NID_SYS, r == E_SUCCESS, E_SYSTEM, r, "[%s] StringUtil::StringToUtf8N It is failed", GetErrorMessage(r));
int ret = system_info_get_platform_string(systemKey.get(), &pStringValue);
- SysTryReturnResult(NID_SYS, ret == SYSTEM_INFO_ERROR_NONE, E_OBJ_NOT_FOUND, "It is failed to get system information %ls from configration file.", tizenKey.GetPointer());
-
+ if (ret != SYSTEM_INFO_ERROR_NONE)
+ {
+ ret = system_info_get_custom_string(systemKey.get(), &pStringValue);
+ SysTryReturnResult(NID_SYS, ret == SYSTEM_INFO_ERROR_NONE, E_OBJ_NOT_FOUND, "It is failed to get system information %ls from configration file.", tizenKey.GetPointer());
+ }
r = StringUtil::Utf8ToString(pStringValue, value);
free(pStringValue);
r = E_SUCCESS;
SysTryReturn(NID_SYS, r == E_SUCCESS, E_SYSTEM, r, "[%s] StringUtil::StringToUtf8N It is failed", GetErrorMessage(r));
ret = system_info_get_platform_int(systemKey.get(), &value);
- SysTryReturnResult(NID_SYS, ret == SYSTEM_INFO_ERROR_NONE, E_OBJ_NOT_FOUND, "It is failed to get system information %ls from configration file.", tizenKey.GetPointer());
+ if (ret != SYSTEM_INFO_ERROR_NONE)
+ {
+ ret = system_info_get_custom_int(systemKey.get(), &value);
+ SysTryReturnResult(NID_SYS, ret == SYSTEM_INFO_ERROR_NONE, E_OBJ_NOT_FOUND,
+ "It is failed to get system information %ls from configration file.", tizenKey.GetPointer());
+ }
r = E_SUCCESS;
}
}
int ret = system_info_get_platform_bool(systemKey.get(), &supported);
if(ret != SYSTEM_INFO_ERROR_NONE)
{
- String screenKey(L"http://tizen.org/feature/screen.size");
- String requiredKey;
- tizenKey.SubString(0, screenKey.GetLength(), requiredKey);
-
- if(requiredKey == screenKey)
+ ret = system_info_get_custom_bool(systemKey.get(), &supported);
+ if (ret != SYSTEM_INFO_ERROR_NONE)
{
- value = false;
+ String screenKey(L"http://tizen.org/feature/screen.size");
+ String requiredKey;
+ tizenKey.SubString(0, screenKey.GetLength(), requiredKey);
+
+ if(requiredKey == screenKey)
+ {
+ value = false;
+ }
}
}
{
private:
_AlarmManager();
- ~_AlarmManager();
-public:
+public:
+ ~_AlarmManager();
result RegisterAlarm(_AlarmImpl* pAlarmImpl);
result UnregisterAlarm(_AlarmImpl* pAlarmImpl);
result UpdateAlarm(_AlarmImpl* pAlarmImpl);
static _AlarmManager* GetInstance(void);
private:
+ result Construct(void);
int ReserveAlarm(Tizen::Base::String appId, Tizen::Base::DateTime startTime, int period);
result AddAlarmList(int alarmId, int period, Tizen::Base::String appId, Tizen::Base::DateTime* endTime);
result RemoveAlarmList(int alarmId);