File: stringviewhelpers.h

package info (click to toggle)
kdevelop 4%3A24.12.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 71,888 kB
  • sloc: cpp: 290,869; python: 3,626; javascript: 3,518; sh: 1,316; ansic: 703; xml: 401; php: 95; lisp: 66; makefile: 31; sed: 12
file content (81 lines) | stat: -rw-r--r-- 2,323 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
/*
    SPDX-FileCopyrightText: 2024 Igor Kushnir <igorkuo@gmail.com>

    SPDX-License-Identifier: LGPL-2.0-or-later
*/

#ifndef KDEVPLATFORM_STRING_VIEW_HELPERS_H
#define KDEVPLATFORM_STRING_VIEW_HELPERS_H

#include <QString>
#include <QStringView>

namespace KDevelop {

/**
 * @pre @p pos >= 0
 * @return a string view starting at position @p pos in @p view and extending to its end,
 *         or an empty string view if @p pos exceeds the length of @p view
 */
constexpr QStringView slicedOrEmptyView(QStringView view, qsizetype pos)
{
    Q_ASSERT(pos >= 0);
    return pos < view.size() ? view.sliced(pos) : QStringView{};
}

/**
 * @pre @p offset >= 0
 * @return @c true if the substring of @p view from position @p offset starts with @p str
 */
template<class String>
constexpr bool matchesAtOffset(QStringView view, qsizetype offset, String str)
{
    Q_ASSERT(offset >= 0);
    const auto strSize = str.size();
    return offset + strSize <= view.size() && view.sliced(offset, strSize) == str;
}

/**
 * @copydoc matchesAtOffset(QStringView,qsizetype,String)
 */
inline bool matchesAtOffset(QStringView view, qsizetype offset, const QString& str)
{
    return matchesAtOffset(view, offset, QStringView{str});
}

/**
 * Finds the first occurrence of @p needle in @p view and returns
 * the subview before the needle or the entire view if not found.
 */
template<typename Needle>
QStringView leftOfNeedleOrEntireView(QStringView view, Needle needle)
{
    const auto index = view.indexOf(needle);
    return index == -1 ? view : view.first(index);
}

/**
 * Finds the last occurrence of @p needle in @p view and returns
 * the subview before the needle or the entire view if not found.
 */
template<typename Needle>
QStringView leftOfLastNeedleOrEntireView(QStringView view, Needle needle)
{
    const auto index = view.lastIndexOf(needle);
    return index == -1 ? view : view.first(index);
}

/**
 * Finds the last occurrence of @p needle in @p view and returns
 * the subview after the needle or the entire view if not found.
 */
template<typename Needle>
QStringView rightOfLastNeedleOrEntireView(QStringView view, Needle needle)
{
    const auto index = view.lastIndexOf(needle);
    return index == -1 ? view : view.sliced(index + 1);
}

} // namespace KDevelop

#endif // KDEVPLATFORM_STRING_VIEW_HELPERS_H