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 필드에 대해 구문 분석합니다.