Клиппер 5. Справочник

числовой параметр, задающий длину возвращаемой


 

See Also: CSETREF()

 

 

 CHARSPREAD()
 Возвращает строку с расширенными промежутками между элементами.
------------------------------------------------------------------------------
 
  Синтаксис
 
    CHARSPREAD(<cString>, <nLength>,
        [<cChar|nChar>]) --> cSpreadString


 
  Параметры
 
    <cString> - символьный параметр, задающий обрабатываемую строку.
 
    <nLength> - числовой параметр, задающий длину возвращаемой строки.
 
    <cChar|nChar> - необязательный параметр, задающий символ-заполнитель
    и одновременно разделитель элементов. Может быть указан символьным или
    числовым (в диапазоне от 0 до 255) значением. По умолчанию
    используется пробел (CHR(32)).
 
  Возвращаемое значение
 
    cSpreadString - строка заданной длины.
 
  Описание
 
    В отличие от EXPAND() функция раздвигает строку, заполняя символом,
    заданным параметром <cChar|nChar>, промежутки между элементами (напр.,
    словами), а не между символами. Аналогичным образом производится
    выравнивание строк по длине большинством текстовых редакторов.
 
  Примечания
 
  . При расширении ранее присутствовавшие символы-заполнители
    рассматриваются как части элементов (см. Примеры). Для устранения
    этих символов строку можно предварительно обработать функцией
    CHARONE().
 
  Примеры
 
  . Если строка не содержит разделителей, то она не расширяется:
 
    ? CHARSPREAD("123456", 20, ".")             // "123456"
 
  . Задание символа-заполнителя в виде числового кода:
 
    ? CHARSPREAD("1.2.3.4.5.6", 20, 46)         // "1...2...3...4...5...6"
 
  . Расширение строки, в которой уже присутствует символ-заполнитель:
 
    ? CHARSPREAD("11..22..33", 20, ".")         // "11.......22.......33"
    ? CHARSPREAD("11.22.........33", 20, ".")   // "11....22..........33"

Содержание раздела