Class SI_ConvertA

SimpleIni.h:2870–2970

 * Null conversion class for MBCS/UTF-8 to char (or equivalent).
 */
template <class SI_CHAR> class SI_ConvertA {
  bool m_bStoreIsUtf8;

protected:
  SI_ConvertA() {}

public:
  SI_ConvertA(bool a_bStoreIsUtf8) : m_bStoreIsUtf8(a_bStoreIsUtf8) {}

  /* copy and assignment */
  SI_ConvertA(const SI_ConvertA &rhs) { operator=(rhs); }
  SI_ConvertA &operator=(const SI_ConvertA &rhs) {
    m_bStoreIsUtf8 = rhs.m_bStoreIsUtf8;
    return *this;
  }

  /** Calculate the number of SI_CHAR required for converting the input
     * from the storage format. The storage format is always UTF-8 or MBCS.
     *
     * @param a_pInputData  Data in storage format to be converted to SI_CHAR.
     * @param a_uInputDataLen Length of storage format data in bytes. This
     *                      must be the actual length of the data, including
     *                      NULL byte if NULL terminated string is required.
     * @return              Number of SI_CHAR required by the string when
     *                      converted. If there are embedded NULL bytes in the
     *                      input data, only the string up and not including
     *                      the NULL byte will be converted.
     * @return              -1 cast to size_t on a conversion error.
     */
  size_t SizeFromStore(const char *a_pInputData, size_t a_uInputDataLen) {
    (void)a_pInputData;
    SI_ASSERT(a_uInputDataLen != (size_t)-1);

    // ASCII/MBCS/UTF-8 needs no conversion
    return a_uInputDataLen;
  }

  /** Convert the input string from the storage format to SI_CHAR.
     * The storage format is always UTF-8 or MBCS.
     *
     * @param a_pInputData  Data in storage format to be converted to SI_CHAR.
     * @param a_uInputDataLen Length of storage format data in bytes. This
     *                      must be the actual length of the data, including
     *                      NULL byte if NULL terminated string is required.
     * @param a_pOutputData Pointer to the output buffer to received the
     *                      converted data.
     * @param a_uOutputDataSize Size of the output buffer in SI_CHAR.
     * @return              true if all of the input data was successfully
     *                      converted.
     */
  bool ConvertFromStore(const char *a_pInputData, size_t a_uInputDataLen,
                        SI_CHAR *a_pOutputData, size_t a_uOutputDataSize) {
    // ASCII/MBCS/UTF-8 needs no conversion
    if (a_uInputDataLen > a_uOutputDataSize) {
      return false;
    }
    memcpy(a_pOutputData, a_pInputData, a_uInputDataLen);
    return true;