/**
 * @file   FITKDictObject.h
 * @brief 字典工程
 * @author liuzhonghua (liuzhonghuaszch@163.com)
 * @date 2024-07-15
 */
#ifndef _FITKDICTOBJECT_H__
#define _FITKDICTOBJECT_H__

#include "FITKOFDictWriterAPI.h"
#include "FITKAbstractDict.h"
#include <QList>

class QTextStream;

namespace DICT
{
    class FITKDictValue;
    /**
     * @brief 字典工程
     * @author liuzhonghua (liuzhonghuaszch@163.com)
     * @date 2024-07-15
     */
    class FITKOFDictWriterAPI FITKDictObject
    {

    public:
        explicit FITKDictObject() = default;
        FITKDictObject(const FITKDictObject &other);
        ~FITKDictObject();
        FITKDictObject &operator=(const FITKDictObject &other);
        /**
         * @brief 获取数量
         * @return int
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-16
         */
        int count() const;
        /**
         * @brief 通过名称获取字典数据
         * @param[i] key 名称或钥匙
         * @return DICT::FITKDictValue*
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-16
         */
        FITKDictValue* value(const QString key);
        /**
         * @brief 通过下标获取字典数据
         * @param[i] index 下标
         * @return DICT::FITKDictValue*
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-16
         */
        FITKDictValue* at(const int index);
        /**
         * @brief 追加字典数据
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void append(QString key, FITKAbstractDict::DictType value);
        /**
         * @brief 追加字典数据
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void append(QString key, bool value);
        /**
         * @brief 追加字典数据
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void append(QString key, double value);
        /**
         * @brief 追加字典数据
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void append(QString key, int value);
        /**
         * @brief 追加字典数据
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void append(QString key, const QString &value);
        /**
         * @brief 追加字典数据
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void append(QString key, const char *value);
        /**
         * @brief 追加字典数据
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void append(QString key, const QStringList &value);
        /**
         * @brief 追加字典数据
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void append(QString key, FITKAbstractDict* value);

        /**
         * @brief 插入字典数据
         * @param[i] index 位置标号
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void insert(int index, QString key, FITKAbstractDict::DictType value);
        /**
         * @brief 插入字典数据
         * @param[i] index 位置标号
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void insert(int index, QString key, bool value);
        /**
         * @brief 插入字典数据
         * @param[i] index 位置标号
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void insert(int index, QString key, double value);
        /**
         * @brief 插入字典数据
         * @param[i] index 位置标号
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void insert(int index, QString key, int value);
        /**
         * @brief 插入字典数据
         * @param[i] index 位置标号
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void insert(int index, QString key, const QString &value);
        /**
         * @brief 插入字典数据
         * @param[i] index 位置标号
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void insert(int index, QString key, const char *value);
        /**
         * @brief 插入字典数据
         * @param[i] index 位置标号
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void insert(int index, QString key, const QStringList& value);
        /**
         * @brief 插入字典数据
         * @param[i] index 位置标号
         * @param[i] key 名称或钥匙
         * @param[i] value 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-17
         */
        void insert(int index, QString key, FITKAbstractDict* value);
        /**
         * @brief 移除字典数据
         * @param[i] i 标号
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-16
         */
        void removeAt(int index);
        /**
         * @brief 移除字典数据
         * @param[i] key 名称或钥匙
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-16
         */
        void removeKey(QString key);
        /**
         * @brief 写出字典数据
         * @param[i] stream 文件数据流
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-16
         */
        void writeObjectDict(QTextStream* stream);
    private:
        /**
         * @brief 字典数据
         * @author liuzhonghua (liuzhonghuaszch@163.com)
         * @date 2024-07-16
         */
        QList<FITKDictValue*> m_values{};
    };
}


#endif