ascii.c File Reference

#include "postgres.h"
#include "mb/pg_wchar.h"
#include "utils/ascii.h"

Include dependency graph for ascii.c:

Go to the source code of this file.

Defines
#define	RANGE_128   128
#define	RANGE_160   160
Functions
static void	pg_to_ascii (unsigned char *src, unsigned char *src_end, unsigned char *dest, int enc)
static text *	encode_to_ascii (text *data, int enc)
Datum	to_ascii_encname (PG_FUNCTION_ARGS)
Datum	to_ascii_enc (PG_FUNCTION_ARGS)
Datum	to_ascii_default (PG_FUNCTION_ARGS)
void	ascii_safe_strlcpy (char *dest, const char *src, size_t destsiz)

---

Define Documentation

#define RANGE_128   128

#define RANGE_160   160

---

Function Documentation

void ascii_safe_strlcpy	(	char *	dest,
		const char *	src,
		size_t	destsiz
	)

Definition at line 172 of file ascii.c.

Referenced by pgstat_get_crashed_backend_activity().

{
    if (destsiz == 0)           /* corner case: no room for trailing nul */
        return;

    while (--destsiz > 0)
    {
        /* use unsigned char here to avoid compiler warning */
        unsigned char ch = *src++;

        if (ch == '\0')
            break;
        /* Keep printable ASCII characters */
        if (32 <= ch && ch <= 127)
            *dest = ch;
        /* White-space is also OK */
        else if (ch == '\n' || ch == '\r' || ch == '\t')
            *dest = ch;
        /* Everything else is replaced with '?' */
        else
            *dest = '?';
        dest++;
    }

    *dest = '\0';
}

static text * encode_to_ascii	(	text *	data,
		int	enc
	)			[static]

Definition at line 102 of file ascii.c.

References pg_to_ascii(), VARDATA, and VARSIZE.

Referenced by to_ascii_default(), to_ascii_enc(), and to_ascii_encname().

{
    pg_to_ascii((unsigned char *) VARDATA(data),        /* src */
                (unsigned char *) (data) + VARSIZE(data),       /* src end */
                (unsigned char *) VARDATA(data),        /* dest */
                enc);           /* encoding */

    return data;
}

static void pg_to_ascii	(	unsigned char *	src,
		unsigned char *	src_end,
		unsigned char *	dest,
		int	enc
	)			[static]

Definition at line 27 of file ascii.c.

References ereport, errcode(), errmsg(), ERROR, pg_encoding_to_char(), PG_LATIN1, PG_LATIN2, PG_LATIN9, and PG_WIN1250.

Referenced by encode_to_ascii().

{
    unsigned char *x;
    const unsigned char *ascii;
    int         range;

    /*
     * relevant start for an encoding
     */
#define RANGE_128   128
#define RANGE_160   160

    if (enc == PG_LATIN1)
    {
        /*
         * ISO-8859-1 <range: 160 -- 255>
         */
        ascii = (const unsigned char *) "  cL Y  \"Ca  -R     'u .,      ?AAAAAAACEEEEIIII NOOOOOxOUUUUYTBaaaaaaaceeeeiiii nooooo/ouuuuyty";
        range = RANGE_160;
    }
    else if (enc == PG_LATIN2)
    {
        /*
         * ISO-8859-2 <range: 160 -- 255>
         */
        ascii = (const unsigned char *) " A L LS \"SSTZ-ZZ a,l'ls ,sstz\"zzRAAAALCCCEEEEIIDDNNOOOOxRUUUUYTBraaaalccceeeeiiddnnoooo/ruuuuyt.";
        range = RANGE_160;
    }
    else if (enc == PG_LATIN9)
    {
        /*
         * ISO-8859-15 <range: 160 -- 255>
         */
        ascii = (const unsigned char *) "  cL YS sCa  -R     Zu .z   EeY?AAAAAAACEEEEIIII NOOOOOxOUUUUYTBaaaaaaaceeeeiiii nooooo/ouuuuyty";
        range = RANGE_160;
    }
    else if (enc == PG_WIN1250)
    {
        /*
         * Window CP1250 <range: 128 -- 255>
         */
        ascii = (const unsigned char *) "  ' \"    %S<STZZ `'\"\".--  s>stzz   L A  \"CS  -RZ  ,l'u .,as L\"lzRAAAALCCCEEEEIIDDNNOOOOxRUUUUYTBraaaalccceeeeiiddnnoooo/ruuuuyt ";
        range = RANGE_128;
    }
    else
    {
        ereport(ERROR,
                (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
                 errmsg("encoding conversion from %s to ASCII not supported",
                        pg_encoding_to_char(enc))));
        return;                 /* keep compiler quiet */
    }

    /*
     * Encode
     */
    for (x = src; x < src_end; x++)
    {
        if (*x < 128)
            *dest++ = *x;
        else if (*x < range)
            *dest++ = ' ';      /* bogus 128 to 'range' */
        else
            *dest++ = ascii[*x - range];
    }
}

Datum to_ascii_default

(

PG_FUNCTION_ARGS

)

Definition at line 154 of file ascii.c.

References enc, encode_to_ascii(), GetDatabaseEncoding(), PG_GETARG_TEXT_P_COPY, and PG_RETURN_TEXT_P.

{
    text       *data = PG_GETARG_TEXT_P_COPY(0);
    int         enc = GetDatabaseEncoding();

    PG_RETURN_TEXT_P(encode_to_ascii(data, enc));
}

Datum to_ascii_enc

(

PG_FUNCTION_ARGS

)

Definition at line 136 of file ascii.c.

References enc, encode_to_ascii(), ereport, errcode(), errmsg(), ERROR, PG_GETARG_INT32, PG_GETARG_TEXT_P_COPY, PG_RETURN_TEXT_P, and PG_VALID_ENCODING.

{
    text       *data = PG_GETARG_TEXT_P_COPY(0);
    int         enc = PG_GETARG_INT32(1);

    if (!PG_VALID_ENCODING(enc))
        ereport(ERROR,
                (errcode(ERRCODE_UNDEFINED_OBJECT),
                 errmsg("%d is not a valid encoding code", enc)));

    PG_RETURN_TEXT_P(encode_to_ascii(data, enc));
}

Datum to_ascii_encname

(

PG_FUNCTION_ARGS

)

Definition at line 117 of file ascii.c.

References enc, encode_to_ascii(), ereport, errcode(), errmsg(), ERROR, NameStr, pg_char_to_encoding(), PG_GETARG_NAME, PG_GETARG_TEXT_P_COPY, and PG_RETURN_TEXT_P.

{
    text       *data = PG_GETARG_TEXT_P_COPY(0);
    char       *encname = NameStr(*PG_GETARG_NAME(1));
    int         enc = pg_char_to_encoding(encname);

    if (enc < 0)
        ereport(ERROR,
                (errcode(ERRCODE_UNDEFINED_OBJECT),
                 errmsg("%s is not a valid encoding name", encname)));

    PG_RETURN_TEXT_P(encode_to_ascii(data, enc));
}