From 0c73f2b91c11ed64fb4bda978541e8a8f85f6558 Mon Sep 17 00:00:00 2001
From: Geert <Geert@6c8b873b-1030-0410-a378-995d7067e127>
Date: Tue, 28 Aug 2007 20:47:54 +0000
Subject: [PATCH] text::limit_words(), text::limit_chars(),
 text::soft_limit_chars() UTF-8 compatible

---
 system/helpers/file.php |  6 +--
 system/helpers/text.php | 82 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 85 insertions(+), 3 deletions(-)
 create mode 100644 system/helpers/text.php

diff --git a/system/helpers/file.php b/system/helpers/file.php
index 4a1e344a..8d532035 100644
--- a/system/helpers/file.php
+++ b/system/helpers/file.php
@@ -44,7 +44,7 @@ public static function split($filename, $output_dir = FALSE, $piece_size = 10)
 		fclose($input_file);
 
 		// Returns the number of pieces that were created
-		return ($piece-1);
+		return ($piece - 1);
 	}
 
 	public static function join($filename, $output = FALSE)
@@ -78,7 +78,7 @@ public static function join($filename, $output = FALSE)
 		fclose($output_file);
 
 		// Return the number of pieces joined
-		return ($piece-1);
+		return ($piece - 1);
 	}
 
-} // End file Class
\ No newline at end of file
+} // End file class
\ No newline at end of file
diff --git a/system/helpers/text.php b/system/helpers/text.php
new file mode 100644
index 00000000..6482afc9
--- /dev/null
+++ b/system/helpers/text.php
@@ -0,0 +1,82 @@
+<?php defined('SYSPATH') or die('No direct access allowed.');
+
+class text {
+	
+	/**
+	 * Word limiter
+	 *
+	 * @access	public
+	 * @param	string
+	 * @param	integer
+	 * @param	string
+	 * @return	string
+	 */
+	public static function limit_words($str, $limit = 100, $end_char = '&#8230;')
+	{
+		$limit = (int) $limit;
+		
+		if (trim($str) == '')
+			return $str;
+
+		if ($limit <= 0)
+			return $end_char;
+
+		preg_match('/^\s*(?:\S+\s*){1,'.$limit.'}/u', $str, $matches);
+
+		if (strlen($matches[0]) == strlen($str))
+		{
+			$end_char = '';
+		}
+
+		return rtrim($matches[0]).$end_char;
+	}
+	
+	/**
+	 * Character limiter
+	 *
+	 * @access	public
+	 * @param	string
+	 * @param	integer
+	 * @param	string
+	 * @return	string
+	 */
+	public static function limit_chars($str, $limit = 100, $end_char = '&#8230;')
+	{
+		$limit = (int) $limit;
+
+		if (trim($str) == '' OR utf8::strlen($str) <= $limit)
+			return $str;
+
+		return rtrim(utf8::substr($str, 0, $limit)).$end_char;
+	}
+	
+	/**
+	 * Character limiter that preserves words
+	 *
+	 * @access	public
+	 * @param	string
+	 * @param	integer
+	 * @param	string
+	 * @return	string
+	 */
+	public static function soft_limit_chars($str, $limit = 100, $end_char = '&#8230;')
+	{
+		$limit = (int) $limit;
+
+		if (trim($str) == '' OR utf8::strlen($str) <= $limit)
+			return $str;
+
+		if ($limit <= 0)
+			return $end_char;
+
+		preg_match('/^.{'.($limit - 1).'}\S*/us', $str, $matches);
+
+		if (strlen($matches[0]) == strlen($str))
+		{
+			$end_char = '';
+		}
+
+		return rtrim($matches[0]).$end_char;
+	}
+
+} // End text class
\ No newline at end of file