current

(PHP 4, PHP 5, PHP 7)

current배열의 현재 원소를 반환

설명

mixed current ( array &\$array )

모든 배열은 "현재" 원소를 가리키는 내부 포인터를 갖는데, 이 내부 포인터는 배열에 삽입되어진 첫번째 원소로 초기화된다.

array

배열.

반환값

current() 함수는 단순히 현재 내부 포인터에서 가리키고 있는 배열 원소의 값을 반환한다. 어떤 방법으로든 그 포인터를 움직이지 않는다. 내부 포인터가 원소 목록의 끝에서 벗어난 곳을 가리키면, current()FALSE를 반환한다.

Warning

이 함수는 논리 FALSE를 반환하지만, 논리 FALSE로 취급할 수 있는 다른 값을 반환할 수 있습니다. 자세한 정보는 논리형 섹션을 참고하십시오. 이 함수의 반환값을 확인하려면 === 연산자를 이용하십시오.

예제

Example #1 current()의 용례와 관련 함수

<?php
\$transport
= array('foot''bike''car''plane');
\$mode current(\$transport); // \$mode = 'foot';
\$mode next(\$transport);    // \$mode = 'bike';
\$mode current(\$transport); // \$mode = 'bike';
\$mode prev(\$transport);    // \$mode = 'foot';
\$mode end(\$transport);     // \$mode = 'plane';
\$mode current(\$transport); // \$mode = 'plane';

\$arr = array();
var_dump(current(\$arr)); // bool(false)

\$arr = array(array());
var_dump(current(\$arr)); // array(0) { }
?>

주의

Note: 배열의 끝과 boolean FALSE 원소를 구별할 수 없습니다. FALSE 원소를 가지는 배열을 올바르게 따라가려면, each()를 참고하십시오.

참고

• end() - 배열 내부 포인터가 마지막 원소를 가리키게 설정
• key() - 배열에서 키를 가져옵니다
• each() - 배열에서 현재 키와 값 쌍을 반환하고 배열 커서를 전진
• prev() - 내부 배열 포인터를 후진
• reset() - 배열의 내부 포인터를 첫 원소로 설정
• next() - 배열의 내부 배열 포인터를 전진

26
michael at squiloople dot com
10 years ago
current() also works on objects:

<?php

echo current((object) array('one', 'two')); // Outputs: one

?>
Vasily Yudin (st-2 at mail dot ru)
7 years ago
If you do current() after using uset() on foreach statement, you can get FALSE in PHP version 5.2.4 and above.
There is example:
<?php
\$prices
= array(

0 => '1300990',

1 => '500',

2 => '600'
);
foreach(
\$prices as \$key => \$price){
if(
\$price < 1000){
unset(
\$prices[\$key]);
}
}

var_dump(current(\$prices)); // bool(false)
?>
If you do unset() without foreach? all will be fine.
<?php
\$prices
= array(

0 => '1300990',

1 => '500',

2 => '600'
);
unset(
\$prices);
unset(
\$prices);

var_dump(current(\$prices));
?>
strate at yandex dot com
8 years ago
Note, that you can pass array by expression, not only by reference (as described in doc).

<?php
var_dump
( current( array(1,2,3) ) ); // (int) 1
?>
mdeng at kabenresearch dot com
17 years ago
For large array(my sample was 80000+ elements), if you want to traverse the array in sequence, using array index \$a[\$i] could be very inefficient(very slow). I had to switch to use current(\$a).
vaclav dot sir at gmail dot com
14 years ago
To that "note": You won't be able to distinguish the end of an array from a boolean FALSE element, BUT you can distinguish the end from a NULL value of the key() function.

Example:
<?php
if (key(\$array) === null) {
echo
"You are in the end of the array.";
} else {
echo
"Current element: " . current(\$array);
}
?>
xedin dot unknown at gmail dot com
3 years ago
Array functions, such as `current()` and `rewind()` will work on `Traversable` as well, PHP 5.0 - 7.3, but not in HHVM:

<?php

\$queue
reset(\$queue);
\$current = current(\$queue);
var_dump(\$current);

?>

See https://3v4l.org/VjCHR
retestro_REMOVE at SPAM_esperanto dot org dot il
18 years ago
The docs do not specify this, but adding to the array using the brackets syntax:
<?php \$my_array[] = \$new_value; ?>
will not advance the internal pointer of the array. therefore, you cannot use current() to get the last value added or key() to get the key of the most recently added element.

You should do an end(\$my_array) to advance the internal pointer to the end ( as stated in one of the notes on end() ), then

<?php
\$last_key
= key(\$my_array);  // will return the key

\$last_value = current(\$my_array);  // will return the value

?>

If you have no need in the key, \$last_value = end(\$my_array) will also do the job.

- Sergey.
vitalib at 012 dot net dot il
18 years ago
Note that by copying an array its internal pointer is lost:

