PocketMine-MP/src/pocketmine/utils/VersionString.php
2018-03-19 14:10:55 +00:00

130 lines
3.2 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;
/**
* Manages PocketMine-MP version strings, and compares them
*/
class VersionString{
/** @var int */
private $generation;
/** @var int */
private $major;
/** @var int */
private $minor;
/** @var int */
private $build;
/** @var bool */
private $development = false;
/**
* VersionString constructor.
*
* @param int|string $version
*/
public function __construct($version = \pocketmine\VERSION){
if(is_int($version)){
$this->minor = $version & 0x1F;
$this->major = ($version >> 5) & 0x0F;
$this->generation = ($version >> 9) & 0x0F;
}else{
$version = preg_split("/([A-Za-z]*)[ _\\-]?([0-9]*)\\.([0-9]*)\\.{0,1}([0-9]*)(dev|)(-[\\0-9]{1,}|)/", $version, -1, PREG_SPLIT_DELIM_CAPTURE);
$this->generation = (int) ($version[2] ?? 0); //0-15
$this->major = (int) ($version[3] ?? 0); //0-15
$this->minor = (int) ($version[4] ?? 0); //0-31
$this->development = $version[5] === "dev";
if($version[6] !== ""){
$this->build = (int) substr($version[6], 1);
}else{
$this->build = 0;
}
}
}
public function getNumber() : int{
return (($this->generation << 9) + ($this->major << 5) + $this->minor);
}
public function getGeneration() : int{
return $this->generation;
}
public function getMajor() : int{
return $this->major;
}
public function getMinor() : int{
return $this->minor;
}
public function getRelease() : string{
return $this->generation . "." . $this->major . ($this->minor > 0 ? "." . $this->minor : "");
}
public function getBuild() : int{
return $this->build;
}
public function isDev() : bool{
return $this->development;
}
public function get(bool $build = false) : string{
return $this->getRelease() . ($this->development ? "dev" : "") . (($this->build > 0 and $build) ? "-" . $this->build : "");
}
public function __toString() : string{
return $this->get();
}
/**
* @param VersionString|int|string $target
* @param bool $diff
*
* @return int
*/
public function compare($target, bool $diff = false) : int{
if(!($target instanceof VersionString)){
$target = new VersionString($target);
}
$number = $this->getNumber();
$tNumber = $target->getNumber();
if($diff){
return $tNumber - $number;
}
if($number > $tNumber){
return -1; //Target is older
}elseif($number < $tNumber){
return 1; //Target is newer
}elseif($target->getBuild() > $this->getBuild()){
return 1;
}elseif($target->getBuild() < $this->getBuild()){
return -1;
}else{
return 0; //Same version
}
}
}