RPad$ - Revision history

Laura at 00:56, 22 May 2014

2014-05-22T00:56:25Z

← Older revision		Revision as of 00:56, 22 May 2014
Line 1:		Line 1:
	~~RPad~~$(A$,X[,"~~char~~"])		RPAD$(<sring>,<length>[,"character"])

	The '''RPad$''' [[internal function]] returns A$, adding trailing blanks to make it X characters long. If A$ already has at least X characters, no blanks are added.		The '''RPad$''' [[internal function]] returns the string, adding trailing blanks to make it <length> characters long. If A$ already has at least X characters, no blanks are added.

	An optional third parameter ("~~char~~") has been added to [[LPad$]] and RPad$ to specify the character to be used for the padding (instead of blanks, which are still the default). The "char" parameter is limited to one character in length (error 410 will result if it is longer). [[Null]]s and [[Chr$]](0) are allowed.		An optional third parameter ("character") has been added to [[LPad$]] and RPad$ to specify the character to be used for the padding (instead of blanks, which are still the default). The "char" parameter is limited to one character in length (error 410 will result if it is longer). [[Null]]s and [[Chr$]](0) are allowed.

	====Comments and Examples====		====Comments and Examples====

John: moved RPAD$ to RPad$ over redirect

2014-02-26T17:43:53Z

moved RPAD$ to RPad$ over redirect

← Older revision	Revision as of 17:43, 26 February 2014
(No difference)

Laura at 18:23, 22 July 2013

2013-07-22T18:23:07Z

← Older revision		Revision as of 18:23, 22 July 2013
Line 3:		Line 3:
	The '''RPad$''' [[internal function]] returns A$, adding trailing blanks to make it X characters long. If A$ already has at least X characters, no blanks are added.		The '''RPad$''' [[internal function]] returns A$, adding trailing blanks to make it X characters long. If A$ already has at least X characters, no blanks are added.

	An optional third parameter ("char") has been added to [[LPad$]] and RPad$ to specify the character to be used for the padding (instead of blanks, which are still the default). The "char" parameter is limited to one character in length (error 410 will result if it is longer). [[Null]]s and [[Chr$(0)]] are allowed.		An optional third parameter ("char") has been added to [[LPad$]] and RPad$ to specify the character to be used for the padding (instead of blanks, which are still the default). The "char" parameter is limited to one character in length (error 410 will result if it is longer). [[Null]]s and [[Chr$]](0) are allowed.

	====Comments and Examples====		====Comments and Examples====

Laura at 17:58, 18 July 2013

2013-07-18T17:58:54Z

← Older revision		Revision as of 17:58, 18 July 2013
Line 3:		Line 3:
	The '''RPad$''' [[internal function]] returns A$, adding trailing blanks to make it X characters long. If A$ already has at least X characters, no blanks are added.		The '''RPad$''' [[internal function]] returns A$, adding trailing blanks to make it X characters long. If A$ already has at least X characters, no blanks are added.

	An optional third parameter ("char") has been added to [[LPad$]] and RPad$ to specify the character to be used for the padding (instead of blanks, which are still the default). The "char" parameter is limited to one character in length (error 410 will result if it is longer). [[~~Nulls~~]] and [[Chr$(0)]] are allowed.		An optional third parameter ("char") has been added to [[LPad$]] and RPad$ to specify the character to be used for the padding (instead of blanks, which are still the default). The "char" parameter is limited to one character in length (error 410 will result if it is longer). [[Null]]s and [[Chr$(0)]] are allowed.

	====Comments and Examples====		====Comments and Examples====

Mikhail.zheleznov: *

2012-01-30T10:49:25Z

← Older revision		Revision as of 10:49, 30 January 2012
Line 1:		Line 1:
	RPad$(A$,X[,"char"])		RPad$(A$,X[,"char"])

	The '''RPad$''' [[internal function]] returns A$, adding trailing blanks to make it X characters long. If A$ already has at least X characters, no blanks are added~~. If "char" is used the padding will use the specified character rather than a blank space for the fill character~~.		The '''RPad$''' [[internal function]] returns A$, adding trailing blanks to make it X characters long. If A$ already has at least X characters, no blanks are added.

	An optional third parameter ("char") has been added to [[LPad$]] and RPad$ to specify the character to be used for the padding (instead of blanks, which are still the default). The "char" parameter is limited to one character in length (error 410 will result if it is longer). [[Nulls]] and [[Chr$(0)]] are allowed.		An optional third parameter ("char") has been added to [[LPad$]] and RPad$ to specify the character to be used for the padding (instead of blanks, which are still the default). The "char" parameter is limited to one character in length (error 410 will result if it is longer). [[Nulls]] and [[Chr$(0)]] are allowed.

	====Comments and Examples====		====Comments and Examples====

	To make sure that a string to be used as a key field is long enough to match the length of the key field (assumed to be 12 in this example), the RPad$ function can be used in the [[KEY=]] clause.		To make sure that a string to be used as a key field is long enough to match the length of the key field (assumed to be 12 in this example), the RPad$ function can be used in the [[KEY=]] clause.

	00510 READ #2,USING 520,KEY=RPAD$(X$,12):COMPANY$ NOKEY 980		00510 READ #2,USING 520,KEY=RPAD$(X$,12): COMPANY$ NOKEY 980

	A more generalized solution is to use the KLN(2) function to obtain the key length for file 2 instead of coding the 12 as a constant; then the KEY= clause would be KEY=RPAD$(X$,KLN(2)).		A more generalized solution is to use the KLN(2) function to obtain the key length for file 2 instead of coding the 12 as a constant; then the KEY= clause would be KEY=RPAD$(X$,KLN(2)).

	====See Also====		====See Also====

	*[[LPad$]]		*[[LPad$]]
	*[[LTrm$]]		*[[LTrm$]]

Mikhail.zheleznov: moved RPad$ to RPAD$

2012-01-17T10:15:54Z

moved RPad$ to RPAD$

← Older revision	Revision as of 10:15, 17 January 2012
(No difference)

Mikhail.zheleznov: 1 revision

2012-01-15T14:11:47Z

1 revision

New page

RPad$(A$,X[,"char"])

The '''RPad$''' [[internal function]] returns A$, adding trailing blanks to make it X characters long. If A$ already has at least X characters, no blanks are added. If "char" is used the padding will use the specified character rather than a blank space for the fill character.

An optional third parameter ("char") has been added to [[LPad$]] and RPad$ to specify the character to be used for the padding (instead of blanks, which are still the default). The "char" parameter is limited to one character in length (error 410 will result if it is longer). [[Nulls]] and [[Chr$(0)]] are allowed.

====Comments and Examples====
To make sure that a string to be used as a key field is long enough to match the length of the key field (assumed to be 12 in this example), the RPad$ function can be used in the [[KEY=]] clause.

00510 READ #2,USING 520,KEY=RPAD$(X$,12):COMPANY$ NOKEY 980

A more generalized solution is to use the KLN(2) function to obtain the key length for file 2 instead of coding the 12 as a constant; then the KEY= clause would be KEY=RPAD$(X$,KLN(2)).

====See Also====
*[[LPad$]]
*[[LTrm$]]
*[[RTrm$]]

<noinclude>
[[Category:Internal Functions]]
</noinclude>