Home
Function Reference
1010data Insights Platform offers a rich set of functions that may be used in value expressions when creating computed columns and in selection expressions when performing row selections.
String functions
String functions are vector functions that manipulate vectors of strings to provide information about a string or substring, concatenate and split strings, or transform strings based on specified criteria.
Regular expressions
regex_beg(X;L;Y;I)
Returns the beginning position with respect to a particular match of a specified regular expression within a given string.

Function Reference
1010data Insights Platform offers a rich set of functions that may be used in value expressions when creating computed columns and in selection expressions when performing row selections.
- All 1010data Functions
  1010data provides a whole range of functions that can provide information and act on your data.
- Time/Date functions
  The time/date functions are vector functions that operate on columns containing time-related data and return specific information about the date/time for each row.
- Group functions (g_functions)
  Group functions, or g_functions, are used to perform operations, such as summarizations, on rows that have the same values in a set of given columns.
- Math functions
  Math functions are vector functions that perform mathematical operations on one or more columns and return a column of results based on the operation.
- Matrix functions
- Categorization functions
  Categorization functions are vector functions that organize data and determine logical groupings. These functions can be used for conditionalizing results and/or bucketing value ranges.
- String functions
  String functions are vector functions that manipulate vectors of strings to provide information about a string or substring, concatenate and split strings, or transform strings based on specified criteria.
  - Length
  - Position
  - Case
  - Substrings
  - Concatenation
  - Comparison
  - Transformations
  - Regular expressions
    - regex_beg(X;L;Y;I)
      Returns the beginning position with respect to a particular match of a specified regular expression within a given string.
    - regex_count(X;L;Y)
      Returns the number of matches of a specified regular expression within a given string.
    - regex_end(X;L;Y;I)
      Returns the position following a particular match of a specified regular expression within a given string.
    - regex_match(X;L;Y;I)
      Returns the substring corresponding to a particular match of a specified regular expression within a given string.
    - regex_subst(X;L;Y;I;Z)
      Returns the given string with a particular match (or all matches) of a specified regular expression replaced by a given substring.
- List functions
  List functions are scalar functions that return lists, subsets of lists, and combinations of lists, among other functionality. Lists, along with packages, are compound scalar data types that facilitate programmatic interaction with scalar data values and variables.
- Data-handling functions
  Data-handling functions are vector functions that return a hash value based on an input column or columns.
- Row functions
  Row functions are vector functions that return computational outputs for row inputs, as opposed to column outputs. Row inputs are defined as a space- or comma-separated list of column names.
- SQL compatibility functions
  SQL compatibility functions are functions that treat null values as SQL nulls.
- Financial functions
- System functions
  System functions are special functions in 1010data that return information about users, tables, and other system objects.
- Object functions
  The object functions can be used to check the existence, type, and accessibility of objects such as folders, tables, and queries on the 1010data Insights Platform.
- Miscellaneous functions
  This category of functions contains special functions that don't neatly fit into other categories of functions.

`regex_beg(X;L;Y;I)`

Returns the beginning position with respect to a particular match of a specified regular expression within a given string.

Syntax

regex_beg(X;L;Y;I)

Input

Argument	Type	Description
`X`	text	A valid regular expression to search for in the string `Y`
`L`	text	A list of one or more string options. (`L` may be omitted.) These options include: `'icase'` - ignore case `'lit'` - treat `X` as a literal string rather than a regular expression `'nl'` - treat the newline character as a line delimiter `'ug'` - default all operators to be ungreedy `'right'` - make matches right-associative `'first'` - find only the first match - this is also faster if it is necessary to determine if there is any match at all `'tre'` - use a TRE regex engine (default) (Available as of prod-9.) `'pcre'` - use a Perl Compatible Regular Expression (PCRE) engine (Available as of prod-9.) The `'tre'` and `'pcre'` options refer to the back-end regex engine used for matching. If both options are specified, or if neither option is specified, the TRE engine will be used. Note: The `'lit'` and `'right'` options cannot be used in conjunction with the `'pcre'` option.
`Y`	text	The string within which to search for the regular expression `X` A scalar value or the name of a column
`I`	integer	An index corresponding to a particular instance of the regular expression `X` within the given string `Y` The index `I` is 1-based (i.e., the first match has index 1). A negative index counts back from the end of the string (i.e., `I`=`-1` refers to the last match).

Return Value

Returns the integer value corresponding to the beginning position of the I'th match of the regular expression X within the string Y.

If Y is N/A, the result is N/A.

Sample Usage


`regex`	`options`	`string`	`index`	`regex_beg(regex;options;string;index)`
'a(b\|c\|d)'		'Abracadabra'	1	4
'a(b\|c\|d)'	'icase'	'Abracadabra'	-4	1
'a(b\|c\|d)'		''	1

Additional Information

1010data supports POSIX standard regular expressions. See Regular Expressions for more information.