Функции для работы со строками
@Length( строка ) @Length( список_строк )
Область применения: без ограничений.
Если параметром является строка, @Length возвращает количество символов в строке. Если параметром является список_строк, @Length возвращает количество символов в каждой строке как числовой список.
Пример 1. Возвращает 45.
@Length( "The boy crossed the wide, but gentle, stream." )
Пример 2. Возвращает 0 : 5 : 3.
@Length( "" : "abcde" : "xyz" )
Пример 3. Возвращает 16 : 10 : 17, если содержимое полей From, Topic, и Date, соответственно, “Stephen Brewster", "News Flash", и [04.11.89 16:45:10].
@Length( From : Topic : @Text( Date ))
@LowerCase( строка )
@LowerCase( список_строк
)
@UpperCase( строка )
@UpperCase( список_строк
)
@ProperCase( строка )
@ProperCase( список_строк
)
Область применения: без ограничений.
@LowerCase преобразует все символы строки к нижнему регистру, @UpperCase - к верхнему, а @ProperCase - первый символ каждого слова - к верхнему, а остальные символы - к нижнему. При использовании в качестве аргумента списка строк, возвращают список, получившийся поэлементным применением функций.
Пример 1. Возвращает "juan mendoza".
@LowerCase( "Juan Mendoza" )
Пример 2. Возвращает "ROBERT T. SMITH".
@UpperCase( "Robert T. Smith" )
Пример 3. Возвращает список "Every Child" : "Loves Toys".
@ProperCase( "every CHILD" : "LOves toys" )
@NewLine
Область применения: нельзя использовать в формулах отбора, колонок, видимости объекта, формы, заголовка окна, области размещения и в контексте функции @Prompt (внутри функции @Prompt используйте для перевода строки функцию @Char с параметрами, соответствующими символу возврата каретки для данной платформы). В Web-приложениях не работает в формулах отбора, формы и заголовка окна.
Вставляет символ перехода на новую строку (возврат каретки) в текстовую строку.
Пример 1. Присвоит полю Subject значение, первой строкой которого будет "Привет", а второй "всем".
@SetField( "Subject"; "Привет" + @NewLine + "всем" )
Пример 2. При использовании в формуле, выполняющейся на компьютере под Windows, выдаст окно, в первой строке которого будет "Hello", а во второй "world".
@Prompt( [Ok]; "Информация"; "Hello" + @Char( 13 ) +
@Char( 10 ) + "world" )
@Repeat( строка; число_повторов;
максимальное_число_символов
)
@Repeat( список_строк; число_повторов;
максимальное_число_символов
)
Область применения: без ограничений. Длина возвращаемой строки не должна превышать 1024 символа, в противном случае возникает ошибка.
Возвращает строку, полученную из исходной путем многократной операции конкатенации самой с собой. Число конкатенаций равно числу_повторов. Третий параметр необязателен, если он присутствует, то полученная строка обрезается до числа символов, равных максимальному_числу_символов. Если в качестве первого аргумента выступает список_строк, возвращаемое значение есть список, полученный поэлементным применением функции.
Пример 1. Возвращает "приветприв".
@Repeat( "привет"; 4; 10 )
Пример 2. Возвращает "приветприв" : "покапокапо".
@Repeat( "привет" : "пока"; 4; 10 )
@Trim( строка ) @Trim( список_строк )
Область применения: без ограничений.
Удаляет пробелы в начале и в конце строки и лишние пробелы внутри строки. Если параметром является список_строк, функция удаляет элементы типа пустой строки из результирующего списка.
Пример 1. Возвращает "БОРИС ИВАНОВ".
@Trim( @UpperCase( "Борис Иванов " ))
Пример 2. Возвращает "БОРИС ИВАНОВ".
@UpperCase( @Trim( "Борис Иванов " ))
Пример 3. Возвращает "Пример использования функции", даже если исходное содержимое поля Topic выглядит как " Пример использования функции ".
@Trim( Topic )
Пример 4. Возвращает "Бостон" : "Торонто" : "Сантьяго" : "США" : "Канада" : "Чили", если список в поле Сity содержит "Бостон" : "Торонто" : "Сантьяго"; поле StateOrProvince не содержит ничего; а поле Сountry содержит список "США" : "Канада" : "Чили".
@Trim( City : StateOrProvince : Country )
Пример 5. Возвращает "45" как текстовую строку, если содержимым поля Date является [8.29.89 16:30:45], или любая другая величина "дата-время", в которой количество секунд равно 45.
@Trim( @Text( @Second( Date )))