//
-// Open Service Platform
// Copyright (c) 2012 Samsung Electronics Co., Ltd.
//
// Licensed under the Apache License, Version 2.0 (the License);
* @brief This is the header file for the %GsmEncoding class.
*
* This header file contains the declarations of the %GsmEncoding class.
- * The %GsmEncoding class is derived from the Encoding class.
+ * This class is derived from the Encoding class.
*/
#ifndef _FTEXT_GSM_ENCODING_H_
#define _FTEXT_GSM_ENCODING_H_
virtual ~GsmEncoding(void);
/**
- * Gets the total number of bytes that are required to encode a specified Tizen::Base::String instance.
+ * Gets the total number of bytes that are required to encode the specified Tizen::Base::String instance.
*
* @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.
virtual result GetByteCount(const Tizen::Base::String& str, int& byteCount) const;
/**
- * Gets the total number of bytes that are required to encode a specified Tizen::Base::WcharBuffer instance.
+ * Gets the total number of bytes that are required to encode the specified Tizen::Base::WcharBuffer instance.
*
* @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;