cvs: phpdoc-da /reference/array/functions array-shift.xml array-slice.xml array-splice.xml array-sum.xml

http://cvs.php.net/co.php/phpdoc-da/reference/array/functions/array-shift.xml?r=1.1&p=1
Index: phpdoc-da/reference/array/functions/array-shift.xml
+++ phpdoc-da/reference/array/functions/array-shift.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.10 Maintainer: lauer Status: ready -->
  <refentry id="function.array-shift">
   <refnamediv>
    <refname>array_shift</refname>
    <refpurpose>
     Fjerner et element i starten af et array
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beskrivelse</title>
     <methodsynopsis>
      <type>mixed</type><methodname>array_shift</methodname>
      <methodparam><type>array</type><parameter>&amp;array</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>array_shift</function> fjerner den første værdi i
     <parameter>array</parameter> og returnerer den, forkorter
     <parameter>array</parameter> med et element og flytter alle ting ned.
     Alle arrays med nøgler bestående af tal vil blive ændret, så de starter fra
     nul, mens nøgler bestående af bogstaver ikke vil blive rørt. Hvis
     <parameter>array</parameter> er tom (eller ikke et array), vil &null; 
     blive returneret.
    </para>
    
    &array.resetspointer;
    
    <example>
     <title><function>array_shift</function> eksempel</title>
     <programlisting role="php">
<![CDATA[
<?php
$stack = array("orange", "banana", "apple", "raspberry");
$fruit = array_shift($stack);
print_r($stack);
?>
]]>
     </programlisting>
     <para>
      Dette vil resulterer i at <varname>$stack</varname> har 3 elementer 
      tilbage:
     </para>
     <screen role="php">
<![CDATA[
Array
(
    [0] => banana
    [1] => apple
    [2] => raspberry
)
]]>
     </screen>
     <para>
      og <literal>orange</literal> vil blive tildelt til
      <varname>$fruit</varname>.
     </para>
    </example>
    <para>
     Se også <function>array_unshift</function>,
     <function>array_push</function> og
     <function>array_pop</function>.
    </para>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

http://cvs.php.net/co.php/phpdoc-da/reference/array/functions/array-slice.xml?r=1.1&p=1
Index: phpdoc-da/reference/array/functions/array-slice.xml
+++ phpdoc-da/reference/array/functions/array-slice.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.9 Maintainer: lauer Status: ready -->
  <refentry id="function.array-slice">
   <refnamediv>
    <refname>array_slice</refname>
    <refpurpose>Pakker en del ud af et array</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beskrivelse</title>
     <methodsynopsis>
      <type>array</type><methodname>array_slice</methodname>
      <methodparam><type>array</type><parameter>array</parameter></methodparam>
      <methodparam><type>int</type><parameter>offset</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
      <methodparam choice="opt"><type>bool</type><parameter>preserve_keys</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>array_slice</function> returnerer en bestemt række af elementer
     fra <parameter>array</parameter> som valgt ved
     <parameter>offset</parameter> og <parameter>length</parameter>
     parameterne.
    </para>
    <para>
     Hvis <parameter>offset</parameter> er positiv, vil rækken af elementer
     starte fra det punkt i <parameter>array</parameter>.  Hvis
     <parameter>offset</parameter> er negativ, vil rækken starte så langt fra
     enden af <parameter>array</parameter> som der er angivet.
    </para>
    <para>
     Hvis <parameter>length</parameter> er givet og er positiv vil række af 
     elementer have det antal i sig. Hvis <parameter>length</parameter> 
     er givet og er negativ vil rækken af elementer stoppe så mange værdier 
     fra enden af arrayet. Hvis den ikke bliver givet vil rækken af elementer 
     have de resterende elementer fra <parameter>offset</parameter> og op til 
     enden af <parameter>array</parameter>.
    </para>
    <para>
     Bemærk at <function>array_slice</function> vil reset nøglerne i arrayet
     som standard. Siden PHP 5.0.2 kan dette ændres ved at sætte
     <parameter>preserve_keys</parameter> til &true;.
    </para>
    <para>
     <example>
      <title><function>array_slice</function> eksempel</title>
      <programlisting role="php">
