이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

dlmwrite

R2026a

(권장되지 않음) ASCII로 구분된 파일에 행렬 쓰기

dlmwrite는 권장되지 않습니다. writematrix를 대신 사용하십시오. 자세한 내용은 호환성 관련 고려 사항을 참조하십시오.

구문

dlmwrite(filename,M)

dlmwrite(filename,M,'-append')

dlmwrite(___,Name,Value)

dlmwrite(filename,M,delimiter)

dlmwrite(filename,M,delimiter,row,col)

설명

dlmwrite(filename,M)은 배열 M의 숫자형 데이터를 ASCII 형식 파일 filename에 쓰며, 디폴트 구분 기호(,)를 사용하여 배열 요소를 구분합니다. filename 파일이 이미 존재하는 경우 dlmwrite는 파일을 덮어씁니다.

dlmwrite(filename,M,'-append')은 기존 파일 filename의 끝에 데이터를 추가(append)합니다.

dlmwrite(___,Name,Value)는 하나 이상의 이름-값 쌍의 인수를 사용하여 구분 기호, 새 줄 문자, 오프셋 및 정밀도 옵션을 추가로 지정합니다.

dlmwrite(filename,M,delimiter)는 배열 M을 filename 파일에 쓰며, 지정된 구분 기호 delimiter를 사용하여 배열 요소를 구분합니다.

dlmwrite(filename,M,delimiter,row,col)은 배열에 지정된 행과 열, row 및 col 부분 부터 대상 파일에 씁니다. 빈 요소는 해당 행, 열 자리에 delimiter로만 채워집니다.

예제

쉼표로 구분된 데이터 쓰기

샘플 데이터로 구성된 배열 M을 만듭니다.

M = magic(3);

행렬 M을 myFile.txt 파일에 씁니다.

dlmwrite('myFile.txt',M)

파일의 데이터를 확인합니다.

type('myFile.txt')

8,1,6
3,5,7
4,9,2

탭으로 구분된 데이터 쓰기 및 정밀도 지정

샘플 데이터로 구성된 배열 M을 만듭니다.

M = magic(3)*pi

M = 3×3

   25.1327    3.1416   18.8496
    9.4248   15.7080   21.9911
   12.5664   28.2743    6.2832

탭 문자로 구분하고 세 자리 유효 자릿수의 정밀도를 사용하여 행렬 M을 'myFile.txt' 파일에 씁니다.

dlmwrite('myFile.txt',M,'delimiter','\t','precision',3)

파일의 데이터를 확인합니다.

type('myFile.txt')

25.1	3.14	18.8
9.42	15.7	22
12.6	28.3	6.28

데이터를 파일에 쓰고 추가(append)

샘플 숫자형 데이터로 구성된 두 개의 배열을 만듭니다.

M = magic(5);
N = magic(3);

행렬 M을 파일로 내보냅니다. 구분 기호로 공백을 사용합니다.

dlmwrite('myFile.txt',M,'delimiter',' ');

행렬 N을 파일에 추가(append)합니다. 기존 데이터에서 한 행 오프셋합니다. 파일의 데이터를 확인합니다.

dlmwrite('myFile.txt',N,'-append',...
'delimiter',' ','roffset',1)
type('myFile.txt')

17 24 1 8 15
23 5 7 14 16
4 6 13 20 22
10 12 19 21 3
11 18 25 2 9
  
8 1 6
3 5 7
4 9 2

dlmread를 사용하여 'myFile.txt'의 데이터를 읽습니다.

dlmread('myFile.txt')

ans = 8×5

    17    24     1     8    15
    23     5     7    14    16
     4     6    13    20    22
    10    12    19    21     3
    11    18    25     2     9
     8     1     6     0     0
     3     5     7     0     0
     4     9     2     0     0

dlmread가 파일에서 두 행렬을 읽으면 더 작은 행렬이 0으로 채워집니다.

데이터 쓰기 및 정밀도 지정

샘플 숫자형 데이터로 구성된 배열을 만듭니다.

M = magic(3);

소수점 이하 여섯 자릿수 정밀도를 사용하여 행렬 M을 파일로 내보냅니다.

dlmwrite('myFile.txt',M,'precision','%.6f');

파일의 데이터를 확인합니다.

type('myFile.txt')

8.000000,1.000000,6.000000
3.000000,5.000000,7.000000
4.000000,9.000000,2.000000

입력 인수

filename — 쓰기 작업에 사용되는 파일 이름

문자형 벡터 | string형

쓰기 작업에 사용되는 파일 이름으로, 문자형 벡터나 string형으로 지정됩니다.

예: 'myFile.txt' 또는 "myFile.txt"

데이터형: char | string

M — 쓰기 작업에 사용되는 숫자형 데이터

행렬 | 숫자형 값으로 구성된 셀형 배열

쓰기 작업에 사용되는 숫자형 데이터로, 행렬로 지정되거나 또는 셀당 값이 하나씩 지정된 숫자형 값 셀형 배열로 지정됩니다.

예: [1,2,3;4,5,6]

예: {1,2,3;4,5,6}

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

delimiter — 배열 요소를 구분하는 구분 기호

',' (디폴트 값) | 문자형 벡터 | string형

배열 요소를 구분하는 구분 기호로, 단일 문자 또는 제어 시퀀스 문자를 포함하는 문자형 벡터나 string형으로 지정됩니다. 탭으로 구분된 파일을 생성하려면 '\t'를 사용하십시오.

