mirror of
https://github.com/php/doc-tr.git
synced 2026-04-24 23:48:18 +02:00
Nilgün Belma Bugüner
328 lines
8.5 KiB
XML
328 lines
8.5 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
||
<!-- EN-Revision: 4d02fe98ddc684a0d82a3921ef189a71b98f4f04 Maintainer: nilgun Status: ready -->
|
||
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.getopt">
|
||
<refnamediv>
|
||
<refname>getopt</refname>
|
||
<refpurpose>Komut satırı bağımsız değişkenleri listesinden seçenekleri döndürür
|
||
</refpurpose>
|
||
</refnamediv>
|
||
|
||
<refsect1 role="description">
|
||
&reftitle.description;
|
||
<methodsynopsis>
|
||
<type class="union"><type>array</type><type>false</type></type><methodname>getopt</methodname>
|
||
<methodparam><type>string</type><parameter>kısa_seçenekler</parameter></methodparam>
|
||
<methodparam choice="opt"><type>array</type><parameter>uzun_seçenekler</parameter><initializer>[]</initializer></methodparam>
|
||
<methodparam choice="opt"><type>int</type><parameter role="reference">kalan_indisi</parameter><initializer>&null;</initializer></methodparam>
|
||
</methodsynopsis>
|
||
<para>
|
||
Betiğe aktarılan seçenekleri çözümler.
|
||
</para>
|
||
</refsect1>
|
||
|
||
<refsect1 role="parameters">
|
||
&reftitle.parameters;
|
||
<para>
|
||
<variablelist>
|
||
<varlistentry>
|
||
<term><parameter>kısa_seçenekler</parameter></term>
|
||
<listitem>
|
||
<simpara>
|
||
Bir dizge olup, dizgenin her karakteri bir seçenek karakteri olarak
|
||
kullanılır ve bu karakterlerle eşleşen seçenekler önlerine birer tire
|
||
imi (<literal>-</literal>) konarak betik çalıştırılırken komut
|
||
satırından belirtilebilir.
|
||
</simpara>
|
||
<simpara>
|
||
Örneğin, <literal>"x"</literal> seçenek dizgesi <literal>-x</literal>
|
||
seçeneğinin tanınmasını sağlar.
|
||
</simpara>
|
||
<simpara>
|
||
Sadece a-z, A-Z ve 0-9 karakterlerine izin verilir.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><parameter>uzun_seçenekler</parameter></term>
|
||
<listitem>
|
||
<simpara>
|
||
Bir dizi olup, dizinin her elemanı bir seçenek dizgesi olarak
|
||
kullanılır ve bu dizgelerle eşleşen seçenekler önlerine birer çift tire
|
||
imi (<literal>--</literal>) konarak betik çalıştırılırken komut
|
||
satırından belirtilebilir.
|
||
</simpara>
|
||
<simpara>
|
||
Örneğin, <literal>"opt"</literal> elemanı <literal>--opt</literal>
|
||
seçeneğinin tanınmasını sağlar.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><parameter>kalan_indisi</parameter></term>
|
||
<listitem>
|
||
<simpara>
|
||
<parameter>kalan_indisi</parameter> bağımsız değişkeni belirtilmişse,
|
||
bağımsız değişken çözümlemesinin durduğu indis bu değişkene yazılacaktır.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
</para>
|
||
<para>
|
||
<parameter>kısa_seçenekler</parameter> bağımsız değişkeni şu bileşenleri
|
||
içerebilir:
|
||
<simplelist>
|
||
<member>Tek tek karakterler (değerler kabul edilmez)</member>
|
||
<member>Ardına tek bir iki nokta imi konmuş karakterler (bağımsız değişkenin
|
||
değer gerektirdiğini belirtir)</member>
|
||
<member>Ardına bir çift iki nokta imi konmuş karakterler (bağımsız değişkenin
|
||
isteğe bağlı değer kabul ettiğini belirtir)</member>
|
||
</simplelist>
|
||
Seçenek değerleri dizgeden sonraki ilk bağımsız değişkendir. Bir değer gerekliyse
|
||
değerin sonunda boşluk bulunup bulunmadığına bakılmaz.
|
||
<note>
|
||
<simpara>
|
||
İsteğe bağlı değerler bir ayraç olarak <literal>" "</literal> (boşluk)
|
||
kabul etmezler.
|
||
</simpara>
|
||
</note>
|
||
</para>
|
||
<para>
|
||
<parameter>uzun_seçenekler</parameter> dizisinin içerebileceği değerler:
|
||
<simplelist>
|
||
<member>Sizge (bağımsız değişken değer kabul etmez)</member>
|
||
<member>Ardına tek bir iki nokta imi konmuş dizge (bağımsız değişken değer
|
||
gerektirir)</member>
|
||
<member>Ardına bir çift iki nokta imi konmuş dizge
|
||
(seçimlik değer)</member>
|
||
</simplelist>
|
||
</para>
|
||
<note>
|
||
<para>
|
||
<parameter>kısa_seçenekler</parameter> ve
|
||
<parameter>uzun_seçenekler</parameter> için biçem hemen hemen aynıdır. Tek
|
||
fark, birincisinin bir dizge (her karakter bir seçenek) ikincisinin bir
|
||
dizi (her eleman bir seçenek) almasıdır.
|
||
</para>
|
||
</note>
|
||
</refsect1>
|
||
|
||
<refsect1 role="returnvalues">
|
||
&reftitle.returnvalues;
|
||
<para>
|
||
Bağımsız değişken çiftlerini içeren bir dizi,&return.falseforfailure;.
|
||
</para>
|
||
<note>
|
||
<para>
|
||
Seçeneklerin çözümlenmesi seçenek olmayan ilk değerde durur, kalan herşey
|
||
yok sayılır.
|
||
</para>
|
||
</note>
|
||
</refsect1>
|
||
|
||
<refsect1 role="changelog">
|
||
&reftitle.changelog;
|
||
<para>
|
||
<informaltable>
|
||
<tgroup cols="2">
|
||
<thead>
|
||
<row>
|
||
<entry>&Version;</entry>
|
||
<entry>&Description;</entry>
|
||
</row>
|
||
</thead>
|
||
<tbody>
|
||
<row>
|
||
<entry>7.1.0</entry>
|
||
<entry>
|
||
<parameter>kalan_indisi</parameter> bağımsız değişkeni eklendi.
|
||
</entry>
|
||
</row>
|
||
</tbody>
|
||
</tgroup>
|
||
</informaltable>
|
||
</para>
|
||
</refsect1>
|
||
|
||
<refsect1 role="examples">
|
||
&reftitle.examples;
|
||
<para>
|
||
<example xml:id="getopt.examples-1">
|
||
<title>- <function>getopt</function> örneği - temeller</title>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
// Betik: example.php
|
||
$options = getopt("f:hp:");
|
||
var_dump($options);
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
<programlisting role="shell">
|
||
<![CDATA[
|
||
shell> php example.php -fdeğer -h
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs;
|
||
<screen>
|
||
<![CDATA[
|
||
array(2) {
|
||
["f"]=>
|
||
string(5) "değer"
|
||
["h"]=>
|
||
bool(false)
|
||
}
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
<para>
|
||
<example xml:id="getopt.examples-2">
|
||
<title>- <function>getopt</function> ve uzun seçenekler</title>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
// Betik: betik.php
|
||
$kısalar = "";
|
||
$kısalar .= "f:"; // Değer, zorunlu
|
||
$kısalar .= "v::"; // Değer, seçimlik
|
||
$kısalar .= "abc"; // Bunlar değer kabul etmez
|
||
|
||
$uzunlar = array(
|
||
"gerekli:", // Değer, zorunlu
|
||
"seçimlik::", // Değer, seçimlik
|
||
"seçenek", // Değer kabul etmez
|
||
"sçnk", // Değer kabul etmez
|
||
);
|
||
$seçenekler = getopt($kısalar, $uzunlar);
|
||
var_dump($seçenekler);
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
<programlisting role="shell">
|
||
<![CDATA[
|
||
shell> php betik.php -f "f değeri" -v -a --gerekli değer --seçimlik="seçimlik değer" --seçenek
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs;
|
||
<screen>
|
||
<![CDATA[
|
||
array(6) {
|
||
["f"]=>
|
||
string(9) "f değeri"
|
||
["v"]=>
|
||
bool(false)
|
||
["a"]=>
|
||
bool(false)
|
||
["gerekli"]=>
|
||
string(6) "değer"
|
||
["seçimlik"]=>
|
||
string(16) "seçimlik değer"
|
||
["seçenek"]=>
|
||
bool(false)
|
||
}
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
<para>
|
||
<example xml:id="getopt.examples-3">
|
||
<title>- <function>getopt</function> ve çoklu-tek seçenek</title>
|
||
<para>Çok sayıda seçeneğin tek bir seçenek olarak verilmesi:</para>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
// Betik: betik.php
|
||
$options = getopt("abc");
|
||
var_dump($options);
|
||
?>
|
||
]]>
|
||
</programlisting><programlisting role="shell">
|
||
<![CDATA[
|
||
shell> php betik.php -aaac
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs;
|
||
<screen>
|
||
<![CDATA[
|
||
array(2) {
|
||
["a"]=>
|
||
array(3) {
|
||
[0]=>
|
||
bool(false)
|
||
[1]=>
|
||
bool(false)
|
||
[2]=>
|
||
bool(false)
|
||
}
|
||
["c"]=>
|
||
bool(false)
|
||
}
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
<para>
|
||
<example xml:id="getopt.examples-4">
|
||
<title><function>getopt</function> ve <parameter>kalan_indisi</parameter>
|
||
kullanımı</title>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
// Betik: example.php
|
||
$rest_index = null;
|
||
$opts = getopt('a:b:', [], $rest_index);
|
||
$pos_args = array_slice($argv, $rest_index);
|
||
var_dump($pos_args);
|
||
]]>
|
||
</programlisting>
|
||
<programlisting role="shell">
|
||
<![CDATA[
|
||
shell> php example.php -a 1 -b 2 -- test
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs;
|
||
<screen>
|
||
<![CDATA[
|
||
array(1) {
|
||
[0]=>
|
||
string(4) "test"
|
||
}
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
</refsect1>
|
||
|
||
<refsect1 role="seealso">
|
||
&reftitle.seealso;
|
||
<para>
|
||
<simplelist>
|
||
<member><link linkend="reserved.variables.argv"><varname>$argv</varname></link></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
|
||
-->
|