<![CDATA[
<?php
$input = array("a", "b", "c", "d", "e");

$output = array_slice($input, 2);      // returns "c", "d", and "e"
$output = array_slice($input, -2, 1);  // returns "d"
$output = array_slice($input, 0, 3);   // returns "a", "b", and "c"

// Bemærk forskellen mellem nøglerne i arrays
print_r(array_slice($input, 2, -1));
print_r(array_slice($input, 2, -1, true));
?>
]]>
      </programlisting>
      <para>
       Overstående script vil vise følgende:
      </para>
      <screen>
<![CDATA[
Array
(
    [0] => c
    [1] => d
)
Array
(
    [2] => c
    [3] => d
)
]]>
      </screen>
     </example>
    </para>
    <para>
     Se også <function>array_splice</function> og
     <function>unset</function>.
    </para>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

http://cvs.php.net/co.php/phpdoc-da/reference/array/functions/array-splice.xml?r=1.1&p=1
Index: phpdoc-da/reference/array/functions/array-splice.xml
+++ phpdoc-da/reference/array/functions/array-splice.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.12 Maintainer: lauer Status: ready -->
  <refentry id="function.array-splice">
   <refnamediv>
    <refname>array_splice</refname>
    <refpurpose>
     Fjerner en del af at array og udskifter det med noget andet
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beskrivelse</title>
     <methodsynopsis>
      <type>array</type><methodname>array_splice</methodname>
      <methodparam><type>array</type><parameter>&amp;input</parameter></methodparam>
      <methodparam><type>int</type><parameter>offset</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>
        replacement
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>array_splice</function> fjerner elementer som angivet ved
     <parameter>offset</parameter> og <parameter>length</parameter> fra arrayet
     <parameter>input</parameter> og udskriver dem med elementer fra 
     <parameter>replacement</parameter> arrayet, hvis dette argument er angivet.
     Den returnerer et array som indeholder de fjernede elementer.
    </para>
    <para>
     Hvis <parameter>offset</parameter> er positiv vil fjernelsen af elementer
     starte fra den afstand fra begyndelsen af <parameter>input</parameter> 
     arrayet.  Hvis <parameter>offset</parameter> er negativ, vil funktionen
     starte fjernelsen af elementerne fra den afstand fra slutningen af 
     <parameter>input</parameter> arrayet.
    </para>
    <para>
     Hvis <parameter>length</parameter> ikke er angivet, bliver alle elementer
     fra <parameter>offset</parameter> til enden af arrayet fjernet. Hvis 
     <parameter>length</parameter> er sat og er positiv, vil dette antal af 
     elemter blive fjernet. Hvis <parameter>length</parameter> er sat og negativ
     vil funktionen stoppe med af fjerne elementer efter den afstand fra enden 
     af arrayet.
     Tip: for at fjerne alt fra <parameter>offset</parameter> til enden af
     arrayet, <parameter>replacement</parameter> skal være sat, kan du 
     bruge <literal>count($input)</literal> til <parameter>length</parameter>.
    </para>
    <para>
     Hvis <parameter>replacement</parameter> arrayet er sat, vil de fjernede
     elementer bliver udskiftet med elementerne fra dette array.
     Hvis <parameter>offset</parameter> og <parameter>length</parameter> 
     falder sammen så ingenting bliver fjernet, vil elementerne fra
     <parameter>replacement</parameter> arrayet blive indsat det sted som er 
     angivet ved <parameter>offset</parameter>. Tip: Hvis udskifningen 
     kun indeholder et element, er det ikke nødvendigt at sætte det ind i en 
     <literal>array()</literal>, med mindre at elementet er et array i sig selv.
    </para>
    <para>
     De følgende eksempler ændre værdierne af <varname>$input</varname>
     på samme måde:
   <table>
    <title><function>array_splice</function> ligheder</title>
    <tgroup cols="2">
     <tbody>
      <row>
       <entry>
        array_push($input, $x, $y) 
       </entry>
       <entry>
        array_splice($input, count($input), 0, array($x, $y))
       </entry>
      </row>
      <row>
       <entry>
        array_pop($input) 
       </entry>
       <entry>
        array_splice($input, -1)
       </entry>
      </row>
      <row>
       <entry>
        array_shift($input)
       </entry>
       <entry>
        array_splice($input, 0, 1)
       </entry>
      </row>
      <row>
       <entry>
        array_unshift($input, $x, $y)
       </entry>
       <entry>
        array_splice($input, 0, 0, array($x, $y))
       </entry>
      </row>
      <row>
       <entry>
        $input[$x] = $y // til arrays hvor nøgler er det samme som forskydningen
       </entry>
       <entry>
        array_splice($input, $x, 1, $y)
       </entry>
      </row>
     </tbody>      
    </tgroup>
   </table>
    </para>
    <para>
     Returnerer et array som indeholder de fjernede elementer.
    </para>
    <para>
     <example>
      <title><function>array_splice</function> eksempler</title>
      <programlisting role="php">
