Požadavek rand

Získání náhodných čísel podle zadaných kritérií

Tento požadavek slouží k získání náhodných čísel podle zadaných kriterií. Vygenerovaná čísla splňují normy pro gerovaná pseudonáhodná čísla použitelná v kriptografii.

<request>
<rand
output="base64|hex|plain"
from="od"
to="do"
repeat="{number}"
unique="true|false"
size="short|ushort|int|uint|long|ulong|velikost v bajtech"
/>
</request>

Atributy

output - Určuje formát vrácené hodnoty, výchozí plin značí normální desítkové číslo.(typ: string) TYP HODNOTY: string; (možnosti obsahu: base64 | hex | plain)

from - Počátek rozsahu vracených čísel (včetně - interval: <from; to).(typ: number) TYP HODNOTY: number; (možnosti obsahu: od)

to - Konec rozsahu vracených čísel (menší než - interval: <from; to).(typ: number) TYP HODNOTY: number; (možnosti obsahu: do)

repeat - Počet vygenerovaných náhodných čísel, výchozí je jedno číslo.(typ: number) TYP HODNOTY: number;

unique - Určuje, zda mají být vygenerovanná čísla unikátní.(typ: boolean) TYP HODNOTY: boolean; (možnosti obsahu: true | false)

size - Alternativně k rozsahu, lze velikost výsledného čísla nastavit velikostí v bajtech, předdefinovaná slova užívají velikost a rozsach užívaný v jazyce C.(typ: number) TYP HODNOTY: number; (možnosti obsahu: short | ushort | int | uint | long | ulong | velikost v bajtech)

Potomci

Požadavek rand neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Poznámka k request

Zadání hodnoty parametru size v kombinaci s parametry from a to, může omezit rozsah parametrů from a to. Je-li požadavek zadán bez atributů, vygeneruje číslo o velikosti 2 bajty a rozsahu <0; 65536).

Unikátnost:

U požadavků, které vyžadují unikátnost vždy zvažte pravděpodobnost kolizí ve vztahu k intervalu. Například pokud si vygenerujete 999999 náhodných čísel z intervalu <0; 1000001), tak se díky kolizím vygenruje (a zahodí) mnohem více náhodných čísel. Bylo by mnohem lepší generovat doplňek.

Odpověď

Struktura odpovědi na požadavek rand vrácená v obálce response:

<response>
<rand
type="ok|error"
>
<value ... {string}</value> *
</rand>
</response>

Atributy

type - Obsahuje hodnoty ok nebo error (možnosti obsahu: ok | error)

Potomci

<value>
 {string} 
</value>

Výraz pro identifikaci chyb v odpovědi serveru: rand[@type='error'] (odkaz na popis detailu: @details).