General.h

/*
 *  Copyright (C) 2005-2018 Team Kodi
 *  This file is part of Kodi - https://kodi.tv
 *
 *  SPDX-License-Identifier: GPL-2.0-or-later
 *  See LICENSES/README.md for more information.
 */
 
#pragma once
 
#include "../../AddonBase.h"
#include "../../c-api/addon-instance/pvr/pvr_general.h"
 
//¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
// "C++" Definitions group 1 - General PVR
#ifdef __cplusplus
 
namespace kodi
{
namespace addon
{
 
//==============================================================================
class PVRTypeIntValue : public DynamicCStructHdl<PVRTypeIntValue, PVR_ATTRIBUTE_INT_VALUE>
{
  friend class CInstancePVRClient;
 
public:
  PVRTypeIntValue(const PVRTypeIntValue& data) : DynamicCStructHdl(data) {}
 
 
  PVRTypeIntValue() = default;
 
  PVRTypeIntValue(int value, const std::string& description)
  {
    SetValue(value);
    SetDescription(description);
  }
 
  void SetValue(int value) { m_cStructure->iValue = value; }
 
  int GetValue() const { return m_cStructure->iValue; }
 
  void SetDescription(const std::string& description)
  {
    ReallocAndCopyString(&m_cStructure->strDescription, description.c_str());
  }
 
  std::string GetDescription() const
  {
    return m_cStructure->strDescription ? m_cStructure->strDescription : "";
  }
 
  static PVR_ATTRIBUTE_INT_VALUE* AllocAndCopyData(const std::vector<PVRTypeIntValue>& source)
  {
    PVR_ATTRIBUTE_INT_VALUE* values = new PVR_ATTRIBUTE_INT_VALUE[source.size()]{};
    for (unsigned int i = 0; i < source.size(); ++i)
    {
      values[i].iValue = source[i].GetCStructure()->iValue;
      AllocResources(source[i].GetCStructure(), &values[i]); // handles strDescription
    }
    return values;
  }
 
  static PVR_ATTRIBUTE_INT_VALUE* AllocAndCopyData(const PVR_ATTRIBUTE_INT_VALUE* source,
                                                   unsigned int size)
  {
    PVR_ATTRIBUTE_INT_VALUE* values = new PVR_ATTRIBUTE_INT_VALUE[size]{};
    for (unsigned int i = 0; i < size; ++i)
    {
      values[i].iValue = source[i].iValue;
      AllocResources(&source[i], &values[i]); // handles strDescription
    }
    return values;
  }
 
  static void AllocResources(const PVR_ATTRIBUTE_INT_VALUE* source, PVR_ATTRIBUTE_INT_VALUE* target)
  {
    target->strDescription = AllocAndCopyString(source->strDescription);
  }
 
  static void FreeResources(PVR_ATTRIBUTE_INT_VALUE* target)
  {
    FreeString(target->strDescription);
    target->strDescription = nullptr;
  }
 
  static void FreeResources(PVR_ATTRIBUTE_INT_VALUE* values, unsigned int size)
  {
    for (unsigned int i = 0; i < size; ++i)
    {
      FreeResources(&values[i]);
    }
    delete[] values;
  }
 
  static void ReallocAndCopyData(PVR_ATTRIBUTE_INT_VALUE** source,
                                 unsigned int* size,
                                 const std::vector<PVRTypeIntValue>& values)
  {
    FreeResources(*source, *size);
    *source = nullptr;
    *size = static_cast<unsigned int>(values.size());
    if (*size)
      *source = AllocAndCopyData(values);
  }
 
private:
  PVRTypeIntValue(const PVR_ATTRIBUTE_INT_VALUE* data) : DynamicCStructHdl(data) {}
  PVRTypeIntValue(PVR_ATTRIBUTE_INT_VALUE* data) : DynamicCStructHdl(data) {}
};
//------------------------------------------------------------------------------
 
//==============================================================================
class PVRTypeStringValue : public DynamicCStructHdl<PVRTypeStringValue, PVR_ATTRIBUTE_STRING_VALUE>
{
  friend class CInstancePVRClient;
 
public:
  PVRTypeStringValue(const PVRTypeStringValue& data) : DynamicCStructHdl(data) {}
 
 
  PVRTypeStringValue() = default;
 
  PVRTypeStringValue(const std::string& value, const std::string& description)
  {
    SetValue(value);
    SetDescription(description);
  }
 
  void SetValue(const std::string& value)
  {
    ReallocAndCopyString(&m_cStructure->strValue, value.c_str());
  }
 
  std::string GetValue() const { return m_cStructure->strValue ? m_cStructure->strValue : ""; }
 
  void SetDescription(const std::string& description)
  {
    ReallocAndCopyString(&m_cStructure->strDescription, description.c_str());
  }
 
  std::string GetDescription() const
  {
    return m_cStructure->strDescription ? m_cStructure->strDescription : "";
  }
 
