dlmwrite

(권장되지 않음) 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