char.c File Reference

#include "postgres.h"
#include <limits.h>
#include "libpq/pqformat.h"
#include "utils/fmgrprotos.h"
#include "varatt.h"

Include dependency graph for char.c:

Go to the source code of this file.

Macros
#define	ISOCTAL(c)   (((c) >= '0') && ((c) <= '7'))
#define	TOOCTAL(c)   ((c) + '0')
#define	FROMOCTAL(c)   ((unsigned char) (c) - '0')

Functions
Datum	charin (PG_FUNCTION_ARGS)
Datum	charout (PG_FUNCTION_ARGS)
Datum	charrecv (PG_FUNCTION_ARGS)
Datum	charsend (PG_FUNCTION_ARGS)
Datum	chareq (PG_FUNCTION_ARGS)
Datum	charne (PG_FUNCTION_ARGS)
Datum	charlt (PG_FUNCTION_ARGS)
Datum	charle (PG_FUNCTION_ARGS)
Datum	chargt (PG_FUNCTION_ARGS)
Datum	charge (PG_FUNCTION_ARGS)
Datum	chartoi4 (PG_FUNCTION_ARGS)
Datum	i4tochar (PG_FUNCTION_ARGS)
Datum	text_char (PG_FUNCTION_ARGS)
Datum	char_text (PG_FUNCTION_ARGS)

Macro Definition Documentation

FROMOCTAL

#define FROMOCTAL

(

c

)

((unsigned char) (c) - '0')

Definition at line 26 of file char.c.

ISOCTAL

#define ISOCTAL

(

c

)

(((c) >= '0') && ((c) <= '7'))

Definition at line 24 of file char.c.

TOOCTAL

#define TOOCTAL

(

c

)

((c) + '0')

Definition at line 25 of file char.c.

Function Documentation

char_text()

Datum char_text

(

PG_FUNCTION_ARGS

)

Definition at line 228 of file char.c.

{
    char        arg1 = PG_GETARG_CHAR(0);
    text       *result = palloc(VARHDRSZ + 4);
 
    /*
     * Conversion rules are the same as in charout(), but here we need to be
     * honest about converting 0x00 to an empty string.
     */
    if (IS_HIGHBIT_SET(arg1))
    {
        SET_VARSIZE(result, VARHDRSZ + 4);
        (VARDATA(result))[0] = '\\';
        (VARDATA(result))[1] = TOOCTAL(((unsigned char) arg1) >> 6);
        (VARDATA(result))[2] = TOOCTAL((((unsigned char) arg1) >> 3) & 07);
        (VARDATA(result))[3] = TOOCTAL(((unsigned char) arg1) & 07);
    }
    else if (arg1 != '\0')
    {
        SET_VARSIZE(result, VARHDRSZ + 1);
        *(VARDATA(result)) = arg1;
    }
    else
        SET_VARSIZE(result, VARHDRSZ);
 
    PG_RETURN_TEXT_P(result);
}

References IS_HIGHBIT_SET, palloc(), PG_GETARG_CHAR, PG_RETURN_TEXT_P, SET_VARSIZE(), TOOCTAL, VARDATA(), and VARHDRSZ.

chareq()

Datum chareq

(

PG_FUNCTION_ARGS

)

Definition at line 127 of file char.c.

{
    char        arg1 = PG_GETARG_CHAR(0);
    char        arg2 = PG_GETARG_CHAR(1);
 
    PG_RETURN_BOOL(arg1 == arg2);
}

References PG_GETARG_CHAR, and PG_RETURN_BOOL.

charge()

Datum charge

(

PG_FUNCTION_ARGS

)

Definition at line 172 of file char.c.

{
    char        arg1 = PG_GETARG_CHAR(0);
    char        arg2 = PG_GETARG_CHAR(1);
 
    PG_RETURN_BOOL((uint8) arg1 >= (uint8) arg2);
}

References PG_GETARG_CHAR, and PG_RETURN_BOOL.

chargt()

Datum chargt

(

PG_FUNCTION_ARGS

)

Definition at line 163 of file char.c.

{
    char        arg1 = PG_GETARG_CHAR(0);
    char        arg2 = PG_GETARG_CHAR(1);
 
    PG_RETURN_BOOL((uint8) arg1 > (uint8) arg2);
}

References PG_GETARG_CHAR, and PG_RETURN_BOOL.

charin()

Datum charin

(

PG_FUNCTION_ARGS

)

Definition at line 41 of file char.c.

{
    char       *ch = PG_GETARG_CSTRING(0);
 
    if (strlen(ch) == 4 && ch[0] == '\\' &&
        ISOCTAL(ch[1]) && ISOCTAL(ch[2]) && ISOCTAL(ch[3]))
        PG_RETURN_CHAR((FROMOCTAL(ch[1]) << 6) +
                       (FROMOCTAL(ch[2]) << 3) +
                       FROMOCTAL(ch[3]));
    /* This will do the right thing for a zero-length input string */
    PG_RETURN_CHAR(ch[0]);
}

References FROMOCTAL, ISOCTAL, PG_GETARG_CSTRING, and PG_RETURN_CHAR.

charle()

