Generatore di numero decimale casuale

Se il limite minimo non è strettamente minore del massimo, l'attività fallisce con invalid_input invece di inventare un ordine.

Come un generatore congruenziale lineare con seme diventa un decimale

Un generatore di numero decimale casuale che non si può ripetere è un passivo nei test, nelle chiavi dei compiti e nei taccuini di simulazione. Fa avanzare un generatore congruenziale lineare a 32 bit le cui costanti sono la coppia 1664525 e 1013904223 di Numerical Recipes, prese modulo due alla trentadue. Un passo della ricorrenza produce un intero senza segno X, che viene diviso per due alla trentadue per ottenere un campione u dell'intervallo unitario, nell'intervallo semiaperto da zero incluso a uno escluso. Prima di qualsiasi arrotondamento, il decimale grezzo vive quindi nell'intervallo semiaperto che include il minimo ed esclude il massimo. Questo endpoint rifiuta quindi la fonte casuale dell'ospite e l'orologio di sistema. Quel campione unitario è poi scalato sull'intervallo del chiamante dalla mappa affine valore uguale a minimum più u per la larghezza maximum meno minimum. Lo stesso seme, gli stessi limiti e la stessa precisione producono sempre lo stesso unit_interval e lo stesso value su ogni runtime che implementa la moltiplicazione-addizione a 32 bit allo stesso modo, che è esattamente il contratto di cui ha bisogno un'asserzione di integrazione continua. Nulla nel percorso è stocastico a livello del sistema operativo; due worker cui si dà lo stesso corpo JSON non possono divergere.

Contratto di ingresso, limiti, precisione e comportamento di errore

Limiti uguali e l'intervallo invertito sono entrambi rifiutati, perché una larghezza nulla o negativa non definisce un'estrazione uniforme e inventare uno scambio nasconderebbe un errore del chiamante. L'arrotondamento dopo la scala può cadere esattamente su un estremo; tratti il valore visualizzato come un decimale con le cifre richieste, non come una promessa che l'estremo superiore esclusivo sopravviva a ogni arrotondamento. La convalida fallita non è addebitata. Accoppi il seme ripetuto con i propri registri se deve dimostrare che una ripetizione successiva ha usato lo stesso flusso. Invii con POST un corpo JSON con tre campi obbligatori. minimum è il limite inferiore dell'intervallo e può arrivare anche come min, lower o lo. maximum è il limite superiore e può arrivare anche come max, upper o hi. seed è il seme del generatore e può arrivare anche come key o salt. Un campo facoltativo precision, accettato anche come decimals, places o digits, imposta il numero di cifre frazionarie del decimale restituito; vale dieci per omissione e deve essere un intero da zero a dodici. Ogni campo numerico può essere un numero JSON o una stringa numerica; valori non finiti, stringhe vuote e campi obbligatori assenti falliscono con invalid_input che nomina il campo. La regola geometrica dura è che minimum deve essere strettamente minore di maximum. In caso di successo il corpo ripete il minimum e il maximum analizzati, il seme a 32 bit senza segno che è davvero entrato nella ricorrenza e la precisione applicata. Restituisce anche unit_interval, la u grezza arrotondata a dodici cifre per ispezione, value, il decimale scalato arrotondato alla precisione richiesta, e una breve stringa formula che riformula la mappa affine. Le chiamate riuscite usano il prezzo base pubblicato $0.002.

Dove un'estrazione decimale ripetibile giustifica l'uso

Ogni chiamata API riuscita costa $0.002; un ingresso non valido non consuma saldo. Lo strumento non è una fonte casuale crittografica, né un generatore di vettori a molte campionature, né un sostituto di una libreria Monte Carlo completa: restituisce un decimale per richiesta.