1
0
mirror of https://github.com/php/doc-tr.git synced 2026-03-24 07:12:18 +01:00
Files
2024-09-09 18:25:17 +03:00

299 lines
9.4 KiB
XML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 647d5c50e3b6c103a3efdb578fd227f8b923399d Maintainer: nilgun Status: ready -->
<refentry xml:id="function.range" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>range</refname>
<refpurpose>Belli bir eleman aralığını içeren bir dizi oluşturur</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>range</methodname>
<methodparam><type class="union"><type>string</type><type>int</type><type>float</type></type><parameter>başlangıç</parameter></methodparam>
<methodparam><type class="union"><type>string</type><type>int</type><type>float</type></type><parameter>bitiş</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>float</type></type><parameter>adım</parameter><initializer>1</initializer></methodparam>
</methodsynopsis>
<para>
Aralığı belirtilen elemanları içeren bir dizi oluşturur.
</para>
<para>
<parameter>başlangıç</parameter> ve <parameter>bitiş</parameter> birer
<type>string</type> ve <parameter>adım</parameter> bir <type>int</type>
değer ise üretilen dizi baytlardan oluşur. Aksi takdirde sayılardan oluşur.
</para>
<para>
<parameter>başlangıç</parameter> küçük veya eşit
<parameter>bitiş</parameter> ise dizi artan sıradadır.
Aksi takdirde azalan sıradadır.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>başlangıç</parameter></term>
<listitem>
<para>
Aralığın ilk değeri.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>bitiş</parameter></term>
<listitem>
<para>
Aralığın olası son değeri.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>adım</parameter></term>
<listitem>
<para>
Üretilen dizinin, dizinin değerleri arasında ne kadar ilerlediğini
gösterir.
</para>
<para>
<parameter>adım</parameter> negatif ise dizi azalan sırada olur.
</para>
<para>
<parameter>adım</parameter> ondalık parçası olayan bir
<type>float</type> değer ise <type>int</type> olarak yorumlanır.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Değerleri arasında <parameter>adım</parameter> fark olan
<parameter>başlangıç</parameter> ve <parameter>bitiş</parameter> dahil
ikisi arasındaki elemanlardan oluşan bir dizi döner.
</para>
<para>
Döndürülen dizinin son elemanı, <parameter>adım</parameter> değerine bağlı
olarak <parameter>bitiş</parameter> veya dizinin bir önceki elemanıdır.
</para>
<para>
<parameter>başlangıç</parameter> ve <parameter>bitiş</parameter> birer
<type>string</type> ve <parameter>adım</parameter> bir <type>int</type>
değer ise üretilen dizi baytlardan oluşur. Bunlar genel olarak
<abbrev>ASCII</abbrev> karakterlerdir.
</para>
<para>
<parameter>başlangıç</parameter>, <parameter>bitiş</parameter>,
ve <parameter>adım</parameter> değerlerinden en az birinin
<type>float</type> olması durumunda dizi <type>float</type> değerler içerir.
</para>
<para>
Aksi takdirde, dizi <type>int</type> değerler içerir.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<itemizedlist>
<listitem>
<simpara>
<parameter>adım</parameter> <literal>0</literal> ise,
<classname>ValueError</classname> oluşur.
</simpara>
</listitem>
<listitem>
<simpara>
<parameter>başlangıç</parameter>, <parameter>bitiş</parameter>,
veya <parameter>adım</parameter> <function>is_finite</function> değilse,
<classname>ValueError</classname> oluşur.
</simpara>
</listitem>
<listitem>
<simpara>
<parameter>adım</parameter> negatif ise ancak üretilen dizi artansa,
(örn, <code>$başlangıç &lt;= $bitiş</code>),
<classname>ValueError</classname> oluşur.
</simpara>
</listitem>
<listitem>
<simpara>
<parameter>başlangıç</parameter> veya <parameter>bitiş</parameter>
boş dige <literal>''</literal> ise, bir <constant>E_WARNING</constant>
yayımlanır ve boş dizge <literal>0</literal> olarak yorumlanır.
</simpara>
</listitem>
<listitem>
<simpara>
<parameter>başlangıç</parameter> veya <parameter>bitiş</parameter>
birden fazla baytı olan
<link linkend="language.types.numeric-strings">sayısal</link> olmayan
bir dizge ise bir <constant>E_WARNING</constant> yayımlanır.
</simpara>
</listitem>
<listitem>
<simpara>
<parameter>başlangıç</parameter> veya <parameter>bitiş</parameter> diğer
sınır değeri bir sayı olduğundan dolaylı olarak <type>int</type> türüne
dönüştürülen bir dizge ise bir <constant>E_WARNING</constant> yayımlanır.
</simpara>
</listitem>
<listitem>
<simpara>
<parameter>adım</parameter> <type>float</type> türünde ve
<parameter>başlangıç</parameter> ve <parameter>bitiş</parameter>
<link linkend="language.types.numeric-strings">sayısal</link> olmayan
bir dizge ise bir <constant>E_WARNING</constant> yayımlanır.
</simpara>
</listitem>
</itemizedlist>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
<parameter>başlangıç</parameter> ve <parameter>bitiş</parameter> ikisi
de dizge ise <function>range</function> işlevi artık daima bayt dizisi
üretiyor. Evvelce bunlaran biri sayısal bir dizge ise diğeri örtük
olarak <type>int</type> türüne dönüştürülürdü.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
<parameter>başlangıç</parameter> veya <parameter>bitiş</parameter>
değerlerinin birinin bir sayı olmasından dolayı dizge olanının örtük
olarak <type>int</type> türüne dönüştürülmesi artık bir
<constant>E_WARNING</constant> yayınlamasına sebep oluyor.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
<parameter>başlangıç</parameter> veya <parameter>bitiş</parameter>
birden fazla bayt içeren sayısal olmayan bir dizge ise artık bir
<constant>E_WARNING</constant> yayınlanıyor.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
<parameter>başlangıç</parameter> veya <parameter>bitiş</parameter>
boş dizge ise artık bir <constant>E_WARNING</constant> yayınlanıyor.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
<parameter>adım</parameter> ondalık kısmı olmayan bir <type>float</type>
değer içeriyorsa artık bir <type>int</type> olarak yorumlanıyor.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
Artan dizi üretilirken <parameter>adım</parameter> negatifse artık
<classname>ValueError</classname> oluşuyor.
range.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
<parameter>adım</parameter> sonlu değilse artık
<classname>ValueError</classname> oluşuyor.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
<parameter>başlangıç</parameter> veya <parameter>bitiş</parameter>
değeri <type>array</type>, <type>object</type> veya
<type>resource</type> türündeyse artık <classname>TypeError</classname>
oluşuyor. Evvelce örtük olarak <type>int</type> değere dönüştürülürdü.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>- <function>range</function> örnekleri</title>
<programlisting role="php">
<![CDATA[
<?php
echo implode(', ', range(0, 12)), PHP_EOL;
echo implode(', ', range(0, 100, 10)), PHP_EOL;
echo implode(', ', range('a', 'i')), PHP_EOL;
echo implode(', ', range('c', 'a')), PHP_EOL;
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12
0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100
a, b, c, d, e, f, g, h, i
c, b, a
A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, [, \, ], ^, _, `, a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>shuffle</function></member>
<member><function>array_fill</function></member>
<member>&foreach;</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
-->