Strings str_getcsv
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
str_getcsv — CSV 문자열을 배열로 구문 분석
설명
str_getcsv( string $string, string $separator = ",", string $enclosure = "\"", string $escape = "\\" ): array
CSV 형식의 필드에 대한 문자열 입력을 구문 분석하고 읽은 필드가 포함된 배열을 반환합니다.
메모: 이 함수는 로케일 설정을 고려합니다. LC_CTYPE
이 예를 들면 en_US.UTF-8
, 1바이트 인코딩의 문자열은 이 함수에서 잘못 읽을 수 있습니다.
매개변수
string
- 구문 분석할 문자열입니다.
separator
- 필드 구분 기호를 설정합니다(단일 바이트 문자 1개만).
enclosure
- 필드 엔클로저 문자를 설정합니다(1바이트 문자만 해당).
escape
- 이스케이프 문자를 설정합니다(최대 1바이트 문자). 기본값은 백슬래시(
\
)입니다. 빈 문자열(""
)은 독점 이스케이프 메커니즘을 비활성화합니다.참고: 일반적으로
enclosure
문자는 두 배로 필드 내부에서 이스케이프됩니다. 그러나escape
문자를 대안으로 사용할 수 있습니다. 따라서 기본 매개변수 값""
과\"
의 경우 동일한 의미를 갖습니다.enclosure
문자를 이스케이프하는 것을 제외하고escape
문자는 특별한 의미가 없습니다.
반환 값
읽은 필드를 포함하는 인덱스 배열을 반환합니다.
변경 로그
버전 | 설명 |
---|---|
7.4.0 | escape 매개변수는 이제 빈 문자열을 독점 이스케이프 메커니즘을 비활성화하는 신호로 해석합니다. 이전에는 빈 문자열이 기본 매개변수 값처럼 처리되었습니다. |
Examples
예제 #1 str_getcsv() 예제
<?php
$string = 'PHP,Java,Python,Kotlin,Swift';
$data = str_getcsv($string);
var_dump($data);
?>
위의 예는 다음을 출력합니다.
array(5) { [0]=> string(3) "PHP" [1]=> string(4) "Java" [2]=> string(6) "Python" [3]=> string(6) "Kotlin" [4]=> string(5) "Swift" }
기타
- fgetcsv() - 파일 포인터에서 줄을 가져오고 CSV 필드에 대해 구문 분석합니다.