목차
truncate() 예제 - 문자열을 지정 길이로 자르기 truncate() 정의 truncate() 구문
truncate() 예제 - 문자열을 지정 길이로 자르기
{{ "foo bar baz qux"|truncate(9) }}
결과값: "foo..."
{{ "foo bar baz qux"|truncate(9, False, "...", 5) }} 와 같음.(문자열길이= 15)보다 (length 9 + leeway 5 = 14)값이 더 작아서 자르기 작동 O.
"foo bar b" 까지가 9인데, 맨 뒤를 점 3개로 대체하면 "foo ba..."가 됨.
killwords 매개변수 값이 False라서 중간의 "bar" 단어가 잘려서 "ba"가 되었으므로 해당 단어와 빈 공백을 버림.결국, "foo..."가 됨.
{{ "foo bar baz qux"|truncate(9, True) }}
결과값: "foo ba..."
{{ "foo bar baz qux"|truncate(9, True, "...", 5) }} 와 같음.(문자열길이= 15)보다 (length 9 + leeway 5 = 14)값이 더 작아서 자르기 작동 O.
"foo bar b" 까지가 9인데, 맨 뒤를 점 3개로 대체하면 "foo ba..."가 됨.
killwords 매개변수 값이 True라서 정확히 해당 길이에서 자름.결국, "foo ba..."가 됨.
{{ "foo bar baz qux"|truncate(11) }}
결과값: "foo bar baz qux"
{{ "foo bar baz qux"|truncate(11, False, "...", 5) }} 와 같음.(문자열길이= 15)보다 (length 11 + leeway 5 = 16)값이 더 커서 자르기 작동 X.
결국, "foo bar baz qux"가 됨.
{{ "foo bar baz qux"|truncate(11, False, '...', 0) }}
결과값: "foo bar..."
{{ "foo bar baz qux"|truncate(11, Fasle, "...", 0) }} 와 동일.(문자열길이= 15)보다 (length 11 + leeway 0 = 11)값이 더 작아서 자르기 작동 O.
"foo bar baz" 까지가 11인데, 맨 뒤를 점 3개로 대체하면 "foo bar ..."가 됨.
killwords 매개변수 값이 False라서 "..." 앞의 빈 공백을 날림.
결국, "foo bar..."가 됨.
PS. 문자열을 정확히 해당 길이에서 자르기{{ "foo bar baz qux"|truncate(5, True, '', 0) }}
{{ "홈짱닷컴 Homzzang.com"|truncate(4, True, '', 0) }}
-> 홈짱닷컴
truncate() 정의
문자열을 지정 길이로 자른 복사본을 반환하는 필터 .
1.
첫 번째 매개변수 length (자를길이) - (기본값: 255)
두 번째 매개변수 killwords (자름방식) - True: 정확히 해당 길이서 자름. / False: 잘린 마지막 단어를 버림.
세 번째 매개변수 end (잘림표시) - (기본값: ...)
네 번째 매개변수 leeway (허용오차) - 허용오차 범위 내 문자열은 안 자름.
2.
문자열 길이는 문자열 개수로 셈.
일반적으로 문자열 길이는 0부터 세지만, 이 필터에서는 문자열의 길이를 1부터 셈 . 따라서 첫 번째 문자의 인덱스는 1이 되고, 문자열의 마지막 문자의 인덱스는 문자열 길이와 동일값이 됨.
문자열 길이를 문자 개수로 세려면 length() 필터 이용: {{ "홈짱닷컴 Homzzang.com"|length }} {# 17 #} / {{ "foo bar baz qux"|length }} {# 15 #}
3. 공식 매뉴얼
https://jinja.palletsprojects.com/en/3.1.x/templates/#jinja-filters.truncate
truncate() 구문
jinja-filters.truncate(s: str, length: int = 255, killwords: bool = False, end: str = '...', leeway: int | None = None ) → str
[매개변수]
s: str
필수. 지정 길이로 자를 문자열.
length: int = 255
선택. 잘라낼 길이.
문자일 길이는 1부터 세며, 문자열 개수로 셈.
end 매개변수에 포함된 문자열 포함 길이임.
killwords: bool = False
선택. 문자열을 정확히 자를지 여부 지정.
True - 지정 길이에서 정확히 자름.False - 지정 길이 초과한 부분의 단어 자체를 버림. (기본값) (주의: (length + end) 길이가 단어 중간에 걸친 경우, 해당 단어와 끝의 빈 공백을 버림. )
end: str = '...'
선택. 지정 길이로 잘라진 문자열임을 표시하는 문자열.
leeway: int | None = None
선택. 문자열을 안 자를 허용 오차 범위 길이값.
(length + leeway ) 길이 이내 경우, 문자열을 자르지 않음.
기본값: (최신버전: 5 ), (구 버전: 0 )이나 차후에 바뀔 지 모름.
[반환값]
문자열을 지정 길이로 자른 복사본을 반환.
