string_list_split*() updates
Get series with b4
b4 am [email protected]Versions newest first · linked by author and title
- v4 Latest7 patches 1 replyIn review
- v37 patches 6 repliesSuperseded
- v27 patches 18 repliesSuperseded
Earlier versions · 1
| Version | Posted | Patches | Replies | Status |
|---|---|---|---|---|
| v1 | 5 patches | 4 replies | Superseded |
Patches in v4 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/7 | string-list: report programming error with BUGstring-list.c | +2 | 0 replies | |
| 2/7 | string-list: align string_list_split() with its _in_place() counterpartbuiltin/ builtin/ builtin/ +16 more | +37 | 0 replies | |
| 3/7 | string-list: unify string_list_split* functionsstring-list.c | +56 | 0 replies | |
| 4/7 | string-list: optionally trim string pieces split by string_list_split*()string-list.c string-list.h t/ | +109 | 0 replies | |
| 5/7 | diff: simplify parsing of diff.colormovedwsdiff.c | +7 | 0 replies | |
| 6/7 | string-list: optionally omit empty string pieces in string_list_split*()string-list.c string-list.h t/ | +20 | 0 replies | |
| 7/7 | string-list: split-then-remove-empty can be done while splittingnotes.c pathspec.c t/ +1 more | +7 | 0 replies |
Reviews trailers per patch
No Reviewed-by, Acked-by or Tested-by trailers for v4 yet.
Cover letter [PATCH v4 0/7] string_list_split*() updates
Two related string-list API functions, string_list_split() and string_list_split_in_place(), more or less duplicates their implementations. They both take a single string, and split the string at the delimiter and stuff the result into a string list.
However, there is one subtle and unnecessary difference. The non "in-place" variant only allows a single byte value as delimiter, while the "in-place" variant can take multiple delimiters (e.g., "split at either a comma or a space").
This series first updates the string_list_split() to allow multiple delimiters like string_list_split_in_place() does, by unifying their implementations into one. This refactoring allows us to give new features to these two functions more easily.
Then these functions learn to optionally
- trim the split string pieces before placing them in the resulting string list.
- omit empty string pieces from the resulting string list.
An existing caller of string_list_split() in diff.c trims the elements in the resulting string list before it uses them, which is simplified by taking advantage of this new feature.
A handful of code paths call string_list_split*(), immediately followed by string_list_remove_empty_items(). They are simplified by not placing empty items in the list in the first place.
Relative to the v3 iteration, the v4 iteration explains the history behind string_list_split_in_place() in a bit more detail, and expands in-code comment to clarify what the verb "trim" means in the context of STRING_LIST_SPLIT_TRIM.
Junio C Hamano (7):
string-list: report programming error with BUG
string-list: align string_list_split() with its _in_place()
counterpart
string-list: unify string_list_split* functions
string-list: optionally trim string pieces split by
string_list_split*()
diff: simplify parsing of diff.colormovedws
string-list: optionally omit empty string pieces in
string_list_split*()
string-list: split-then-remove-empty can be done while splitting
builtin/blame.c | 2 +- builtin/merge.c | 2 +- builtin/var.c | 2 +- connect.c | 2 +- diff.c | 20 ++---- fetch-pack.c | 2 +- notes.c | 6 +- parse-options.c | 2 +- pathspec.c | 3 +- protocol.c | 2 +- ref-filter.c | 4 +- setup.c | 3 +- string-list.c | 120 ++++++++++++++++++++++++----------- string-list.h | 33 +++++++--- t/helper/test-hashmap.c | 4 +- t/helper/test-json-writer.c | 4 +- t/helper/test-path-utils.c | 3 +- t/helper/test-ref-store.c | 2 +- t/unit-tests/u-string-list.c | 95 ++++++++++++++++++++++++--- transport.c | 2 +- upload-pack.c | 2 +- 21 files changed, 225 insertions(+), 90 deletions(-)
Range-diff against v3:
1: 442ed679bb = 1: 4f9c8d8963 string-list: report programming error with BUG 2: cc80bac8c2 ! 2: 9f6dfe43c8 string-list: align string_list_split() with its _in_place() counterpart
@@ Metadata
## Commit message ##
string-list: align string_list_split() with its _in_place() counterpart
- For some unknown reason, unlike string_list_split_in_place(),
- string_list_split() took only a single character as a field
- delimiter. Before giving both functions more features in future
- commits, allow string_list_split() to take more than one delimiter
- characters to make them closer to each other.
+ The string_list_split_in_place() function was updated by 52acddf3
+ (string-list: multi-delimiter string_list_split_in_place(),
+ 2023-04-24) to take more than one delimiter characters, hoping that
+ we can later use it to replace our uses of strtok(). We however did
+ not make a matching change to the string_list_split() function,
+ which is very similar.
+
+ Before giving both functions more features in future commits, allow
+ string_list_split() to also take more than one delimiter characters
+ to make them closer to each other.
3: c7922b3e14 = 3: 527535fcdd string-list: unify string_list_split* functions
4: 9d7d22e8ef ! 4: 5764549741 string-list: optionally trim string pieces split by string_list_split*()
@@ string-list.h: int string_list_split(struct string_list *list, const char *strin
int string_list_split_in_place(struct string_list *list, char *string,
const char *delim, int maxsplit);
+
-+/* flag bits for split_f and split_in_place_f functions */
++/* Flag bits for split_f and split_in_place_f functions */
+enum {
-+ /* trim() resulting string piece before adding it to the list */
++ /*
++ * trim whitespaces around resulting string piece before adding
++ * it to the list
++ */
+ STRING_LIST_SPLIT_TRIM = (1 << 0),
+};
+
5: ad8b425bc5 = 5: f3a303aef0 diff: simplify parsing of diff.colormovedws
6: d03f443878 ! 6: 27531efa41 string-list: optionally omit empty string pieces in string_list_split*() @@ string-list.c: static int append_one(struct string_list *list,
string_list_append(list, p);
## string-list.h ##
-@@ string-list.h: int string_list_split_in_place(struct string_list *list, char *string,
- enum {
- /* trim() resulting string piece before adding it to the list */
+@@ string-list.h: enum {
+ * it to the list
+ */
STRING_LIST_SPLIT_TRIM = (1 << 0),
+ /* omit adding empty string piece to the resulting list */
+ STRING_LIST_SPLIT_NONEMPTY = (1 << 1),
7: 9eb8d87d62 = 7: 2ab2aac73d string-list: split-then-remove-empty can be done while splitting
Signature · 1 line
2.50.1-633-g69dfdd50af