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.
Comparison
strfollow(X;Y;B)
Returns the first position where two strings differ from one another, or 0 if they are equal.

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
    - beginswith(X;L)
      Returns a boolean value indicating whether a given string begins with any of the substrings in a given list.
    - beginswith_ci(X;L)
      Returns a boolean value indicating whether a given string begins with any of the substrings in a given list and is case insensitive. (Available as of version 12.33)
    - between(X;Y;Z)
      Returns a boolean value indicating whether a given value is between two other values.
    - between_ci(X;Y;Z)
      Returns a boolean value indicating whether a given value is between two other values and is case insensitive. (Available as of version 12.34)
    - bstrclean(X)
      Returns a boolean value indicating whether the given string is plain (7-bit) ASCII (i.e., "8-bit clean").
    - contains(X;L)
      Returns a boolean value indicating whether a given string contains any of the substrings in a given list.
    - contains_ci(X;L)
      Returns a boolean value indicating whether a given string contains any of the substrings in a given list and is case insensitive. (Available as of version 12.33)
    - edistnorm(X;Y)
      Returns the normalized Levenshtein edit distance between two given strings.
    - editdist(X;Y)
      Returns the Levenshtein edit distance between two given strings.
    - endswith(X;L)
      Returns a boolean value indicating whether a given string ends with any of the substrings in a given list.
    - endswith_ci(X;L)
      Returns a boolean value indicating whether a given string ends with any of the substrings in a given list and is case insensitive. (Available as of version 12.33)
    - eq_ci(X;Y)
      Returns a boolean value indicating whether the value of the first argument is equal to the second and is case insensitive. (Available as of version 12.34)
    - eqlin_ci(X;Y)
      Returns a boolean value indicating whether the value of the first argument is equal to (one of the values of) the second and is case insensitive. (Available as of version 12.34)
    - gt_ci(X;Y)
      Returns a boolean value indicating whether the value of the first argument is greater than the value of the second argument and is case insensitive. (Available as of version 12.34)
    - lt_ci(X;Y)
      Returns a boolean value indicating whether the value of the first argument is less than the value of the second argument and is case insensitive. (Available as of version 12.34)
    - rm(X;Y)
      Returns a boolean value indicating whether a given string matches a standard regular expression. (Available as of version 12.33)
    - rm_ci(X;Y)
      Returns a boolean value indicating whether a given string matches a standard regular expression and is case insensitive. (Available as of version 12.33)
    - sm(X;Y)
      Returns a boolean value indicating whether a given string matches a particular template, and is case sensitive.
    - sm_ci(X;Y)
      Returns a boolean value indicating whether a given string matches a particular template and is case insensitive. (Available as of version 12.33)
    - strclean(X)
      Returns a boolean value indicating whether the given string is a legal UTF-8 (Unicode) string.
    - strcmp(X;Y;B)
      Returns an integer value that indicates the results of comparing two strings.
    - strfollow(X;Y;B)
      Returns the first position where two strings differ from one another, or 0 if they are equal.
  - Transformations
  - Regular expressions
- 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.

`strfollow(X;Y;B)`

Returns the first position where two strings differ from one another, or 0 if they are equal.

Syntax

strfollow(X;Y;B)
bstrfollow(X;Y;B)

Input

Argument Type Description

X

text

The string on which to apply the function

A scalar value or the name of a column

Y

text

The string to compare to X

A scalar value or the name of a column

B

integer

Specifies whether the comparison is case sensitive or not

If B=0, the comparison is not case sensitive.

If B is non-zero (including N/A), then it is treated as if it were 1 (i.e., the comparison is case sensitive).

Return Value

Returns an integer value corresponding to the first position where the string X differs from the string Y. If the strings are the same, the function returns 0.

Note: The comparison is case insensitive if and only if B=0.

Unicode code-point order (which does not correspond to the lexicographic order used in any particular language) is used for comparison. Generic (non-language-specific) Unicode case folding is used for case-insensitive comparisons.

If both X and Y are N/A, then the result is 0. If either X or Y is N/A, then the result is 1.

Sample Usage


`value`	`string2`	`caseflag`	`strfollow(value;string2;caseflag)`
'apple'	'application'	1	5
'apple'	'app'	1	4
'apple'	'Apple'	0	0
'Apple'	'apple'	1	1
'Apple'	''	1	1
''	''	1	0

Additional Information

strfollow is Unicode (UTF-8) compliant and will work with Unicode or plain ASCII text fields.
If passed a string argument that is not legal Unicode, it will by default signal an error (configurable as a user preference).
A corresponding function bstrfollow can be used with non-Unicode strings (e.g., binary or legacy encodings).