예: ';' 또는 ";"

예: '\t' 또는 "\t"

데이터형: char | string

row — 행 오프셋

0 (디폴트 값) | 스칼라

행 오프셋으로, 스칼라로 지정됩니다. 행 오프셋은 숫자형 데이터를 쓰기 전에 건너뛸 행의 개수를 나타냅니다. row는 0부터 시작하므로 row = 0은 MATLAB^®이 대상 파일의 첫 번째 행에 쓰기를 시작하도록 지시합니다. 건너뛴 행은 지정된 구분 기호로 채워집니다.

col — 열 오프셋

0 (디폴트 값) | 스칼라

열 오프셋으로, 스칼라로 지정됩니다. 열 오프셋은 숫자형 데이터를 쓰기 전에 건너뛸 열의 개수를 나타냅니다. col은 0부터 시작하므로 col = 0은 MATLAB이 대상 파일의 첫 번째 열에 쓰기를 시작하도록 지시합니다. 건너뛴 열은 지정된 구분 기호로 구분됩니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: dlmwrite('myFile.txt',M,'precision',4,'delimiter',' ')는 배열 M에 숫자형 값을 쓰며, 네 자리 유효 자릿수를 사용하고 공백 문자를 사용하여 구분합니다.

delimiter — 배열 요소를 구분하는 구분 기호

',' (디폴트 값) | 문자형 벡터 | string형

배열 요소를 구분하는 구분 기호로, 'delimiter'와 함께 단일 문자 또는 제어 시퀀스 문자를 포함하는 문자형 벡터나 string형이 쉼표로 구분되어 지정됩니다. 탭으로 구분된 파일을 생성하려면 '\t'를 사용하십시오.

예: 'delimiter',';' 또는 'delimiter',";"

예: 'delimiter','\t' 또는 'delimiter',"\t"

데이터형: char | string

roffset — 행 오프셋

0 (디폴트 값) | 스칼라

행 오프셋으로, 'roffset'과 스칼라가 쉼표로 구분되어 지정됩니다. 행 오프셋은 숫자형 데이터를 쓰기 전에 건너뛸 행의 개수를 나타냅니다. 이 행들은 지정된 구분 기호로 채워집니다. 기존 파일에 추가(append)하는 경우 새로운 데이터는 기존 데이터의 끝에서 오프셋됩니다.

행 오프셋은 0부터 시작하므로 'roffset',0은 MATLAB이 대상 파일의 첫 번째 행에서 쓰기를 시작하도록 지시합니다(디폴트 값). 그러나 파일에 추가(append)하는 경우 'roffset',0은 MATLAB이 기존 데이터 바로 다음에 오는 첫 번째 행에서 쓰기를 시작하도록 지시합니다.

예: 'roffset',2

coffset — 열 오프셋

0 (디폴트 값) | 스칼라

대상 파일 왼쪽에서의 열 오프셋으로, 'coffset'과 스칼라가 쉼표로 구분되어 지정됩니다. 열 오프셋은 숫자형 데이터를 쓰기 전에 건너뛸 열의 개수를 나타냅니다. 이 열들은 지정된 구분 기호로 구분됩니다.

열 오프셋은 0부터 시작하므로 'coffset',0은 MATLAB이 대상 파일의 첫 번째 열에서 쓰기를 시작하도록 지시합니다(디폴트 값).

예: 'coffset',1

precision — 숫자 정밀도

5 (디폴트 값) | 스칼라 | C 스타일 형식 지정자 | 문자형 벡터

파일에 데이터를 쓰는 데 사용할 숫자 정밀도로, 'precision'과 스칼라가 쉼표로 구분되어 지정되거나, %로 시작하는 C 스타일 형식 지정자(예: '%10.5f')로 지정됩니다. precision의 값이 스칼라인 경우 숫자 정밀도는 유효 자릿수를 나타냅니다.

예: 'precision',3

예: 'precision','%10.5f'

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

newline — 라인 종결자

'pc' | 'unix'

라인 종결자로, 'newline'과 'pc'가(캐리지 리턴/라인 피드 CR/LF를 사용하려는 경우) 쉼표로 구분되어 지정되거나 또는 'unix'로(라인 피드 LF를 사용하려는 경우) 지정됩니다.

예: 'newline','pc'

팁

• 스프레드시트 프로그램에서 읽을 수 있는 파일이어야 dlmwrite가 쓰기 작업을 할 수 있습니다. 또는 시스템에 Windows^®용 Excel^®이 설치되어 있다면 xlswrite를 사용하여 스프레드시트를 만들 수 있습니다.

버전 내역

R2006a 이전에 개발됨

R2019a: dlmwrite는 권장되지 않음

dlmwrite는 권장되지 않습니다. writematrix를 대신 사용하십시오. dlmwrite를 제거할 계획은 없습니다.

R2019a부터는 행렬을 구분된 텍스트 파일로 쓰려면 writematrix 함수를 사용하십시오. writematrix 함수는 dlmwrite 함수보다 성능 및 크로스 플랫폼 지원 기능이 더 우수합니다.

다음 표에서는 dlmwrite의 일반적인 사용법과 코드에서 대신 writematrix를 사용하도록 업데이트하는 방법을 보여줍니다.

권장되지 않음	권장됨
dlmwrite('mydata.txt',M)	writematrix(M,'mydata.txt')

참고 항목

writematrix | dlmread | xlswrite | writetable