B4P Reference

Function Names

outside , outside exclude , outside until , outside until exclude

Description

This function extracts a outside part of the parameter set either with two element position numbers or matching elements or a combination of both. More precisely, is is the opposite of the middle [parameter set function].

Call as: function

Restrictions

Indirect parameter passing is disabled

Parameter count

Parameters

No.	Type	Description
1 input	parameter set	input parameter set Attention: If 1st parameter is not a parameter set, please refer to outside [string function] instead.
2 input	numeral	starting element position Positive: First part of the subset ends before this position (0 = 1st element, 1 = 2nd element, etc.) Larger than number of elements: complete parameter set returned Negative: Starting position counted from right to left, e.g. -1 = last element Smaller than minus number of elements in parameter set: Begins with 1st element The function name ending '... exclude' will be ignored.
Alt. 2 input	parameter set	starting matching elements Function outside ...: First part of the parameter set ends including the starting matching element. Function outside exclude ...: First part of the parameter set ends before the starting matching element. Empty parameter sets are interprested as per se found. If this function parameter contains 2 or more elements, then the set will be compared with all elements and the first match with any of these elements will apply. Function name ending ... last match: Looks for the last matching elements in the parameter set and not the first one.
3 input	numeral	element count or ending element position For function names outside until, this parameter contains the ending element position. Negative numbers count from right to left: -1 = 2nd part begins behind last element (= nothing), -2 = 2nd part begins behind 2nd last element (last element included). Element positions before the starting position of found element will return the full parameter sets. For function names not containing until, this parameter contains the element count. 0 and negative numbers complete parameter sets. The function name ending '... exclude' will be ignored.
Alt. 3 input	parameter set	ending matching elements Function outside ...: 2nd part of the parameter set begins including the ending matching element. Function outside exclude ...: 2nd part of the parameter set begins after the ending matching element. Empty parameter sets means no further matches and the full original parameter set is returned. Attention: The function names ending outside until combined with matching elements provided will assert errors. If this function parameter contains 2 or more elements, then the set will be compared with all elements and the first match with any of these elements will apply. Function name ending ... last match: Looks for the last matching element in the parameter set and not the first one. Empty parameter sets are interprested as per se found.
Opt. 4+ io	parameter set	follower Other parameter sets in addition to the one provided as the first function parameter can be extracted in the same same way. Add any number of additional parameter set variables. They will be manipulated at the exact same positions as the returned value.

Return value

Type	Description
parameter set	Extracted subset

Examples

      set[] = { the, taste, of, the, 12, coffees, '!' };



      echo( outside( set[], 4,  2 ), " / ", outside until( set[], 1, 5 ) );

      echo( outside( set[], -3, 2 ), " / ",  outside until( set[], -6, -2 ) );

      echo;

      echo( outside( set[],  99, 3 ), " / ",  outside until ( set[],  99, 3 ) ); // empty sets

      echo( outside( set[], -99, 3 ), " / ",  outside until ( set[], -99, 3 ) ); // the taste of / ... the

      echo;

      echo( outside( set[], {taste}, 4 ), " / ", outside exclude( set[], {taste}, 4 ) ); // 4 elements in both cases

      echo( outside until( set[], {taste}, -2 ), " / ", outside until exclude( set[], {taste}, -2 ) );

      echo( outside ( set[], {taste}, {coffees} ), " / ", outside exclude( set[], {taste}, {coffees} ) );



      echo( outside ( set[], {}, {coffees} ), " / ", outside exclude( set[], {taste}, {} ) );

      echo( outside ( {}, {}, {coffees} ), " / ", outside exclude( {}, {taste}, {} ) ); // empty sets

      echo;

      echo( "Demonstrate the follower feature: ");



      set2[] = { A, fragrance, coming, from, 120, espressos, '!' };

      set3[] = { Der, Geschmack, kommt, von, 120, Tassen Kaffee, '!' };



      echo( "Extraction 1: ", outside( set[], {of}, 3, set2[], set3[] ) );

      echo( "Extraction 2: ", set2[] );

      echo( "Extraction 3: ", set3[] );

Output

{'the','taste','of','the','!'} / {'the','!'}
{'the','taste','of','the','!'} / {'the','!'}

{'the','taste','of','the',12,'coffees','!'} / {'the','taste','of','the',12,'coffees','!'}
{'the',12,'coffees','!'} / {12,'coffees','!'}

{'the','taste','!'} / {'the','coffees','!'}
{'the','taste','!'} / {'the','!'}
{'the','taste','coffees','!'} / {'the','!'}
{'coffees','!'} / {'the','taste','of','the',12,'coffees','!'}
{} / {}

Demonstrate the follower feature: 
Extraction 1: {'the','taste','of','!'}
Extraction 2: {'A','fragrance','coming','!'}
Extraction 3: {'Der','Geschmack','kommt','!'}

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

outside ... (parameter set function)