num2str

숫자를 문자형 배열로 변환하기

구문

s = num2str(A)

s = num2str(A,precision)

s = num2str(A,formatSpec)

설명

참고

숫자형 스칼라를 텍스트와 결합하는 데는 string이 num2str보다 권장됩니다. 가독성을 높이기 위해 + 연산자를 사용하여 string형과 숫자형 값을 결합할 수 있습니다. 추가적인 정보는 대체 기능 항목을 참조하십시오.

s = num2str(A)는 숫자형 배열을 숫자를 나타내는 문자형 배열로 변환합니다. 출력 형식은 원래 값의 크기에 따라 달라집니다. num2str은 숫자형 값을 사용하여 플롯에 레이블과 제목을 지정하는 데 유용합니다.

s = num2str(A,precision)은 precision으로 지정된 최대 유효 자릿수를 갖는 숫자를 나타내는 문자형 배열을 반환합니다.

s = num2str(A,formatSpec)은 formatSpec으로 지정된 형식을 A의 모든 요소에 적용합니다.

참고

형식이 지정된 경우 s는 A의 요소 사이에 공백을 포함하지 않습니다. 공백을 포함하려면 형식에 공백을 추가하십시오.

예제

부동소수점 값의 디폴트 변환

pi와 eps가 반환한 부동소수점 값을 문자형 벡터로 변환합니다.

s = num2str(pi)

s = 
'3.1416'

s = num2str(eps)

s = 
'2.2204e-16'

정밀도 지정

부동소수점 값의 최대 유효 자릿수를 지정합니다.

rng('default')
A = randn([2,2]);
s = num2str(A,3)

s = 2x15 char array
    '0.538     -2.26'
    ' 1.83     0.862'

형식 지정

pi를 지정된 정밀도의 부동소수점 숫자로 표시합니다.

formatSpec = '%.2f';
s = num2str(pi,formatSpec)

s = 
'3.14'

입력 인수

A — 입력 배열

숫자형 배열

입력 배열로, 숫자형 배열로 지정됩니다.

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical
복소수 지원 여부: 예

precision — 최대 유효 자릿수

양의 정수

출력 문자열의 최대 유효 자릿수로, 양의 정수로 지정됩니다.

참고

precision을 입력 부동소수점 데이터형의 정밀도를 초과하도록 지정할 경우, 결과값이 지정한 정밀도 범위 내에서 입력값과 일치하지 않을 수도 있습니다. 결과는 사용자의 컴퓨터 하드웨어와 운영 체제에 따라 다릅니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

formatSpec — 출력 필드의 형식

형식 지정 연산자

출력 필드의 형식으로, 형식 지정 연산자를 사용하여 지정됩니다. formatSpec은 일반 텍스트와 특수 문자를 포함할 수도 있습니다.

formatSpec에 \n과 같이 이스케이프 문자를 나타내는 리터럴 텍스트가 포함된 경우 num2str 함수는 이스케이프 문자를 변환합니다.

formatSpec은 작은따옴표로 묶인 문자형 벡터이거나 string형 스칼라일 수 있습니다.

형식 지정 연산자

형식 지정 연산자는 퍼센트 기호 %로 시작하고 변환 문자로 끝납니다. 변환 문자는 반드시 필요합니다. %와 변환 문자 사이에는 필요에 따라 식별자, 플래그, 필드 너비, 정밀도 및 하위유형 연산자를 지정할 수 있습니다. (연산자 사이에는 공백을 사용할 수 없지만 여기서는 읽기 편하도록 표시되어 있습니다.)

변환 문자

다음 표에는 숫자형 데이터와 문자 데이터의 형식을 텍스트로 지정하는 변환 문자가 나와 있습니다.

값 유형	변환	세부 정보
정수, 부호 있음	%d 또는 %i	10진법
정수, 부호 없음	%u	10진법
	%o	8진법(8진수)
	%x	16진법(16진수), 소문자 a–f
	%X	%x와 동일, 대문자 A–F
