PHP 사용자 정의 함수 반환값 사용법에 대한 자세한 설명

반환 값

사용자 공간 함수는 return 키워드를 사용하여 호출 공간에 정보를 반환합니다. 이는 C 언어의 구문과 동일합니다.

예:

function sample_long() {  
  return 42;  
}  
$bar = sample_long();

sample_long()이 호출되면, 42를 반환하고 이를 $bar 변수에 설정합니다. C 언어의 해당 코드는 다음과 같습니다.

int sample_long(void) {  
  return 42;  
}  
void main(void) {  
  int bar = sample_long();  
}

물론 C 언어에서는 항상 함수가 호출되는 내용을 알고 함수 프로토타입을 기반으로 반환하므로 이에 따라 반환 결과가 저장되는 변수를 정의해야 합니다. PHP 사용자 공간에서 처리할 때 변수 유형은 동적이며 2장 "변수의 입력 및 출력"에서 소개한 zval 유형에 따라 다릅니다.

return_value 변수

내부 함수가 직접 zval을 반환해야 하거나 다음과 같이 zval의 메모리 공간을 할당하고 zval *을 반환해야 한다고 생각할 수 있습니다.

PHP_FUNCTION(sample_long_wrong)  
{  
    zval *retval;  
      
    MAKE_STD_ZVAL(retval);  
    ZVAL_LONG(retval, 42);  
      
    return retval;  
}

안타깝게도 모든 함수 구현에서 zval을 할당하고 반환하는 것이 필수는 아닙니다. 대신 Zend 엔진은 함수 호출 전에 이 공간을 미리 할당합니다. 그런 다음 zval 유형을 IS_NULL로 초기화하고 값을 매개변수 이름 return_value로 전달합니다.

PHP_FUNCTION(sample_long)  
{  
    ZVAL_LONG(return_value, 42);  
    return;  
}

주의해야 합니다. PHP_FUNCTION() 구현은 어떤 값도 직접 반환하지 않습니다. 대신 적절한 데이터가 return_value 매개변수에 직접 삽입되고 Zend 엔진은 내부 함수가 실행된 후 이를 처리합니다.

알림: ZVAL_LONG() 매크로는 다중 할당 작업에 대한 래퍼:

Z_TYPE_P(return_value) = IS_LONG;  
Z_LVAL_P(return_value) = 42;

또는 더 직접적으로:

return_value->type = IS_LONG;  
return_value->value.lval = 42;

return_value 의 is_ref 및 refcount 속성 은 내부 함수에 의해 직접 수정되어서는 안 됩니다. 이러한 값은 Zend 엔진에 의해 초기화되고 처리됩니다.

이제 이 특수 함수를 살펴보고 5장 "첫 번째 확장"에서 만든 샘플 확장에 추가해 보겠습니다. 이 함수를 Sample_hello_world() 함수 아래에 추가하고 php_sample_functions구조에서:

static function_entry php_sample_functions[] = {  
    PHP_FE(sample_hello_world, NULL)  
    PHP_FE(sample_long, NULL)  
    { NULL, NULL, NULL }  
};

이제 make를 실행하여 확장을 다시 빌드할 수 있습니다.

모든 것이 정상이면 php를 실행하고 새 함수를 테스트할 수 있습니다:

$ php -r 'var_dump(sample_long()) ;

좀 더 컴팩트한 매크로를 압축하세요

코드 가독성과 유지 관리 측면에서 ZVAL_*() 매크로에 return_value 변수가 반복되는 부분이 있습니다. 이 경우 매크로의 ZVAL을 RETVAL로 바꾸면 Return_value를 사용할 수 있습니다. 호출할 때는 생략됩니다.

이전 예에서 Sample_long()의 구현 코드는 다음과 같이 줄일 수 있습니다.

PHP_FUNCTION(sample_long)  
{  
    RETVAL_LONG(42);  
    return;  
}

위 내용은 PHP 사용자 정의 함수 반환값 사용법에 대한 자세한 설명의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!