//
-// 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 %AsciiEncoding class.
*
* This header file contains the declarations of the %AsciiEncoding class. @n
- * The %AsciiEncoding class is derived from the Encoding class.
+ * This class is derived from the Encoding class.
*/
#ifndef _FTEXT_ASCII_ENCODING_H_
#define _FTEXT_ASCII_ENCODING_H_
/**
* Decodes an instance of the specified Tizen::Base::ByteBuffer into an instance of Tizen::Base::WcharBuffer. @n
- * The GetCharsN() method maintains no state consistency between conversions. The method is intended for
- * conversions of complete blocks of bytes and characters in one operation.
- * This method decodes in a single step.
+ * The %GetCharsN() method does not maintain state consistency between conversions as this method is intended to
+ * convert complete blocks of bytes and characters in one operation and also to decode it in a single step.
*
* @since 2.0
*
/**
* Decodes an instance of Tizen::Base::ByteBuffer into an instance of Tizen::Base::WcharBuffer as per the specified range. @n
* The position and limit of the %Tizen::Base::WcharBuffer instance is not changed.
- * The GetChars() method maintains no state consistency between conversions. The method is intended for
- * conversions of complete blocks of bytes and characters in one operation.
+ * The %GetChars() method does not maintain state consistency between conversions as this is intended to
+ * convert complete blocks of bytes and characters in one operation.
*
* @since 2.0
*
* @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.
- * @remarks GetString() assumes that the Tizen::Base::ByteBuffer instance contains all the bytes necessary to generate the entire string.
+ * @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 GetBytesN()
* @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_ENCODING_RANGE The specified string contains code points that are outside the bounds of the character encoding scheme.
- * @remarks GetString() assumes that the Tizen::Base::ByteBuffer instance contains all the bytes necessary to generate the entire string.
+ * @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()
*
* @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 GetMaxByteCount() 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()
* @see GetBytes()
*/
*
* @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 GetMaxCharCount() 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::GetCharCount()
* @see GetChars()