* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace RectorPrefix20210902\Symfony\Component\Console\Helper; use RectorPrefix20210902\Symfony\Component\Console\Formatter\OutputFormatterInterface; use RectorPrefix20210902\Symfony\Component\String\UnicodeString; /** * Helper is the base class for all helper classes. * * @author Fabien Potencier */ abstract class Helper implements \RectorPrefix20210902\Symfony\Component\Console\Helper\HelperInterface { protected $helperSet = null; /** * {@inheritdoc} * @param \Symfony\Component\Console\Helper\HelperSet|null $helperSet */ public function setHelperSet($helperSet = null) { $this->helperSet = $helperSet; } /** * {@inheritdoc} */ public function getHelperSet() { return $this->helperSet; } /** * Returns the length of a string, using mb_strwidth if it is available. * * @deprecated since Symfony 5.3 * * @return int The length of the string * @param string|null $string */ public static function strlen($string) { trigger_deprecation('symfony/console', '5.3', 'Method "%s()" is deprecated and will be removed in Symfony 6.0. Use Helper::width() or Helper::length() instead.', __METHOD__); return self::width($string); } /** * Returns the width of a string, using mb_strwidth if it is available. * The width is how many characters positions the string will use. * @param string|null $string */ public static function width($string) : int { $string ?? ($string = ''); if (\preg_match('//u', $string)) { return (new \RectorPrefix20210902\Symfony\Component\String\UnicodeString($string))->width(\false); } if (\false === ($encoding = \mb_detect_encoding($string, null, \true))) { return \strlen($string); } return \mb_strwidth($string, $encoding); } /** * Returns the length of a string, using mb_strlen if it is available. * The length is related to how many bytes the string will use. * @param string|null $string */ public static function length($string) : int { $string ?? ($string = ''); if (\preg_match('//u', $string)) { return (new \RectorPrefix20210902\Symfony\Component\String\UnicodeString($string))->length(); } if (\false === ($encoding = \mb_detect_encoding($string, null, \true))) { return \strlen($string); } return \mb_strlen($string, $encoding); } /** * Returns the subset of a string, using mb_substr if it is available. * * @return string The string subset * @param string|null $string * @param int $from * @param int|null $length */ public static function substr($string, $from, $length = null) { $string ?? ($string = ''); if (\false === ($encoding = \mb_detect_encoding($string, null, \true))) { return \substr($string, $from, $length); } return \mb_substr($string, $from, $length, $encoding); } public static function formatTime($secs) { static $timeFormats = [[0, '< 1 sec'], [1, '1 sec'], [2, 'secs', 1], [60, '1 min'], [120, 'mins', 60], [3600, '1 hr'], [7200, 'hrs', 3600], [86400, '1 day'], [172800, 'days', 86400]]; foreach ($timeFormats as $index => $format) { if ($secs >= $format[0]) { if (isset($timeFormats[$index + 1]) && $secs < $timeFormats[$index + 1][0] || $index == \count($timeFormats) - 1) { if (2 == \count($format)) { return $format[1]; } return \floor($secs / $format[2]) . ' ' . $format[1]; } } } } /** * @param int $memory */ public static function formatMemory($memory) { if ($memory >= 1024 * 1024 * 1024) { return \sprintf('%.1f GiB', $memory / 1024 / 1024 / 1024); } if ($memory >= 1024 * 1024) { return \sprintf('%.1f MiB', $memory / 1024 / 1024); } if ($memory >= 1024) { return \sprintf('%d KiB', $memory / 1024); } return \sprintf('%d B', $memory); } /** * @deprecated since Symfony 5.3 * @param \Symfony\Component\Console\Formatter\OutputFormatterInterface $formatter * @param string|null $string */ public static function strlenWithoutDecoration($formatter, $string) { trigger_deprecation('symfony/console', '5.3', 'Method "%s()" is deprecated and will be removed in Symfony 6.0. Use Helper::removeDecoration() instead.', __METHOD__); return self::width(self::removeDecoration($formatter, $string)); } /** * @param \Symfony\Component\Console\Formatter\OutputFormatterInterface $formatter * @param string|null $string */ public static function removeDecoration($formatter, $string) { $isDecorated = $formatter->isDecorated(); $formatter->setDecorated(\false); // remove <...> formatting $string = $formatter->format($string ?? ''); // remove already formatted characters $string = \preg_replace("/\33\\[[^m]*m/", '', $string ?? ''); $formatter->setDecorated($isDecorated); return $string; } }