B4P Reference

Function Names

right, right include, right last match, right last match include

Description

This function extracts a right part of the string either with a character position number or a matching pattern.

Call as: function

Restrictions

Indirect parameter passing is disabled

Parameter count

Parameters

No.	Type	Description
1 input	valid types	input string or value Attention: If 1st parameter is a parameter set, please refer to right [parameter set function] instead. Values of types other than string will be converted to strings first.
2 input	numeral	character position Positive: Keep number of characters counted from the right (0 = blank string, 1 = last, etc.) Larger than character count: Full string returned Negative: Keep number of characters counted from the left (-1 = all except first character) Smaller than minus character count: Empty string returned Zero: Empty string returned The function name ending '... include' will be ignored. Using the function name part '... last match ...' will assert an error.
Alt. 2 input	string	matching pattern Function right ...: Return the right part of the string without the matching pattern. Function right include ...: Return the right part of the string including the matching pattern. Function name ending ... last match: Looks for the last matching pattern in the string and not the first one. Empty strings will be interpreted as positive match before the 1st character and this function returns the complete strings. Matching patterns are case-sensitive. Attention: The matching pattern parameter distinguishes between strings and softquoted strings. In softquoted strings, following wildcard symbols act as placeholders: '?' for any character, '#' for any digit and '^' for any letter.

Return value

Type	Description
string	Extracted substring

Examples

      st[] = "The taste of the coffee!";



      echo( right( st[], 0 ), " / ", right( st[], 1 ), " / ", right( st[], -2 ), " / ", right( st[], -1 ) );

      echo( right( st[],99 ), " / ", right( st[],-99) );

      echo;

      echo( right( st[], ' taste' ), " / ", right include( st[], ' taste' ) );

      echo( right( st[], ' ' ), " / ", right last match( st[], ' ' ) );

      echo( right last match include( st[], 'e' ) ); // Last 'e' and exclamation mark

      echo;

      echo( right( st[], 't?ste' ) ); // Softquoted string (no or single quotation marks) - matched

      echo( right( st[], "t?ste" ) ); // Quoted string (double quotation marks) - not matched

Output

 / ! / e taste of the coffee! / he taste of the coffee!
The taste of the coffee! / 

 of the coffee! /  taste of the coffee!
taste of the coffee! / coffee!
e!

 of the coffee!
The taste of the coffee!

Try it yourself: Open LIB_Function_right.b4p in B4P_Examples.zip. Decompress before use.

right ... (string function)