  static PVR_ATTRIBUTE_STRING_VALUE* AllocAndCopyData(const std::vector<PVRTypeStringValue>& source)
  {
    PVR_ATTRIBUTE_STRING_VALUE* values = new PVR_ATTRIBUTE_STRING_VALUE[source.size()]{};
    for (unsigned int i = 0; i < source.size(); ++i)
      AllocResources(source[i].GetCStructure(), &values[i]); // handles strValue, strDescription
    return values;
  }
 
  static PVR_ATTRIBUTE_STRING_VALUE* AllocAndCopyData(const PVR_ATTRIBUTE_STRING_VALUE* source,
                                                      unsigned int size)
  {
    PVR_ATTRIBUTE_STRING_VALUE* values = new PVR_ATTRIBUTE_STRING_VALUE[size]{};
    for (unsigned int i = 0; i < size; ++i)
      AllocResources(&source[i], &values[i]); // handles strValue, strDescription
    return values;
  }
 
  static void AllocResources(const PVR_ATTRIBUTE_STRING_VALUE* source,
                             PVR_ATTRIBUTE_STRING_VALUE* target)
  {
    target->strValue = AllocAndCopyString(source->strValue);
    target->strDescription = AllocAndCopyString(source->strDescription);
  }
 
  static void FreeResources(PVR_ATTRIBUTE_STRING_VALUE* target)
  {
    FreeString(target->strValue);
    target->strValue = nullptr;
    FreeString(target->strDescription);
    target->strDescription = nullptr;
  }
 
  static void FreeResources(PVR_ATTRIBUTE_STRING_VALUE* values, unsigned int size)
  {
    for (unsigned int i = 0; i < size; ++i)
      FreeResources(&values[i]);
    delete[] values;
  }
 