<![CDATA[
<?php
$input = array("red", "green", "blue", "yellow");
array_splice($input, 2);
// $input er nu array("red", "green")

$input = array("red", "green", "blue", "yellow");
array_splice($input, 1, -1);
// $input er nu array("red", "yellow")

$input = array("red", "green", "blue", "yellow");
array_splice($input, 1, count($input), "orange");
// $input er nu array("red", "orange")

$input = array("red", "green", "blue", "yellow");
array_splice($input, -1, 1, array("black", "maroon"));
// $input er nu array("red", "green",
//          "blue", "black", "maroon")

$input = array("red", "green", "blue", "yellow");
array_splice($input, 3, 0, "purple");
// $input er nu array("red", "green",
//          "blue", "purple", "yellow");
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Se også <function>array_slice</function>, 
     <function>unset</function> og
     <function>array_merge</function>.
    </para>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

http://cvs.php.net/co.php/phpdoc-da/reference/array/functions/array-sum.xml?r=1.1&p=1
Index: phpdoc-da/reference/array/functions/array-sum.xml
+++ phpdoc-da/reference/array/functions/array-sum.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.10 Maintainer: lauer Status: ready -->
  <refentry id="function.array-sum">
   <refnamediv>
    <refname>array_sum</refname>
    <refpurpose>
     Beregner summenaf værdierne i et array
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beskrivelse</title>
     <methodsynopsis>
      <type>number</type><methodname>array_sum</methodname>
      <methodparam><type>array</type><parameter>array</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>array_sum</function> returnerer summen af værdierne i et array
     som enten et tal (integer) eller kommatal (float).
    </para>
    <para>
     <example>
      <title><function>array_sum</function> eksempel</title>
      <programlisting role="php">
<![CDATA[
<?php
$a = array(2, 4, 6, 8);
echo "sum(a) = " . array_sum($a) . "\n";

$b = array("a" => 1.2, "b" => 2.3, "c" => 3.4);
echo "sum(b) = " . array_sum($b) . "\n";
?>
]]>
      </programlisting>
      <para>
       Dette script vil udskrive følgende:
      </para>
      <screen>
<![CDATA[
sum(a) = 20
sum(b) = 6.9
]]>
      </screen>
     </example>
    </para>
    <note>
     <para>
      PHP versioner før 4.2.1 ændrede det angivende array og konverterede
      strenge til tal (hvilket ofte betød at de blev taget som nul, alt efter
      hvad deres værdi var).
     </para>
    </note>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->