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

# shmop_write

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

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

### Описание

function 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() - Считывает данные из блока разделяемой памяти

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open