  static void ReallocAndCopyData(PVR_ATTRIBUTE_STRING_VALUE** source,
                                 unsigned int* size,
                                 const std::vector<PVRTypeStringValue>& values)
  {
    FreeResources(*source, *size);
    *source = nullptr;
    *size = static_cast<unsigned int>(values.size());
    if (*size)
      *source = AllocAndCopyData(values);
  }
 
private:
  PVRTypeStringValue(const PVR_ATTRIBUTE_STRING_VALUE* data) : DynamicCStructHdl(data) {}
  PVRTypeStringValue(PVR_ATTRIBUTE_STRING_VALUE* data) : DynamicCStructHdl(data) {}
};
//------------------------------------------------------------------------------
 
//==============================================================================
class PVRIntSettingDefinition
  : public DynamicCStructHdl<PVRIntSettingDefinition, PVR_INT_SETTING_DEFINITION>
{
  friend class CInstancePVRClient;
 
public:
  PVRIntSettingDefinition() { m_cStructure->iStep = 1; }
  PVRIntSettingDefinition(const PVRIntSettingDefinition& def) : DynamicCStructHdl(def) {}
 
 
  PVRIntSettingDefinition(const std::vector<PVRTypeIntValue>& settingValues,
                          int defaultValue,
                          int minValue,
                          int step,
                          int maxValue)
  {
    SetValues(settingValues);
    SetDefaultValue(defaultValue);
    SetMinValue(minValue);
    SetStep(step);
    SetMaxValue(maxValue);
  }
 
  void SetValues(const std::vector<PVRTypeIntValue>& values, int defaultValue = -1)
  {
    PVRTypeIntValue::ReallocAndCopyData(&m_cStructure->values, &m_cStructure->iValuesSize, values);
    if (defaultValue != -1)
      m_cStructure->iDefaultValue = defaultValue;
  }
 
  std::vector<PVRTypeIntValue> GetValues() const
  {
    std::vector<PVRTypeIntValue> ret;
    for (unsigned int i = 0; i < m_cStructure->iValuesSize; ++i)
      ret.emplace_back(m_cStructure->values[i].iValue, m_cStructure->values[i].strDescription);
    return ret;
  }
 
  void SetDefaultValue(int defaultValue) { m_cStructure->iDefaultValue = defaultValue; }
 
  int GetDefaultValue() const { return m_cStructure->iDefaultValue; }
 
  void SetMinValue(int minValue) { m_cStructure->iMinValue = minValue; }
 
  int GetMinValue() const { return m_cStructure->iMinValue; }
 
  void SetStep(int step) { m_cStructure->iStep = step; }
 
  int GetStep() const { return m_cStructure->iStep; }
 
  void SetMaxValue(int maxValue) { m_cStructure->iMaxValue = maxValue; }
 
  int GetMaxValue() const { return m_cStructure->iMaxValue; }
 
  static PVR_INT_SETTING_DEFINITION* AllocAndCopyData(const PVRIntSettingDefinition& source)
  {
    PVR_INT_SETTING_DEFINITION* def = new PVR_INT_SETTING_DEFINITION{};
    AllocResources(source.GetCStructure(), def); // handles values, iValuesSize
    def->iDefaultValue = source.GetCStructure()->iDefaultValue;
    def->iMinValue = source.GetCStructure()->iMinValue;
    def->iStep = source.GetCStructure()->iStep;
    def->iMaxValue = source.GetCStructure()->iMaxValue;
    return def;
  }
 
  static PVR_INT_SETTING_DEFINITION* AllocAndCopyData(PVR_INT_SETTING_DEFINITION* source)
  {
    PVR_INT_SETTING_DEFINITION* def = new PVR_INT_SETTING_DEFINITION{};
    AllocResources(source, def); // handles values, iValuesSize
    def->iDefaultValue = source->iDefaultValue;
    def->iMinValue = source->iMinValue;
    def->iStep = source->iStep;
    def->iMaxValue = source->iMaxValue;
    return def;
  }
 
  static void AllocResources(const PVR_INT_SETTING_DEFINITION* source,
                             PVR_INT_SETTING_DEFINITION* target)
  {
    target->values = PVRTypeIntValue::AllocAndCopyData(source->values, source->iValuesSize);
    target->iValuesSize = source->iValuesSize;
  }
 
  static void FreeResources(PVR_INT_SETTING_DEFINITION* target)
  {
    PVRTypeIntValue::FreeResources(target->values, target->iValuesSize);
    target->values = nullptr;
    target->iValuesSize = 0;
  }
 
  static void ReallocAndCopyData(PVR_INT_SETTING_DEFINITION** source,
                                 const PVRIntSettingDefinition& def)
  {
    if (*source)
      FreeResources(*source);
    *source = AllocAndCopyData(def);
  }
 
private:
  PVRIntSettingDefinition(const PVR_INT_SETTING_DEFINITION* def) : DynamicCStructHdl(def) {}
  PVRIntSettingDefinition(PVR_INT_SETTING_DEFINITION* def) : DynamicCStructHdl(def) {}
};
//------------------------------------------------------------------------------
 
//==============================================================================
class PVRStringSettingDefinition
  : public DynamicCStructHdl<PVRStringSettingDefinition, PVR_STRING_SETTING_DEFINITION>
{
  friend class CInstancePVRClient;
 
public:
  PVRStringSettingDefinition() { m_cStructure->bAllowEmptyValue = true; }
  PVRStringSettingDefinition(const PVRStringSettingDefinition& def) : DynamicCStructHdl(def) {}
 
 
  PVRStringSettingDefinition(const std::vector<PVRTypeStringValue>& settingValues,
                             const std::string& defaultValue,
                             bool allowEmptyValue)
  {
    SetValues(settingValues);
    SetDefaultValue(defaultValue);
    SetAllowEmptyValue(allowEmptyValue);
  }
 
  void SetValues(const std::vector<PVRTypeStringValue>& values,
                 const std::string& defaultValue = "")
  {
    PVRTypeStringValue::ReallocAndCopyData(&m_cStructure->values, &m_cStructure->iValuesSize,
                                           values);
    ReallocAndCopyString(&m_cStructure->strDefaultValue, defaultValue.c_str());
  }
 
  std::vector<PVRTypeStringValue> GetValues() const
  {
    std::vector<PVRTypeStringValue> ret;
    for (unsigned int i = 0; i < m_cStructure->iValuesSize; ++i)
      ret.emplace_back(m_cStructure->values[i].strValue, m_cStructure->values[i].strDescription);
    return ret;
  }
 
  void SetDefaultValue(const std::string& defaultValue)
  {
    ReallocAndCopyString(&m_cStructure->strDefaultValue, defaultValue.c_str());
  }
 
  std::string GetDefaultValue() const
  {
    return m_cStructure->strDefaultValue ? m_cStructure->strDefaultValue : "";
  }
 
  void SetAllowEmptyValue(bool allowEmptyValue)
  {
    m_cStructure->bAllowEmptyValue = allowEmptyValue;
  }
 
  bool GetAllowEmptyValue() const { return m_cStructure->bAllowEmptyValue; }
 
  static PVR_STRING_SETTING_DEFINITION* AllocAndCopyData(const PVRStringSettingDefinition& source)
  {
    PVR_STRING_SETTING_DEFINITION* def = new PVR_STRING_SETTING_DEFINITION{};
    AllocResources(source.GetCStructure(), def); // handles strDefaultValue, values, iValuesSize
    def->bAllowEmptyValue = source.GetCStructure()->bAllowEmptyValue;
    return def;
  }
 
  static PVR_STRING_SETTING_DEFINITION* AllocAndCopyData(PVR_STRING_SETTING_DEFINITION* source)
  {
    PVR_STRING_SETTING_DEFINITION* def = new PVR_STRING_SETTING_DEFINITION{};
    AllocResources(source, def); // handles strDefaultValue, values, iValuesSize
    def->bAllowEmptyValue = source->bAllowEmptyValue;
    return def;
  }
 
  static void AllocResources(const PVR_STRING_SETTING_DEFINITION* source,
                             PVR_STRING_SETTING_DEFINITION* target)
  {
    target->strDefaultValue = AllocAndCopyString(source->strDefaultValue);
    target->values = PVRTypeStringValue::AllocAndCopyData(source->values, source->iValuesSize);
    target->iValuesSize = source->iValuesSize;
  }
 
  static void FreeResources(PVR_STRING_SETTING_DEFINITION* target)
  {
    PVRTypeStringValue::FreeResources(target->values, target->iValuesSize);
    target->values = nullptr;
    target->iValuesSize = 0;
 
    FreeString(target->strDefaultValue);
    target->strDefaultValue = nullptr;
  }
 
  static void ReallocAndCopyData(PVR_STRING_SETTING_DEFINITION** source,
                                 const PVRStringSettingDefinition& def)
  {
    if (*source)
      FreeResources(*source);
    *source = AllocAndCopyData(def);
  }
 
private:
  PVRStringSettingDefinition(const PVR_STRING_SETTING_DEFINITION* def) : DynamicCStructHdl(def) {}
  PVRStringSettingDefinition(PVR_STRING_SETTING_DEFINITION* def) : DynamicCStructHdl(def) {}
};
//------------------------------------------------------------------------------
 
//==============================================================================
class PVRSettingDefinition : public DynamicCStructHdl<PVRSettingDefinition, PVR_SETTING_DEFINITION>
{
  friend class CInstancePVRClient;
 
public:
  PVRSettingDefinition() = default;
  PVRSettingDefinition(const PVRSettingDefinition& type) : DynamicCStructHdl(type) {}
 
 
  PVRSettingDefinition(unsigned int settingDefId,
                       const std::string& settingDefName,
                       uint64_t readonlyConditions,
                       const PVRIntSettingDefinition& settingDef)
  {
    SetId(settingDefId);
    SetName(settingDefName);
    SetType(PVR_SETTING_TYPE::INTEGER);
    SetReadonlyConditions(readonlyConditions);
    SetIntDefinition(settingDef);
  }
 
