<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >pad-string</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="DSSSL Library Reference" HREF="index.html"><LINK REL="UP" TITLE="Miscellaneous" HREF="r300.htm"><LINK REL="PREVIOUS" TITLE="join" HREF="join.html"><LINK REL="NEXT" TITLE="match-split" HREF="match-split.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >DSSSL Library Reference: Part of the Modular DocBook Stylesheet distribution</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="join.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="match-split.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="PAD-STRING" ></A >pad-string</H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN433" ></A ><H2 >Name</H2 >pad-string -- Pads a string, in front, to the specified length</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN436" ></A ><H2 >Synopsis</H2 ><PRE CLASS="SYNOPSIS" >(pad-string string length padchar)</PRE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN439" ></A ><H2 >Description</H2 ><P >Returns <TT CLASS="LITERAL" >string</TT >, padded in front with <TT CLASS="LITERAL" >padchar</TT > to at least <TT CLASS="LITERAL" >length</TT > Returns <TT CLASS="LITERAL" >string</TT > unmodified if <TT CLASS="LITERAL" >string</TT > is not a <TT CLASS="LITERAL" >(string?)</TT >, <TT CLASS="LITERAL" >padchar</TT > is not a <TT CLASS="LITERAL" >(string?)</TT >, <TT CLASS="LITERAL" >padchar</TT > is the empty string, or if <TT CLASS="LITERAL" >string</TT > is already greater than or equal to <TT CLASS="LITERAL" >length</TT > in length.</P ><P ></P ><DIV CLASS="VARIABLELIST" ><DL ><DT ><TT CLASS="LITERAL" >string</TT ></DT ><DD ><P >The string to pad.</P ></DD ><DT ><TT CLASS="LITERAL" >length</TT ></DT ><DD ><P >The desired length.</P ></DD ><DT ><TT CLASS="LITERAL" >padchar</TT ></DT ><DD ><P >The character (string, actually) to use as padding. If <TT CLASS="LITERAL" >padchar</TT > is longer than 1 character, the resulting string may be longer than <TT CLASS="LITERAL" >length</TT > when returned.</P ></DD ></DL ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN471" ></A ><H2 >Author</H2 ><P >Norman Walsh, <ndw@nwalsh.com></P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN474" ></A ><H2 >Source Code</H2 ><PRE CLASS="PROGRAMLISTING" >(define (pad-string string length padchar) ;; Pads a string, in front, to the specified length (if (and (string? string) (string? padchar) (> (string-length padchar) 0)) (let loop ((s string) (count (- length (string-length string)))) (if (<= count 0) s (loop (string-append padchar s) (- count (string-length padchar))))) string))</PRE ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="join.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="match-split.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >join</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="r300.htm" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >match-split</TD ></TR ></TABLE ></DIV ></BODY ></HTML >