mid, mid$, mid$$ function

	<< Index >>	FutureBasic
mid, mid$, mid$$		function

Syntax
subCFString = mid( CFString, startPos [ , numChars ] )
subPascalString = mid$( PascalString, startPos [ , numChars ] )
subContainer$$ = mid$$( container$$, startPos [ , numChars ] )

Description
This function returns a substring or subcontainer of CFString, PascalString or container$$, consisting of characters which begin at position startPos within PascalString or container$$. If you specify numChars, then a maximum of numChars characters are returned; otherwise, all the characters from startPos to the end of PascalString or container$$ are returned. If startPos is less than 1, then it's treated as 1. If startPos is greater than the length of PascalString or container$$, then a null (zero-length) string is returned.

Note
You may not use complex expressions that include containers on the right side of the equal sign. Instead of using:
c$$ = c$$ + mid$$(a$$,10)
Use:
c$$ += mid$$(a$$,10)

CFString Example

Note: CFStrings are zero-based, which means the first character of the string is at position 0.

print mid( @"Rick Brown", 1, 3 ) print mid( @"Rick Brown", 5 ) output: ick Brown

Pascal String Example

The first character of a pascal string or container is at position 1.

print mid$("Rick Brown", 2, 3) myContainer$$ = "Rick Brown" print mid$(myContainer$$, 2, 3) print mid$("Rick Brown", 6)

program output: ick ick Brown

See also
mid statement; left; right; instr