  PVRSettingDefinition(unsigned int settingDefId,
                       const std::string& settingDefName,
                       uint64_t readonlyConditions,
                       const PVRStringSettingDefinition& settingDef)
  {
    SetId(settingDefId);
    SetName(settingDefName);
    SetType(PVR_SETTING_TYPE::STRING);
    SetReadonlyConditions(readonlyConditions);
    SetStringDefinition(settingDef);
  }
 
  PVRSettingDefinition(unsigned int settingDefId,
                       const std::string& settingDefName,
                       PVR_SETTING_TYPE eType,
                       uint64_t readonlyConditions,
                       const PVRIntSettingDefinition& intSettingDef,
                       const PVRStringSettingDefinition& stringSettingDef)
  {
    SetId(settingDefId);
    SetName(settingDefName);
    SetType(eType);
    SetReadonlyConditions(readonlyConditions);
    SetIntDefinition(intSettingDef);
    SetStringDefinition(stringSettingDef);
  }
 
  void SetId(unsigned int defId) { m_cStructure->iId = defId; }
 
  unsigned int GetId() const { return m_cStructure->iId; }
 
  void SetName(const std::string& name)
  {
    ReallocAndCopyString(&m_cStructure->strName, name.c_str());
  }
 
  std::string GetName() const { return m_cStructure->strName ? m_cStructure->strName : ""; }
 
  void SetType(PVR_SETTING_TYPE eType) { m_cStructure->eType = eType; }
 
  PVR_SETTING_TYPE GetType() const { return m_cStructure->eType; }
 
  void SetReadonlyConditions(uint64_t conditions)
  {
    m_cStructure->iReadonlyConditions = conditions;
  }
 
  uint64_t GetReadonlyConditions() const { return m_cStructure->iReadonlyConditions; }
 
  //----------------------------------------------------------------------------
 
  void SetIntDefinition(const PVRIntSettingDefinition& def)
  {
    PVRIntSettingDefinition::ReallocAndCopyData(&m_cStructure->intSettingDefinition, def);
  }
 
  PVRIntSettingDefinition GetIntDefinition() const
  {
    PVRIntSettingDefinition ret;
    if (m_cStructure->intSettingDefinition)
    {
      std::vector<PVRTypeIntValue> settingValues;
      settingValues.reserve(m_cStructure->intSettingDefinition->iValuesSize);
      for (unsigned int i = 0; i < m_cStructure->intSettingDefinition->iValuesSize; ++i)
      {
        settingValues.emplace_back(m_cStructure->intSettingDefinition->values[i].iValue,
                                   m_cStructure->intSettingDefinition->values[i].strDescription);
      }
      ret.SetValues(std::move(settingValues));
      ret.SetDefaultValue(m_cStructure->intSettingDefinition->iDefaultValue);
      ret.SetMinValue(m_cStructure->intSettingDefinition->iMinValue);
      ret.SetStep(m_cStructure->intSettingDefinition->iStep);
      ret.SetMaxValue(m_cStructure->intSettingDefinition->iMaxValue);
    }
    return ret;
  }
 
