mirror of
https://github.com/pmmp/PocketMine-MP.git
synced 2025-07-06 01:51:51 +00:00
4b9a142a5d
This is better for performance because these then don't need to be reevaluated every time they are called. When encountering an unqualified function or constant reference, PHP will first try to locate a symbol in the current namespace by that name, and then fall back to the global namespace. This short-circuits the check, which has substantial performance effects in some cases - in particular, ord(), chr() and strlen() show ~1500x faster calls when they are fully qualified. However, this doesn't mean that PM is getting a massive amount faster. In real world terms, this translates to about 10-15% performance improvement. But before anyone gets excited, you should know that the CodeOptimizer in the PreProcessor repo has been applying fully-qualified symbol optimizations to Jenkins builds for years, which is one of the reasons why Jenkins builds have better performance than home-built or source installations. We're choosing to do this for the sake of future SafePHP integration and also to be able to get rid of the buggy CodeOptimizer, so that phar and source are more consistent.
156 lines
3.3 KiB
PHP
156 lines
3.3 KiB
PHP
<?php
|
|
|
|
/*
|
|
*
|
|
* ____ _ _ __ __ _ __ __ ____
|
|
* | _ \ ___ ___| | _____| |_| \/ (_)_ __ ___ | \/ | _ \
|
|
* | |_) / _ \ / __| |/ / _ \ __| |\/| | | '_ \ / _ \_____| |\/| | |_) |
|
|
* | __/ (_) | (__| < __/ |_| | | | | | | | __/_____| | | | __/
|
|
* |_| \___/ \___|_|\_\___|\__|_| |_|_|_| |_|\___| |_| |_|_|
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Lesser General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* @author PocketMine Team
|
|
* @link http://www.pocketmine.net/
|
|
*
|
|
*
|
|
*/
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace pocketmine\utils;
|
|
|
|
use function time;
|
|
|
|
/**
|
|
* XorShift128Engine Random Number Noise, used for fast seeded values
|
|
* Most of the code in this class was adapted from the XorShift128Engine in the php-random library.
|
|
*/
|
|
class Random{
|
|
public const X = 123456789;
|
|
public const Y = 362436069;
|
|
public const Z = 521288629;
|
|
public const W = 88675123;
|
|
|
|
/**
|
|
* @var int
|
|
*/
|
|
private $x;
|
|
|
|
/**
|
|
* @var int
|
|
*/
|
|
private $y;
|
|
|
|
/**
|
|
* @var int
|
|
*/
|
|
private $z;
|
|
|
|
/**
|
|
* @var int
|
|
*/
|
|
private $w;
|
|
|
|
/** @var int */
|
|
protected $seed;
|
|
|
|
/**
|
|
* @param int $seed Integer to be used as seed.
|
|
*/
|
|
public function __construct(int $seed = -1){
|
|
if($seed === -1){
|
|
$seed = time();
|
|
}
|
|
|
|
$this->setSeed($seed);
|
|
}
|
|
|
|
/**
|
|
* @param int $seed Integer to be used as seed.
|
|
*/
|
|
public function setSeed(int $seed){
|
|
$this->seed = $seed;
|
|
$this->x = self::X ^ $seed;
|
|
$this->y = self::Y ^ ($seed << 17) | (($seed >> 15) & 0x7fffffff) & 0xffffffff;
|
|
$this->z = self::Z ^ ($seed << 31) | (($seed >> 1) & 0x7fffffff) & 0xffffffff;
|
|
$this->w = self::W ^ ($seed << 18) | (($seed >> 14) & 0x7fffffff) & 0xffffffff;
|
|
}
|
|
|
|
public function getSeed() : int{
|
|
return $this->seed;
|
|
}
|
|
|
|
/**
|
|
* Returns an 31-bit integer (not signed)
|
|
*
|
|
* @return int
|
|
*/
|
|
public function nextInt() : int{
|
|
return $this->nextSignedInt() & 0x7fffffff;
|
|
}
|
|
|
|
/**
|
|
* Returns a 32-bit integer (signed)
|
|
*
|
|
* @return int
|
|
*/
|
|
public function nextSignedInt() : int{
|
|
$t = ($this->x ^ ($this->x << 11)) & 0xffffffff;
|
|
|
|
$this->x = $this->y;
|
|
$this->y = $this->z;
|
|
$this->z = $this->w;
|
|
$this->w = ($this->w ^ (($this->w >> 19) & 0x7fffffff)
|
|
^ ($t ^ (($t >> 8) & 0x7fffffff))) & 0xffffffff;
|
|
|
|
return $this->w;
|
|
}
|
|
|
|
/**
|
|
* Returns a float between 0.0 and 1.0 (inclusive)
|
|
*
|
|
* @return float
|
|
*/
|
|
public function nextFloat() : float{
|
|
return $this->nextInt() / 0x7fffffff;
|
|
}
|
|
|
|
/**
|
|
* Returns a float between -1.0 and 1.0 (inclusive)
|
|
*
|
|
* @return float
|
|
*/
|
|
public function nextSignedFloat() : float{
|
|
return $this->nextSignedInt() / 0x7fffffff;
|
|
}
|
|
|
|
/**
|
|
* Returns a random boolean
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function nextBoolean() : bool{
|
|
return ($this->nextSignedInt() & 0x01) === 0;
|
|
}
|
|
|
|
/**
|
|
* Returns a random integer between $start and $end
|
|
*
|
|
* @param int $start default 0
|
|
* @param int $end default 0x7fffffff
|
|
*
|
|
* @return int
|
|
*/
|
|
public function nextRange(int $start = 0, int $end = 0x7fffffff) : int{
|
|
return $start + ($this->nextInt() % ($end + 1 - $start));
|
|
}
|
|
|
|
public function nextBoundedInt(int $bound) : int{
|
|
return $this->nextInt() % $bound;
|
|
}
|
|
}
|