java.util.concurrent

Class ThreadLocalRandom

Inhoudsopgave
  • All Implemented Interfaces:
    Serializable

    public class ThreadLocalRandom
extends Random
    A random number generator isolated to the current thread. Like the global Random generator used by the Math class, a ThreadLocalRandom is initialized with an internally generated seed that may not otherwise be modified. When applicable, use of ThreadLocalRandom rather than shared Random objects in concurrent programs will typically encounter much less overhead and contention. Use of ThreadLocalRandom is particularly appropriate when multiple tasks (for example, each a ForkJoinTask) use random numbers in parallel in thread pools.

    Usages of this class should typically be of the form: ThreadLocalRandom.current().nextX(...) (where X is Int, Long, etc). When all usages are of this form, it is never possible to accidently share a ThreadLocalRandom across multiple threads.

    This class also provides additional commonly used bounded random generation methods.

    Since:
    1.7
    See Also:
    Serialized Form

    • Method Summary

      Methods 
      Modifier and Type Method and Description
      static ThreadLocalRandom current()
      Returns the current thread's ThreadLocalRandom.
      protected int next(int bits)
      Generates the next pseudorandom number.
      double nextDouble(double n)
      Returns a pseudorandom, uniformly distributed double value between 0 (inclusive) and the specified value (exclusive).
      double nextDouble(double least, double bound)
      Returns a pseudorandom, uniformly distributed value between the given least value (inclusive) and bound (exclusive).
      int nextInt(int least, int bound)
      Returns a pseudorandom, uniformly distributed value between the given least value (inclusive) and bound (exclusive).
      long nextLong(long n)
      Returns a pseudorandom, uniformly distributed value between 0 (inclusive) and the specified value (exclusive).
      long nextLong(long least, long bound)
      Returns a pseudorandom, uniformly distributed value between the given least value (inclusive) and bound (exclusive).
      void setSeed(long seed)
      Throws UnsupportedOperationException.

      Eerste pagina van API Java Inhoudsopgave Haut

    • Method Detail

      • current

        public static ThreadLocalRandom current()
        Returns the current thread's ThreadLocalRandom.
        Returns:
        the current thread's ThreadLocalRandom

      • setSeed

        public void setSeed(long seed)
        Throws UnsupportedOperationException. Setting seeds in this generator is not supported.
        Overrides:
        setSeed in class Random
        Parameters:
        seed - the initial seed
        Throws:
        UnsupportedOperationException - always

      • next

        protected int next(int bits)
        Description copied from class: Random
        Generates the next pseudorandom number. Subclasses should override this, as this is used by all other methods.

        The general contract of next is that it returns an int value and if the argument bits is between 1 and 32 (inclusive), then that many low-order bits of the returned value will be (approximately) independently chosen bit values, each of which is (approximately) equally likely to be 0 or 1. The method next is implemented by class Random by atomically updating the seed to 

        (seed * 0x5DEECE66DL + 0xBL) & ((1L << 48) - 1)
        and returning 
        (int)(seed >>> (48 - bits)).
        This is a linear congruential pseudorandom number generator, as defined by D. H. Lehmer and described by Donald E. Knuth in The Art of Computer Programming, Volume 3: Seminumerical Algorithms, section 3.2.1.
        Overrides:
        next in class Random
        Parameters:
        bits - random bits
        Returns:
        the next pseudorandom value from this random number generator's sequence

      • nextInt

        public int nextInt(int least,
          int bound)
        Returns a pseudorandom, uniformly distributed value between the given least value (inclusive) and bound (exclusive).
        Parameters:
        least - the least value returned
        bound - the upper bound (exclusive)
        Returns:
        the next value
        Throws:
        IllegalArgumentException - if least greater than or equal to bound

      • nextLong

        public long nextLong(long n)
        Returns a pseudorandom, uniformly distributed value between 0 (inclusive) and the specified value (exclusive).
        Parameters:
        n - the bound on the random number to be returned. Must be positive.
        Returns:
        the next value
        Throws:
        IllegalArgumentException - if n is not positive

      • nextLong

        public long nextLong(long least,
            long bound)
        Returns a pseudorandom, uniformly distributed value between the given least value (inclusive) and bound (exclusive).
        Parameters:
        least - the least value returned
        bound - the upper bound (exclusive)
        Returns:
        the next value
        Throws:
        IllegalArgumentException - if least greater than or equal to bound

      • nextDouble

        public double nextDouble(double n)
        Returns a pseudorandom, uniformly distributed double value between 0 (inclusive) and the specified value (exclusive).
        Parameters:
        n - the bound on the random number to be returned. Must be positive.
        Returns:
        the next value
        Throws:
        IllegalArgumentException - if n is not positive

      • nextDouble

        public double nextDouble(double least,
                double bound)
        Returns a pseudorandom, uniformly distributed value between the given least value (inclusive) and bound (exclusive).
        Parameters:
        least - the least value returned
        bound - the upper bound (exclusive)
        Returns:
        the next value
        Throws:
        IllegalArgumentException - if least greater than or equal to bound

Nederlandse vertaling

U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.

Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.

Bij voorbaat dank.

Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/util/concurrent/threadlocalrandom.html

De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.

Referenties

  1. Bekijk - html-document Taal van het document:fr Manuel PHP : https://docs.oracle.com

Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.

Inhoudsopgave Haut