IRandomGenerator Schnittstelle

Definition

[Android.Runtime.Register("java/util/random/RandomGenerator", "", "Java.Util.RandomGenerators.IRandomGeneratorInvoker", ApiSince=35)]
public interface IRandomGenerator : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("java/util/random/RandomGenerator", "", "Java.Util.RandomGenerators.IRandomGeneratorInvoker", ApiSince=35)>]
type IRandomGenerator = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Abgeleitet

Java.Util.Random

Java.Util.SplittableRandom

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable IDisposable

Hinweise

Die RandomGenerator Schnittstelle wurde entwickelt, um ein allgemeines Protokoll für Objekte bereitzustellen, die zufällige oder (in der Regel) pseudorandomsequenzen von Zahlen (oder booleschen Werten) generieren. Eine solche Sequenz kann entweder durch wiederholtes Aufrufen einer Methode abgerufen werden, die einen einzelnen pseudozufällig gewählten Wert zurückgibt, oder durch Aufrufen einer Methode, die einen Datenstrom von pseudorandig gewählten Werten zurückgibt.

Im Idealfall, wenn ein impliziter oder explizit angegebener Wertebereich gegeben ist, würde jeder Wert unabhängig und einheitlich aus diesem Bereich ausgewählt. In der Praxis muss man sich vielleicht mit einer Annäherung an Unabhängigkeit und Einheitlichkeit begnügen.

Im Fall von int, longund boolean Werten, wenn keine explizite Spezifikation des Bereichs vorhanden ist, enthält der Bereich alle möglichen Werte des Typs. Im Fall von float und double Werten wird zuerst ein Wert immer einheitlich aus der Gruppe von 2<sup>w</sup-Werten> zwischen 0,0 (einschließlich) und 1,0 (exklusiv) ausgewählt, wobei w für float Werte und Double#PRECISION für double Werte bestimmt istFloat#PRECISION, sodass sich benachbarte Werte von 2^{&minus unterscheiden;w} (beachten Sie, dass dieser Satz eine Teilmenge des Satzes aller darstellbaren Gleitkommawerte zwischen 0,0 (einschließlich) und 1,0 (exklusiv)) ist); wenn ein expliziter Bereich angegeben wurde, wird die ausgewählte Zahl rechnerisch skaliert und übersetzt, sodass sie ungefähr einheitlich aus diesem expliziten Bereich ausgewählt wurden.

Jede Methode, die einen Datenstrom zurückgibt, erzeugt einen Datenstrom von Werten, die jeweils auf die gleiche Weise ausgewählt werden wie für eine Methode, die einen einzelnen pseudorandom ausgewählten Wert zurückgibt. Wenn beispielsweise r implementiert wird RandomGenerator, gibt der Methodenaufruf r.ints(100) einen Datenstrom von 100 int Werten zurück. Dies sind nicht unbedingt die genauen Werte, die zurückgegeben werden würden, wenn sie stattdessen r.nextInt() 100 Mal aufgerufen worden wären. Alles, was garantiert ist, ist, dass jeder Wert im Datenstrom in einer ähnlichen pseudorandom-Weise aus demselben Bereich ausgewählt wird.

Jedes Objekt, das die RandomGenerator Schnittstelle mithilfe eines Pseudorandomalgorithmus implementiert, wird angenommen, eine endliche Menge an Zustand zu enthalten. Wenn Sie ein solches Objekt verwenden, um einen pseudozufällig gewählten Wert zu generieren, wird der Zustand durch Berechnen eines neuen Zustands als Funktion des aktuellen Zustands geändert, ohne auf andere Informationen als den aktuellen Zustand zu verweisen. Die Anzahl der unterschiedlichen möglichen Zustände eines solchen Objekts wird als Seine Periode bezeichnet. (Einige Implementierungen der RandomGenerator Schnittstelle können wirklich zufällig und nicht pseudorandom sein, z. B. auf das statistische Verhalten eines physischen Objekts, um ausgewählte Werte abzuleiten. Solche Implementierungen haben keinen festen Zeitraum.)

In der Regel müssen Objekte, die die RandomGenerator Schnittstelle implementieren, nicht threadsicher sein. Es wird empfohlen, Multithread-Anwendungen entweder ThreadLocalRandom oder (vorzugsweise) Pseudorandomzahlengeneratoren zu verwenden, die die SplittableGenerator Oder-Schnittstelle JumpableGenerator implementieren.

Objekte, die implementiert RandomGenerator werden, sind in der Regel nicht kryptografisch sicher. Erwägen Sie stattdessen die Verwendung SecureRandom eines kryptografisch sicheren Pseudozuschreibungszahlengenerators für die Verwendung durch sicherheitsrelevante Anwendungen. Beachten Sie jedoch, dass die SecureRandomRandomGenerator Schnittstelle implementiert wird, sodass Instanzen von SecureRandom möglicherweise austauschbar mit anderen Typen von Pseudorandomgeneratoren in Anwendungen verwendet werden können, die keinen sicheren Generator erfordern.

Sofern nicht anders angegeben, führt die Verwendung von NULL für ein Beliebiges Methodenargument zu einer NullPointerException.

Hinzugefügt in 17.

Java Dokumentation für java.util.random.RandomGenerator.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.