Előző Következő

BirtMath osztály

A BirtMath osztály numerikus adatok kezelésére szolgáló függvényeket biztosít, mint például számok összeadása, kivonása, szorzása, osztása és kerekítése. A szám egy általános objektum, amely más típusra módosítható az Adatkötés szerkesztése párbeszédablak Adattípus mezőjében. Ez az osztály statikus. Az alkalmazás nem hozhat létre példányokat az osztályból.

BirtMath.add

Ez a függvény két szám összegét adja vissza.

Szintaxis

Number BirtMath.add( Number n1, Number n2 )

Paraméterek

n1

Number objektum. A számításban használandó első szám.

n2

A számításban használandó második szám.

Visszatérési érték

Number objektum. Az n1 és n2 összadásának eredménye.

Példa

A következő példa a SalesTotal (összes eladás) és Shipping (kiszállítás)mezők értékeinek összegét adja vissza:

BirtMath.add( row["SalesTotal"], row["Shipping"] )

BirtMath.ceiling

Ez a függvény felfelé kerekít (0-tól távolodva) egy számot, a legközelebbi megadott többszörösre.

Szintaxis

Number BirtMath.ceiling( Number n, Number significance )

Paraméterek

n

Number objektum. A kerekítendő szám.

significance

Number objektum. A többszörös, amelyre n-t kerekíteni kell.

Visszatérési érték

Number objektum. A kerekítés eredményéül kapott szám. Ha n a significance érték többszöröse, akkor nem történik kerekítés.

Példák

A BirtMath.ceiling( ) függvényt általánosan használják árak kerekítésére. Például, ha nem szeretne foglalkozni a penny értékekkel, akkor a Price (ár) mezőben lévő értékeket felfelé kerekítheti a legközelebbi 5 centes értékre a következő kifejezéssel:

BirtMath.ceiling( row["Price"] , 0.05 )

Ha a Price értéke 20.52, akkor a kifejezés a 20.55 értéket adja vissza.

A következő kifejezés az árakat a legközelebbi 10 centes értékre kerekíti:

BirtMath.ceiling( row["Price"] , 0.1 )

Ha a Price értéke 20.52, akkor a kifejezés 20.60 értéket ad vissza. Ha a Price értéke 20.40, akkor a kifejezés 20.40 értéket ad vissza. Ekkor nem történik kerekítés, mivel a 20.40 a 0.1 többszöröse.

A következő kifejezés az árakat a legközelebbi dollár értékre kerekíti:

BirtMath.ceiling( row["Price"] , 1 )

Ha a Price értéke 20.30, akkor a kifejezés a 21 értéket adja vissza.

BirtMath.divide

Ez a függvény két szám közötti osztás művelet eredményét adja vissza.

Szintaxis

Number BirtMath.divide( Number dividend, Number divisor )

Paraméterek

osztandó

Number objektum. Az osztandó szám.

osztó

Number objektum. A szám, amellyel az osztandót el kell osztani.

Visszatérési érték

Number objektum. Az osztandónak az osztóval történő osztásának eredményeként kapott szám.

Példák

A következő példa adott számok osztásának eredményeit mutatja be:

BirtMath.divide( 10, 2 ) // az 5 értéket adja vissza
BirtMath.divide( 2, 10) // a 0,2 értéket adja vissza

A következő példa a Total (összesen) mezőben lévő értékek osztásának eredménye a Quantity (mennyiség) mezőben lévő értékekkel:

BirtMath.divide( row["Total"], row["Quantity"] )

BirtMath.mod

Ez a függvény a maradékot adja vissza egy szám osztása után az osztóval.

Szintaxis

Number BirtMath.mod( Number number, Number divisor )

Paraméterek

szám

Number objektum. Az osztandó szám.

osztó

Number objektum. A szám, amellyel az első szám el van osztva. Nem nulla számot kell megadni.

Visszatérési érték

A maradék a szám osztása után az osztóval.

Példák

A következő példák azokat az eredményeket mutatják, amelyeket a függvény adott számokhoz visszaad:

BirtMath.mod( 10, 3 ) // visszaadott érték: 1
BirtMath.mod( 10, 5 ) // visszaadott érték: 0
BirtMath.mod( 10, 6 ) // visszaadott érték: 4

A következő példa ellenőrzi, hogy a Grade mezőben lévő számok párosak vagy páratlanok. Ha az osztó 2, akkor a függvény páros számok esetén 0 értéket ad vissza, páratlan számok esetén 1 értéket.

BirtMath.mod( row["Grade"], 2 )

BirtMath.multiply

Ez a függvény két szám szorzatát adja vissza.

Szintaxis

Number BirtMath.multiply( Number n1, Number n2 )

Paraméterek

n1

Number objektum. A számításban használandó első szám.

n2

Number objektum. A számításban használandó második szám.

Visszatérési érték

Number objektum. Az n1 és n2 szorzásának eredménye.

Példa

A következő példa a QuantityOrdered (rendelt mennyiség) és PriceEach (egységár) mezők értékeinek szorzatát adja vissza:

BirtMath.multiply( row["QuantityOrdered"], row["PriceEach"] )

BirtMath.round

Ez a függvény a megadott számú tizedesjegyre kerekít egy számot.

Szintaxis

Number BirtMath.round( Number number, Number dec )

Paraméterek

szám

