<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.sodium.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'function.sodium-crypto-secretstream-xchacha20poly1305-pull.php',
    1 => 'sodium_crypto_secretstream_xchacha20poly1305_pull',
    2 => 'Расшифровывает часть данных из зашифрованного потока',
  ),
  'up' => 
  array (
    0 => 'ref.sodium.php',
    1 => 'Функции Sodium',
  ),
  'prev' => 
  array (
    0 => 'function.sodium-crypto-secretstream-xchacha20poly1305-keygen.php',
    1 => 'sodium_crypto_secretstream_xchacha20poly1305_keygen',
  ),
  'next' => 
  array (
    0 => 'function.sodium-crypto-secretstream-xchacha20poly1305-push.php',
    1 => 'sodium_crypto_secretstream_xchacha20poly1305_push',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/sodium/functions/sodium-crypto-secretstream-xchacha20poly1305-pull.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.sodium-crypto-secretstream-xchacha20poly1305-pull" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">sodium_crypto_secretstream_xchacha20poly1305_pull</h1>
  <p class="verinfo">(PHP 7 &gt;= 7.2.0, PHP 8)</p><p class="refpurpose"><span class="refname">sodium_crypto_secretstream_xchacha20poly1305_pull</span> &mdash; <span class="dc-title">Расшифровывает часть данных из зашифрованного потока</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.sodium-crypto-secretstream-xchacha20poly1305-pull-description">
  <h3 class="title">Описание</h3>
  <div class="methodsynopsis dc-description"><span class="methodname"><strong>sodium_crypto_secretstream_xchacha20poly1305_pull</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter reference">&$state</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$ciphertext</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$additional_data</code><span class="initializer"> = &quot;&quot;</span></span>): <span class="type"><span class="type"><a href="language.types.array.php" class="type array">array</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>

  <p class="simpara">
   Расшифровывает часть данных из зашифрованного потока.
  </p>

 </div>


 <div class="refsect1 parameters" id="refsect1-function.sodium-crypto-secretstream-xchacha20poly1305-pull-parameters">
  <h3 class="title">Список параметров</h3>
  <dl>
   
    <dt><code class="parameter">state</code></dt>
    <dd>
     <span class="simpara">
      Смотрите <span class="function"><a href="function.sodium-crypto-secretstream-xchacha20poly1305-init-pull.php" class="function">sodium_crypto_secretstream_xchacha20poly1305_init_pull()</a></span>
      и <span class="function"><a href="function.sodium-crypto-secretstream-xchacha20poly1305-init-push.php" class="function">sodium_crypto_secretstream_xchacha20poly1305_init_push()</a></span>
     </span>
    </dd>
   
   
    <dt><code class="parameter">ciphertext</code></dt>
    <dd>
     <span class="simpara">
      Фрагмент зашифрованного текста, который нужно расшифровать.
     </span>
    </dd>
   
   
    <dt><code class="parameter">additional_data</code></dt>
    <dd>
     <span class="simpara">
      Необязательные дополнительные данные для включения в тег аутентификации.
     </span>
    </dd>
   
  </dl>
 </div>


<div class="refsect1 returnvalues" id="refsect1-function.sodium-crypto-secretstream-xchacha20poly1305-pull-returnvalues">
  <h3 class="title">Возвращаемые значения</h3>
  <p class="para">
   Массив с двумя значениями:
   <ul class="itemizedlist">
    <li class="listitem">
     <span class="simpara">
      Строка (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>); Расшифрованный фрагмент
     </span>
    </li>
    <li class="listitem">
     <p class="para">
      Целое число (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>); Необязательный тег (если предоставляется во время отправки). Возможные значения:
      <ul class="simplelist">
       <li>
        <strong><code><a href="sodium.constants.php#constant.sodium-crypto-secretstream-xchacha20poly1305-tag-message">SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_MESSAGE</a></code></strong>:
        самый распространённый тег, который не добавляет никакой информации о характере сообщения.
       </li>
       <li>
        <strong><code><a href="sodium.constants.php#constant.sodium-crypto-secretstream-xchacha20poly1305-tag-final">SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_FINAL</a></code></strong>:
        указывает, что сообщение отмечает конец потока, и стирает секретный ключ, использованный для шифрования предыдущей последовательности.
       </li>
       <li>
        <strong><code><a href="sodium.constants.php#constant.sodium-crypto-secretstream-xchacha20poly1305-tag-push">SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_PUSH</a></code></strong>:
        указывает, что сообщение отмечает конец набора сообщений, но не конец потока.
       Например, огромная строка JSON, отправленная в виде нескольких фрагментов, может использовать этот тег,
       чтобы указать приложению, что строка завершена и что её можно декодировать.
       Но сам поток не закрывается и могут последовать дополнительные данные.
       </li>
       <li>
        <strong><code><a href="sodium.constants.php#constant.sodium-crypto-secretstream-xchacha20poly1305-tag-rekey">SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_REKEY</a></code></strong>:
        "забывает" ключ, использованный для шифрования этого и предыдущих сообщений и получает новый секретный ключ.
       </li>
      </ul>
     </p>
    </li>
   </ul>
  </p>
 </div>



</div><?php manual_footer($setup); ?>