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

Возвращает часть строки перед искомым


 
  . Начальная позиция третьего элемента:
 
    ? ATTOKEN("Какой замечательный день!", 3)           // 21
 
  . Начальная позиция несуществующего элемента:
 
    ? ATTOKEN("Какой замечательный день!", 6)           // 0
 

See Also: NUMTOKEN()
TOKEN()
TOKENLOWER()
TOKENUPPER()



 

 

 BEFORATNUM()
  Возвращает часть строки перед искомым вхождением подстроки.
------------------------------------------------------------------------------
 
  Синтаксис
 
    BEFORATNUM(<cSearchFor>, <cString>,
        [<nCounter>], [<nIgnore>]) --> cBeforeString
 
  Параметры
 
    <cSearchFor> - символьный параметр, задающий искомую подстроку.
 
    <cString> - символьный параметр, задающий обрабатываемую строку.
 
    <nCounter> - необязательный числовой параметр, задающий номер искомого
    вхождения <cSearchFor> в <cString>. По умолчанию осуществляется поиск
    последнего вхождения.
 
    <nIgnore> - необязательный числовой параметр, задающий количество
    символов с начала строки <cString>, исключаемых из поиска. По
    умолчанию 0.
 
  Возвращаемое значение
 
    cBeforeString - часть строки <cString> от ее начала и до начала
    заданного вхождения искомой подстроки, или пустая строка, если
    искомая подстрока не найдена.
 
  Описание
 
    Функция находит требуемое по номеру вхождение подстроки <cSearchFor> в
    строке <cString> и возвращает часть строки, предшествующую искомому
    вхождению.
 
    Для поиска требуемого по номеру вхождения подстроки функция
    просматривает, начиная слева, обрабатываемую строку, осуществляя поиск
    каждого вхождения.
 
    В зависимости от состояния режима прохода по символам, переключаемого
    функцией CSETATMUPA(), дальнейший поиск продолжается с символа,
    следующего либо за последним (режим включен), либо за первым (режим

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