HomeManualTopicsTypesSymbols

std_types::string/std::until

returns the substring until (including) the specified expression

Parameters

str
the input string
expr
the expression to look for
nth (default: 1)
look for the nth occurrence of *expr* instead for the first one

Results

None

Description

If the specified expression is found within the string the substring until the expression is returned. Otherwise the empty string is returned.

If nth is specified then the nth occurence of the expression expr is looked for. If there are not at least n matches for expr within str then the empty string is returned.

A very similar function is std_types::string/std::truncate_behind. It behaves differently only when the expression is not found.

Example

$identifier "std::until" $first_part identifier .until. "::" println! first_part

Output

std::

Example

$identifier "std::until" $first_part identifier .until. '.' println! '<' first_part '>'

Output

[]

Topic

Strings

Implements

std::until returns the substring ending with the specified expression

See also

std_types::string/std::truncate_behind returns the substring until (including) the specified expression
std_types::string/std::before returns the substring before the specified expression
std_types::string/std::behind returns the substring after the specified expression
std_types::string/std::from returns the substring starting with the specified expression
(defined in basic/types/collections/strings/string.fky)