dns_name_totext

isc_result_t

dns_name_totext( dns_name_t *name, isc_boolean_t omit_final_dot,

isc_buffer_t *target);

将 'name' 转换成文本格式，转换后的结果储存在 'target' 中。

注意：

• •. 如果 'omit_final_dot' 为 true （真），则除咯根域名以外的位于绝对域名末尾的 '.' 会被省略。

• •. 如果 dns_name_countlabels == 0，则name（域名）会是"@"，它表示的是当前的根（origin），RFC1035 中有说明。

• •. 不是以 NUL 结尾的。

要求：

• •. 'name'是一個有效的域名。

• •. 'target'是一個有效的缓冲区。

• •. 如果 dns_name_isabsolute == FALSE，则 omit_final_dot == FALSE

确保：

• •. 如果结果为成功：

则在中的“已用”空间被更新。

返回：

• •. ISC_R_SUCCESS

• •. ISC_R_NOSPACE