mirror of
https://github.com/php/doc-tr.git
synced 2026-03-24 23:32:06 +01:00
458 lines
9.7 KiB
XML
458 lines
9.7 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
||
<!-- EN-Revision: d042804100d34f5389fe122b0e1cd41087fd94ba Maintainer: nilgun Status: ready -->
|
||
<refentry xml:id="function.array-map" xmlns="http://docbook.org/ns/docbook">
|
||
<refnamediv>
|
||
<refname>array_map</refname>
|
||
<refpurpose>Belirtilen dizilerin elemanlarına geriçağırım işlevini uygular
|
||
</refpurpose>
|
||
</refnamediv>
|
||
|
||
<refsect1 role="description">
|
||
&reftitle.description;
|
||
<methodsynopsis>
|
||
<type>array</type><methodname>array_map</methodname>
|
||
<methodparam><type class="union"><type>callable</type><type>null</type></type><parameter>işlev</parameter></methodparam>
|
||
<methodparam><type>array</type><parameter>dizi</parameter></methodparam>
|
||
<methodparam rep="repeat"><type>array</type><parameter>diziler</parameter></methodparam>
|
||
</methodsynopsis>
|
||
<para>
|
||
<function>array_map</function> işlevi belirtilen dizinin
|
||
(<parameter>diziler</parameter> ile daha fazla dizi belirtilmişse, onların
|
||
da) ilgili elemanlarının her birine <parameter>işlev</parameter> geri
|
||
çağırım işlevini uygulayıp sonucu bir dizi olarak döndürür. Geriçağırım
|
||
işlevinin değiştirge sayısı <function>array_map</function> işlevine
|
||
aktarılan değiştirge sayısını kabul edebilmelidir. Fazladan belirtilen
|
||
diziler yok sayılır. Değiştirge sayısı yetersizse
|
||
<classname>ArgumentCountError</classname> yavrulanır.
|
||
</para>
|
||
</refsect1>
|
||
|
||
<refsect1 role="parameters">
|
||
&reftitle.parameters;
|
||
<para>
|
||
<variablelist>
|
||
<varlistentry>
|
||
<term><parameter>işlev</parameter></term>
|
||
<listitem>
|
||
<para>
|
||
Her dizinin her elemanına uygulanacak <type>callable</type> türünde
|
||
geri çağırım işlevi.
|
||
</para>
|
||
<para>
|
||
Çok sayıda diziye bir zip işlemi uygulamak için
|
||
<parameter>işlev</parameter>'e değer olarak &null; aktarılabilir.
|
||
Sadece <parameter>dizi</parameter> sağlanmışsa,
|
||
<methodname>array_map</methodname> girilen diziyle döner.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><parameter>dizi</parameter></term>
|
||
<listitem>
|
||
<para>
|
||
Elemanları <parameter>işlev</parameter> tarafından işlenecek ilk dizi.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><parameter>diziler</parameter></term>
|
||
<listitem>
|
||
<para>
|
||
Elemanları <parameter>işlev</parameter> tarafından işlenecek diğer
|
||
dizilerin ek değişken listesi.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
</para>
|
||
</refsect1>
|
||
|
||
<refsect1 role="returnvalues">
|
||
&reftitle.returnvalues;
|
||
<para>
|
||
<function>array_map</function> işlevi belirtilen dizinin
|
||
(<parameter>diziler</parameter> ile daha fazla dizi belirtilmişse, onların
|
||
da) ilgili elemanlarının her birine <parameter>işlev</parameter> geri çağırım
|
||
işlevini uygulayıp sonucu bir dizi olarak döndürür.
|
||
</para>
|
||
<para>
|
||
Döndürülen dizi, yalnız ve yalnız tek bir dizi aktarılırsa, dizi
|
||
değiştirgesinin anahtarlarını korur. Birden fazla dizi aktarılırsa,
|
||
döndürülen dizi sıralı tamsayı anahtarlara sahip olacaktır.
|
||
</para>
|
||
</refsect1>
|
||
|
||
<refsect1 role="examples">
|
||
&reftitle.examples;
|
||
<para>
|
||
<example>
|
||
<title>- <function>array_map</function> örneği</title>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
function cube($n)
|
||
{
|
||
return ($n * $n * $n);
|
||
}
|
||
|
||
$a = [1, 2, 3, 4, 5];
|
||
$b = array_map('cube', $a);
|
||
print_r($b);
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
<para>
|
||
<varname>$b</varname> şöyle olur:
|
||
</para>
|
||
<screen>
|
||
<![CDATA[
|
||
Array
|
||
(
|
||
[0] => 1
|
||
[1] => 8
|
||
[2] => 27
|
||
[3] => 64
|
||
[4] => 125
|
||
)
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
<para>
|
||
<example>
|
||
<title>- Lamda işlevi kullanan <function>array_map</function> örneği
|
||
</title>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
$func = function(int $deger): int {
|
||
return $deger * 2;
|
||
};
|
||
|
||
print_r(array_map($func, range(1, 5)));
|
||
|
||
// Veya PHP 7.4.0 ve sonrasında:
|
||
|
||
print_r(array_map(fn($value): int => $value * 2, range(1, 5)));
|
||
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
<screen>
|
||
<![CDATA[
|
||
Array
|
||
(
|
||
[0] => 2
|
||
[1] => 4
|
||
[2] => 6
|
||
[3] => 8
|
||
[4] => 10
|
||
)
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
<para>
|
||
<example>
|
||
<title>- Birden fazla diziyle <function>array_map</function> örneği</title>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
function show_Spanish(int $n, string $m): string
|
||
{
|
||
return("İspanyolcada {$n} sayısının ismi: {$m}");
|
||
}
|
||
|
||
function map_Spanish(int $n, string $m): array
|
||
{
|
||
return [$n => $m];
|
||
}
|
||
|
||
$a = [1, 2, 3, 4, 5];
|
||
$b = ['uno', 'dos', 'tres', 'cuatro', 'cinco'];
|
||
|
||
$c = array_map('show_Spanish', $a, $b);
|
||
print_r($c);
|
||
|
||
$d = array_map('map_Spanish', $a , $b);
|
||
print_r($d);
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs;
|
||
<screen>
|
||
<![CDATA[
|
||
// $c çıktısı
|
||
Array
|
||
(
|
||
[0] => İspanyolcada 1 sayısının ismi: uno
|
||
[1] => İspanyolcada 2 sayısının ismi: dos
|
||
[2] => İspanyolcada 3 sayısının ismi: tres
|
||
[3] => İspanyolcada 4 sayısının ismi: cuatro
|
||
[4] => İspanyolcada 5 sayısının ismi: cinco
|
||
)
|
||
|
||
// $d çıktısı
|
||
Array
|
||
(
|
||
[0] => Array
|
||
(
|
||
[1] => uno
|
||
)
|
||
|
||
[1] => Array
|
||
(
|
||
[2] => dos
|
||
)
|
||
|
||
[2] => Array
|
||
(
|
||
[3] => tres
|
||
)
|
||
|
||
[3] => Array
|
||
(
|
||
[4] => cuatro
|
||
)
|
||
|
||
[4] => Array
|
||
(
|
||
[5] => cinco
|
||
)
|
||
|
||
)
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
<para>
|
||
İki veya daha fazla sayıda dizi kullanırken işlev elemanlara karşılıklı
|
||
uygulanacağından normal olarak dizilerin eleman sayılarının eşit olması
|
||
gerekir. Eğer bu eşitlik yoksa, kısa olanlar boş elemanlar eklenerek en
|
||
uzun olanın boyuna eşitlenir
|
||
</para>
|
||
<para>
|
||
Bu işlevin ilginç bir kullanımı da, geriçağırım işlevi ismi olarak &null;
|
||
belirterek bir diziler dizisi oluşturmaktır.
|
||
</para>
|
||
<para>
|
||
<example>
|
||
<title>- Dizileri ziplemek</title>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
$a = [1, 2, 3, 4, 5];
|
||
$b = ['one', 'two', 'three', 'four', 'five'];
|
||
$c = ['uno', 'dos', 'tres', 'cuatro', 'cinco'];
|
||
|
||
$d = array_map(null, $a, $b, $c);
|
||
print_r($d);
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs;
|
||
<screen>
|
||
<![CDATA[
|
||
Array
|
||
(
|
||
[0] => Array
|
||
(
|
||
[0] => 1
|
||
[1] => one
|
||
[2] => bir
|
||
)
|
||
|
||
[1] => Array
|
||
(
|
||
[0] => 2
|
||
[1] => two
|
||
[2] => iki
|
||
)
|
||
|
||
[2] => Array
|
||
(
|
||
[0] => 3
|
||
[1] => three
|
||
[2] => üç
|
||
)
|
||
|
||
[3] => Array
|
||
(
|
||
[0] => 4
|
||
[1] => four
|
||
[2] => dört
|
||
)
|
||
|
||
[4] => Array
|
||
(
|
||
[0] => 5
|
||
[1] => five
|
||
[2] => beş
|
||
)
|
||
|
||
)
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
<para>
|
||
<example>
|
||
<title>- Tek <parameter>dizi</parameter> ile
|
||
&null; <parameter>işlev</parameter>
|
||
|
||
</title>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
$array = [1, 2, 3];
|
||
var_dump(array_map(null, $array));
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs;
|
||
<screen>
|
||
<![CDATA[
|
||
array(3) {
|
||
[0]=>
|
||
int(1)
|
||
[1]=>
|
||
int(2)
|
||
[2]=>
|
||
int(3)
|
||
}
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
<para>
|
||
<example>
|
||
<title>- Dizgesel anahtarlarla <function>array_map</function> örneği
|
||
</title>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
$arr = ['anahtar' => 'değer'];
|
||
function cb1($a) {
|
||
return [$a];
|
||
}
|
||
function cb2($a, $b) {
|
||
return [$a, $b];
|
||
}
|
||
var_dump(array_map('cb1', $arr));
|
||
var_dump(array_map('cb2', $arr, $arr));
|
||
var_dump(array_map(null, $arr));
|
||
var_dump(array_map(null, $arr, $arr));
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs;
|
||
<screen>
|
||
<![CDATA[
|
||
array(1) {
|
||
["anahtar"]=>
|
||
array(1) {
|
||
[0]=>
|
||
string(5) "deger"
|
||
}
|
||
}
|
||
array(1) {
|
||
[0]=>
|
||
array(2) {
|
||
[0]=>
|
||
string(5) "deger"
|
||
[1]=>
|
||
string(5) "deger"
|
||
}
|
||
}
|
||
array(1) {
|
||
["stringkey"]=>
|
||
string(5) "deger"
|
||
}
|
||
array(1) {
|
||
[0]=>
|
||
array(2) {
|
||
[0]=>
|
||
string(5) "deger"
|
||
[1]=>
|
||
string(5) "deger"
|
||
}
|
||
}
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
<example>
|
||
<title>- <function>array_map</function> ve ilişkisel diziler</title>
|
||
<para>
|
||
<function>array_map</function> dizi anahtarlarının doğrudan girdi olarak
|
||
kullanımını desteklemese de <function>array_keys</function> kullanılarak
|
||
bu yapılabilir.
|
||
</para>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
$arr = [
|
||
'v1' => 'ilk sürüm',
|
||
'v2' => 'ikinci sürüm',
|
||
'v3' => 'üçüncü sürüm',
|
||
];
|
||
|
||
// Bilgi: 7.4.0 öncesinde, anonim işlevler için bunun yerine uzun
|
||
// sözdizimi kullanılırdı.
|
||
$callback = fn(string $k, string $v): string => "$k $v idi";
|
||
|
||
$result = array_map($callback, array_keys($arr), array_values($arr));
|
||
|
||
var_dump($result);
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs;
|
||
<screen>
|
||
<![CDATA[
|
||
array(3) {
|
||
[0]=>
|
||
string(24) "v1 ilk sürüm idi"
|
||
[1]=>
|
||
string(25) "v2 ikinci sürüm idi"
|
||
[2]=>
|
||
string(24) "v3 üçüncü sürüm idi"
|
||
}
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
</refsect1>
|
||
|
||
<refsect1 role="seealso">
|
||
&reftitle.seealso;
|
||
<para>
|
||
<simplelist>
|
||
<member><function>array_filter</function></member>
|
||
<member><function>array_reduce</function></member>
|
||
<member><function>array_walk</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
|
||
-->
|