PhutilTerminalString.php
View Options

	<?php

	/**
	* String escaped for terminal output. See @{function:tsprintf}.
	*/
	final class PhutilTerminalString extends Phobject {

	private $string;

	public function __construct($string) {
	$this->string = $string;
	}

	public function __toString() {
	return $this->string;
	}

	public function applyWrap() {
	$string = phutil_string_cast($this);
	$string = phutil_console_wrap($string);
	return new self($string);
	}

	public function applyIndent($depth, $with_prefix = true) {
	$string = phutil_string_cast($this);
	$string = phutil_console_wrap($string, $depth, $with_prefix);
	return new self($string);
	}

	public static function escapeStringValue($value, $allow_whitespace) {
	if ($value instanceof PhutilTerminalString) {
	return phutil_string_cast($value);
	}

	if ($value instanceof ArcanistTerminalStringInterface) {
	$value = $value->newTerminalString();
	return self::escapeStringValue($value, $allow_whitespace);
	}

	if ($value === null) {
	return '';
	}

	if (is_array($value)) {
	if (!$value) {
	return '';
	}

	$parts = array();

	foreach ($value as $part) {
	$part = self::escapeStringValue($part, $allow_whitespace);
	$parts[] = $part;
	}

	return implode('', $parts);
	}

	$value = phutil_string_cast($value);

	static $escape_map;
	if ($escape_map === null) {
	$escape_map = array(
	chr(0x00) => '<NUL>',
	chr(0x07) => '<BEL>',
	chr(0x08) => '<BS>',
	chr(0x09) => '<TAB>',
	chr(0x0A) => '<LF>',
	chr(0x0D) => '<CR>',
	chr(0x1B) => '<ESC>',
	chr(0x7F) => '<DEL>',
	);

	for ($ii = 0; $ii < 32; $ii++) {
	$c = chr($ii);
	if (empty($escape_map[$c])) {
	$escape_map[$c] = sprintf('<0x%02X>', $ii);
	}
	}
	}

	$map = $escape_map;
	if ($allow_whitespace) {
	unset($map["\r"]);
	unset($map["\n"]);
	unset($map["\t"]);
	}

	$value = str_replace(array_keys($map), array_values($map), $value);

	// In this mode, we additionally escape any <CR> which is not immediately
	// followed by <LF>.
	if ($allow_whitespace) {
	$value = preg_replace('/\r(?!\n)/', '<CR>', $value);
	}

	// See T13209. If we print certain invalid unicode byte sequences to the
	// terminal under "cmd.exe", the entire string is silently dropped. Avoid
	// printing invalid sequences.
	if (phutil_is_windows()) {
	$value = phutil_utf8ize($value);
	}

	return $value;
	}
	}

File Metadata

Mime Type: text/x-php
Expires: Mon, Mar 24, 03:22 (1 d, 1 h ago)
Storage Engine: blob
Storage Format: Raw Data
Storage Handle: 1115220
Default Alt Text: PhutilTerminalString.php (2 KB)

PhutilTerminalString.php
No OneTemporary
Actions

PhutilTerminalString.php
View Options

File Metadata

Event Timeline

PhutilTerminalString.phpNo OneTemporaryActions

PhutilTerminalString.phpView Options

File Metadata

Event Timeline

PhutilTerminalString.php
No OneTemporary
Actions

PhutilTerminalString.php
View Options