mirrors/haproxy
1
0
Fork 0
mirror of https://git.haproxy.org/git/haproxy.git/ synced 2025-08-07 15:47:01 +02:00
Code Issues Projects Releases Wiki Activity

DOC: Clarify the differences between field() and word()

Browse Source 
word() mentions that delimiters at the start and end are ignored, but
it does not mention that consecutive delimiters are merged.

May be backported as far as the patch applies.
This commit is contained in:
Tim Duesterhus 2023-11-30 16:41:18 +01:00 committed by Willy Tarreau
parent 1dcc6a8a96
commit ed3bc0bfdd
1 changed files with 6 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
doc/configuration.txt
View File

@ -18479,6 +18479,7 @@ field(<index>,<delimiters>[,<count>])
fields. fields.
Example : Example :
str(f1_f2_f3__f5),field(4,_) # <empty>
str(f1_f2_f3__f5),field(5,_) # f5 str(f1_f2_f3__f5),field(5,_) # f5
str(f1_f2_f3__f5),field(2,_,0) # f2_f3__f5 str(f1_f2_f3__f5),field(2,_,0) # f2_f3__f5
str(f1_f2_f3__f5),field(2,_,2) # f2_f3 str(f1_f2_f3__f5),field(2,_,2) # f2_f3
@ -19746,17 +19747,21 @@ word(<index>,<delimiters>[,<count>])
Extracts the nth word counting from the beginning (positive index) or from Extracts the nth word counting from the beginning (positive index) or from
the end (negative index) considering given delimiters from an input string. the end (negative index) considering given delimiters from an input string.
Indexes start at 1 or -1 and delimiters are a string formatted list of chars. Indexes start at 1 or -1 and delimiters are a string formatted list of chars.
Delimiters at the beginning or end of the input string are ignored. Empty words are skipped. This means that delimiters at the start or end of
the input string are ignored and consecutive delimiters within the input
string are considered to be a single delimiter.
Optionally you can specify <count> of words to extract (default: 1). Optionally you can specify <count> of words to extract (default: 1).
Value of 0 indicates extraction of all remaining words. Value of 0 indicates extraction of all remaining words.
Example : Example :
str(f1_f2_f3__f5),word(4,_) # f5 str(f1_f2_f3__f5),word(4,_) # f5
str(f1_f2_f3__f5),word(5,_) # <not found>
str(f1_f2_f3__f5),word(2,_,0) # f2_f3__f5 str(f1_f2_f3__f5),word(2,_,0) # f2_f3__f5
str(f1_f2_f3__f5),word(3,_,2) # f3__f5 str(f1_f2_f3__f5),word(3,_,2) # f3__f5
str(f1_f2_f3__f5),word(-2,_,3) # f1_f2_f3 str(f1_f2_f3__f5),word(-2,_,3) # f1_f2_f3
str(f1_f2_f3__f5),word(-3,_,0) # f1_f2 str(f1_f2_f3__f5),word(-3,_,0) # f1_f2
str(/f1/f2/f3/f4),word(1,/) # f1 str(/f1/f2/f3/f4),word(1,/) # f1
str(/f1////f2/f3/f4),word(1,/) # f2
wt6([<avalanche>]) wt6([<avalanche>])
Hashes a binary input sample into an unsigned 32-bit quantity using the WT6 Hashes a binary input sample into an unsigned 32-bit quantity using the WT6