<?php
\$myarray
= array(0=>'a', 1=>'b', 2=>'c');
next(\$myarray);
print_r(current(\$myarray));
echo
'<br>';
\$a = \$myarray;
print_r(current(\$a));
?>

Would output 'b' and then 'a' since the internal pointer wasn't copied. You can cope with that problem using references instead, like that:

<?php
\$a
=& \$myarray;
?>
leozmm at outlook dot com
2 years ago
Array can be passed by both REFERENCE and EXPRESSION on `current`, because current doesn't move array's internal pointer,
this is not true for other functions like: `end`, `next`, `prev` etc.

<?php

function foo() {return array(1,2,3);}
echo
current(foo());  // this print '1'

echo end(foo());      // this print error: Only variables should be passed by reference
?>
pdarmis at gmail dot com
4 years ago
Based on this example http://php.net/manual/en/function.current.php#116128 i would like to add the following.  As Vasily points out in his example
<?php
\$prices
= array(

0 => '1300990',

1 => '500',

2 => '600'
);
foreach(
\$prices as \$key => \$price){
if(
\$price < 1000){
unset(
\$prices[\$key]);
}
}

var_dump(current(\$prices)); // bool(false)
?>
The above example will not work and return false for version of PHP between 5.2.4 and 5.6.29. The issue is not present on PHP versions >= 7.0.1
A different workaround (at least from Vasily's example) would be to use reset() before using current() in order to reset the array pointer to start.
<?php
\$prices
= array(

0 => '1300990',

1 => '500',

2 => '600'
);
foreach(
\$prices as \$key => \$price){
if(
\$price < 1000){
unset(
\$prices[\$key]);
}
}
reset(\$prices);
var_dump(current(\$prices)); // string(7) "1300990"
?>
-2
gregory at gregory dot net
13 years ago
It took me a while to figure this out, but there is a more consistent way to figure out whether you really went past the end of the array, than using each().

You see, each() gets the value BEFORE advancing the pointer, and next() gets the value AFTER advancing the pointer. When you are implementing the Iterator interface, therefore, it's a real pain in the behind to use each().

And thus, I give you the solution:
To see if you've blown past the end of the array, use key(\$array) and see if it returns NULL. If it does, you're past the end of the array -- keys can't be null in arrays.

Nifty, huh? Here's how I implemented the Iterator interface in one of my classes:

<?php

/**
* DbRow file
* @package PalDb
*/

/**
* This class lets you use Db rows and object-relational mapping functionality.
*/

class DbRow implements Iterator
{

/**
* The DbResult object that gave us this row through fetchDbRows
* @var DbResult
*/

protected \$result;

/**
* The fields of the row
* @var \$fields
*/

protected \$fields;

/**
* Constructor
*
* @param PDOStatement \$stmt
*  The PDO statement object that this result uses
* @param DbResult \$result
*  The result that produced this row through fetchDbRows
*/

function __construct(\$result)
{

\$this->result = \$result;
}

/**
* Get the DbResult object that gave us this row through fetchDbRows
* @return DbResult
*
* @return unknown
*/

function getResult()
{
return
\$this->result;
}

function
__set(

\$name,

\$value)
{

\$this->fields[\$name] = \$value;
}

function
__get(

\$name)
{
if (isset(
\$this->fields[\$name]))
return
\$this->fields[\$name];
else
return
null;
}

/**
* Iterator implementation - rewind
*/

function rewind()
{

\$this->beyondLastField = false;
return
reset(\$this->fields);
}

function
valid()
{
return !
\$this->beyondLastField;
}

function
current()
{
return
current(\$this->fields);
}

function
key()
{
return
key(\$this->fields);
}

function
next()
{

\$next = next(\$this->fields);

\$key = key(\$this->fields);
if (isset(
\$key)) {
return
\$next;
} else {

\$this->beyondLastField = true;
return
false; // doesn't matter what we return here, see valid()

}
}

private
\$beyondLastField = false;
};

Hope this helps someone.
-8
aefxx
13 years ago
A simple copy function that not only copies the given array but ensures the copy's pointer is set to the exact same position:

<?php
function array_copy(&array)
{

\$key = key(\$array);

\$copy = \$array;

while ((
\$copy_key = key(\$copy)) !== NULL) {
if (
\$copy_key == \$key) break;

next(\$copy);
}

return
\$copy;
}
?>

That's all ... bye.
-5
Pratip Ghosh
7 years ago
If we unset any element from an array, and then try the current function, I noted it returned FALSE. To overcome this limitation, you can use array_values function to re-order the tree.
-6
jodevweb at gmail dot com
5 years ago
As Sergey stated a long time ago in this notes, when adding to the array using the brackets syntax, current won't return the last added value. Instead of moving the pointer with end(), you simply can get the last value with <?php \$my_array[count(\$my_array) - 1] ?> (only applies to a non-associative array). 