Hudzilla.org - the homepage of Paul Hudson
Contents > Functions > User functions Wish List | Report Bug | About Me ]

4.15.1     Return values

This is NOT the latest copy of this book; click here for the latest version.

You're allowed to return one and only one value back from functions, and you do this by using the return statement. In our example, we could have used "return 'foo';" or "return 10 + 10;" to pass other values back, but "return 1;" is easiest, and usually the most common as it is the same as "return true;"

You can return any variable you want, as long as it is just one variable - it can be an integer, a string, a database connection, etc. The "return" keyword sets up the function return value to be whatever variable you use with it, then exits the function immediately. You can also just use "return;", which means "exit without sending a value back."

Consider this script:

<?php
    
function foo() {
        print
"In function";
        return
1;
        print
"Leaving function...";
    }

    print
foo();
?>

That will output "In function", followed by "1", and then the script will terminate. The reason we never see "Leaving function..." is because the line "return 1" passes one back then immediately exits - the second print statement in foo() is never reached.

If you want to pass more than one value back, you need to use an array - this is covered soon.

A popular thing to do is to return the value of a conditional statement, e.g.:

return $i > 10;

If $i is indeed greater than 10, the > operator will return 1, so it is the same as having "return 1", but if $i is less than or equal to ten, it is the same as being "return 0".





<< 4.15 User functions   4.15.2 Parameters >>
Table of Contents
Want to see this stuff in print? PHP in a Nutshell takes the core topics covered here, adds in thousands of edits from the editorial team and myself, and combines them to make an unbeatable reference for PHP programmers at all levels.



My latest book has hundreds more tips on how to use PHP, Apache, and MySQL, plus Perl, Python, shell scripts, performance tuning, and more!



Top-right shadow
 
Bottom-left shadow Bottom shadow

Comments from other readers
Be the first to add a comment to this chapter!



Add comment
Please note that by posting a comment here you are committing it to the public domain. This is important so that others can make use of your code themselves, and also so that I can incorporate helpful notes directly into the main text. Comments are limited to 2000 characters in length.

If you are reporting an error in the content, please tell me directly.

Your name/email address:
Your comment:
 
Now, in order to verify that you're a real person, please answer this simple question: what is eight plus four?
The answer is:
(please write in
numbers, eg 19)


Top-right shadow
 
Bottom-left shadow Bottom shadow