  //----------------------------------------------------------------------------
 
  void SetStringDefinition(const PVRStringSettingDefinition& def)
  {
    PVRStringSettingDefinition::ReallocAndCopyData(&m_cStructure->stringSettingDefinition, def);
  }
 
  PVRStringSettingDefinition GetStringDefinition() const
  {
    PVRStringSettingDefinition ret;
    if (m_cStructure->stringSettingDefinition)
    {
      std::vector<PVRTypeStringValue> settingValues;
      settingValues.reserve(m_cStructure->stringSettingDefinition->iValuesSize);
      for (unsigned int i = 0; i < m_cStructure->stringSettingDefinition->iValuesSize; ++i)
      {
        settingValues.emplace_back(m_cStructure->stringSettingDefinition->values[i].strValue,
                                   m_cStructure->stringSettingDefinition->values[i].strDescription);
      }
      ret.SetValues(std::move(settingValues));
      ret.SetDefaultValue(m_cStructure->stringSettingDefinition->strDefaultValue);
    }
    return ret;
  }
 
  static PVR_SETTING_DEFINITION** AllocAndCopyData(const std::vector<PVRSettingDefinition>& source)
  {
    PVR_SETTING_DEFINITION** defs = new PVR_SETTING_DEFINITION* [source.size()] {};
    for (unsigned int i = 0; i < source.size(); ++i)
    {
      defs[i] = new PVR_SETTING_DEFINITION{};
      defs[i]->iId = source[i].GetCStructure()->iId;
      defs[i]->eType = source[i].GetCStructure()->eType;
      defs[i]->iReadonlyConditions = source[i].GetCStructure()->iReadonlyConditions;
      AllocResources(source[i].GetCStructure(),
                     defs[i]); // handles strName, intSettingDefinition, stringSettingDefinition
    }
    return defs;
  }
 
  static PVR_SETTING_DEFINITION** AllocAndCopyData(PVR_SETTING_DEFINITION** source,
                                                   unsigned int size)
  {
    PVR_SETTING_DEFINITION** defs = new PVR_SETTING_DEFINITION* [size] {};
    for (unsigned int i = 0; i < size; ++i)
    {
      defs[i] = new PVR_SETTING_DEFINITION{};
      defs[i]->iId = source[i]->iId;
      defs[i]->eType = source[i]->eType;
      defs[i]->iReadonlyConditions = source[i]->iReadonlyConditions;
      AllocResources(source[i],
                     defs[i]); // handles strName, intSettingDefinition, stringSettingDefinition
    }
    return defs;
  }
 
  static void AllocResources(const PVR_SETTING_DEFINITION* source, PVR_SETTING_DEFINITION* target)
  {
    target->strName = AllocAndCopyString(source->strName);
    if (source->intSettingDefinition)
      target->intSettingDefinition =
          PVRIntSettingDefinition::AllocAndCopyData(source->intSettingDefinition);
    if (source->stringSettingDefinition)
      target->stringSettingDefinition =
          PVRStringSettingDefinition::AllocAndCopyData(source->stringSettingDefinition);
  }
 
  static void FreeResources(PVR_SETTING_DEFINITION* target)
  {
    FreeString(target->strName);
    target->strName = nullptr;
 
    if (target->intSettingDefinition)
    {
      PVRIntSettingDefinition::FreeResources(target->intSettingDefinition);
      target->intSettingDefinition = nullptr;
    }
 
    if (target->stringSettingDefinition)
    {
      PVRStringSettingDefinition::FreeResources(target->stringSettingDefinition);
      target->stringSettingDefinition = nullptr;
    }
  }
 
  static void FreeResources(PVR_SETTING_DEFINITION** defs, unsigned int size)
  {
    for (unsigned int i = 0; i < size; ++i)
    {
      FreeResources(defs[i]);
      delete defs[i];
    }
    delete[] defs;
  }
 