Datum charle

(

PG_FUNCTION_ARGS

)

Definition at line 154 of file char.c.

{
    char        arg1 = PG_GETARG_CHAR(0);
    char        arg2 = PG_GETARG_CHAR(1);
 
    PG_RETURN_BOOL((uint8) arg1 <= (uint8) arg2);
}

References PG_GETARG_CHAR, and PG_RETURN_BOOL.

charlt()

Datum charlt

(

PG_FUNCTION_ARGS

)

Definition at line 145 of file char.c.

{
    char        arg1 = PG_GETARG_CHAR(0);
    char        arg2 = PG_GETARG_CHAR(1);
 
    PG_RETURN_BOOL((uint8) arg1 < (uint8) arg2);
}

References PG_GETARG_CHAR, and PG_RETURN_BOOL.

charne()

Datum charne

(

PG_FUNCTION_ARGS

)

Definition at line 136 of file char.c.

{
    char        arg1 = PG_GETARG_CHAR(0);
    char        arg2 = PG_GETARG_CHAR(1);
 
    PG_RETURN_BOOL(arg1 != arg2);
}

References PG_GETARG_CHAR, and PG_RETURN_BOOL.

charout()

Datum charout

(

PG_FUNCTION_ARGS

)

Definition at line 64 of file char.c.

{
    char        ch = PG_GETARG_CHAR(0);
    char       *result = (char *) palloc(5);
 
    if (IS_HIGHBIT_SET(ch))
    {
        result[0] = '\\';
        result[1] = TOOCTAL(((unsigned char) ch) >> 6);
        result[2] = TOOCTAL((((unsigned char) ch) >> 3) & 07);
        result[3] = TOOCTAL(((unsigned char) ch) & 07);
        result[4] = '\0';
    }
    else
    {
        /* This produces acceptable results for 0x00 as well */
        result[0] = ch;
        result[1] = '\0';
    }
    PG_RETURN_CSTRING(result);
}

References IS_HIGHBIT_SET, palloc(), PG_GETARG_CHAR, PG_RETURN_CSTRING, and TOOCTAL.

charrecv()

Datum charrecv

(

PG_FUNCTION_ARGS

)

Definition at line 94 of file char.c.

{
    StringInfo  buf = (StringInfo) PG_GETARG_POINTER(0);
 
    PG_RETURN_CHAR(pq_getmsgbyte(buf));
}

References buf, PG_GETARG_POINTER, PG_RETURN_CHAR, and pq_getmsgbyte().

charsend()

Datum charsend

(

PG_FUNCTION_ARGS

)

Definition at line 105 of file char.c.

{
    char        arg1 = PG_GETARG_CHAR(0);
    StringInfoData buf;
 
    pq_begintypsend(&buf);
    pq_sendbyte(&buf, arg1);
    PG_RETURN_BYTEA_P(pq_endtypsend(&buf));
}

References buf, PG_GETARG_CHAR, PG_RETURN_BYTEA_P, pq_begintypsend(), pq_endtypsend(), and pq_sendbyte().

chartoi4()

Datum chartoi4

(

PG_FUNCTION_ARGS

)

Definition at line 182 of file char.c.

{
    char        arg1 = PG_GETARG_CHAR(0);
 
    PG_RETURN_INT32((int32) ((int8) arg1));
}

References PG_GETARG_CHAR, and PG_RETURN_INT32.

i4tochar()

Datum i4tochar

(

PG_FUNCTION_ARGS

)

Definition at line 190 of file char.c.

{
    int32       arg1 = PG_GETARG_INT32(0);
 
    if (arg1 < SCHAR_MIN || arg1 > SCHAR_MAX)
        ereport(ERROR,
                (errcode(ERRCODE_NUMERIC_VALUE_OUT_OF_RANGE),
                 errmsg("\"char\" out of range")));
 
    PG_RETURN_CHAR((int8) arg1);
}

References ereport, errcode(), errmsg(), ERROR, PG_GETARG_INT32, and PG_RETURN_CHAR.

text_char()

Datum text_char

(

PG_FUNCTION_ARGS

)

Definition at line 204 of file char.c.

{
    text       *arg1 = PG_GETARG_TEXT_PP(0);
    char       *ch = VARDATA_ANY(arg1);
    char        result;
 
    /*
     * Conversion rules are the same as in charin(), but here we need to
     * handle the empty-string case honestly.
     */
    if (VARSIZE_ANY_EXHDR(arg1) == 4 && ch[0] == '\\' &&
        ISOCTAL(ch[1]) && ISOCTAL(ch[2]) && ISOCTAL(ch[3]))
        result = (FROMOCTAL(ch[1]) << 6) +
            (FROMOCTAL(ch[2]) << 3) +
            FROMOCTAL(ch[3]);
    else if (VARSIZE_ANY_EXHDR(arg1) > 0)
        result = ch[0];
    else
        result = '\0';
 
    PG_RETURN_CHAR(result);
}

References FROMOCTAL, ISOCTAL, PG_GETARG_TEXT_PP, PG_RETURN_CHAR, VARDATA_ANY(), and VARSIZE_ANY_EXHDR().