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

что применяется при выявлении пустых


    разделителей (длину последовательности), необходимых для подсчета
    элементов, что применяется при выявлении пустых элементов.
    По умолчанию разделители используются по одному.
 
  Возвращаемое значение
 
    lStatus - логическое значение .T. при успешном завершении
    инициализации, или .F., если символьная переменная не может быть
    инициализирована, например, если она не была передана по ссылке.
 
  Описание
 
    Использование описываемой функции совместно с TOKENNEXT()


    предоставляет самые разнообразные возможности выделения элементов,
    значительно повышая скорость этого процесса по сравнению с
    использованием функции TOKEN().
 
    Эффект достигается благодаря замене описываемой функцией всех
    символов-разделителей на первый символ из списка разделителей, что
    позволяет в дальнейшем не просматривать полный их список. Кроме того,
    TOKENNEXT() не всегда начинает поиск выделяемого элемента с начала
    строки (см. TOKENNEXT()). Однако TOKENNEXT(), в отличие от функции
    TOKEN(), не может выделить элемент, заданный по номеру.
 
    При использовании параметра <nSkipDistance> можно задать длину
    последовательности символов-разделителей. Это позволяет, например,
    распознавать пустые строки в тексте, где им соответствует
    последовательность CRLFCRLF. Поскольку описываемая функция заменяет
    все различные символы-разделители на первый из списка, то эта
    последовательность будет заменена на CRCRCRCR. Задание значения 2 для
    параметра <nSkipDistance> означает, что элемент выделяется после
    нахождения двух подряд идущих разделителей (в данном случае CRCR).
    Если этой последовательности ничего не предшествовало, то TOKENNEXT()
    возвращает пустую строку, которую можно интерпретировать как пустой
    элемент.
 
    По умолчанию описываемая функция использует следующий список
    разделителей:
 
    CHR(32), CHR(0), CHR(9), CHR(10), CHR(13),

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