  static void ReallocAndCopyData(PVR_SETTING_DEFINITION*** source,
                                 unsigned int* size,
                                 const std::vector<PVRSettingDefinition>& defs)
  {
    FreeResources(*source, *size);
    *source = nullptr;
    *size = static_cast<unsigned int>(defs.size());
    if (*size)
      *source = AllocAndCopyData(defs);
  }
 
private:
  PVRSettingDefinition(const PVR_SETTING_DEFINITION* def) : DynamicCStructHdl(def) {}
  PVRSettingDefinition(PVR_SETTING_DEFINITION* def) : DynamicCStructHdl(def) {}
};
//------------------------------------------------------------------------------
 
//==============================================================================
class PVRSettingKeyValuePair
  : public DynamicCStructHdl<PVRSettingKeyValuePair, PVR_SETTING_KEY_VALUE_PAIR>
{
  friend class CInstancePVRClient;
 
public:
  PVRSettingKeyValuePair(const PVRSettingKeyValuePair& pair) : DynamicCStructHdl(pair) {}
 
 
  PVRSettingKeyValuePair() = default;
 
  PVRSettingKeyValuePair(unsigned int key, int value)
  {
    SetKey(key);
    SetType(PVR_SETTING_TYPE::INTEGER);
    SetIntValue(value);
  }
 
  PVRSettingKeyValuePair(unsigned int key, const std::string& value)
  {
    SetKey(key);
    SetType(PVR_SETTING_TYPE::STRING);
    SetStringValue(value);
  }
 
  PVRSettingKeyValuePair(unsigned int key,
                         PVR_SETTING_TYPE eType,
                         int intValue,
                         const std::string& stringValue)
  {
    SetKey(key);
    SetType(eType);
    SetIntValue(intValue);
    SetStringValue(stringValue);
  }
 
  void SetKey(unsigned int key) { m_cStructure->iKey = key; }
 
  unsigned GetKey() const { return m_cStructure->iKey; }
 
  void SetType(PVR_SETTING_TYPE eType) { m_cStructure->eType = eType; }
 
  PVR_SETTING_TYPE GetType() const { return m_cStructure->eType; }
 
  void SetIntValue(int value) { m_cStructure->iValue = value; }
 
  int GetIntValue() const { return m_cStructure->iValue; }
 
  void SetStringValue(const std::string& value)
  {
    ReallocAndCopyString(&m_cStructure->strValue, value.c_str());
  }
 
  std::string GetStringValue() const
  {
    return m_cStructure->strValue ? m_cStructure->strValue : "";
  }
 
  static PVR_SETTING_KEY_VALUE_PAIR* AllocAndCopyData(
      const std::vector<PVRSettingKeyValuePair>& values)
  {
    PVR_SETTING_KEY_VALUE_PAIR* pairs = new PVR_SETTING_KEY_VALUE_PAIR[values.size()]{};
    for (unsigned int i = 0; i < values.size(); ++i)
    {
      pairs[i].iKey = values[i].GetCStructure()->iKey;
      pairs[i].eType = values[i].GetCStructure()->eType;
      pairs[i].iValue = values[i].GetCStructure()->iValue;
      AllocResources(values[i].GetCStructure(), &pairs[i]); // handles strValue
    }
    return pairs;
  }
 
  static PVR_SETTING_KEY_VALUE_PAIR* AllocAndCopyData(const PVR_SETTING_KEY_VALUE_PAIR* source,
                                                      unsigned int size)
  {
    PVR_SETTING_KEY_VALUE_PAIR* pairs = new PVR_SETTING_KEY_VALUE_PAIR[size]{};
    for (unsigned int i = 0; i < size; ++i)
    {
      pairs[i].iKey = source[i].iKey;
      pairs[i].eType = source[i].eType;
      pairs[i].iValue = source[i].iValue;
      AllocResources(&source[i], &pairs[i]); // handles strValue
    }
    return pairs;
  }
 
  static void AllocResources(const PVR_SETTING_KEY_VALUE_PAIR* source,
                             PVR_SETTING_KEY_VALUE_PAIR* target)
  {
    target->strValue = AllocAndCopyString(source->strValue);
  }
 
  static void FreeResources(PVR_SETTING_KEY_VALUE_PAIR* target) { FreeString(target->strValue); }
 
  static void FreeResources(PVR_SETTING_KEY_VALUE_PAIR* pairs, unsigned int size)
  {
    for (unsigned int i = 0; i < size; ++i)
      FreeResources(&pairs[i]);
    delete[] pairs;
  }
 
  static void ReallocAndCopyData(PVR_SETTING_KEY_VALUE_PAIR** source,
                                 unsigned int* size,
                                 const std::vector<PVRSettingKeyValuePair>& values)
  {
    FreeResources(*source, *size);
    *source = nullptr;
    *size = static_cast<unsigned int>(values.size());
    if (*size)
      *source = AllocAndCopyData(values);
  }
 
private:
  PVRSettingKeyValuePair(const PVR_SETTING_KEY_VALUE_PAIR* pair) : DynamicCStructHdl(pair) {}
  PVRSettingKeyValuePair(PVR_SETTING_KEY_VALUE_PAIR* pair) : DynamicCStructHdl(pair) {}
};
//------------------------------------------------------------------------------
 
//==============================================================================
class PVRCapabilities : public DynamicCStructHdl<PVRCapabilities, PVR_ADDON_CAPABILITIES>
{
  friend class CInstancePVRClient;
 
public:
  PVRCapabilities() = default;
  PVRCapabilities(const PVRCapabilities& capabilities) : DynamicCStructHdl(capabilities) {}
 
 
  void SetSupportsEPG(bool supportsEPG) { m_cStructure->bSupportsEPG = supportsEPG; }
 
