텍스트 헬퍼

텍스트 헬퍼 파일에는 텍스트 작업을 도와주는 함수가 포함되어 있습니다.

헬퍼 로드

이 헬퍼는 다음 코드를 사용하여 로드합니다:

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

사용 가능한 함수

사용 가능한 함수는 다음과 같습니다:

word_limiter($str[, $limit = 100[, $end_char = '…']])
매개변수:

  • $str (string) – 입력 문자열

  • $limit (int) – 제한

  • $end_char (string) – 끝 문자 (보통 생략 부호)

반환:

단어 수가 제한된 문자열

반환 형식:

string

지정된 단어 수로 문자열을 자릅니다. 예시:

$string = "Here is a nice text string consisting of eleven words.";
$string = word_limiter($string, 4);
// Returns:  Here is a nice

세 번째 매개변수는 문자열에 추가되는 선택적 접미사입니다. 기본적으로 생략 부호를 추가합니다.

character_limiter($str[, $n = 500[, $end_char = '…']])
매개변수:

  • $str (string) – 입력 문자열

  • $n (int) – 문자 수

  • $end_char (string) – 끝 문자 (보통 생략 부호)

반환:

문자 수가 제한된 문자열

반환 형식:

string

지정된 문자 수로 문자열을 자릅니다. 단어의 무결성을 유지하므로 실제 문자 수는 지정한 것보다 약간 많거나 적을 수 있습니다.

예시:

$string = "Here is a nice text string consisting of eleven words.";
$string = character_limiter($string, 20);
// Returns:  Here is a nice text string

세 번째 매개변수는 문자열에 추가되는 선택적 접미사이며, 선언되지 않으면 생략 부호를 사용합니다.

참고

정확한 문자 수로 자르려면 아래의 ellipsize() 함수를 참조하세요.

ascii_to_entities($str)
매개변수:

  • $str (string) – 입력 문자열

반환:

ASCII 값이 엔티티로 변환된 문자열

반환 형식:

string

ASCII 값을 문자 엔티티로 변환합니다. 상위 ASCII 및 웹 페이지에서 사용될 때 문제를 일으킬 수 있는 MS Word 문자를 포함하여, 브라우저 설정에 관계없이 일관되게 표시하거나 데이터베이스에 안정적으로 저장할 수 있도록 합니다. 서버의 지원 문자셋에 약간의 의존성이 있어 모든 경우에 100% 신뢰할 수는 없지만, 대부분의 경우 일반 범위 밖의 문자(예: 악센트 문자)를 올바르게 식별해야 합니다.

예시:

$string = ascii_to_entities($string);
convert_accented_characters($str)
매개변수:

  • $str (string) – 입력 문자열

반환:

악센트 문자가 변환된 문자열

반환 형식:

string

상위 ASCII 문자를 하위 ASCII 동등 문자로 음역합니다. URL과 같이 표준 ASCII 문자만 안전하게 사용할 수 있는 곳에서 비영어 문자를 사용해야 할 때 유용합니다.

예시:

$string = convert_accented_characters($string);

참고

이 함수는 음역을 위한 배열을 정의하는 설정 파일 application/config/foreign_chars.php를 사용합니다.

word_censor($str, $censored[, $replacement = ''])
매개변수:

  • $str (string) – 입력 문자열

  • $censored (array) – 검열할 금지 단어 목록

  • $replacement (string) – 금지 단어를 대체할 내용

반환:

검열된 문자열

반환 형식:

string

텍스트 문자열 내의 단어를 검열할 수 있습니다. 첫 번째 매개변수에 원본 문자열, 두 번째 매개변수에 금지 단어 배열을 전달합니다. 세 번째 (선택적) 매개변수에는 단어 대체 값을 지정할 수 있습니다. 지정하지 않으면 파운드 기호(####)로 대체됩니다.

예시:

$disallowed = array('darn', 'shucks', 'golly', 'phooey');
$string = word_censor($string, $disallowed, 'Beep!');
highlight_code($str)
매개변수:

  • $str (string) – 입력 문자열

반환:

HTML을 통해 코드가 강조된 문자열

반환 형식:

string

코드 문자열(PHP, HTML 등)에 색상을 입힙니다. 예시:

$string = highlight_code($string);

이 함수는 PHP의 highlight_string() 함수를 사용하므로 사용되는 색상은 php.ini 파일에 지정된 것입니다.

highlight_phrase($str, $phrase[, $tag_open = '<mark>'[, $tag_close = '</mark>']])
매개변수:

  • $str (string) – 입력 문자열

  • $phrase (string) – 강조할 구문

  • $tag_open (string) – 강조에 사용할 여는 태그

  • $tag_close (string) – 강조를 위한 닫는 태그

반환:

HTML을 통해 구문이 강조된 문자열

반환 형식:

string

텍스트 문자열 내의 구문을 강조합니다. 첫 번째 매개변수에 원본 문자열, 두 번째 매개변수에 강조할 구문을 전달합니다. 세 번째와 네 번째 매개변수에는 구문을 감쌀 여는/닫는 HTML 태그를 전달합니다.

예시:

$string = "Here is a nice text string about nothing in particular.";
echo highlight_phrase($string, "nice text", '<span style="color:#990000;">', '</span>');

위 코드는 다음을 출력합니다:

Here is a <span style="color:#990000;">nice text</span> string about nothing in particular.

참고

이 함수는 기본적으로 <strong> 태그를 사용했습니다. 구형 브라우저는 새 HTML5 mark 태그를 지원하지 않을 수 있으므로, 그런 브라우저를 지원해야 한다면 스타일시트에 다음 CSS 코드를 삽입하는 것이 좋습니다:

mark {
        background: #ff0;
        color: #000;
};
word_wrap($str[, $charlim = 76])
매개변수:

  • $str (string) – 입력 문자열

  • $charlim (int) – 문자 제한

반환:

단어 단위로 줄 바꿈된 문자열

반환 형식:

string

완전한 단어를 유지하면서 지정된 문자 수에서 텍스트를 줄 바꿈합니다.

예시:

$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($str, $max_length[, $position = 1[, $ellipsis = '&hellip;']])
매개변수:

  • $str (string) – 입력 문자열

  • $max_length (int) – 문자열 길이 제한

  • $position (mixed) – 분할 위치 (int 또는 float)

  • $ellipsis (string) – 생략 부호로 사용할 문자

반환:

생략 부호가 삽입된 문자열

반환 형식:

string

이 함수는 문자열에서 태그를 제거하고, 정의된 최대 길이에서 분할하여 생략 부호를 삽입합니다.

첫 번째 매개변수는 생략할 문자열, 두 번째는 최종 문자열의 문자 수입니다. 세 번째 매개변수는 문자열에서 생략 부호가 나타날 위치를 0~1 사이의 왼쪽에서 오른쪽 값으로 지정합니다. 예를 들어 값이 1이면 오른쪽에, .5이면 중간에, 0이면 왼쪽에 생략 부호가 위치합니다.

선택적인 네 번째 매개변수는 생략 부호의 종류입니다. 기본적으로 &hellip;이 삽입됩니다.

예시:

$str = 'this_string_is_entirely_too_long_and_might_break_my_design.jpg';
echo ellipsize($str, 32, .5);

출력:

this_string_is_e&hellip;ak_my_design.jpg