Main Content

csvread

(권장되지 않음) 쉼표로 구분된 값(CSV) 파일 읽어 들이기

페이지 내 모두 축소

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

구문

M = csvread(filename)
M = csvread(filename,R1,C1)
M = csvread(filename,R1,C1,[R1 C1 R2 C2])

설명

예제

M = csvread(filename)은 쉼표로 구분된 값(CSV) 형식의 파일을 배열 M으로 읽어 들입니다. 파일에는 숫자형 값만 포함되어 있어야 합니다.

예제

M = csvread(filename,R1,C1)은 행 오프셋 R1과 열 오프셋 C1에서부터 파일의 데이터를 읽어 들입니다. 예를 들어, 오프셋 R1=0, C1=0은 파일의 첫 번째 값을 지정합니다.

예제

M = csvread(filename,R1,C1,[R1 C1 R2 C2])는 행 오프셋 R1, R2와 열 오프셋 C1, C2로 경계가 지정된 범위만 읽어 들입니다. 범위를 정의하는 또 다른 방법은 [0 0 6 1] 대신 'A1..B7'과 같은 스프레드시트 표기법을 사용하는 것입니다.

예제

모두 축소

쉼표로 구분된 값을 포함하는 파일 csvlist.dat를 만듭니다.

   02, 04, 06, 08
   03, 06, 09, 12
   05, 10, 15, 20
   07, 14, 21, 28

파일의 숫자형 값을 읽어 들입니다.

filename = 'csvlist.dat';
M = csvread(filename)
M =

     2     4     6     8
     3     6     9    12
     5    10    15    20
     7    14    21    28

위 예제에 설명된 파일에서 첫 번째 행 아래로 두 개의 행부터 행렬을 읽어 들입니다.

M = csvread('csvlist.dat',2,0)
M =

     5    10    15    20
     7    14    21    28

첫 번째 예제에 설명된 파일에서 행 오프셋 1과 2, 열 오프셋 0과 2로 경계가 지정된 행렬을 읽어 들입니다.

M = csvread('csvlist.dat',1,0,[1,0,2,2])
M =

     3     6     9
     5    10    15

입력 인수

모두 축소

파일 이름으로, 문자형 벡터 또는 string형으로 지정됩니다.

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

데이터형: char | string

시작 행 오프셋으로, 음이 아닌 정수로 지정됩니다. 첫 번째 행의 오프셋은 0입니다.

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

시작 열 오프셋으로, 음이 아닌 정수로 지정됩니다. 첫 번째 열의 오프셋은 0입니다.

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

끝 행 오프셋으로, 음이 아닌 정수로 지정됩니다. 첫 번째 행의 오프셋은 0입니다.

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

끝 열 오프셋으로, 음이 아닌 정수로 지정됩니다. 첫 번째 열의 오프셋은 0입니다.

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

팁

  • 행 오프셋과 열 오프셋을 지정하여 제목 행이나 열을 건너뛰십시오. 파일에서 제목 이외의 모든 값은 숫자형이어야 합니다.

알고리즘

csvread는 구분된 필드 중 빈 필드는 0으로 채웁니다. 라인이 공백이 아닌 구분 기호 즉, 세미콜론 등으로 끝날 경우 csvread 함수는 0으로 이루어진 열을 출력 행렬 M의 마지막에 추가해 반환합니다.

csvread는 복소수를 가져오는 경우 전체 필드를 복소수 필드로 설정해, 실수부와 허수부를 지정된 숫자형으로 변환합니다. 다음 표는 복소수의 유효한 형식을 보여줍니다.

형식

예

±<real>±<imag>i|j

5.7-3.1i

±<imag>i|j

-7j

복소수에 포함된 공백은 유효하지 않으며 필드 구분 기호로 간주됩니다.

버전 내역

R2006a 이전에 개발됨

모두 축소

R2019a: csvread는 권장되지 않음

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

R2019a부터는 csv 파일에서 행렬을 읽으려면 readmatrix 함수를 사용하십시오. readmatrix 함수는 csvread 함수에 비해 다음과 같은 이점이 있습니다.

  • 성능 및 크로스 플랫폼 지원 기능이 더 우수함

  • 데이터 형식 및 데이터형의 자동 감지

  • 가져오기 옵션을 사용하여 데이터 가져오기 프로세스 제어(오류 및 누락된 데이터 처리 포함)

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

권장되지 않음

권장됨

M = csvread(filename)
 
M = readmatrix(filename)

참고 항목

| | | | |

도움말 항목