<?xml version="1.0" encoding="utf-8"?> 
<?xml-stylesheet type="text/xsl" href="topic_template.xsl"?> 
<topic>
<category>ib_udf</category>
<ref_entry>RPAD()</ref_entry>
<creator date="2003/10/02 13:30:22">山田健一</creator>
<modified />
<definition>指定した文字列を右側に連続的に埋め込みます。
</definition>
<structure>
<function>
<name>RPAD</name>
<args>
<a><var>string</var></a>
<a><var>bytes</var></a>
<a><var>padchar</var></a>
</args>
</function>
</structure>
<arguments>
<argument>
<name><var>string</var></name><description>文字列データ型の列または式</description>
</argument>
<argument>
<name><var>bytes</var></name><description>数値データ型の列または式</description>
</argument>
<argument>
<name><var>padchar</var></name><description>文字列データ型の列または式</description>
</argument>
</arguments>
<declaration>DECLARE EXTERNAL FUNCTION rpad 
	CSTRING(80), INTEGER, CSTRING(1)
	RETURNS CSTRING(80) FREE_IT
	ENTRY_POINT 'IB_UDF_rpad' MODULE_NAME 'ib_udf';
</declaration>
<description><var>padchar</var>を<var>string</var>の右に連続的に埋め込み<var>bytes</var>バイトの長さの文字列を返します。<br />
<var>bytes</var>が文字数ではないので、<var>string</var>にダブルバイトを含む場合は、注意が必要です。<br />
<var>string</var>が<var>bytes</var>バイトより大きい時は、<var>bytes</var>バイトに切り捨てられます。</description>
<examples>
<example>
<!--SEQ = 1-->
<description>文字列 '12' に文字数が 7 バイトになるよう '_' を左に追加します。</description>
<samplecode>SELECT '|' || RPAD('12',7,'_') || '|' FROM RDB$DATABASE;</samplecode>
<result>|12_____|</result>
</example>
<example>
<!--SEQ = 2-->
<description><var>string</var>が<var>bytes</var>バイトより大きい時は、<var>bytes</var>バイトに切り捨てられます。<br />
('123456789'は9バイト)</description>
<samplecode>SELECT '|' || RPAD('123456789',7,'_') || '|' FROM RDB$DATABASE;</samplecode>
<result>|1234567|</result>
</example>
<example>
<!--SEQ = 3-->
<description>文字列 '山' に文字数が 7 バイトになるよう '★' を右に追加します。<br />
(結果として文字コードが欠けます)</description>
<samplecode>SELECT '|' || RPAD('山',7,'★') || '|' FROM RDB$DATABASE;</samplecode>
<result>|山★★－</result>
</example>
</examples>
<see_also>
<keyword name="udf_lpad">LPAD()</keyword>
</see_also>
</topic>
