Repository: xbmc/xbmc
File: xbmc/addons/kodi-dev-kit/include/kodi/addon-instance/pvr/Recordings.h (C/C++)

Code before:
  unsigned int GetParentalRating() const { return m_cStructure->iParentalRating; }

  /// @brief **optional**\n
  /// Parental rating code for this recording.
  void SetParentalRatingCode(const std::string& ratingCode)
  {
    strncpy(m_cStructure->strParentalRatingCode, ratingCode.c_str(),
            sizeof(m_cStructure->strParentalRatingCode) - 1);
  }

  /// @brief To get with @ref SetParentalRatingCode changed values.
  std::string GetParentalRatingCode() const { return m_cStructure->strParentalRatingCode; }

  /// @brief **optional**\n
  /// Parental rating icon URL for this recording.
  void SetParentalRatingIcon(const std::string& ratingIcon)
  {
    strncpy(m_cStructure->strParentalRatingIcon, ratingIcon.c_str(),
            sizeof(m_cStructure->strParentalRatingIcon) - 1);
  }

  /// @brief To get with @ref SetParentalRatingIcon changed values.
  std::string GetParentalRatingIcon() const { return m_cStructure->strParentalRatingIcon; }

  /// @brief **optional**\n
  /// The source that the backend used to determine the event's parental rating.
  void SetParentalRatingSource(const std::string& ratingSource)
  {
    strncpy(m_cStructure->strParentalRatingSource, ratingSource.c_str(),
            sizeof(m_cStructure->strParentalRatingSource) - 1);
  }

  /// @brief To get with @ref SetParentalRatingSource changed values.
  std::string GetParentalRatingSource() const { return m_cStructure->strParentalRatingSource; }

private:
  PVRRecording(const PVR_RECORDING* recording) : CStructHdl(recording) {}
  PVRRecording(PVR_RECORDING* recording) : CStructHdl(recording) {}
};
///@}
//------------------------------------------------------------------------------

//==============================================================================
/// @defgroup cpp_kodi_addon_pvr_Defs_Recording_PVRRecordingsResultSet class PVRRecordingsResultSet
/// @ingroup cpp_kodi_addon_pvr_Defs_Recording_PVRRecording
/// @brief **PVR add-on recording transfer class**\n
/// To transfer the content of @ref kodi::addon::CInstancePVRClient::GetRecordings().
///
/// @note This becomes only be used on addon call above, not usable outside on
/// addon itself.
///@{

Review comment (suggestion):
=> The source used to determine the recording's parental rating.

Please also note change from event's to recording's.

Code after:
  ///
  /// @ref PVR_PROVIDER_INVALID_UID denotes that provider uid is not available.
  void SetClientProviderUid(int iClientProviderUid)
  {
    m_cStructure->iClientProviderUid = iClientProviderUid;
  }

  /// @brief To get with @ref SetClientProviderUid changed values
  int GetClientProviderUid() const { return m_cStructure->iClientProviderUid; }

  /// @brief **optional**\n
  /// Name for the provider of this channel.
  void SetProviderName(const std::string& providerName)
  {
    ReallocAndCopyString(&m_cStructure->strProviderName, providerName.c_str());
  }

  /// @brief To get with @ref SetProviderName changed values.
  std::string GetProviderName() const
  {
    return m_cStructure->strProviderName ? m_cStructure->strProviderName : "";
  }

  /// @brief **optional**\n
  /// Age rating for the recording.
  void SetParentalRating(unsigned int iParentalRating)
  {
    m_cStructure->iParentalRating = iParentalRating;
  }

  /// @brief To get with @ref SetParentalRating changed values
  unsigned int GetParentalRating() const { return m_cStructure->iParentalRating; }

  /// @brief **optional**\n
  /// Parental rating code for this recording.
  void SetParentalRatingCode(const std::string& ratingCode)
  {
    ReallocAndCopyString(&m_cStructure->strParentalRatingCode, ratingCode.c_str());
  }

  /// @brief To get with @ref SetParentalRatingCode changed values.
  std::string GetParentalRatingCode() const
  {
    return m_cStructure->strParentalRatingCode ? m_cStructure->strParentalRatingCode : "";
  }

  /// @brief **optional**\n
  /// Parental rating icon for this recording.
  void SetParentalRatingIcon(const std::string& ratingIcon)
  {
    ReallocAndCopyString(&m_cStructure->strParentalRatingIcon, ratingIcon.c_str());