Forrige Neste

Klassen BirtMath

BirtMath-klassen har funksjoner for å manipulere numeriske data, for eksempel for å legge til, trekke fra, multiplisere, dividere og avrunde tall. Et tall er et generisk objekt som kan endres til en annen type i Datatype-feltet i dialogboksen Rediger databinding. Denne klassen er statisk. Applikasjonen kan ikke opprette forekomster av klassen.

BirtMath.add

Denne funksjonen returnerer summen av to tall.

Syntaks

Number BirtMath.add( Number n1, Number n2 )

Parametere

n1

Number-objekt. Det første tallet som skal brukes i beregningen.

n2

Det andre tallet som skal brukes i beregningen.

Returnerer

Number-objekt. Tallet som er resultatet av å addere n1 og n2.

Eksempel

Det følgende eksempelet returnerer summen av verdier i feltene SalesTotal og Shipping:

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

BirtMath.ceiling

Denne funksjonen avrunder et tall oppover, bort fra null, til det nærmeste oppgitte multiplum.

Syntaks

Number BirtMath.ceiling( Number n, Number significance )

Parametere

n

Number-objekt. Tallet som skal avrundes oppover.

significance

Number-objekt. Multiplum som n skal avrundes til.

Returnerer

Number-objekt. Et tall som er resultatet av avrundingen. Hvis n er et nøyaktig multiplum av significance-verdien, foretas ingen avrunding.

Eksempler

BirtMath.ceiling( ) blir vanligvis brukt til å avrunde priser oppover. Hvis du vil unngå å måtte behandle smådeler av beløp, kan du for eksempel avrunde priser i et Price-felt til nærmeste større mynt med det følgende uttrykket:

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

Hvis Price-verdien er 20,52, returnerer uttrykket 20,55.

Det følgende uttrykket runder priser opp til nærmeste 0,10:

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

Hvis Price-verdien er 20,52, returnerer uttrykket 20,60. Hvis Price-verdien er 20,40, returnerer uttrykket 20,40. Det foretas ingen avrunding fordi 20,40 er et multiplum av 0,1.

Det følgende uttrykket runder priser opp til nærmeste heltall:

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

Hvis Price-verdien er 20,30, returnerer uttrykket 21.

BirtMath.divide

Denne funksjonen returnerer resultatet av å dividere ett tall med et annet.

Syntaks

Number BirtMath.divide( Number dividend, Number divisor )

Parametere

dividend

Number-objekt. Tallet som skal divideres.

divisor

Number-objekt. Tallet som dividenden skal divideres med.

Returnerer

Number-objekt. Et tall som er resultatet av å dividere dividenden med divisoren.

Eksempler

Det følgende eksempelet viser resultatet av å dividere bestemte tall:

BirtMath.divide( 10, 2 ) // returns 5
BirtMath.divide( 2, 10) // returns 0.2

Det følgende eksempelet returnerer resultatet av å dividere verdier i Total-feltet med verdiene i Quantity-feltet:

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

BirtMath.mod

Denne funksjonen returnerer resten etter at et tall er dividert med en divisor.

Syntaks

Number BirtMath.mod( Number number, Number divisor )

Parametere

number

Number-objekt. Tallet som skal divideres.

divisor

Number-objekt. Tallet som det første tallet skal divideres med. Du må oppgi et tall som ikke er null.

Returnerer

Resten etter at et tall er dividert med en divisor.

Eksempler

De følgende eksemplene viser resultatene som funksjonen returnerer for bestemte tall:

BirtMath.mod( 10, 3 ) // returns 1
BirtMath.mod( 10, 5 ) // returns 0
BirtMath.mod( 10, 6 ) // returns 4

Det følgende eksempelet kontrollerer om tall i Grade-feltet er oddetall eller partall. Når divisoren er 2, returnerer funksjonen 0 for partall og 1 for oddetall.

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

BirtMath.multiply

Denne funksjonen returnerer multiplikasjonen av to tall.

Syntaks

Number BirtMath.multiply( Number n1, Number n2 )

Parametere

n1

Number-objekt. Det første tallet som skal brukes i beregningen.

n2

Number-objekt. Det andre tallet som skal brukes i beregningen.

Returnerer

Number-objekt. Et tall som er resultatet av å multiplisere n1 og n2.

Eksempel

Det følgende eksempelet returnerer resultatet av å multiplisere verdier i feltene QuantityOrdered og PriceEach:

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

BirtMath.round

Denne funksjonen avrunder et tall til et oppgitt antall sifre.

Syntaks

