[정의]
자리표시자 가진 문자열을 특정 지정 값으로 포맷.
[구문]
%(string, value1, value2, ...)
[매개변수]
string
필수. placeholders (자리표시자) 가진 format (포맷)할 문자열.
placeholders (자리표시자)
1. 백분율 기호 %로 시작하고, 그 뒤에 문자 s, S, d, D, a, A 붙임.
(예) %s , %S , %d, %D, %a, %A
d, D, a, A
・어떤 인수 (색상, 숫자, 이스케이프 된 값, 표현식, ...)로 대체 가능.
・문자열과 함께 사용 시, 따옴표 포함 문자열 사용.
・따옴표는 그대로 문자열에 배치. ("/" 등으로 회피 안 됨.)
s, S
・모든 표현식으로 대체 가능.
・문자열과 함께 사용 시, 따옴표 제외 문자열 사용.
2. 소문자 placeholders : 특수문자를 그대로 둠.
3. 대문자 placeholders : 특수문자를 utf-8 회피 코드로 회피.
cf. 회피 안 되는 특수문자 5개 : (, ), ', ~, !
4. % 문자는 % 문자로 회피. (예) %%
5. 공백은 %20으로 인코딩.
value1, value2, ...
필수. placeholders 부분을 대체할 value(값)들.
[반환값]
포맷된 문자열 반환.
[예제]
format-a-d: %("repetitions: %a file: %d", 1 + 2, "directory/file.less");
format-a-d-upper: %('repetitions: %A file: %D', 1 + 2, "directory/file.less");
format-s: %("repetitions: %s file: %s", 1 + 2, "directory/file.less");
format-s-upper: %('repetitions: %S file: %S', 1 + 2, "directory/file.less");
[예제 결과]
format-a-d: "repetitions: 3 file: "directory/file.less"";
format-a-d-upper: "repetitions: 3 file: %22directory%2Ffile.less%22";
format-s: "repetitions: 3 file: directory/file.less";
format-s-upper: "repetitions: 3 file: directory%2Ffile.less";