Merge remote-tracking branch 'dist/main'

Author: Mathys-Gasnier

CONTRIBUTING.md

@@ -65,7 +65,7 @@ If your function doesn't return anything just show how to use it. If the result
 
 To ensure your snippet isn’t refused, consider these questions:
 - **Does the standard library of my language provide an easy way of doing this ?**
-- **Does that snippet have a real, and practical use case ?**
+- **Does that snippet not have a real, and practical use case ?**
 - **Could it be split into separate parts to be better understood ?**
 
 If any answer is yes, then your snippet will most likely get rejected.

snippets/cpp/array-manipulation/filter-vector.md

@@ -0,0 +1,25 @@
+---
+Title: Filter Vector
+Description: Filters a vector using a predicate function.
+Author: majvax
+Tags: array,filter,c++23
+---
+
+```cpp
+#include <ranges>
+#include <vector>
+
+template <typename T, typename P>
+auto filter(const std::vector<T>& vec, P&& predicate) {
+    return vec
+        | std::views::filter(std::forward<P>(predicate))
+        | std::ranges::to<std::vector<T>>();
+}
+
+
+
+// Usage:
+std::vector<int> vec = {1, 2, 3, 4, 5};
+std::vector<int> filtered = filter(vec, [](int i){ return i % 2 == 0; });
+// filtered contains 2 and 4
+```

snippets/cpp/array-manipulation/transform-vector.md

@@ -0,0 +1,26 @@
+---
+Title: Transform Vector
+Description: Transforms a vector using a function.
+Author: majvax
+Tags: array,transform,c++23
+---
+
+```cpp
+#include <ranges>
+#include <vector>
+
+template <typename T, typename F>
+auto transform(const std::vector<T>& vec, F&& transformer) {
+    using U = std::invoke_result_t<F, T>;
+    return vec
+        | std::views::transform(std::forward<F>(transformer))
+        | std::ranges::to<std::vector<U>>();
+}
+
+
+
+// Usage:
+std::vector<int> vec = {1, 2, 3, 4, 5};
+std::vector<int> transformed = transform(vec, [](int i){ return i * 2; });
+// transformed contains 2, 4, 6, 8, 10
+```

snippets/cpp/file-handling/find-files-recursively.md

@@ -0,0 +1,57 @@
+---
+Title: Find files recursively
+Description: Find all the files in a directory and subdirectories using a predicate function.
+Author: majvax
+Tags: filesystem,file_search,c++17
+---
+
+```cpp
+#include <filesystem>
+#include <vector>
+#include <string>
+
+template <typename P>
+std::vector<std::filesystem::path> find_files_recursive(const std::string& path, P&& predicate) {
+    std::vector<std::filesystem::path> files;
+    std::error_code ec;
+
+    if (!std::filesystem::exists(path, ec) || ec)
+        return files;
+    if (!std::filesystem::is_directory(path, ec) || ec)
+        return files;
+
+    auto it = std::filesystem::recursive_directory_iterator(path, ec);
+    if (ec)
+        return files;
+
+    for (const auto& entry : it)
+        if (!std::filesystem::is_directory(entry) && predicate(entry.path()))
+            files.push_back(entry.path());
+
+    return files;
+}
+
+
+
+// Usage:
+
+// Find all files with size greater than 10MB
+auto files = find_files_recursive("Path", [](const auto& p) {
+    return std::filesystem::file_size(p) > 10 * 1024 * 1024;
+});
+
+// Find all files with ".pdf" as extension
+auto files = find_files_recursive("Path", [](const auto& p) {
+    return p.extension() == ".pdf";
+});
+
+// Find all files writed after The New Year
+#include <chrono>
+// need std=c++20
+auto jan_1_2025 = std::filesystem::file_time_type::clock::from_sys(
+    std::chrono::sys_days{std::chrono::year{2025}/std::chrono::month{1}/std::chrono::day{1}}
+);
+auto files = find_files_recursive("Path", [jan_1_2025](const auto& p) {
+    return std::filesystem::last_write_time(p) > jan_1_2025;
+}),
+```

snippets/cpp/file-handling/find-files.md

