CodeIgniter 使用手冊版本 2.2.0


Text 輔助函數

Text 輔助函數裡的檔案所包含的函數,可以用來協助處理 text。

載入 輔助函數

此輔助函數的載入方式依照下列程式碼:

$this->load->helper('text');

下列函數即可使用:

word_limiter()

擷取字串中的某個數量的單字(words)。參考範例:

$string = "Here is a nice text string consisting of eleven words.";

$string = word_limiter($string,4);

// 回傳的是: Here is a nice…

第三個選擇性的參數是加入後置符號到字串。預設加入省略符號。

character_limiter()

擷取字串中的某個數量的字元(characters)。它會維持單字的完整性,所以字元的數量會稍微比你預期的來的多或少一些。參考範例:

$string = "Here is a nice text string consisting of eleven words.";

$string = character_limiter($string,20);

// 回傳的是: Here is a nice text string…

第三個選擇性的參數是加入後置符號到字串。預設加入省略符號。

ascii_to_entities()

將 ASCII 值轉換成字元實體,包含那些使用在網站頁面裡頭,可能會造成問題的 high ASCII 以及 MS Word charcters。這樣則可以一致的顯示出來,而不需顧慮瀏覽器設定或是可靠的儲存在資料庫。但還有些需依賴伺服器所支援的字元,所以並非在所有的 case 都完全 ok,但是它還是可以正確的辨識出正常範圍外的字元(像是早期的字元)。參考範例:

$string = ascii_to_entities($string);

entities_to_ascii()

此函數提供的是前個函數的逆向功能。它將字元實體還原至 ACSII 數值。

convert_accented_characters()

Transliterates high ASCII characters to low ASCII equivalents, useful when non-English characters need to be used where only standard ASCII characters are safely used, for instance, in URLs.

$string = convert_accented_characters($string);

This function uses a companion config file application/config/foreign_chars.php to define the to and from array for transliteration.

word_censor()

允許你去檢查字串中的單字。第一個參數將會包含原始的字串。第二個字串則包含你所不允許的單字陣列。第三個字串的是選擇性的參數,包含用來取代單字的值。如果未提供取代的值的話,那麼就會用 #### 來取代。參考範例:

$disallowed = array('darn','shucks','golly','phooey');

$string = word_censor($string,$disallowed,'Beep!');

highlight_code()

替程式碼上色(PHP,HTML,etc.)。 參考範例:

$string = highlight_code($string);

此功能使用 PHP 的 highlight_string() 函數,所以該顏色是依照 php.ini 檔案裡頭所指定。

highlight_phrase()

替字串中的某個片語上色。第一個參數包含原始的字串,第二字串則包含你所要上色的片語,第三已及第四的參數,則包含你要將它們包在一起的開始與結束的 HTML 標籤。參考範例:

$string = "Here is a nice text string about nothing in particular.";

$string = highlight_phrase($string,"nice text",'<span style="color:#990000">','</span>');

傳回下述的文字:

Here is a nice text string about nothing in particular.

word_wrap()

在指定的字元(character)數斷行,並且保留單字的完整性。 參考範例:

$string = "Here is a simple string of text that will help us demonstrate this function.";

echo word_wrap($string,25);

// Would produce:

Here is a simple string
of text that will help
us demonstrate this
function

ellipsize()

This function will strip tags from a string, split it at a defined maximum length, and insert an ellipsis.

The first parameter is the string to ellipsize, the second is the number of characters in the final string. The third parameter is where in the string the ellipsis should appear from 0 - 1, left to right. For example. a value of 1 will place the ellipsis at the right of the string, .5 in the middle, and 0 at the left.

An optional forth parameter is the kind of ellipsis. By default, &hellip; will be inserted.

$str = 'this_string_is_entirely_too_long_and_might_break_my_design.jpg';

echo ellipsize($str, 32, .5);
Produces: this_string_is_e…ak_my_design.jpg