GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • WOLFRAM
  • Products
  • AI AccessUse with Mathematica and Wolfram|One
  • Finance Platform
  • Wolfram|Alpha Notebook Edition
  • Application Server
  • Enterprise Private Cloud
  • Wolfram Engine
  • Wolfram Player
  • Wolfram Cloud App
  • Wolfram Player App
  • Wolfram|Alpha Website
  • Wolfram|Alpha APIs
  • Wolfram AI Ecosystem

This view

  • Original page
  • New address

GeezerVison is showing reference.wolfram.com — PadLeft: Pad to a given length with new elements on the left—Wolfram Documentation

PadLeft[list,n]

makes a list of length n by padding list with zeros on the left.

PadLeft[list,n,x]

pads by repeating the element x.

PadLeft[list,n,{x1,x2,…}]

pads by cyclically repeating the elements xi.

PadLeft[list,n,padding,m]

leaves a margin of m elements of padding on the right.

PadLeft[list,{n1,n2,…}]

makes a nested list with length ni at level i.

PadLeft[list]

pads a ragged array list with zeros to make it full.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Generalizations & Extensions  
Applications  
Properties & Relations  
Possible Issues  
See Also
Tech Notes
Related Guides
Related Links
History
Cite this Page

PadLeft

PadLeft[list,n]

makes a list of length n by padding list with zeros on the left.

PadLeft[list,n,x]

pads by repeating the element x.

PadLeft[list,n,{x1,x2,…}]

pads by cyclically repeating the elements xi.

PadLeft[list,n,padding,m]

leaves a margin of m elements of padding on the right.

PadLeft[list,{n1,n2,…}]

makes a nested list with length ni at level i.

PadLeft[list]

pads a ragged array list with zeros to make it full.

Details

  • PadLeft[list,n,…] always returns a list of length n, except in some special cases where padding is {}.
  • With padding {x1,x2,…,xs}, cyclic repetitions of the xi are effectively laid down and then the list is superimposed on top of them, with the last element of the list lying on an occurrence of xs. »
  • PadLeft[list,n,padding,-m] truncates the last m elements of list.
  • A margin of Round[(n-Length[list])/2] effectively centers list.
  • PadLeft[list,n,list] effectively treats list as cyclic.
  • PadLeft[list,n,{xlist}] can be used to repeat an individual element that is itself a list.
  • PadLeft[{},n,{x1,x2,…}] repeats the sequence of xi as many times as fit in a list of length n.
  • PadLeft[list,{n1,n2,…}] creates a full array with dimensions {n1,n2,…} even if list is ragged. »
  • PadLeft[list,Automatic,x] pads with x to make a full array.
  • Negative ni specify to pad on the right.
  • PadLeft[list,{n1,n2},{{x11,x12,…},{x21,…},…}] pads by repeating the block of xij.
  • PadLeft[list,{n1,n2,…},list] effectively treats list as cyclic in every dimension.
  • PadLeft[list,{n1,n2,…},padding,{m1,m2,…}] uses margin mi at level i.
  • The object list need not have head List.
  • PadLeft can be used on SparseArray objects.

Examples

open all close all

Basic Examples  (6)

Pad with 0 to make the list be of length 10:

Wolfram Language code: PadLeft[{a, b, c}, 10]

Pad with x:

Wolfram Language code: PadLeft[{a, b, c}, 10, x]

Pad by repeating {x,y,z}:

Wolfram Language code: PadLeft[{a, b, c}, 10, {x, y, z}]

Leave margin 2 on the right:

Wolfram Language code: PadLeft[{a, b, c}, 10, x, 2]

Pad to make a 3×5 array:

Wolfram Language code: PadLeft[{{a, b}, {c}}, {3, 5}]//TableForm

Pad to make a full array:

Wolfram Language code: PadLeft[{{a, b, c}, {d, e}, {f}}]//TableForm

Scope  (3)

Negative length specifications pad on the right:

Wolfram Language code: PadLeft[{a, b, c}, -10]

Lay down repetitions of the padding, then superimpose the original array:

Wolfram Language code: PadLeft[{{aa, bb}, {cc}}, {4, 4}, {{x, y}, {z}}]//TableForm

Use different margins for rows and columns:

Wolfram Language code: PadLeft[{{aa, bb}, {cc}}, {5, 5}, {{x, y}, {z}}, {1, 2}]//TableForm

Generalizations & Extensions  (1)

Use a head other than List:

Wolfram Language code: PadLeft[f[a, b, c], 8, x]

Applications  (3)

Put a 1 at the center of a list of 0s:

Wolfram Language code: PadLeft[{1}, 19, 0, 9]

Pad digit lists to be the same length:

Wolfram Language code: PadLeft[Table[IntegerDigits[i ^ 2, 2], {i, 5}]]

Lay out an array of tiles:

Wolfram Language code: ArrayPlot[PadLeft[{{}}, {15, 15}, {{1, 0, 1}, {0, 1, 1}, {1, 0, 0}}], Mesh -> True]

Properties & Relations  (1)

PadLeft[list,n] and PadRight[list,n] pad to make a list of length n:

Wolfram Language code: PadLeft[{1, 2, 3}, 5]
Wolfram Language code: PadRight[{1, 2, 3}, 5]

ArrayPad[list,n] pads with n additional elements on each side:

Wolfram Language code: ArrayPad[{1, 2, 3}, 5]

Possible Issues  (1)

Pad with an element that is itself a list:

Wolfram Language code: PadLeft[{a, b, c}, 7, {{u, v}}]
Wolfram Language code: PadLeft[{a, b, c}, 7, {u, v}]

See Also

PadRight  ArrayPad  Join  Partition  ArrayReshape  CenterArray  ListCorrelate  Riffle  RotateLeft  ArrayQ  StringPadLeft

Function Repository: Broadcasting

Tech Notes

    ▪
  • Rearranging Lists
  • ▪
  • Nested Lists
  • ▪
  • Partitioning and Padding Lists

Related Guides

    ▪
  • Rearranging & Restructuring Lists
  • ▪
  • Constructing Matrices

Related Links

  • NKS|Online  (A New Kind of Science)

History

Introduced in 1999 (4.0) | Updated in 2003 (5.0) ▪ 2007 (6.0)

Wolfram Research (1999), PadLeft, Wolfram Language function, https://reference.wolfram.com/language/ref/PadLeft.html (updated 2007).

Text

Wolfram Research (1999), PadLeft, Wolfram Language function, https://reference.wolfram.com/language/ref/PadLeft.html (updated 2007).

CMS

Wolfram Language. 1999. "PadLeft." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2007. https://reference.wolfram.com/language/ref/PadLeft.html.

APA

Wolfram Language. (1999). PadLeft. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/PadLeft.html

BibTeX

@misc{reference.wolfram_2026_padleft, author="Wolfram Research", title="{PadLeft}", year="2007", howpublished="\url{https://reference.wolfram.com/language/ref/PadLeft.html}", note=[Accessed: 12-November-2026]}

BibLaTeX

@online{reference.wolfram_2026_padleft, organization={Wolfram Research}, title={PadLeft}, year={2007}, url={https://reference.wolfram.com/language/ref/PadLeft.html}, note=[Accessed: 12-November-2026]}

Top
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.