텍스트(Text Helper)

텍스트처리 헬퍼는 텍스트관련 작업에 유용한 함수를 포함합니다.

헬퍼 로딩 Loading this Helper

헬퍼는 아래와 같이 로드합니다:

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

사용 가능한 함수들 Available Functions

아래의 함수들이 사용 가능합니다:

word_limiter($str[, $limit = 100[, $end_char = '…']])
인수:
  • $str (string) – 입력 문자열
  • $limit (int) – Limit
  • $end_char (string) – End character (usually an ellipsis)
반환값:

Word-limited string
반환형:

문자열

문자열을 지정된 숫자만큼 단어(words) 단위로 잘라냅니다. 예제:

$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) – Number of characters
  • $end_char (string) – End character (usually an ellipsis)
반환값:

Character-limited string
반환형:

문자열

문자열을 지정된 글자수만큼 잘라냅니다. 이 함수는 단어의 완전성 검사를 하기 때문에 지정된 숫자보다 조금더 적거나 많게 잘라질 수 있습니다.

예제:

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

세 번째 파라미터는 옵션이며, 문자열 끝에 붙이고 싶은 것을 설정합니다. 기본값은 말줄임표 입니다.

Note

문자를 정확한 숫자로 잘라야 하는 경우, 아래의 ellipsize() 이 함수를 참고하세요.

ascii_to_entities($str)
인수:
  • $str (string) – 입력 문자열
반환값:

A string with ASCII values converted to entities
반환형:

문자열

high ASCII 나 MS Word 에 쓰이는 문자 등 웹페이지에 표시될 때 문제가 되는 ASCII 값들을 문자 엔티티로 변경합니다. 그렇게 함으로서 브라우저의 설정에 상관 없이 일관되게 페이지에 표시할 수 있게하거나 신뢰성 있게 데이터베이스에 저장할 수 있게 합니다. 이 함수는 서버의 문자셋(character sets)에 대한 의존성이 일부 있으므로, 모든 상황에서 100% 신뢰성이 있지는 않습니다만, 대부분의 경우에 잘 작동합니다.

예제:

$string = ascii_to_entities($string);
convert_accented_characters($str)
인수:
  • $str (string) – 입력 문자열
반환값:

A string with accented characters converted
반환형:

문자열

높은 ASCII 문자를 동일한 낮은 ASCII로 변환합니다. 표준 ASCII문자만 허용되는 곳에서 영어가 아닌 문자를 사용해야만 할 때 유용합니다. 예를 들어 URL.

예제:

$string = convert_accented_characters($string);

Note

이 함수에서 사용되는 변환 정보는 application/config/foreign_chars.php 에 정의되어 있습니다.

word_censor($str, $censored[, $replacement = ''])
인수:
  • $str (string) – 입력 문자열
  • $censored (array) – List of bad words to censor
  • $replacement (string) – What to replace bad words with
반환값:

Censored string
반환형:

문자열

텍스트 문자열에서 특정 단어를 검열합니다. 첫 번째 파라미터는 원본 문자열입니다. 두 번째 파라미터는 검열 대상 문자열의 배열입니다. 옵션인 세 번째 파라미터는 검열 대상 문자열을 대신할 문자열입니다. 만약 세 번째 파라미터를 지정하지 않으면 #### 로 변환됩니다.

예제:

$disallowed = array('darn', 'shucks', 'golly', 'phooey');
$string = word_censor($string, $disallowed, 'Beep!');
highlight_code($str)
인수:
  • $str (string) – 입력 문자열
반환값:

String with code highlighted via HTML
반환형:

문자열

문자열에서 소스 코드(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) – Phrase to highlight
  • $tag_open (string) – Opening tag used for the highlight
  • $tag_close (string) – Closing tag for the highlight
반환값:

String with a phrase highlighted via 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.

Note

이 함수는 기본적으로 <strong> 태그를 사용하는데 사용됩니다. 이전 브라우저는 새로운 HTML5 마크 태그를 지원하지 않을 수 있습니다. 그래서 그런 브라우저를 지원하기 위해 다음 CSS 를 추가할 것을 권장합니다:

mark {
        background: #ff0;
        color: #000;
};
word_wrap($str[, $charlim = 76])
인수:
  • $str (string) – 입력 문자열
  • $charlim (int) – Character limit
반환값:

Word-wrapped string
반환형:

문자열

지정된 글자 개수길이만큼으로 감쌉니다(Wraps text). 줄바꿈이 아니라 한 줄에 표시될 문자 개수를 정해주면 그 이상 벗어나지 않고 한 줄 아래로 내려가는 효과입니다.

예제:

$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) – String length limit
  • $position (mixed) – Position to split at (int or float)
  • $ellipsis (string) – What to use as the ellipsis character
반환값:

Ellipsized string
반환형:

문자열

이 함수는 문자열에서 태그를 제거하고 지정된 최대 길이로 자른 후 생략 기호를 삽입합니다.

첫 번째 파라미터는 대상문자열, 두 번째는 문자열 길이, 세 번째는 생략 기호가 어디에 붙어야할지 결정합니다. 예를 들어 1은 생략기호를 문자열의 오른쪽에 붙이고, 5는 중간, 0은 왼쪽에 붙입니다.

옵션인 네 번째 파라미터는 생략기호입니다. 기본값은 … 입니다.

예제:

$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