readlines

파일의 라인을 string형 배열로 읽기

R2020b 이후

구문

S = readlines(filename)

S = readlines(filename,Name,Value)

설명

S = readlines(filename)은 라인이 N개인 파일을 읽어 N×1 string형 배열을 만듭니다.

S = readlines(filename,Name,Value)는 하나 이상의 이름-값 쌍의 인수를 추가 옵션으로 지정하여 파일에서 string형 배열을 만듭니다. 예를 들어, 'EmptyLineRule','skip'은 빈 라인을 건너뜁니다.

예제

텍스트 파일에서 string형 배열 생성하기

텍스트 파일의 각 라인을 개별 문자열로 읽어 4×1 string형 배열을 생성합니다.

lines = readlines("badpoem.txt")

lines = 4x1 string
    "Oranges and lemons,"
    "Pineapples and tea."
    "Orangutans and monkeys,"
    "Dragonflys or fleas."

텍스트 파일의 빈 라인 무시하기

capital_cities.txt 파일의 내용을 확인합니다.

type 'capital_cities.txt'

  Boston, Massachusetts

Albany, New York

  Sacramento, California

Columbus, Ohio

  Santa Fe, New Mexico

capital_cities.txt를 읽는 동안 빈 라인을 건너뛰어 5×1 string형 배열을 생성합니다. 배열은 여전히 입력값의 공백 문자를 포함하지만 빈 라인은 포함하지 않습니다.

lines = readlines("capital_cities.txt","EmptyLineRule","skip")

lines = 5x1 string
    "  Boston, Massachusetts"
    "Albany, New York"
    "  Sacramento, California"
    "Columbus, Ohio"
    "  Santa Fe, New Mexico"

텍스트 주변의 공백 지우기

capital_cities.txt 파일의 내용을 확인합니다.

type 'capital_cities.txt'

  Boston, Massachusetts

Albany, New York

  Sacramento, California

Columbus, Ohio

  Santa Fe, New Mexico

'WhitespaceRule' 값을 'trimleading'으로 지정하여 텍스트의 각 라인 앞에 있는 공백을 제거합니다. 배열은 더 이상 입력값의 선행 공백 문자를 포함하지 않지만 여전히 빈 라인을 유지합니다.

lines = readlines("capital_cities.txt","WhitespaceRule","trimleading")

lines = 10x1 string
    "Boston, Massachusetts"
    ""
    "Albany, New York"
    ""
    "Sacramento, California"
    ""
    "Columbus, Ohio"
    ""
    "Santa Fe, New Mexico"
    ""

입력 인수

filename — 읽을 파일의 이름

문자형 벡터 | string형 스칼라

읽을 파일의 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

파일의 위치에 따라 filename은 다음 형식 중 하나가 될 수 있습니다.

위치	형식
현재 폴더 또는 MATLAB® 경로의 폴더	filename에 파일의 이름을 지정합니다. 예: 'myFile.txt'
폴더 안의 파일	파일이 현재 폴더나 MATLAB 경로의 폴더에 없는 경우, filename에 전체 경로 또는 상대 경로 이름을 지정합니다. 예: 'C:\myFolder\myFile.txt' 예: 'dataDir\myFile.txt'
인터넷 URL	파일이 인터넷 URL(Uniform Resource Locator)로 지정된 경우, filename은 프로토콜 유형 'http://' 또는 'https://'를 포함해야 합니다. 예: 'http://hostname/path_to_file/my_data.csv'
원격 위치	파일이 원격 위치에 저장된 경우, filename은 다음 형식으로 지정된 파일의 전체 경로를 포함해야 합니다. scheme_name://path_to_file/my_file.ext 원격 위치에 따라 scheme_name은 다음 표에 있는 값 중 하나가 될 수 있습니다. 원격 위치 scheme_name Amazon S3™ s3 Windows Azure® Blob Storage wasb, wasbs HDFS™ hdfs 자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오. 예: 's3://bucketname/path_to_file/my_file.csv'

데이터형: char | string

이름-값 인수

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

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

예: 'EmptyLineRule','skip'은 파일을 가져오는 동안 빈 라인을 생략하도록 지정합니다.

LineEnding — 라인 끝(EOL) 문자

{'\n','\r','\r\n'} (디폴트 값) | 문자형 벡터 | string형 스칼라 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

라인 끝(EOL) 문자로, 'LineEnding'과 함께 문자형 벡터 또는 string형이 쉼표로 구분되어 지정됩니다. 문자형 벡터는 '\r\n'이거나 단일 문자를 지정해야 합니다. 일반적인 라인 끝(EOL) 문자는 새 줄(Newline) 문자('\n') 또는 캐리지 리턴('\r')이 있습니다. '\r\n'을 지정할 경우 가져오기 함수는 \r, \n, 이 둘의 조합(\r\n)을 모두 라인 끝(EOL) 문자로 처리합니다.

디폴트 라인 끝(EOL) 시퀀스는 파일의 내용에 따라 \n, \r, \r\n 중 하나입니다.

예: 'LineEnding','\n'

예: 'LineEnding','\r\n'

데이터형: char | string | cell

Whitespace — 공백으로 처리할 문자

{' ','\b','\t'} | 문자형 벡터 | string형 스칼라

공백으로 처리할 문자로, 하나 이상의 문자를 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

예: 'Whitespace',' _'

예: 'Whitespace','?!.,'

WhitespaceRule — 공백을 처리하는 절차

'preserve' (디폴트 값) | 'trim' | 'trimleading' | 'trimtrailing'

데이터의 라인 주변에 있는 공백을 처리하는 절차로, 'preserve', 'trim', 'trimleading' 또는 'trimtrailing'으로 지정됩니다.

공백 규칙	동작
'preserve'	선행 공백과 후행 공백을 유지합니다.
'trim'	선행 공백과 후행 공백을 제거합니다.
'trimleading'	선행 공백만 제거합니다.
'trimtrailing'	후행 공백만 제거합니다.

예: 'WhitespaceRule','trim'

데이터형: char | string

EmptyLineRule — 빈 라인을 처리하는 절차

'read' (디폴트 값) | 'skip' | 'error'

데이터의 빈 라인을 처리하는 절차로, 'skip', 'read' 또는 'error'로 지정됩니다.

빈 라인 규칙	동작
'read'	빈 라인을 가져옵니다.
'skip'	빈 라인을 건너뜁니다.
'error'	오류 메시지를 표시하고 가져오기 작업을 중단합니다.

예: 'EmptyLineRule','skip'

데이터형: char | string

Encoding — 문자 인코딩 체계

'' (디폴트 값) | 'UTF-8' | 'system' | 'ISO-8859-1' | 'windows-1251' | 'windows-1252' | ...

파일과 연결된 문자 인코딩 체계로, 'Encoding'과 함께 'system' 또는 표준 문자 인코딩 체계 이름이 쉼표로 구분되어 지정됩니다. 'Encoding','system'은 시스템 디폴트 인코딩을 사용합니다.

인코딩을 지정하지 않은 경우 함수는 파일을 읽을 때 문자 집합을 자동으로 감지하여 인코딩을 결정합니다.

데이터형: char | string

WebOptions — HTTP 또는 HTTPS 요청 옵션

weboptions 객체

HTTP 또는 HTTPS 요청 옵션으로, weboptions 객체로 지정됩니다. weboptions 객체는 지정된 filename이 프로토콜 유형 "http://" 또는 "https://"를 포함하는 인터넷 URL일 때 데이터를 어떻게 가져올지를 결정합니다.

버전 내역

R2020b에 개발됨

참고 항목

writelines | readtable | readtimetable | readmatrix | readvars