1BSON_APPEND_REGEX_W_LEN(3)          libbson         BSON_APPEND_REGEX_W_LEN(3)
2
3
4

NAME

6       bson_append_regex_w_len - bson_append_regex_w_len()
7

SYNOPSIS

9          bool
10          bson_append_regex_w_len (bson_t *bson,
11                                    const char *key,
12                                    int key_length,
13                                    const char *regex,
14                                    int regex_length,
15                                    const char *options);
16

PARAMETERS

18       · bson: A bson_t.
19
20       · key: An ASCII C string containing the name of the field.
21
22       · key_length: The length of key in bytes, or -1 to determine the length
23         with strlen().
24
25       · regex: An ASCII string containing the regex.
26
27       · regex_length: The length of regex in bytes, or -1  to  determine  the
28         length with strlen().
29
30       · options: An optional string containing the regex options as a string.
31

DESCRIPTION

33       Appends  a  new  field to bson of type BSON_TYPE_REGEX. regex should be
34       the regex string. options should contain the options for the regex.
35
36       Valid characters for options include:
37
38       · 'i' for case-insensitive.
39
40       · 'm' for multiple matching.
41
42       · 'x' for verbose mode.
43
44       · 'l' to make w and W locale dependent.
45
46       · 's' for dotall mode ('.' matches everything)
47
48       · 'u' to make w and W match unicode.
49

RETURNS

51       Returns true if the operation was applied  successfully.  The  function
52       will fail if appending the regex grows bson larger than INT32_MAX.
53

AUTHOR

55       MongoDB, Inc
56

58       2017-present, MongoDB, Inc
59
60
61
62
631.16.2                           Feb 25, 2020       BSON_APPEND_REGEX_W_LEN(3)
Impressum