부동소수점 숫자	%f	고정소수점 표기법(정밀도 연산자를 사용하여 소수점 이하 자릿수를 지정합니다.)
	%e	지수 표기법(예: 3.141593e+00)(정밀도 연산자를 사용하여 소수점 이하 자릿수를 지정합니다.)
	%E	%e와 동일하되 대문자임(예: 3.141593E+00)(정밀도 연산자를 사용하여 소수점 이하 자릿수를 지정합니다.)
	%g	%e 또는 %f 중 더 간단한 형식(후행 0을 포함하지 않음)(정밀도 연산자를 사용하여 소수점 이하 유효 자릿수를 지정합니다.)
	%G	%E 또는 %f 중 더 간단한 형식(후행 0을 포함하지 않음)(정밀도 연산자를 사용하여 소수점 이하 유효 자릿수를 지정합니다.)
문자 또는 string형	%c	단일 문자
	%s	문자형 벡터 또는 string형 배열. 출력 텍스트의 유형은 formatSpec의 유형과 같습니다.

선택적 연산자

식별자, 플래그, 필드 너비, 정밀도, 하위유형 등의 선택적 연산자는 출력 텍스트의 형식을 추가로 정의합니다.

• 식별자

  참고: num2str 함수는 sprintf 함수와 달리 식별자를 지원하지 않습니다.

• 플래그

  '–'	왼쪽 맞춤. 예: %-5.2f 예: %-10s
  '+'	모든 숫자형 값에 대해 항상 부호 문자(+ 또는 –)를 출력합니다. 예: %+5.2f 텍스트 오른쪽 맞춤. 예: %+10s
  ' '	값 앞에 공백을 삽입합니다. 예: % 5.2f
  '0'	값 앞의 필드 너비를 0으로 채웁니다. 예: %05.2f
  '#'	선택한 수치 변환을 수정합니다. %o, %x 또는 %X의 경우 0, 0x 또는 0X 접두사를 출력합니다. %f, %e 또는 %E의 경우 정밀도가 0이어도 소수점을 출력합니다. %g 또는 %G의 경우 후행 0 또는 소수점을 제거하지 않습니다. 예: %#5.0f

• 필드 너비

  출력할 최소 문자 수입니다.

  예: '%5d'는 intmax를 2147483647로 출력합니다. intmax가 반환하는 값이 출력할 최소 문자 수를 초과하기 때문입니다.

  출력할 문자 수가 필드 너비보다 적은 경우 compose 함수는 플래그에 의해 달리 지정되지 않은 이상 값 앞에 공백을 사용하여 필드 너비를 채웁니다.

  그러나 num2str 함수는 공백을 사용하여 필드 너비를 채우지 않습니다.

• 정밀도

  표시할 자릿수입니다.

  %f, %e 또는 %E의 경우	소수점 오른쪽의 자릿수입니다. 예: '%.4f'는 pi를 '3.1416'으로 출력함
  %g 또는 %G의 경우	유효 자릿수입니다. 예: '%.4g'는 pi를 '3.142'로 출력함

  예: '%6.4f'는 pi를 '3.1416'으로 출력합니다.

  참고

  부동소수점 값에 대한 입력 숫자 데이터형의 정밀도를 초과하는 정밀도 연산자를 지정하는 경우 결과는 지정한 정밀도에 대한 입력값과 일치하지 않을 수 있습니다. 결과는 사용자의 컴퓨터 하드웨어와 운영 체제에 따라 다릅니다.

• 하위유형

  하위유형 연산자를 사용하여 부동소수점 값을 8진수 값, 10진수 값, 16진수 값 중 하나로 출력할 수 있습니다. 하위유형 연산자는 변환 문자 바로 앞에 옵니다. 다음 표에는 하위유형을 사용할 수 있는 변환이 나와 있습니다.

  입력값 유형	하위유형 및 변환 문자	출력값 유형
  부동소수점 숫자	%bx 또는 %bX %bo %bu	배정밀도 16진수, 8진수 또는 십진수 값 예: %bx는 pi를 400921fb54442d18로 출력함
  	%tx 또는 %tX %to %tu	단정밀도 16진수, 8진수 또는 십진수 값 예: %tx는 pi를 40490fdb로 출력함

