mercredi 6 octobre 2010

Some functions used in X++

strRem 
Removes the characters specified in one string from another string.  
str strRem(str text1, str text2) 
where 
text1 : The string from which to remove characters.
text2 : The characters to exclude from the output string.

subStr

Retrieves part of a string. 
str subStr(str _text, int _position, int _number) 
where
_text : The original string.
_position : The position in the original string where the part to retrieve begins.

_number : A signed integer that indicates the direction and number of positions to retrieve from the original string.
If there is a minus sign preceding _number, the system selects the substring backward from the specified position.

strDel  

Creates a copy of a string with the specified substring removed. 
str  strDel( str _text, int _position, int _number) 
where
_text  : The string to copy from
_position : The position at which to begin ignoring characters during the copy.

_number : The number of characters to ignore.
A minus in front of _number parameter indicates that the (_number-1) characters before the character at the _position parameter are to be removed along with the character at the _position.


strFmt

Formats the specified string and substitutes any occurrences of %n with the nth argument.

str strFmt(str _string, ...)
where 
_string  : The strings to be formatted.

example: to set the number of page in a report :

Display STR 20 pageNum()
{
    return StrFmt("@SYS24160", element.page());
}

num2Str 

Converts a real number to a string. 

str num2Str(
    real number,
    int character,
    int decimals,
    int separator1,
    int separator2)
where: 
number The real number to convert to a string.
character The minimum number of characters required in the text.
decimals The required number of decimal places.
separator1 A DecimalSeparator enumeration value.
separator2 A ThousandSeparator enumeration value.

 Example 

static void Job_Num2Str(Args _args)
{
    real realNum = 0.1294567890123456777; // 19 decimals places.
    ;
    info(Num2Str(realNum,0,16,1,3)); // 16 decimals
    info(Num2Str(realNum,0,17,1,3)); // 17 decimals
}
 
Round   
Rounds a real number to the nearest multiple of another real number.
real round(real _arg, real _decimals)
 
_arg The original number.
_decimals The number that the value of the _arg parameter must be rounded to a multiple of.
Examples:
  • round(123.45,5.00); //Returns the value 125.00.
  • round(7.45,1.05); //Returns the value 7.35.
  • round(23.9,5.0); //Returns the value 25.00;
  • round(26.1,5.0); //Returns the value 25.00;
strLen 

Returns the size of a string 

int strLen ( Str _text )

ConPeek

Retrieves a specific element from a container.

anytype conPeek(container container, int number)
Example:
static void conPeekExample(Args _arg)
{
    container c;
    int i;
    ;
 
    c = conIns(["item1", "item2"], 1);  
    for (i = 1 ; i <= conLen(c) ; i++)  
    {
        print conPeek(c, i);
    }
    pause;
}

strUpr

Converts all the letters in a string to uppercase. 

str strUpr(str _text)

static void strUprExample(Args _args)
{
    print strUpr("Abcdd55EFGhiJ");
    pause;
}

strLwr
Converts all the letters in a string to lowercase. 
str strLwr(str _text)

static void strLwrExample(Args _args)
{
    // Returns the text string "abcdd55efghij".
    print strLwr("Abcdd55EFGHIJ");
    pause;
}
Units  
 We use it to set the unit of a dimension.
Example : 
element.design().controlName("CustInvoiceJour_InvoicingName"); 
CustInvoiceJour_InvoicingName.top(20.8, Units::mm);

    Global::dateEndYr Method

    Retrieves the date of the last day in the same year as the specified date.  

    client server public static date dateEndYr(date transDate)

    Global::DateMthFwd Method

    Adds the specified number of months to a date. 

    client server public static date DateMthFwd(date transDate, int qty) 

    Global::DateStartYr Method 

    Retrieves the first date of the specified year. 

    client server public static date DateStartYr (date transDate)
     
    tableName2Id Function

    Retrieves the ID of a table. 

    int tableName2Id(str _name)
     
    Resources:
    http://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/ntcmds.mspx?mfr=true 

    
    

    Aucun commentaire:

    Enregistrer un commentaire