Utils: Introduce a FilePath::chopped() convenience function

Change-Id: I5fd813af83d58e62e026b3764d3d4378429c2162
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
Reviewed-by: Marcus Tillmanns <marcus.tillmanns@qt.io>
Reviewed-by: Dominik Holland <dominik.holland@qt.io>

2 files changed, 18 insertions, 0 deletions

diff --git a/src/libs/utils/filepath.cpp b/src/libs/utils/filepath.cpp
index 66bdfe3d76..c38c80d182 100644
--- a/src/libs/utils/filepath.cpp
+++ b/src/libs/utils/filepath.cpp
@@ -1576,6 +1576,23 @@ FilePath FilePath::withNewMappedPath(const FilePath &newPath) const
 }
 
 /*!
+    Returns a path with the \a n characters of the local path removed.
+    Example usage:
+    \code
+        backup = FilePath("/tmp/example.txt.backup");
+        real = backup.chopped(7);
+        assert(real == FilePath("/tmp/example.txt"))
+    \endcode
+*/
+
+FilePath FilePath::chopped(int n) const
+{
+    FilePath res;
+    res.setParts(scheme(), host(), path().chopped(n));
+    return res;
+}
+
+/*!
     Returns a FilePath with local path \a newPath on the same device
     as the current object.
 
diff --git a/src/libs/utils/filepath.h b/src/libs/utils/filepath.h
index 2264e3761a..24048a84fc 100644
--- a/src/libs/utils/filepath.h
+++ b/src/libs/utils/filepath.h
@@ -168,6 +168,7 @@ public:
     [[nodiscard]] FilePaths devicePathEnvironmentVariable() const;
     [[nodiscard]] FilePath withNewPath(const QString &newPath) const;
     [[nodiscard]] FilePath withNewMappedPath(const FilePath &newPath) const;
+    [[nodiscard]] FilePath chopped(int n) const;
 
     using IterateDirCallback
         = std::variant<