kstringarray.h

Go to the documentation of this file.

/****************************************************************************
**
** This file is part of KDWinutils, KDAB's MFC to Qt migration tool.
**
** Copyright (C) 2023 Klarälvdalens Datakonsult AB, a KDAB Group company <info@kdab.com>
** All rights reserved.
**
** This file is intended solely for use by the migration tools and services
** provided by Klarälvdalens Datakonsult AB.
**
**  Any other use or distribution of this software that is not otherwise agreed
**  upon in writing and signed by an authorized representative of Klarälvdalens
**  Datakonsult AB, KDAB (USA) LLC, KDAB (Deutschland) GmbH & Co. K.G.,
**  KDAB (France) SAS, KDAB (UK), Ltd., or any future subsidiary of Klarälvdalens
**  Datakonsult AB is hereby prohibited.
**
**  Contact info@kdab.com if any conditions stated above are unclear to you.
**
****************************************************************************/
 
#pragma once
 
#include "../kdwinutils_global.h"
#include "kstring.h"
 
#include <QStringList>
 
KDWINUTILS_BEGIN_NAMESPACE
 
class KDWINUTILS_EXPORT KStringArray : public QList<KString>
{
public:
    KStringArray();
    using QList<KString>::QList;
 
    // QStringList CString specific methods
    /* implicit */ KStringArray(const QStringList &strList);
    using QList<KString>::operator=;
    KStringArray &operator=(const QStringList &strList);
    QStringList toQStringList() const;
    /* implicit */ operator QStringList() const;
 
#ifdef KDWINUTILS_WITHMFC
    // CStringArray specific methods, available only on Windows with MFC set
    // Note: CStringArray is not copyable, nor movable, so we cannot provide any conversion operators
    // and it doesn't make sense to add a constructor from CStringArray either.
    void Copy(const CStringArray &strArray);
#endif // KDWINUTILS_WITHMFC
 
    // MFC API from here on
 
    int Add(const KString &str);
 
    int Append(const KStringArray &src);
 
    void Copy(const KStringArray &src);
 
    QString &ElementAt(int nIndex);
 
    void FreeExtra();
 
    const QString &GetAt(int nIndex) const;
 
    int GetCount() const;
 
    int GetSize() const;
 
    int GetUpperBound() const;
 
    void InsertAt(int nIndex, const KString &newElement, int nCount = 1);
 
    void InsertAt(int nStartIndex, const KStringArray &pNewArray);
 
    bool IsEmpty() const;
 
    void RemoveAll();
 
    void RemoveAt(int nIndex, int nCount = 1);
 
    void SetAt(int nIndex, const KString &newElement);
 
    void SetAtGrow(int nIndex, const QString &newElement);
 
    void SetSize(int nNewSize, int nGrowBy = -1);
};
 
KDWINUTILS_END_NAMESPACE