PADL()

Left-justifies an expression for a given width

Syntax

      PADL( <xVal>, <nWidth>, <cFill> )  --> cString

Arguments

<xVal> An number, Character or date to pad

<nWidth> Width of output string

<cFill> Character to fill in the string

Returns

<cString> The left-justifies string of <xVal>

Description

This function takes an date, number, or character expression <xVal> and attempt to left-justify it within a string of a given width expressed as <nWidth>. The default character used to pad left side of <xVal> will be an blank space; however, this character may be explicitly specified the value of <cFill>.

If the length of <xVal> is longer then <nWidth>, this function will truncate the string <xVal> from the leftmost side to the length of <nWidth>.

Examples

      ? PADL( "Harbour", 20 )
      ? PADL( 34.5142, 20 )
      ? PADL( Date(), 35 )

Tests

      See examples

Compliance

Clipper

Platforms

All

Files

Library is rtl

Seealso

ALLTRIM(), PADC(), PADR()