Last 5.3 release ever available: PHP 5.3.29 - 5.3 now EOL

func_num_args

(PHP 4, PHP 5)

func_num_argsİşleve aktarılan değiştirge sayısını döndürür

Açıklama

int func_num_args ( void )

İşleve aktarılan değiştirge sayısını elde eder.

Bu işlev kullanıcı tanımlı işlevlerin değişken sayıda değiştirge kabul edebilmesini sağlamak için func_get_arg() ve func_get_args() ile birlikte kullanılabilir.

Dönen Değerler

Mevcut kullanıcı tanımlı işleve aktarılan değiştirge sayısını döndürür.

Sürüm Bilgisi

Sürüm: Açıklama
5.3.0 Bu işlev artık değiştirge listelerinde kullanılabilmektedir.
5.3.0 Bu işlev, çağrının yapıldığı dosyadaki bir işlev tanımında bulunan bir include veya require üzerinden dosyaya dahil edilen bir dosyadan yani, asıl dosyanın etki alanının dışından) çağrılırsa artık bir uyarı üretip FALSE döndürmektedir.

Hatalar/İstisnalar

Eğer kullanıcı tanımlı işlev dışından çağrılırsa uyarı oluşturur.

Örnekler

Örnek 1 - func_num_args() örneği

<?php
function işlev()
{
    
$dğşsayısı func_num_args();
    echo 
"Değiştirge sayısı: $dğşsayısı\n";
}

işlev(123);
?>

Yukarıdaki örneğin çıktısı:

Değiştirge sayısı: 3

Örnek 2 - PHP 5.3 sonrası func_get_arg()örneği

test.php
<?php
function foo() {
    include 
'./fga.inc';
}

foo('First arg''Second arg');
?>

fga.php
<?php

$arg 
func_get_arg1(1);
var_export($arg);

?>

PHP 5.3 öncesi için çıktı:

'Second arg'

PHP 5.3 ve sonrası için çıktı:

Warning: func_get_arg():  Called from the global scope - no function
context in /home/torben/Desktop/code/ml/fga.inc on line 3
false

Notlar

Bilginize:

Bu işlev değiştirge ayrıntılarını saptamak için mevcut etki alanına bağımlı olduğundan bir işlev değiştirgesi olarak kullanılamaz. Eğer bu değerin aktarılması gerekli ise sonuçlar bir değişkene atanmalı ve bu değişken aktarılmalıdır.

Ayrıca Bakınız

  • func_get_arg() - Değiştirge listesinden bir üyeyi döndürür
  • func_get_args() - İşleve aktarılan değiştirgelerin listesini dizi olarak döndürür

add a note add a note

User Contributed Notes 6 notes

up
9
jared at ws-db dot com
8 years ago
Just a note for anyone wondering. This function doesn't include params that have a default value, unless you pass one in to overwrite the default param value. Not sure if that makes sense, so here's an example:

<?php
function helloWorld($ArgA, $ArgB="HelloWorld!") {
  return
func_num_args();
}

// The following will return 1
$Returns1 = helloWorld("HelloWorld!");

// The following will return 2
$Returns2 = helloWorld("HelloWorld!", "HowdyWorld!");
?>
up
2
luisguillermo dot quevedovelez at gmail dot com
2 years ago
I had defined a function function_name(){ ...} as a drupal callback.
I try to get how many params where passed

I got a Error and my Site falls down

I've replaced func_get_args() instead func_num_args() and my Site was restored.

I conclude you can not use  func_num_args() in callbacks.

Hope it helps.
up
2
ashley at dcs dot warwick dot ac dot uk
12 years ago
If you want to pass the parameters on intact to another function, use func_get_args and call_user_func_array (careful - this one is only available in recent PHP versions).  For example:

<?php
/* Print an HTML tag.  This accepts a variable number of arguments:
   the first should be the name of the tag, followed by pairs of
   arguments that describe keys and values.  The values are printed
   with surrounding double quote characters.  */
function printTag() {
 
$numArgs = func_num_args();
  if (
$numArgs < 1) die("printTag given no arguments");
 
  echo
"<" . func_get_arg(0);
  for (
$i = 1; $i < $numArgs; $i+=2) {
    echo
" " . func_get_arg($i);
    if (
$i+1 < $numArgs)
      echo
"=\"" . func_get_arg($i+1) . "\"";
  }
  echo
">";
 
}

/* Print an HTML tag with a newline on the end */
function printTagNL() {
 
$args = func_get_args();
 
call_user_func_array("printTag", $args);
  echo
"\n";
}

printTagNL("input", "type", "hidden", "name", "SORTORDER", "value", $columnNo);
?>
up
1
andy at arakka dot co dot th
9 years ago
func_num_args() can be used in conjunction with named arguments, also. For example:

<?php
function DebugShow( $label, $value ) {
  echo
"# " . $label ;
  if (
func_num_args() > 1 ) echo " = " . $value ;
  echo
"<br>";
}
?>
up
1
Dennis Robinson from basnetworks dot net
5 years ago
This function comes in handy, and I believe is the only solution, when you have an optional parameter that can take any type of data.

For example:

<?php

// $data can be of any type, including null
function my_function($name, $data = null)
{
    if (
$data !== null)
    {
       
// Do something with $data
        // If you call my_function('something'), this WILL NOT be reached
        // If you call my_function('something', null), this WILL NOT be reached
   
}
}

?>

The problem with the above function is that you will never be able to use null as the value for $data.  To fix this, use func_num_args() like so:

<?php

// $data can be of any type, including null
function my_function($name, $data = null)
{
    if (
func_num_args() >= 2)
    {
       
// Do something with $data
        // If you call my_function('something'), this WILL NOT be reached
        // If you call my_function('something', null), this WILL be reached
   
}
}

?>

This solution works because func_num_args() reports exactly how many arguments were passed when the function was called.  It does not take into account when default argument values are used.
up
0
thalis at NOSPAMcs dot pitt dot edu
12 years ago
The idea of func_get_args() is to construct functions of variable number of parameters like

<?php
function var_param_func(){
    if(
func_num_args()==0){
       
//do one thing
   
}
    if(
func_num_args()==1)
       
//do another thing
        //get the args with func_get_args()
   
}
}
?>
To Top