shmop_write

    (PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

    shmop_write — Запись данных в разделяемую память

    Описание

    shmop_write(Shmop$shmop, string$data, int$offset): int

    shmop_write() записывает строковые данные в участок разделяемой памяти.

    Список параметров

    shmop

    Ресурс блока памяти, возвращаемый функцией shmop_open()

    data

    Строковые данные для размещения в памяти

    offset

    Определяет, в каком месте участка памяти следует начать запись данных. Смещение должно быть больше или равно нулю и меньше или равно фактическому размеру сегмента разделяемой памяти.

    Возвращаемые значения

    Размер записанных данных, переданных через параметр data.

    Ошибки

    Если параметр offset находится вне диапазона или в сегмент разделяемой памяти, доступный только для чтения, должна быть произведена запись, будет выброшена ошибка ValueError.

    Список изменений

    ВерсияОписание
    8.0.0 До PHP 8.0.0 в случае возникновения ошибки возвращалось false.
    8.0.0 Параметр shmop ожидает экземпляр Shmop; ранее ожидался ресурс (resource).

    Примеры

    Пример #1 Запись данных в участок разделяемой памяти

    <?php
    $shm_bytes_written     = shmop_write($shm_id, $my_string, 0);
    ?>

    В данном примере в память помещается содержимое строковой переменной $my_string, после чего переменная $shm_bytes_written будет содержать размер фактически записанных данных.

    Смотрите также

    • shmop_read() - Чтение данных из участка разделяемой памяти
    To Top