Initial commit

typo3conf/ext/vhs/Classes/ViewHelpers/Render/AsciiViewHelper.php

@@ -0,0 +1,63 @@
+<?php
+namespace FluidTYPO3\Vhs\ViewHelpers\Render;
+
+/*
+ * This file is part of the FluidTYPO3/Vhs project under GPLv2 or later.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.md file that was distributed with this source code.
+ */
+
+use TYPO3\CMS\Fluid\Core\ViewHelper\AbstractViewHelper;
+
+/**
+ * ### Render: ASCII Character
+ *
+ * Renders a single character identified by its charset number.
+ *
+ * For example: `<v:render.character ascii="10" /> renders a UNIX linebreak
+ * as does {v:render.character(ascii: 10)}. Can be used in combination with
+ * `v:iterator.loop` to render sequences or repeat the same character:
+ *
+ *     {v:render.ascii(ascii: 10) -> v:iterator.loop(count: 5)}
+ *
+ * And naturally you can feed any integer variable or ViewHelper return value
+ * into the `ascii` parameter throught `renderChildren` to allow chaining:
+ *
+ *     {variableWithAsciiInteger -> v:render.ascii()}
+ *
+ * And arrays are also supported - they will produce a string of characters
+ * from each number in the array:
+ *
+ *     {v:render.ascii(ascii: {0: 13, 1: 10})}
+ *
+ * Will produce a Windows line break, \r\n
+ *
+ * @author Claus Due <claus@namelesscoder.net>
+ * @package Vhs
+ * @subpackage ViewHelpers\Render
+ */
+class AsciiViewHelper extends AbstractViewHelper {
+
+	/**
+	 * @param mixed $ascii
+	 * @return string
+	 */
+	public function render($ascii = NULL) {
+		if (NULL === $ascii) {
+			$ascii = $this->renderChildren();
+		}
+		if (TRUE === is_numeric($ascii)) {
+			return chr((integer) $ascii);
+		}
+		if (TRUE === is_array($ascii) || TRUE === $ascii instanceof \Traversable) {
+			$string = '';
+			foreach ($ascii as $characterNumber) {
+				$string .= chr($characterNumber);
+			}
+			return $string;
+		}
+		return '';
+	}
+
+}