Number BirtMath.round( Number number, Number dec )

Parametere

number

Number-objekt. Tallet som skal avrundes.

dec

Number-objekt. Antall sifre tallet skal avrundes til. Hvis du utelater dette argumentet, antar funksjonen 0.

Returnerer

Number-objekt. Et tall som er avrundet til et oppgitt antall sifre.

Eksempler

De følgende eksemplene viser resultatene som funksjonen returnerer for bestemte tall:

BirtMath.round( 1545.50 ) // returns 1546
BirtMath.round( 1545.56, 1 ) // returns 1545.6
BirtMath.round( 1545.23, 1 ) // returns 1545.2
BirtMath.round( 1545.50, -1 ) // returns 1550

Det følgende eksempelet avrunder verdiene i PriceEstimate-feltet for å returnere et heltall:

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

BirtMath.roundDown

Denne funksjonen avrunder et tall ned til et oppgitt antall sifre.

Syntaks

Number BirtMath.roundDown( Number number, Number dec )

Parametere

number

Number-objekt. Tallet som skal avrundes.

dec

Number-objekt. Antall sifre tallet skal avrundes ned til. Hvis du utelater dette argumentet, antar funksjonen 0.

Returnerer

Number-objekt. Et tall som er avrundet ned til et oppgitt antall sifre.

Eksempler

De følgende eksemplene viser resultatene som funksjonen returnerer for bestemte tall:

BirtMath.roundDown( 1545.50 ) // returns 1545
BirtMath.roundDown( 1545.56, 1 ) // returns 1545.5
BirtMath.roundDown( 1545.23, 1 ) // returns 1545.2
BirtMath.roundDown( 1545.50, -1 ) // returns 1540

Det følgende eksempelet avrunder verdiene i PriceEstimate-feltet ned for å returnere et heltall:

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

BirtMath.roundUp

Denne funksjonen avrunder et tall opp til et oppgitt antall sifre.

Syntaks

Number BirtMath.roundUp( Number number, Number dec )

Parametere

number

Number-objekt. Tallet som skal avrundes oppover.

dec

Number-objekt. Antall sifre tallet skal avrundes opp til. Hvis du utelater dette argumentet, antar funksjonen 0.

Returnerer

Number-objekt. Et tall som er avrundet opp til et oppgitt antall sifre.

Eksempler

De følgende eksemplene viser resultatene som funksjonen returnerer for bestemte tall:

BirtMath.roundUp( 1545.50 ) // returns 1546
BirtMath.roundUp( 1545.56, 1 ) // returns 1545.6
BirtMath.roundUp( 1545.23, 1 ) // returns 1545.3
BirtMath.roundUp( 1545.50, -1 ) // returns 1550

Det følgende eksempelet avrunder verdiene i PriceEstimate-feltet opp for å returnere et heltall:

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

BirtMath.safeDivide

Denne funksjonen returnerer resultatet av å dividere ett tall med et annet, og forhindrer en deling med null.

Syntaks

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

Parametere

dividend

Number-objekt. Tallet som skal divideres.

divisor

Number-objekt. Tallet som dividenden skal divideres med.

ifZero

Objekt. Verdien som skal returneres når divisoren er null.

Returnerer

Number-objekt. Number-objekt. Et tall som er resultatet av å dividere dividenden med divisoren.

Eksempler

Det følgende eksempelet viser resultatene som funksjonen returnerer for bestemte tall:

BirtMath.safeDivide( 10, 2, 0 ) // returns 5
BirtMath.safeDivide( 10, 0, 0 ) // returns 0

Det følgende eksempelet returnerer resultatet av å dividere verdier i Revenue-feltet med verdier i Volume-feltet. Hvis Volume-verdien er 0, returnerer funksjonen 0.

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

BirtMath.subtract

Denne funksjonen returnerer resultatet av å subtrahere ett tall fra et annet.

Syntaks

Number BirtMath.subtract( Number n1, Number n2 )

Parametere

n1

Number-objekt. Tallet som det skal subtraheres fra.

n2

Number-objekt. Tallet som skal subtraheres fra n1.

Returnerer

Number-objekt. Et tall som er resultatet av å subtrahere n2 fra n1.

Eksempel

Det følgende eksempelet viser resultatene av å subtrahere bestemte tall:

BirtMath.subtract( 12, 4 ) // returns 8
BirtMath.subtract( 4, 12) // returns -8

Det følgende eksempelet returnerer resultatet av å subtrahere verdier i Discount-feltet fra verdier i Total-feltet:

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

(c) Copyright Actuate Corporation 2013