functions of manipulation of the string

• CreateStrID : Create a Unique string Identifier
• Copy
• Length
• LeftStr
• RightStr
• LowerCase
• UpperCase
• UpperCaseFirst
• MinifyString
• QuotedStr
• Trim
• SlashBackward and SlashForward
• USSDStringFilter
• UTF8ToString
• URLEncode
• URLDecode
• FormatFloat

In this section, we will describe some of functions used to manipulate strings on FMScript.

CreateStrID : Create a Unique string Identifier

This function generate a unique ID. two simultaneous calls of the same functions in your will return almost different values

Demo : Generate two Strings ID at the same time

            
var Result : String;

Result := 'Str 1 = ' + CreateStrID + LINEBREAK + 'Str 2 = ' + CreateStrID;         
Exit; 
            
        

Copy

copy a sub string in a chain. It takes in parameter a string (Str), the index of beginning of the copy (StartIndex), as well as the number of characters to copy in the String(NbCharacters)

Signature

            
Copy(Str : String, StartIndex : Integer, NbCharacters : Integer);
            
        

Demo

            
var Result : String; 
                       
Result := Copy('Hello FM Community', 6, 15);         
Exit; 
            
        

This above demo will return automatically FM Community

Length

returns the size of a text passed as a parameter

Signature

            
Length(Value : String); 
            
        

Demo

            
var Result : String; 
                       
Result := Copy('Hello FM Community', 6, 15); 

ShowMessage(Length(Result));
Exit;                                         
            
        

This above demo shows 13, as length of the string returned by the Copy function

LeftStr

Returns 'ACount' most Left caracters of 'AStr'

Signature

            
LeftStr(AStr : String, ACount : Integer);  
            
        

Demo

            
var Result : String; 
                       
Result := '1 row inserted'; 
 
IF LeftStr(Result, 1) <> '1' THEN
(
  ShowMessage('Failed');
  Exit;
);  

ShowMessage('Succeed');
Exit;                             
            
        

This above demo shows Succeed

RightStr

Returns 'ACount' most Right caracters of 'AStr'

Signature

            
RightStr(AStr : String, ACount : Integer); 
            
        

LowerCase

Convert all caracters of AString to their corresponding LowerCase Value

Signature

            
LowerCase(AString : String); 
            
        

UpperCase

Convert all caracters of AString to their corresponding UpperCase Value

Signature

            
UpperCase(AString : String); 
            
        

UpperCaseFirst

Convert only 1st caracter of AString to it corresponding Uppercase Value

Signature

            
UpperCaseFirst(AString : String); 
            
        

MinifyString

Minify string like javascript or css code

Signature

            
MinifyString(AString : String);      
            
        

QuotedStr

Returns Quoted string of 'AStr'

Signature

            
QuotedStr(AStr : String);      
            
        

Trim

Return a string value with edge spaces removed

Signature

            
Trim(Value : String);          
            
        

SlashBackward and SlashForward

Return respectively Slash Backward and Slash Forward string

USSDStringFilter

convert caracters of to their corresponding USSD String Value

Signature

            
USSDStringFilter(Value : String);          
            
        

UTF8ToString

Decode a UTF8 string.

Signature

            
UTF8ToString(Value : String);          
            
        

URLEncode

Encode Astring to make it compatible for get method.

Signature

            
URLEncode(Value : String);          
            
        

URLDecode

Decode and encoded Astring.

Signature

            
URLDecode(Value : String);          
            
        

FormatFloat

Mostly used to display prices.

Signature

            
FormatFloat(Format : String, Extended : Double);   
            
        

Demo

            
var Result : String; 
var Amount : String; 

Amount := 20000;                       
Result := FormatFloat('#,##0.00', Amount); 

ShowMessage(Result);
Exit;      
            
        

This above demo shows 20 000,00