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() 実装は直接値を返しません。代わりに、適切なデータが return_value パラメータに直接ポップされ、内部関数の実行後に Zend エンジンがそれを処理します。複数の割り当ての場合 操作のラッパー:

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

またはより直接的に:

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

return_value

の is_ref および refcount プロパティ

は、内部関数によって直接変更されるべきではありません。これらの値は、Zend によって初期化および処理されます。

次に、この特別な関数を見て、第 5 章「最初の拡張機能」で作成したサンプル拡張機能にこの関数を追加し、sample_long() を追加します。 php_sample_functions へ構造体内:

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

これで、make を実行して拡張機能を再構築できます。

すべてが OK であれば、php を実行して新しい関数をテストできます:

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

よりコンパクトなマクロをパックする

コードの可読性と保守性の観点から、ZVAL_*() マクロには繰り返し部分があります: return_value 変数 この場合、マクロの ZVAL を RETVAL に置き換えることができます。呼び出し時に Return_value は省略されます。

前の例では、sample_long() の実装コードは次のように削減できます:

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

以上がPHPカスタム関数の戻り値の使い方を詳しく解説の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。