  bool GetSupportsEPG() const { return m_cStructure->bSupportsEPG; }
 
  void SetSupportsEPGEdl(bool supportsEPGEdl) { m_cStructure->bSupportsEPGEdl = supportsEPGEdl; }
 
  bool GetSupportsEPGEdl() const { return m_cStructure->bSupportsEPGEdl; }
 
  void SetSupportsTV(bool supportsTV) { m_cStructure->bSupportsTV = supportsTV; }
 
  bool GetSupportsTV() const { return m_cStructure->bSupportsTV; }
 
  void SetSupportsRadio(bool supportsRadio) { m_cStructure->bSupportsRadio = supportsRadio; }
 
  bool GetSupportsRadio() const { return m_cStructure->bSupportsRadio; }
 
  void SetSupportsRecordings(bool supportsRecordings)
  {
    m_cStructure->bSupportsRecordings = supportsRecordings;
  }
 
  bool GetSupportsRecordings() const { return m_cStructure->bSupportsRecordings; }
 
  void SetSupportsRecordingsUndelete(bool supportsRecordingsUndelete)
  {
    m_cStructure->bSupportsRecordingsUndelete = supportsRecordingsUndelete;
  }
 
  bool GetSupportsRecordingsUndelete() const { return m_cStructure->bSupportsRecordingsUndelete; }
 
  void SetSupportsTimers(bool supportsTimers) { m_cStructure->bSupportsTimers = supportsTimers; }
 
  bool GetSupportsTimers() const { return m_cStructure->bSupportsTimers; }
 
  void SetSupportsProviders(bool supportsProviders)
  {
    m_cStructure->bSupportsProviders = supportsProviders;
  }
 
  bool GetSupportsProviders() const { return m_cStructure->bSupportsProviders; }
 
  void SetSupportsChannelGroups(bool supportsChannelGroups)
  {
    m_cStructure->bSupportsChannelGroups = supportsChannelGroups;
  }
 
  bool GetSupportsChannelGroups() const { return m_cStructure->bSupportsChannelGroups; }
 
  void SetSupportsChannelScan(bool supportsChannelScan)
  {
    m_cStructure->bSupportsChannelScan = supportsChannelScan;
  }
 
  bool GetSupportsChannelScan() const { return m_cStructure->bSupportsChannelScan; }
 
  void SetSupportsChannelSettings(bool supportsChannelSettings)
  {
    m_cStructure->bSupportsChannelSettings = supportsChannelSettings;
  }
 
  bool GetSupportsChannelSettings() const { return m_cStructure->bSupportsChannelSettings; }
 
  void SetHandlesInputStream(bool handlesInputStream)
  {
    m_cStructure->bHandlesInputStream = handlesInputStream;
  }
 
  bool GetHandlesInputStream() const { return m_cStructure->bHandlesInputStream; }
 
  void SetHandlesDemuxing(bool handlesDemuxing)
  {
    m_cStructure->bHandlesDemuxing = handlesDemuxing;
  }
 
  bool GetHandlesDemuxing() const { return m_cStructure->bHandlesDemuxing; }
 
  void SetSupportsRecordingPlayCount(bool supportsRecordingPlayCount)
  {
    m_cStructure->bSupportsRecordingPlayCount = supportsRecordingPlayCount;
  }
 
  bool GetSupportsRecordingPlayCount() const { return m_cStructure->bSupportsRecordingPlayCount; }
 
  void SetSupportsLastPlayedPosition(bool supportsLastPlayedPosition)
  {
    m_cStructure->bSupportsLastPlayedPosition = supportsLastPlayedPosition;
  }
 
  bool GetSupportsLastPlayedPosition() const { return m_cStructure->bSupportsLastPlayedPosition; }
 
  void SetSupportsRecordingEdl(bool supportsRecordingEdl)
  {
    m_cStructure->bSupportsRecordingEdl = supportsRecordingEdl;
  }
 
  bool GetSupportsRecordingEdl() const { return m_cStructure->bSupportsRecordingEdl; }
 
  void SetSupportsRecordingsRename(bool supportsRecordingsRename)
  {
    m_cStructure->bSupportsRecordingsRename = supportsRecordingsRename;
  }
 
  bool GetSupportsRecordingsRename() const { return m_cStructure->bSupportsRecordingsRename; }
 
  void SetSupportsRecordingsLifetimeChange(bool supportsRecordingsLifetimeChange)
  {
    m_cStructure->bSupportsRecordingsLifetimeChange = supportsRecordingsLifetimeChange;
  }
 
  bool GetSupportsRecordingsLifetimeChange() const
  {
    return m_cStructure->bSupportsRecordingsLifetimeChange;
  }
 
  void SetSupportsDescrambleInfo(bool supportsDescrambleInfo)
  {
    m_cStructure->bSupportsDescrambleInfo = supportsDescrambleInfo;
  }
 
  bool GetSupportsDescrambleInfo() const { return m_cStructure->bSupportsDescrambleInfo; }
 