형식 지정 연산자 앞이나 뒤의 텍스트

formatSpec은 퍼센트 기호 % 앞이나 변환 문자 뒤에 텍스트를 추가로 포함할 수도 있습니다. 가능한 텍스트는 다음과 같습니다.

• 출력할 일반 텍스트.

• 일반 텍스트로 입력할 수 없는 특수 문자. 다음 표에는 formatSpec에서 특수 문자를 나타내는 방식이 나와 있습니다.

  특수 문자	표현
  작은따옴표	''
  퍼센트 문자	%%
  백슬래시	\\
  경보	\a
  백스페이스	\b
  폼 피드(FF)	\f
  새 줄(Newline)	\n
  캐리지 리턴	\r
  가로 탭	\t
  세로 탭	\v
  그 Unicode® 숫자형 값을 16진수 N으로 나타낼 수 있는 문자	\xN 예: num2str('\x5A')는 'Z'를 반환합니다.
  그 Unicode 숫자형 값을 8진수 N으로 나타낼 수 있는 문자	\N 예: num2str('\132')는 'Z'를 반환합니다.

형식 지정 연산자를 사용한 변환의 중요 동작

• 수치 변환은 복소수의 실수부만 출력합니다.

• 숫자형 값에 대한 텍스트 변환과 같이 데이터에 맞지 않는 변환을 지정하는 경우 MATLAB^®은 지정된 변환을 무시하고 %e를 사용합니다.

  예: '%s'는 pi를 3.141593e+00으로 변환합니다.

• 텍스트 변환(%c나 %s)을 정수 값에 적용하는 경우 MATLAB은 유효한 문자 코드에 대응하는 값을 문자로 변환합니다.

  예: '%s'는 [65 66 67]을 ABC로 변환합니다.

출력 인수

s — 입력 배열의 텍스트 표현

문자형 배열

입력 배열의 텍스트 표현으로, 문자형 배열로 반환됩니다.

팁

• num2str은 formatSpec 입력 인수에 포함된 위치 식별자를 받지 않습니다. 예를 들어, num2str([14 15],'%2$X %1$o)는 오류를 반환합니다.

  위치 식별자는 형식 지정 연산자가 입력 배열의 요소가 아니라 함수의 입력 인수를 처리하는 순서를 지정합니다. num2str을 호출하는 경우 변환할 숫자가 있는 입력 인수는 하나뿐입니다.

• 유효하지 않은 형식 지정 연산자 또는 특수 문자를 지정할 경우, num2str 함수는 유효하지 않은 연산자 또는 문자 전까지의 텍스트는 출력하고 나머지는 버립니다.

  예: formatSpec이 'value = %z'인 경우, %z는 형식 지정 연산자가 아니기 때문에 num2str 함수는 'value ='를 출력합니다.

  예: formatSpec이 'character \x99999 = %s'인 경우, \x99999는 유효한 특수 문자가 아니기 때문에 num2str 함수는 'character'를 출력합니다.

알고리즘

num2str은 formatSpec에 공백 문자 플래그가 포함된 경우에도 문자형 배열에서 선행 공백을 자릅니다. 예를 들어, num2str(42.67,'% 10.2f')는 1×5 문자형 배열인 '42.67'을 반환합니다.

대체 기능

num2str을 사용하여 숫자형 스칼라와 텍스트를 결합하는 코드를, 그 대신 string을 사용하도록 업데이트합니다. + 연산자를 사용하여 숫자형 값을 string형과 결합할 수 있습니다. 예를 들면 다음과 같습니다.

권장되지 않음	권장됨
newstr = ['The value is ' num2str(4.5)] newstr = 'The value is 4.5'	newstr = "The value is " + 4.5 newstr = "The value is 4.5"

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 입력 인수는 상수여야 합니다.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

이 함수는 GPU 배열을 완전히 지원합니다. 자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

참고 항목

int2str | mat2str | sprintf | str2num | string | sprintf | str2double