PHP pos 数组函数

• 

  定义和用法

  pos - 返回数组中的当前单元。current() 的别名函数。
• 

  版本支持

  PHP4	PHP5	PHP7
  支持	支持	支持

• 

  语法

  pos (array &$array)   
  

  每个数组中都有一个内部的指针指向它“当前的”单元，初始指向插入到数组中的第一个单元。
• 

  参数

  参数	必需的	描述
  array	是	一个数组。

• 

  返回值

  pos() 函数返回当前被内部指针指向的数组单元的值，并不移动指针。如果内部指针指向超出了单元列表的末端，pos() 返回 FALSE。

  此函数可能返回布尔值 FALSE，但也可能返回等同于 FALSE 的非布尔值。请阅读 布尔类型章节以获取更多信息。应使用 === 运算符来测试此函数的返回值。

  如果数组包含 boolean FALSE 的单元则本函数在碰到这个单元时也返回 FALSE，使得不可能判断是否到了此数组列表的末端。 要正确遍历可能含有空单元的数组，用 each() 函数。

• 

  示例

  <?php
  $transport = array('foot', 'bike', 'car', 'plane');
  $mode = pos($transport); // $mode = 'foot';
  $mode = next($transport);    // $mode = 'bike';
  $mode = pos($transport); // $mode = 'bike';
  $mode = prev($transport);    // $mode = 'foot';
  $mode = end($transport);     // $mode = 'plane';
  $mode = pos($transport); // $mode = 'plane';
  
  $arr = array();
  var_dump(pos($arr)); // bool(false)
  echo '<br/>';
  $arr = array(array());
  var_dump(pos($arr)); // array(0) { }
  ?>
  

• 

  相关函数

  end() - 将数组的内部指针指向最后一个单元

  key() - 从关联数组中取得键名

  each() - 返回数组中当前的键／值对并将数组指针向前移动一步

  prev() - 将数组的内部指针倒回一位

  reset() - 将数组的内部指针指向第一个单元

  next() - 将数组中的内部指针向前移动一位