Chris@0: <?php
Chris@0: 
Chris@0: namespace Drupal\Component\Render;
Chris@0: 
Chris@0: /**
Chris@0:  * Implements MarkupInterface and Countable for rendered objects.
Chris@0:  *
Chris@0:  * @see \Drupal\Component\Render\MarkupInterface
Chris@0:  */
Chris@0: trait MarkupTrait {
Chris@0: 
Chris@0:   /**
Chris@0:    * The safe string.
Chris@0:    *
Chris@0:    * @var string
Chris@0:    */
Chris@0:   protected $string;
Chris@0: 
Chris@0:   /**
Chris@0:    * Creates a Markup object if necessary.
Chris@0:    *
Chris@0:    * If $string is equal to a blank string then it is not necessary to create a
Chris@0:    * Markup object. If $string is an object that implements MarkupInterface it
Chris@0:    * is returned unchanged.
Chris@0:    *
Chris@0:    * @param mixed $string
Chris@0:    *   The string to mark as safe. This value will be cast to a string.
Chris@0:    *
Chris@0:    * @return string|\Drupal\Component\Render\MarkupInterface
Chris@0:    *   A safe string.
Chris@0:    */
Chris@0:   public static function create($string) {
Chris@0:     if ($string instanceof MarkupInterface) {
Chris@0:       return $string;
Chris@0:     }
Chris@0:     $string = (string) $string;
Chris@0:     if ($string === '') {
Chris@0:       return '';
Chris@0:     }
Chris@0:     $safe_string = new static();
Chris@0:     $safe_string->string = $string;
Chris@0:     return $safe_string;
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * Returns the string version of the Markup object.
Chris@0:    *
Chris@0:    * @return string
Chris@0:    *   The safe string content.
Chris@0:    */
Chris@0:   public function __toString() {
Chris@0:     return $this->string;
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * Returns the string length.
Chris@0:    *
Chris@0:    * @return int
Chris@0:    *   The length of the string.
Chris@0:    */
Chris@0:   public function count() {
Chris@17:     return mb_strlen($this->string);
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * Returns a representation of the object for use in JSON serialization.
Chris@0:    *
Chris@0:    * @return string
Chris@0:    *   The safe string content.
Chris@0:    */
Chris@0:   public function jsonSerialize() {
Chris@0:     return $this->__toString();
Chris@0:   }
Chris@0: 
Chris@0: }