Просмотр кода страницы Шаблон:Str left/doc

{{docpage}}
{{СИШ}}
{{tc||''строка''{{optp|''количество символов''}}}} возвращает указанное количество символов с начала строки.

Если <code>''количество символов''</code> неправильное, пустое или равно 0, возвращает пустую строку. Если неопределённое, то используется значение 1.

=== Примеры ===
* {{пример||Lorem ipsum dolor sit amet|10}}
* {{пример|| Lorem ipsum dolor sit amet|10|_comment=Обратите внимание на неучтённый пробел слева.}}
* {{пример||Lorem ipsum dolor sit amet|1}}
* {{пример||Lorem ipsum dolor sit amet|0}}
* {{пример||Lorem ipsum dolor sit amet|}}
* {{пример||Lorem ipsum dolor sit amet}}
* {{пример||Lorem ipsum dolor sit amet|foo}}
* {{пример||Lorem ipsum dolor sit amet|40}}
* {{пример||àçé|2|_comment=Правильно обрабатывает [[UTF-8]].}}

=== См. также ===
* {{t|trunc}} — отличается обработкой случая при неуказанном или пустом втором параметре
* {{t|str right}}

{{шаблоны обработки строк|обрезка}}

=== Параметры шаблона для визуального редактора ===
<templatedata>
{
	"description": "Возвращает заданное количество символов, начиная с начала строки.",
	"params": {
		"1": {
			"label": "Строка",
			"description": "Текстовая строка, которую надо обрезать",
			"type": "string",
			"required": true
		},
		"2": {
			"label": "Количество",
			"type": "number",
			"description": "Количество символов, которые надо вернуть. Если это количество задано, как пустое или некорректное значение, то возвращается пустая строка. Если количество не определено, то возвращается первый символ строки.",
			"default": "1",
			"suggested": true
		}
	}
}
</templatedata>