Переносит слово

# ps_hyphenate

(PECL ps >= 1.1.1)

ps_hyphenate — Переносит слово

### Описание

function ps_hyphenate(resource `$psdoc`, string `$text`): array|false

Переносит указанное слово. Функция ps_hyphenate() оценивает дефисы значения (устанавливается ps_set_value()) и дефисы параметра (устанавливается ps_set_parameter()). Перед вызовом этой функции необходимо установить дефис.

Для работы функции требуется, чтобы категорию языкового стандарта `LC_CTYPE` установили корректно. Это делается при инициализации модуля с использованием переменных окружения. В системах Unix дополнительную информацию дают справочные страницы языковых стандартов.

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

`psdoc`

  Идентификатор ресурса файла postscript, возвращённый функцией ps_new().

`text`
  Параметр `text` не должен содержать символов, которые отличаются от букв. Возможные позиции для переносов возвращаются в виде массива целых чисел. Каждое число — позиция символа в значении `text`, после которой может быть выполнен перенос.

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

Функция возвращает массив целых чисел, который указывает положение возможных переносов в тексте или `false`, если возникла ошибка.

### Примеры

Пример #1 Перенос текста

    <?php

    $word = "Koordinatensystem";
    $psdoc = ps_new();

    ps_set_parameter($psdoc, "hyphendict", "hyph_de.dic");

    $hyphens = ps_hyphenate($psdoc, $word);

    for ($i=0; $i < strlen($word); $i++) {
      echo $word[$i];

      if (in_array($i, $hyphens))
        echo "-";
    }

    ps_delete($psdoc);

    ?>

Результат выполнения приведённого примера:

    Ko-ordi-na-ten-sys-tem

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

- ps_show_boxed() - Выводит текст в поле
- locale(1)

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