diff --git a/reference/array/functions/current.xml b/reference/array/functions/current.xml index 0d79c89cfd..8e3d038c38 100644 --- a/reference/array/functions/current.xml +++ b/reference/array/functions/current.xml @@ -1,5 +1,5 @@ - + @@ -23,22 +23,18 @@ internal pointer. It does not move the pointer in any way. If the internal pointer points beyond the end of the elements list, current returns &false;. - - - If the array contains empty elements (0 or "", the empty - string) then this function will return a value which - evaluates to &false; for these elements as well (see converting to boolean - and the type comparison tables - for more information). - This makes it impossible to - determine if you are really at the end of the list in such - an array using current. To properly - traverse an array that may contain empty elements, use the - each function. - - + + &return.falseproblem; + + + + You won't be able to distinguish the end of an array from a + boolean &false; element. To properly traverse an array + which may contain &false; elements, see the each + function. + + Example use of <function>current</function> and friends @@ -59,8 +55,8 @@ $mode = current($transport); // $mode = 'plane'; See also end, key, - next, prev, and - reset. + next, prev, + reset, and each. diff --git a/reference/array/functions/next.xml b/reference/array/functions/next.xml index 78d953f6ef..c43b0d4935 100644 --- a/reference/array/functions/next.xml +++ b/reference/array/functions/next.xml @@ -1,5 +1,5 @@ - + @@ -26,19 +26,18 @@ advances the internal array pointer by one. If advancing the internal array pointer results in going beyond the end of the element list, next returns &false;. - - - If the array contains empty elements, or elements that have a key - value of 0 then this function will return a value which - evaluates to &false; for these elements as well (see converting to boolean - and the type comparison tables - for more information). To properly traverse an array which - may contain empty elements or elements with key values of 0 see the - each function. - - + + &return.falseproblem; + + + + You won't be able to distinguish the end of an array from a + boolean &false; element. To properly traverse an array + which may contain &false; elements, see the each + function. + + Example use of <function>next</function> and friends @@ -59,7 +58,8 @@ $mode = end($transport); // $mode = 'plane'; See also current, end, - prev, and reset. + prev, reset, + and each. diff --git a/reference/array/functions/prev.xml b/reference/array/functions/prev.xml index 0b7bceeafb..785800414e 100644 --- a/reference/array/functions/prev.xml +++ b/reference/array/functions/prev.xml @@ -1,5 +1,5 @@ - + @@ -16,18 +16,18 @@ Returns the array value in the previous place that's pointed to by the internal array pointer, or &false; if there are no more elements. - - - If the array contains empty elements then this function will - return a value which evaluates to &false; for these elements as well - (see converting to boolean - and the type comparison tables - for more information). - To properly traverse an array which may contain empty elements - see the each function. - - + + &return.falseproblem; + + + + You won't be able to distinguish the beginning of an array from a + boolean &false; element. To properly traverse an array + which may contain &false; elements, see the each + function. + + prev behaves just like next, except it rewinds the internal array @@ -52,7 +52,8 @@ $mode = end($transport); // $mode = 'plane'; See also current, end, - next, and reset. + next, reset, + and each.