Spec-Zone.ru › ColdFusion

left

Возвращает count крайних левых символов строки.

left(String, count) → returns string

Синтаксис функции-члена

string.left(count)

  • CF
  • Lucee
  • BL 1.0.0+
  • См. также: right mid

    Описание аргументов

    String string
    Обязательный

    count numeric
    Обязательный

    Целое число или переменная, содержащая целое число. Количество символов, которые нужно вернуть.

    Совместимость

    ColdFusion:

    Начиная с CF2018+ значение count может быть отрицательным целым числом.

    Примеры
    Пример кода с вызовом функции left

    Использование left() со строкой

    В этом примере мы используем left(), чтобы вернуть часть строки.

    writeOutput( left( 'The quick brown fox jumped over the lazy dog', 19 ) );

    Ожидаемый результат: The quick brown fox

    Использование left() со строкой и отрицательным значением count

    CF 2018+ В этом примере мы используем отрицательное значение count, чтобы вернуть часть строки. CF 2018+

    writeOutput( left( 'The quick brown fox jumped over the lazy dog', -25 ) );

    Ожидаемый результат: The quick brown fox

    Использование left() в функции

    В этом примере мы используем left() в функции, чтобы сделать первую букву строки заглавной.

    public string function capitalize( required string text ) {
    	return uCase( left( arguments.text, 1 ) ) & right( arguments.text, len( arguments.text ) - 1 );
    }

    Проверка значений с помощью left()

    В этом примере мы используем left(), чтобы проверить первые пять символов переменной контекста запроса.

    if( listFindNoCase( 'super,great,coder,rulez', left( rc.answer, 5 ) ) ) {
    	writeOutput( 'You are an awesome developer!' );
    }

    Использование left() как функции-члена

    CF 11+ Lucee 4.5+ В этом примере мы используем left() как функцию-член внутри функции, чтобы сделать первую букву строки заглавной.

    public string function capitalize( required string text ) {
    	return arguments.text.left( 1 ).ucase() & arguments.text.right( arguments.text.len() - 1 );
    }

    © 2012–present Foundeo, Inc. and the CFDocs contributors.
    Licensed under the MIT License.
    ColdFusion is a trademark of Adobe Systems Incorporated.
    https://cfdocs.org/left

    Spec-Zone.ru

    Настройки Оффлайн Что нового Помощь О нас
    Spec-Zone .ru
    спецификации, руководства, описания, API