  void SetSupportsAsyncEPGTransfer(bool supportsAsyncEPGTransfer)
  {
    m_cStructure->bSupportsAsyncEPGTransfer = supportsAsyncEPGTransfer;
  }
 
  bool GetSupportsAsyncEPGTransfer() const { return m_cStructure->bSupportsAsyncEPGTransfer; }
 
  void SetSupportsRecordingSize(bool supportsRecordingSize)
  {
    m_cStructure->bSupportsRecordingSize = supportsRecordingSize;
  }
 
  bool GetSupportsRecordingSize() const { return m_cStructure->bSupportsRecordingSize; }
 
  void SetSupportsRecordingsDelete(bool supportsRecordingsDelete)
  {
    m_cStructure->bSupportsRecordingsDelete = supportsRecordingsDelete;
  }
 
  bool GetSupportsRecordingsDelete() const { return m_cStructure->bSupportsRecordingsDelete; }
 
  void SetSupportsMultipleRecordedStreams(bool supportsMultipleRecordedStreams)
  {
    m_cStructure->bSupportsMultipleRecordedStreams = supportsMultipleRecordedStreams;
  }
 
  bool GetSupportsMultipleRecordedStreams() const
  {
    return m_cStructure->bSupportsMultipleRecordedStreams;
  }
 
  void SetRecordingsLifetimeValues(const std::vector<PVRTypeIntValue>& recordingsLifetimeValues)
  {
    PVRTypeIntValue::ReallocAndCopyData(&m_cStructure->recordingsLifetimeValues,
                                        &m_cStructure->iRecordingsLifetimesSize,
                                        recordingsLifetimeValues);
  }
 
  std::vector<PVRTypeIntValue> GetRecordingsLifetimeValues() const
  {
    std::vector<PVRTypeIntValue> recordingsLifetimeValues;
    for (unsigned int i = 0; i < m_cStructure->iRecordingsLifetimesSize; ++i)
      recordingsLifetimeValues.emplace_back(
          m_cStructure->recordingsLifetimeValues[i].iValue,
          m_cStructure->recordingsLifetimeValues[i].strDescription);
    return recordingsLifetimeValues;
  }
 
  static void AllocResources(const PVR_ADDON_CAPABILITIES* source, PVR_ADDON_CAPABILITIES* target)
  {
    if (target->iRecordingsLifetimesSize)
    {
      target->recordingsLifetimeValues = PVRTypeIntValue::AllocAndCopyData(
          source->recordingsLifetimeValues, source->iRecordingsLifetimesSize);
    }
  }
 
  static void FreeResources(PVR_ADDON_CAPABILITIES* target)
  {
    PVRTypeIntValue::FreeResources(target->recordingsLifetimeValues,
                                   target->iRecordingsLifetimesSize);
    target->recordingsLifetimeValues = nullptr;
    target->iRecordingsLifetimesSize = 0;
  }
 
private:
  PVRCapabilities(const PVR_ADDON_CAPABILITIES* capabilities) : DynamicCStructHdl(capabilities) {}
  PVRCapabilities(PVR_ADDON_CAPABILITIES* capabilities) : DynamicCStructHdl(capabilities) {}
};
//------------------------------------------------------------------------------
 
//==============================================================================
class PVRStreamProperty : public DynamicCStructHdl<PVRStreamProperty, PVR_NAMED_VALUE>
{
  friend class CInstancePVRClient;
 
public:
  PVRStreamProperty(const PVRStreamProperty& property) : DynamicCStructHdl(property) {}
 
 
  PVRStreamProperty() = default;
 
  PVRStreamProperty(const std::string& name, const std::string& value)
  {
    SetName(name);
    SetValue(value);
  }
 
  void SetName(const std::string& name)
  {
    ReallocAndCopyString(&m_cStructure->strName, name.c_str());
  }
 
  std::string GetName() const { return m_cStructure->strName ? m_cStructure->strName : ""; }
 
  void SetValue(const std::string& value)
  {
    ReallocAndCopyString(&m_cStructure->strValue, value.c_str());
  }
 
  std::string GetValue() const { return m_cStructure->strValue ? m_cStructure->strValue : ""; }
 
  static void AllocResources(const PVR_NAMED_VALUE* source, PVR_NAMED_VALUE* target)
  {
    target->strName = AllocAndCopyString(source->strName);
    target->strValue = AllocAndCopyString(source->strValue);
  }
 
  static void FreeResources(PVR_NAMED_VALUE* target)
  {
    FreeString(target->strName);
    FreeString(target->strValue);
  }
 
private:
  PVRStreamProperty(const PVR_NAMED_VALUE* property) : DynamicCStructHdl(property) {}
  PVRStreamProperty(PVR_NAMED_VALUE* property) : DynamicCStructHdl(property) {}
};
//------------------------------------------------------------------------------
 
} /* namespace addon */
} /* namespace kodi */
 
#endif /* __cplusplus */