String.format 함수
업데이트: 2007년 11월
String 개체의 각 형식 항목을 해당 개체 값을 나타내는 텍스트로 바꿉니다.
var s = String.format(format, args);
인수
format
형식 문자열입니다.args
형식을 지정할 개체의 배열입니다.
반환 값
형식이 적용된 문자열의 복사본입니다.
예외
예외 형식 |
조건 |
|---|---|
(디버그) format에 포함된 여는 중괄호와 닫는 중괄호의 짝이 맞지 않는 경우 |
설명
format 함수를 사용하면 지정된 형식 항목을 해당 개체 값을 나타내는 텍스트로 바꿀 수 있습니다. args 인수에는 단일 개체 또는 개체 배열이 포함될 수 있으며, format 인수에는 0개 이상의 고정 텍스트가 하나 이상의 형식 항목과 결합된 형태로 포함됩니다. 각 형식 항목은 objects의 개체에 해당합니다. 런타임에 각 형식 항목은 목록에서 해당하는 개체를 나타내는 문자열로 바뀝니다.
형식 항목은 {0}과 같이 objects 목록에서 해당 항목을 식별하는 숫자가 중괄호 안에 포함된 형태로 구성됩니다. 이때 번호는 0부터 시작됩니다. 단일 리터럴 중괄호 문자를 형식에 지정하려면 "{{" 또는 "}}"와 같이 여는 중괄호 문자나 닫는 중괄호 문자를 두 개 지정합니다. 중첩 중괄호는 지원되지 않습니다.
형식 지정 루틴 사용자 지정
args 인수에 toFormattedString 메서드를 포함하는 특수 형식 지정 개체를 제공하여 형식 항목에 대해 형식 지정 루틴을 사용자 지정할 수 있습니다. toFormattedString 메서드는 문자열 인수를 받고 문자열을 반환해야 합니다. 런타임에 format 함수는 해당하는 매개 변수 지정자의 중괄호 문자열을 toFormattedStrings 메서드에 전달합니다. toFormattedString 메서드에서 반환되는 문자열은 해당하는 매개 변수 지정자 위치에서 형식 지정된 문자열에 삽입됩니다.
예제
다음 예제에서는 format 함수를 사용하여 특정 형식 항목을 해당 개체 값을 나타내는 텍스트로 바꾸는 방법을 보여 줍니다. 이 코드에는 toFormattedString 메서드가 있는 사용자 지정 형식 지정 개체 예제가 포함됩니다.
// Define an class with a custom toFormattedString
// formatting routine.
Type.registerNamespace('Samples');
Samples.ToFormattedStringExample = function() {
}
Samples.ToFormattedStringExample.prototype = {
toFormattedString: function(format) {
return "This was custom formatted: " + format;
}
}
Samples.ToFormattedStringExample.registerClass('Samples.ToFormattedStringExample');
var result = "";
// Format a string.
result = String.format("{0:d}", 123);
// Displays: "123"
alert(result);
// Format a string with an object that has
// a custom toFormattedString method.
var o = new Samples.ToFormattedStringExample();
result = String.format("{0:12345}", o);
// Displays: "This was custom formatted: 12345"
alert(result);