@@ -0,0 +1,57 @@
+---
+Title: Find files
+Description: Find all the files in a directory using a predicate function.
+Author: majvax
+Tags: filesystem,file_search,c++17
+---
+
+```cpp
+#include <filesystem>
+#include <vector>
+#include <string>
+
+template <typename P>
+std::vector<std::filesystem::path> find_files(const std::string& path, P&& predicate) {
+    std::vector<std::filesystem::path> files;
+    std::error_code ec;
+
+    if (!std::filesystem::exists(path, ec) || ec)
+        return files;
+    if (!std::filesystem::is_directory(path, ec) || ec)
+        return files;
+
+    auto it = std::filesystem::directory_iterator(path, ec);
+    if (ec)
+        return files;
+
+    for (const auto& entry : it)
+        if (!std::filesystem::is_directory(entry) && predicate(entry.path()))
+            files.push_back(entry.path());
+
+    return files;
+}
+
+
+
+// Usage:
+
+// Find all files with size greater than 10MB
+auto files = find_files("Path", [](const auto& p) {
+    return std::filesystem::file_size(p) > 10 * 1024 * 1024;
+});
+
+// Find all files with ".pdf" as extension
+auto files = find_files("Path", [](const auto& p) {
+    return p.extension() == ".pdf";
+});
+
+// Find all files writed after The New Year
+#include <chrono>
+// need std=c++20
+auto jan_1_2025 = std::filesystem::file_time_type::clock::from_sys(
+    std::chrono::sys_days{std::chrono::year{2025}/std::chrono::month{1}/std::chrono::day{1}}
+);
+auto files = find_files("Path", [jan_1_2025](const auto& p) {
+    return std::filesystem::last_write_time(p) > jan_1_2025;
+}),
+```

snippets/cpp/file-handling/list-directories.md

@@ -0,0 +1,37 @@
+---
+Title: List Directories
+Description: Lists all the directories in a path.
+Author: majvax
+Tags: filesystem,directories,c++17
+---
+
+```cpp
+#include <filesystem>
+#include <vector>
+#include <string>
+
+std::vector<std::filesystem::path> list_directories(const std::string& path) {
+    std::vector<std::filesystem::path> files;
+    std::error_code ec;
+
+    if (!std::filesystem::exists(path, ec) || ec)
+        return files;
+    if (!std::filesystem::is_directory(path, ec) || ec)
+        return files;
+
+    auto it = std::filesystem::directory_iterator(path, ec);
+    if (ec)
+        return files;
+
+    for (const auto& entry : it)
+        if (std::filesystem::is_directory(entry))
+            files.push_back(entry.path());
+
+    return files;
+}
+
+
+
+// Usage:
+auto directories = list_directories("Path");
+```

snippets/cpp/string-manipulation/filter.md

@@ -0,0 +1,25 @@
+---
+title: Filter
+description: Filter a string with a predicate function
+author: majvax
+tags: string,filtering,c++23
+---
+
+```cpp
+#include <ranges>
+#include <string>
+
+template <typename P>
+std::string filter(const std::string& str, P&& predicate) {
+    return str
+        | std::ranges::views::filter(std::forward<P>(predicate))
+        | std::ranges::to<std::string>();
+}
+
+
+
+// Usage:
+std::string str = "Hello, World!";
+std::string filtered = filter(str, [](char c){ return std::isalpha(c); });
+std::cout << filtered << std::endl; // HelloWorld
+```

snippets/cpp/string-manipulation/palindrome.md

@@ -0,0 +1,26 @@
+---
+title: Palindrome
+description: Check if a string is a palindrome or not.
+author: majvax
+tags: string,c++23
+---
+
+```cpp
+#include <string>
+#include <ranges>
+#include <algorithm>
+
+bool is_palindrome(const std::string& str) {
+    std::string sanitized_string = str
+        | std::ranges::views::filter([](char c){ return std::isalnum(c); })
+        | std::ranges::views::transform([](char c){ return std::tolower(c); })
+        | std::ranges::to<std::string>();
+    
+    return std::ranges::equal(sanitized_string, sanitized_string | std::views::reverse);
+}
+
+
+
+// Usage:
+bool pal = is_palindrome("A man, a plan, a canal, Panama"); // true
+```

snippets/cpp/string-manipulation/reverse-string.md

@@ -2,7 +2,7 @@
 title: Reverse String
 description: Reverses the characters in a string.
 author: Vaibhav-kesarwani
-tags: array,reverse
+tags: array,reverse,c++23
 ---
 
 ```cpp

snippets/cpp/string-manipulation/transform.md

@@ -0,0 +1,25 @@
+---
+title: Transform
+description: Transform a string with a function
+author: majvax
+tags: string,transform,c++23
+---
+
+```cpp
+#include <ranges>
+#include <string>
+
+template <typename F>
+std::string transform(const std::string& str, F&& transformer) {
+    return str
+        | std::ranges::views::transform(std::forward<F>(transformer))
+        | std::ranges::to<std::string>();
+}
+
+
+
+// Usage:
+std::string str = "Hello, World!";
+std::string transformed = transform(str, [](char c){ return std::toupper(c); });
+std::cout << transformed << std::endl; // HELLO, WORLD!
+```