Code Coverage for /Users/ericduran/Sites/drupal/drupal/core/lib/Drupal/Component/Utility/ToStringTrait.php

1	<?php
2
3	/**
4	* @file
5	* Contains \Drupal\Component\Utility\ToStringTrait.
6	*/
7
8	namespace Drupal\Component\Utility;
9
10	/**
11	* Wraps __toString in a trait to avoid some fatals.
12	*/
13	trait ToStringTrait {
14
15	/**
16	* Implements the magic __toString() method.
17	*/
18	public function __toString() {
19	try {
20	return (string) $this->render();
21	}
22	catch (\Exception $e) {
23	// User errors in __toString() methods are considered fatal in the Drupal
24	// error handler.
25	trigger_error(get_class($e) . ' thrown while calling __toString on a ' . get_class($this) . ' object in ' . $e->getFile() . ' on line ' . $e->getLine() . ': ' . $e->getMessage(), E_USER_ERROR);
26	// In case we are using another error handler that did not fatal on the
27	// E_USER_ERROR, we terminate execution. However, for test purposes allow
28	// a return value.
29	return $this->_die();
30	}
31	}
32
33	/**
34	* For test purposes, wrap die() in an overridable method.
35	*/
36	protected function _die() {
37	die();
38	}
39
40	/**
41	* Renders the object as a string.
42	*
43	* @return string\|object
44	* The rendered string or an object implementing __toString().
45	*/
46	abstract public function render();
47
48	}