<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<!-- EN-Revision: 56509d07ae636f076057f55bbb2572ab7b7a39eb Maintainer: cmb Status: ready -->

<refentry xml:id="function.array-udiff" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>array_udiff</refname>

<refpurpose>

Ermittelt den Unterschied zwischen Arrays mittels einer Callbackfunktion für

den Datenvergleich

</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>array</type><methodname>array_udiff</methodname>

<methodparam><type>array</type><parameter>array</parameter></methodparam>

<methodparam rep="repeat"><type>array</type><parameter>arrays</parameter></methodparam>

<methodparam><type>callable</type><parameter>value_compare_func</parameter></methodparam>

</methodsynopsis>

<para>

Ermittelt den Unterschied zwischen Arrays mittels einer Callbackfunktion für

den Datenvergleich. Dies ist anders als bei <function>array_diff</function>,

das eine interne Funktion zum Vergleichen der Daten verwendet.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>array</parameter></term>

<listitem>

<para>

Das erste Array.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>arrays</parameter></term>

<listitem>

<para>

Arrays zum Vergleichen.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>value_compare_func</parameter></term>

<listitem>

&sort.callback.description;

&sort.callback.description.presort;

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Gibt ein Array zurück, das alle Werte von <parameter>array</parameter>

enthält, die nicht in einem der anderen Argumente vorhanden sind.

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title><function>array_udiff</function> Beispiel mit stdClass Objekten</title>

<programlisting role="php">

<![CDATA[

<?php

// Die zu vergleichenden Arrays

$array1 = array(new stdClass, new stdClass,

new stdClass, new stdClass,

);

$array2 = array(

new stdClass, new stdClass,

);

// Setze einige Eigenschaften für jedes Objekt

$array1[0]->width = 11; $array1[0]->height = 3;

$array1[1]->width = 7; $array1[1]->height = 1;

$array1[2]->width = 2; $array1[2]->height = 9;

$array1[3]->width = 5; $array1[3]->height = 7;

$array2[0]->width = 7; $array2[0]->height = 5;

$array2[1]->width = 9; $array2[1]->height = 2;

function compare_by_area($a, $b) {

$areaA = $a->width * $a->height;

$areaB = $b->width * $b->height;

if ($areaA < $areaB) {

return -1;

} elseif ($areaA > $areaB) {

return 1;

} else {

return 0;

}

}

print_r(array_udiff($array1, $array2, 'compare_by_area'));

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Array

(

[0] => stdClass Object

(

[width] => 11

[height] => 3

)

[1] => stdClass Object

(

[width] => 7

[height] => 1

)

)

]]>

</screen>

</example>

</para>

<para>

<example>

<title><function>array_udiff</function> Beispiel mit DateTime Objekten</title>

<programlisting role="php">

<![CDATA[

<?php

class MyCalendar {

public $free = array();

public $booked = array();

public function __construct($week = 'now') {

$start = new DateTime($week);

$start->modify('Monday this week midnight');

$end = clone $start;

$end->modify('Friday this week midnight');

$interval = new DateInterval('P1D');

foreach (new DatePeriod($start, $interval, $end) as $freeTime) {

$this->free[] = $freeTime;

}

}

public function bookAppointment(DateTime $date, $note) {

$this->booked[] = array('date' => $date->modify('midnight'), 'note' => $note);

}

public function checkAvailability() {

return array_udiff($this->free, $this->booked, array($this, 'customCompare'));

}

public function customCompare($free, $booked) {

if (is_array($free)) $a = $free['date'];

else $a = $free;

if (is_array($booked)) $b = $booked['date'];

else $b = $booked;

if ($a == $b) {

return 0;

} elseif ($a > $b) {

return 1;

} else {

return -1;

}

}

}

// Erzeuge einen Kalender für wöchentliche Termine

$myCalendar = new MyCalendar;

// Buche einige Termine für diese Woche

$myCalendar->bookAppointment(new DateTime('Monday this week'), "GoogleGuys Wohnung reinigen.");

$myCalendar->bookAppointment(new DateTime('Wednesday this week'), "Snowboard fahren gehen.");

$myCalendar->bookAppointment(new DateTime('Friday this week'), "Fehlerhaften Code beheben.");

// Prüfe die Verfügbarkeit von Tagen durch Vergleichen von $booked Daten mit $free Daten

echo "Ich bin an den folgenden Tagen dieser Woche verfügbar...\n\n";

foreach ($myCalendar->checkAvailability() as $free) {

echo $free->format('l'), "\n";

}

echo "\n\n";

echo "Ich bin an den folgenden Tagen dieser Woche beschäftigt...\n\n";

foreach ($myCalendar->booked as $booked) {

echo $booked['date']->format('l'), ": ", $booked['note'], "\n";

}

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Ich bin an den folgenden Tagen dieser Woche verfügbar...

Tuesday

Thursday

Ich bin an den folgenden Tagen dieser Woche beschäftigt...

Monday: GoogleGuys Wohnung reinigen.

Wednesday: Snowboard fahren gehen.

Friday: Fehlerhaften Code beheben.

]]>

</screen>

</example>

</para>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

<note>

<simpara>

Bitte beachten Sie, dass diese Funktion nur eine Dimension eines

n-dimensionalen Arrays überprüft. Natürlich können Sie tiefere Dimensionen

prüfen, indem Sie

<literal>array_udiff($array1[0], $array2[0], "data_compare_func");</literal>

verwenden.

</simpara>

</note>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>array_diff</function></member>

<member><function>array_diff_assoc</function></member>

<member><function>array_diff_uassoc</function></member>

<member><function>array_udiff_assoc</function></member>

<member><function>array_udiff_uassoc</function></member>

<member><function>array_intersect</function></member>

<member><function>array_intersect_assoc</function></member>

<member><function>array_uintersect</function></member>

<member><function>array_uintersect_assoc</function></member>

<member><function>array_uintersect_uassoc</function></member>

</simplelist>

</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:"~/.phpdoc/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

-->