Number objektum. A kerekítendő szám.

tizedes

Number objektum. A tizedes számjegyek száma, amelyre kerekíteni kell a számot. Ha kihagyja ezt az argumentumot, akkor a függvény a 0-t felételezi.

Visszatérési érték

Number objektum. A megadott számú tizedesjegyre kerekített szám.

Példák

A következő példák azokat az eredményeket mutatják, amelyeket a függvény adott számokhoz visszaad:

BirtMath.round( 1545.50 ) // visszaadott érték: 1546
BirtMath.round( 1545.56, 1 ) // visszaadott érték: 1545.6
BirtMath.round( 1545.23, 1 ) // visszaadott érték: 1545.2
BirtMath.round( 1545.50, -1 ) // visszaadott érték: 1550

A következő példa a PriceEstimate (becsült ár) mező értékét egész számra kerekíti:

BirtMath.round( row["PriceEstimate"], 0 )

BirtMath.roundDown

Ez a függvény a megadott számú tizedesjegyre kerekíti le egy számot.

Szintaxis

Number BirtMath.roundDown( Number number, Number dec )

Paraméterek

szám

Number objektum. A kerekítendő szám.

tizedes

Number objektum. A tizedes számjegyek száma, amelyre le kell kerekíteni a számot. Ha kihagyja ezt az argumentumot, akkor a függvény a 0-t felételezi.

Visszatérési érték

Number objektum. A megadott számú tizedesjegyre lekerekített szám.

Példák

A következő példák azokat az eredményeket mutatják, amelyeket a függvény adott számokhoz visszaad:

BirtMath.roundDown( 1545.50 ) // visszaadott érték: 1545
BirtMath.roundDown( 1545.56, 1 ) // visszaadott érték: 1545.5
BirtMath.roundDown( 1545.23, 1 ) // visszaadott érték: 1545.2
BirtMath.roundDown( 1545.50, -1 ) // visszaadott érték: 1540

A következő példa a PriceEstimate (becsült ár) mező értékét egy egész számra kerekíti le:

BirtMath.roundDown( row["PriceEstimate"], 0 )

BirtMath.roundUp

Ez a függvény a megadott számú tizedesjegyre kerekít fel egy számot.

Szintaxis

Number BirtMath.roundUp( Number number, Number dec )

Paraméterek

szám

Number objektum. A kerekítendő szám.

tizedes

Number objektum. A tizedes számjegyek száma, amelyre fel kell kerekíteni a számot. Ha kihagyja ezt az argumentumot, akkor a függvény a 0-t felételezi.

Visszatérési érték

Number objektum. A megadott számú tizedesjegyre felkerekített szám.

Példák

A következő példák azokat az eredményeket mutatják, amelyeket a függvény adott számokhoz visszaad:

BirtMath.roundUp( 1545.50 ) // visszaadott érték: 1546
BirtMath.roundUp( 1545.56, 1 ) // visszaadott érték: 1545.6
BirtMath.roundUp( 1545.23, 1 ) // visszaadott érték: 1545.3
BirtMath.roundUp( 1545.50, -1 ) // visszaadott érték: 1550

A következő példa a PriceEstimate (becsült ár) mező értékét egy egész számra kerekíti fel:

BirtMath.roundUp( row["PriceEstimate"], 0 )

BirtMath.safeDivide

Ez a függvény két szám közötti osztás művelet eredményét adja vissza, és megelőzi a nullával való osztás miatti hibát.

Szintaxis

Number BirtMath.safeDivide( Number dividend, Number divisor, object ifZero )

Paraméterek

osztandó

Number objektum. Az osztandó szám.

osztó

Number objektum. A szám, amellyel az osztandót el kell osztani.

haNulla

Objektum. Az érték, amelyet nulla osztó esetén kell visszaadni.

Visszatérési érték

Number objektum. Number objektum. Az osztandónak az osztóval történő osztásának eredményeként kapott szám.

Példák

A következő példák azokat az eredményeket mutatják, amelyeket a függvény adott számokhoz visszaad:

BirtMath.safeDivide( 10, 2, 0 ) // visszaadott érték: 5
BirtMath.safeDivide( 10, 0, 0 ) // visszaadott érték: 0

A következő példa a Revenue (bevétel) mezőben lévő értékek és a Volume (mennyiség) mezőben lévő értékek hányadosát adja vissza. Ha a Volume értéke 0, akkor a függvény 0 értéket ad vissza.

BirtMath.safeDivide( row["Revenue"], row["Volume"], 0 )

BirtMath.subtract

Ez a függvény két szám különbségét adja vissza.

Szintaxis

Number BirtMath.subtract( Number n1, Number n2 )

Paraméterek

n1

Number objektum. A szám, amelyből a másik számot ki kell vonni.

n2

Number objektum. Az n1 számból kivonandó szám.

Visszatérési érték

Number objektum. Az n1 számból az n2 szám kivonása után kapott eredmény.

Példa

A következő példa adott számok kivonásainak eredményét mutatja be:

BirtMath.subtract( 12, 4 ) // visszaadott érték: 8
BirtMath.subtract( 4, 12) // visszaadott érték: -8

A következő példa a Total (Összesen) mező értékéből kivonja a Discount (árengedmény) mező értékét:

BirtMath.subtract( row["Total"], row["Discount"] )

(c) Copyright Actuate Corporation 2013