sscanf.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4225e50bc391ddba99e367c231463da0dc04357d Maintainer: nilgun Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sscanf" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>sscanf</refname>
  <refpurpose>Girdi dizgesini belli bir biçeme göre yorumlar</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>array</type><type>int</type><type>null</type></type><methodname>sscanf</methodname>
   <methodparam><type>string</type><parameter>dizge</parameter></methodparam>
   <methodparam><type>string</type><parameter>biçem</parameter></methodparam>
   <methodparam rep="repeat"><type>mixed</type><parameter role="reference">değişkenler</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>sscanf</function> işlevi, <function>printf</function> işlevinin
   tersine çıktıyı biçemlemek yerine girdiyi bir biçeme göre çözümler.
   <function>sscanf</function> belirtilen <parameter>dizge</parameter>
   dizgesini okur ve <parameter>biçem</parameter> dizgesine göre bu dizgeyi
   yorumlar.
  </para>
  <para>
   Biçem dizgesindeki herhangi bir boşluk karakteri girdi dizgesindeki
   herhangi bir boşluk karakteriyle eşleşir. Yani, biçem dizgesindeki bir
   sekme karakteri (<literal>\t</literal>) girdi dizgesindeki tek bir boşluk
   karakteri ile eşleşebilir.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>dizge</parameter></term>
     <listitem>
      <para>
       Yorumlanacak dizge.
      </para>
     </listitem>
    </varlistentry>
    &strings.scanf.parameter.format;
    <varlistentry>
     <term><parameter>değişkenler</parameter></term>
     <listitem>
      <para>
       Çözümlenen değerleri içermek üzere aktarımı isteğe
       bağlı gönderimli değişkenler.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   İşleve sadece iki bağımsız değişken aktarılmışsa, çözümlenen değerler bir dizi
   içinde döndürülür. İsteğe bağlı bağımsız değişkenler belirtilmişse işlev bu
   bağımsız değişkenlere atanan değer sayısını döndürür. İsteğe bağlı bağımsız değişkenlerin
   gönderimli olarak aktarılmaları gerekir.
  </para>
  <para>
   <parameter>biçem</parameter>, <parameter>dizge</parameter> içinde bulunandan
   daha fazla alt dizge bekliyorsa, &null; döndürülür.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>- <function>sscanf</function> örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
// Seri numarasını döndürelim
list($serial) = sscanf("SN/2350001", "SN/%d");
// üretim tarihini de döndürelim
$mandate = "January 01 2000";
list($month, $day, $year) = sscanf($mandate, "%s %d %d");
echo "$serial numaralı mal şu tarihte üretildi: $year-" .
      substr($month, 0, 3) . "-$day\n";
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   İşleve isteğe bağlı bağımsız değişkenler belirtilmişse işlev bu
   bağımsız değişkenlere atanan değer sayısını döndürür.
  </para>
  <para>
   <example>
    <title>- Seçimlik bağımsız değişkenlerle <function>sscanf</function>
    kullanımı</title>
    <programlisting role="php">
<![CDATA[
<?php
// Yazar bilgisiyle bir DocBook girdisi üretelim
$auth = "24\tLewis Carroll";
$n = sscanf($auth, "%d\t%s %s", $id, $first, $last);
echo "<author id='$id'>
    <firstname>$first</firstname>
    <surname>$last</surname>
</author>\n";
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>printf</function></member>
    <member><function>sprintf</function></member>
    <member><function>fprintf</function></member>
    <member><function>vprintf</function></member>
    <member><function>vsprintf</function></member>
    <member><function>vfprintf</function></member>
    <member><function>fscanf</function></member>
    <member><function>number_format</function></member>
    <member><function>date</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
-->