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

pads by repeating the element x.

pads by cyclically repeating the elements xi.

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

makes a nested list with length ni at level i.

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. »
• 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. »
• Negative ni specify to pad on the right.
• PadLeft[list,{n1,n2,},list] effectively treats list as cyclic in every dimension.
• The object list need not have head List.
• PadLeft can be used on SparseArray objects.

# Examples

open allclose all

## Basic Examples(6)

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

 In[1]:=
 Out[1]=

 In[1]:=
 Out[1]=

 In[1]:=
 Out[1]=

Leave margin 2 on the right:

 In[1]:=
 Out[1]=

Pad to make a 3×5 array:

 In[1]:=
 Out[1]//TableForm=

Pad to make a full array:

 In[1]:=
 Out[1]//TableForm=