//
-// Open Service Platform
// Copyright (c) 2012 Samsung Electronics Co., Ltd.
//
// Licensed under the Apache License, Version 2.0 (the License);
*
* 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,