money_format

money_format

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

money_format 수치를 금액문자열의 포맷으로 맞춤

 

설명

string money_format ( string $format , float $number )

money_format()은 number를 포맷에 맞춰 반환합니다. 이 함수는 C의 라이브러리 함수 strfmon()를 포팅한 것 입니다만, 한번에 변환 가능한 수치가 하나 뿐이라는 점에서 차이가 있습니다.

 

파라메터

format

포맷지정의 서식은 이라의 순이 됩니다.

• % 문자
• 플러그(옵션)
• 필드의 폭(옵션)
• 왼쪽 정밀도(옵션)
• 오른쪽 정밀도(옵션)
• 변환문자 (필수)

 

플러그

이하의 플러그중 하나또는 복수를 사용할 수 있습니다.

=f

문자 = 의 뒤에 이어지는(단일 바이트의) 문자 f 가 수치를 채우는 문자로서 사용됩니다. 디플ㄹ트는 스페이스 문자 입니다.

^

그룹화 문자( 현재의 로케일에서 지정되어 있는)를 사용하지 않도록 합니다.

+ or (

정의수, 음의수의 형식을 지정합니다. + 가 사용되는 경우 + 또는 - 에 해당하는 그 지역의 마크가 사용됩니다.

( 가 사용되는 경우 음의 수는 괄호로 감쌉니다. 아무것조 지정하지 않는 경우 디폴트는 + 입니다.

!

출력문자열로부터 통화기호를 제외시킵니다.

-

지정한 문자, 전체의 필드를 왼쪽에서 채워넣기( 우측에 수치를 채우는 문자가 추가됨 )를 합니다. 디폴트는 이것과는 반대로, 전체의 필드를 오른쪽 채워넣기 ( 왼쪽에 수치를 채우는 문자가 추가됨 )을 합니다.

 

필드의 폭

w

10진수 형식의 문자열로, 필드의 폭의 최소치를 지정합니다. 플러그 - 가 사용되고 있지 않을 경우에 한하여, 플드는 오른쪽 채우넣기가 됩니다. 디폴트치는 0입니다.

 

오른쪽 정밀도

#n

10진수의 표준문자 ( 예: 소수점 )에 의하여 오른쪽의 최대의 문자수(n)을 지정합니다. 이것은 통상 n보다 작은 문자수의 수치에 대하여 수치 채워넣기 문자를 사용하는 것으로 출력의 문자수 위치를 정렬하기 위하여 사용됩니다.

실제의 문자수가 n 보다 많은 경우 이 설정은 무시됩니다.

 

^플러그로 그룹화된 문자열이 억제되어 있지 않은 경우( 혹시 존재한다면 )수치채워넣기 문지가 추가 되기 전에 그룹화 문자가 투입됩니다.

그룹화 문자는 수치 채워넣기 문자에는 통용되지 않습니다. 예를들어 수치를 채우는 문자가 숫자라고 할 지라도 똑같습니다.

 

위치 맞춤을 확실히 하기 위하여 출력중 수치의 전후에 표시되는 문자( 예를 들면 통화기후나 등호 등)은 필요에 의하여 (양의수 와 음의수의 길이를 정렬하는등의 이유로 )스페이스 문자가 추가되는 경우가 있습니다.

 

.p

피리오드는 연결수치(p)로 10진수 기준문자 이후의 문자수를 지정합니다. p의 값이 0 인 경우, 기준문자와 그것 이외의 수치는 생략됩니다.

우 정밀도가 지정되지 않은 경우, 사용중인 현재의 지역으로 부터 디폴트 값을 검출합니다. 포맷된 수치는 포맷전에 이 문자수를 반올림 합니다.

 

변환 문자

i

지역의 국제통화 포맷( 예 : USA 지역에서는 USD 1,234.56)에 따라 포맷화 됩니다.

n

지역의 국제통화 포맷 ( 예 : de_DE 지역에서는 EU1.234,65)에 따라 포맷화 됩니다.

%

%문자를 반환합니다.

 

number

포맷할 문자

 

반환치

포맷된 문자열을 반환합니다. 포맷 문자열의 전후의 문자는 그대로 반환합니다. nubmer이 비수치의 경우에는 NULL을 반환하고, E_WARNNING을 발행합니다.

 

주의

주의 : 시스템에서 strfmon이 사용가능한 경우에만 money_format() 함수가 정의됩니다. 예를들어 windows에는 strfmon는 사용 할 수없습니다.

그렇기 때문에 money_format()은 Windows 에서는 정의 되어 있지 않습니다.

주의 : 지역설정중 LC_MONETARY 카테고리의 내용이 이 함수의 행동에 영향을 받습니다. 이 함수를 사용하기전에 setlocale()로 적절한 디폴트 지역을 설정하여 주세요.