percentrepl.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
char *	replace_percent_placeholders (const char *instr, const char *param_name, const char *letters,...)

Function Documentation

replace_percent_placeholders()

char * replace_percent_placeholders	(	const char *	instr,
		const char *	param_name,
		const char *	letters,
			...
	)

Definition at line 59 of file percentrepl.c.

{
    StringInfoData result;
 
    initStringInfo(&result);
 
    for (const char *sp = instr; *sp; sp++)
    {
        if (*sp == '%')
        {
            if (sp[1] == '%')
            {
                /* Convert %% to a single % */
                sp++;
                appendStringInfoChar(&result, *sp);
            }
            else if (sp[1] == '\0')
            {
                /* Incomplete escape sequence, expected a character afterward */
#ifdef FRONTEND
                pg_log_error("invalid value for parameter \"%s\": \"%s\"", param_name, instr);
                pg_log_error_detail("String ends unexpectedly after escape character \"%%\".");
                exit(1);
#else
                ereport(ERROR,
                        errcode(ERRCODE_INVALID_PARAMETER_VALUE),
                        errmsg("invalid value for parameter \"%s\": \"%s\"", param_name, instr),
                        errdetail("String ends unexpectedly after escape character \"%%\"."));
#endif
            }
            else
            {
                /* Look up placeholder character */
                bool        found = false;
                va_list     ap;
 
                sp++;
 
                va_start(ap, letters);
                for (const char *lp = letters; *lp; lp++)
                {
                    char       *val = va_arg(ap, char *);
 
                    if (*sp == *lp)
                    {
                        if (val)
                        {
                            appendStringInfoString(&result, val);
                            found = true;
                        }
                        /* If val is NULL, we will report an error. */
                        break;
                    }
                }
                va_end(ap);
                if (!found)
                {
                    /* Unknown placeholder */
#ifdef FRONTEND
                    pg_log_error("invalid value for parameter \"%s\": \"%s\"", param_name, instr);
                    pg_log_error_detail("String contains unexpected placeholder \"%%%c\".", *sp);
                    exit(1);
#else
                    ereport(ERROR,
                            errcode(ERRCODE_INVALID_PARAMETER_VALUE),
                            errmsg("invalid value for parameter \"%s\": \"%s\"", param_name, instr),
                            errdetail("String contains unexpected placeholder \"%%%c\".", *sp));
#endif
                }
            }
        }
        else
        {
            appendStringInfoChar(&result, *sp);
        }
    }
 
    return result.data;
}

References appendStringInfoChar(), appendStringInfoString(), StringInfoData::data, ereport, errcode(), errdetail(), errmsg(), ERROR, initStringInfo(), pg_log_error, pg_log_error_detail, and val.

Referenced by BuildRestoreCommand(), ExecuteRecoveryCommand(), run_ssl_passphrase_command(), shell_archive_file(), and shell_construct_command().