working on documentation and more API functions

2026-04-29 12:09:37 +00:00
parent cd445f3c9b
commit 9f7625c7fd
94 changed files with 1896 additions and 458 deletions
@@ -0,0 +1,38 @@
+:sig
+StringList regex_split(String pattern, String subject)
+StringList regex_split(String pattern, String subject, String flags)
+
+:params
+pattern : PCRE2 regular expression pattern used as the separator
+subject : string to split
+flags : optional regex flags
+return value : a list of string parts
+
+:see
+>regex
+regex_match
+regex_search
+regex_search_all
+regex_replace
+split
+join
+StringList
+
+:content
+Splits `subject` wherever `pattern` matches.
+
+Example:
+
+```uce
+StringList tags = regex_split("\\s*,\\s*", "uce, components, markdown");
+print(join(tags, "\n"));
+```
+
+This is the pattern-aware companion to `split()`.
+
+Behavior notes:
+
+- Separators are removed from the returned list.
+- Empty fields are preserved.
+- If the pattern does not match, the result contains the original subject as a single item.
+- Zero-length separators are handled safely to avoid infinite loops.