Caution: This documentation is for eZ Publish legacy, from version 3.x to 6.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

pad

Summary

Returns a lengthened version of the input string.

Usage

input|pad( length [, padding ] )

Parameters

NameTypeDescriptionRequired
length integer The desired length of the string. Yes.
padding character Custom character to be used for padding. No.

Returns

A padded version of the input string.

Description

This operator makes sure that the input string is at least "length" characters long by inserting extra characters at the end. It is possible to specify a custom character using the "padding" parameter (default is space). The operator returns a padded version of the input string.

Examples

Example 1

{'Too short!'|pad( 15 )}

The following string will be produced: "Too short! ".

Example 2

{'Too short!'|pad( 16, '-' )}

The following string will be produced: "Too short!------".

Balazs Halasy (05/02/2004 10:58 am)

Balazs Halasy (04/05/2005 2:44 pm)

Comments

  • How to pad left?

    Thursday 14 July 2005 11:14:39 am

    Massimiliano Bariola

    Is there a way to left-pad a string without having to reverse|pad|reverse it ?

  • How to pad left .. I found out how

    Thursday 08 September 2005 3:58:08 pm

    Massimiliano Bariola

    This requires some lateral thinking:

    for example, to pad a 0-99 $number to 00-99:

    0|pad(2, $number)

    I don't know what happens if $number is over 2 digits tho'. didn't try it.