Skip to content

Commit b6477c6

Browse files
bmomjianbmomjian
committed
Add regexp_replace() to string functions section.
Joachim Wieland
1 parent fcc02c2 commit b6477c6

File tree

9 files changed

+491
-42
lines changed

9 files changed

+491
-42
lines changed

‎doc/src/sgml/func.sgml‎

Lines changed: 19 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.318 2006/05/18 03:18:24 momjian Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.319 2006/05/30 11:54:51 momjian Exp $ -->
22

33
<chapter id="functions">
44
<title>Functions and Operators</title>
@@ -1112,7 +1112,9 @@
11121112
<entry><literal><function>substring</function>(<parameter>string</parameter> from <replaceable>pattern</replaceable>)</literal></entry>
11131113
<entry><type>text</type></entry>
11141114
<entry>
1115-
Extract substring matching POSIX regular expression
1115+
Extract substring matching POSIX regular expression. See
1116+
<xref linkend="functions-matching"> for more information on pattern
1117+
matching.
11161118
</entry>
11171119
<entry><literal>substring('Thomas' from '...$')</literal></entry>
11181120
<entry><literal>mas</literal></entry>
@@ -1122,8 +1124,9 @@
11221124
<entry><literal><function>substring</function>(<parameter>string</parameter> from <replaceable>pattern</replaceable> for <replaceable>escape</replaceable>)</literal></entry>
11231125
<entry><type>text</type></entry>
11241126
<entry>
1125-
Extract substring matching <acronym>SQL</acronym> regular
1126-
expression
1127+
Extract substring matching <acronym>SQL</acronym> regular expression.
1128+
See <xref linkend="functions-matching"> for more information on
1129+
pattern matching.
11271130
</entry>
11281131
<entry><literal>substring('Thomas' from '%#"o_a#"_' for '#')</literal></entry>
11291132
<entry><literal>oma</literal></entry>
@@ -1420,6 +1423,18 @@
14201423
<entry><literal>'O''Reilly'</literal></entry>
14211424
</row>
14221425

1426+
<row>
1427+
<entry><literal><function>regexp_replace</function>(<parameter>string</parameter> <type>text</type>, <parameter>pattern</parameter> <type>text</type>, <parameter>replacement</parameter> <type>text</type> [,<parameter>flags</parameter> <type>text</type>])</literal></entry>
1428+
<entry><type>text</type></entry>
1429+
<entry>
1430+
Replace substring matching POSIX regular expression. See
1431+
<xref linkend="functions-matching"> for more information on pattern
1432+
matching.
1433+
</entry>
1434+
<entry><literal>regexp_replace('Thomas', '.[mN]a.', 'M')</literal></entry>
1435+
<entry><literal>ThM</literal></entry>
1436+
</row>
1437+
14231438
<row>
14241439
<entry><literal><function>repeat</function>(<parameter>string</parameter> <type>text</type>, <parameter>number</parameter> <type>int</type>)</literal></entry>
14251440
<entry><type>text</type></entry>

‎doc/src/sgml/plpgsql.sgml‎

Lines changed: 50 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/plpgsql.sgml,v 1.90 2006/05/30 11:40:21 momjian Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/plpgsql.sgml,v 1.91 2006/05/30 11:54:51 momjian Exp $ -->
22

33
<chapter id="plpgsql">
44
<title><application>PL/pgSQL</application> - <acronym>SQL</acronym> Procedural Language</title>
@@ -879,6 +879,55 @@ SELECT merge_fields(t.*) FROM table1 t WHERE ... ;
879879
field in it will draw a run-time error.
880880
</para>
881881

882+
<para>
883+
To obtain the values of the fields the record is made up of,
884+
the record variable can be qualified with the column or field
885+
name. This can be done either by literally using the column name
886+
or the column name for indexing the record can be taken out of a scalar
887+
variable. The syntax for this notation is Record_variable.(IndexVariable).
888+
To get information about the column field names of the record,
889+
a special expression exists that returns all column names as an array:
890+
RecordVariable.(*) .
891+
Thus, the RECORD can be viewed
892+
as an associative array that allows for introspection of it's contents.
893+
This feature is especially useful for writing generic triggers that
894+
operate on records with unknown structure.
895+
Here is an example procedure that shows column names and values
896+
of the predefined record NEW in a trigger procedure:
897+
<programlisting>
898+
899+
CREATE OR REPLACE FUNCTION show_associative_records() RETURNS TRIGGER AS $$
900+
DECLARE
901+
colname TEXT;
902+
colcontent TEXT;
903+
colnames TEXT[];
904+
coln INT4;
905+
coli INT4;
906+
BEGIN
907+
-- obtain an array with all field names of the record
908+
colnames := NEW.(*);
909+
RAISE NOTICE 'All column names of test record: %', colnames;
910+
-- show field names and contents of record
911+
coli := 1;
912+
coln := array_upper(colnames,1);
913+
RAISE NOTICE 'Number of columns in NEW: %', coln;
914+
FOR coli IN 1 .. coln LOOP
915+
colname := colnames[coli];
916+
colcontent := NEW.(colname);
917+
RAISE NOTICE 'column % of NEW: %', quote_ident(colname), quote_literal(colcontent);
918+
END LOOP;
919+
-- Do it with a fixed field name:
920+
-- will have to know the column name
921+
RAISE NOTICE 'column someint of NEW: %', quote_literal(NEW.someint);
922+
RETURN NULL;
923+
END;
924+
$$ LANGUAGE plpgsql;
925+
--CREATE TABLE test_records (someint INT8, somestring TEXT);
926+
--CREATE TRIGGER tr_test_record BEFORE INSERT ON test_records FOR EACH ROW EXECUTE PROCEDURE show_associative_records();
927+
928+
</programlisting>
929+
</para>
930+
882931
<para>
883932
Note that <literal>RECORD</> is not a true data type, only a placeholder.
884933
One should also realize that when a <application>PL/pgSQL</application>

‎src/pl/plpgsql/src/pl_comp.c‎

Lines changed: 131 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
*
99
*
1010
* IDENTIFICATION
11-
* $PostgreSQL: pgsql/src/pl/plpgsql/src/pl_comp.c,v 1.102 2006/05/28 03:03:17 adunstan Exp $
11+
* $PostgreSQL: pgsql/src/pl/plpgsql/src/pl_comp.c,v 1.103 2006/05/30 11:54:51 momjian Exp $
1212
*
1313
*-------------------------------------------------------------------------
1414
*/
@@ -884,7 +884,8 @@ plpgsql_parse_dblword(char *word)
884884

885885
new = palloc(sizeof(PLpgSQL_recfield));
886886
new->dtype = PLPGSQL_DTYPE_RECFIELD;
887-
new->fieldname = pstrdup(cp[1]);
887+
new->fieldindex.fieldname = pstrdup(cp[1]);
888+
new->fieldindex_flag = RECFIELD_USE_FIELDNAME;
888889
new->recparentno = ns->itemno;
889890

890891
plpgsql_adddatum((PLpgSQL_datum *) new);
@@ -990,7 +991,8 @@ plpgsql_parse_tripword(char *word)
990991

991992
new = palloc(sizeof(PLpgSQL_recfield));
992993
new->dtype = PLPGSQL_DTYPE_RECFIELD;
993-
new->fieldname = pstrdup(cp[2]);
994+
new->fieldindex.fieldname = pstrdup(cp[2]);
995+
new->fieldindex_flag = RECFIELD_USE_FIELDNAME;
994996
new->recparentno = ns->itemno;
995997

996998
plpgsql_adddatum((PLpgSQL_datum *) new);
@@ -1438,6 +1440,132 @@ plpgsql_parse_dblwordrowtype(char *word)
14381440
return T_DTYPE;
14391441
}
14401442

1443+
/* ----------
1444+
* plpgsql_parse_recindex
1445+
* lookup associative index into record
1446+
* ----------
1447+
*/
1448+
int
1449+
plpgsql_parse_recindex(char *word)
1450+
{
1451+
PLpgSQL_nsitem *ns1, *ns2;
1452+
char *cp[2];
1453+
int ret = T_ERROR;
1454+
char *fieldvar;
1455+
int fl;
1456+
1457+
/* Do case conversion and word separation */
1458+
plpgsql_convert_ident(word, cp, 2);
1459+
Assert(cp[1] != NULL);
1460+
1461+
/* cleanup the "(identifier)" string to "identifier" */
1462+
fieldvar = cp[1];
1463+
Assert(*fieldvar == '(');
1464+
++fieldvar; /* get rid of ( */
1465+
1466+
fl = strlen(fieldvar);
1467+
Assert(fieldvar[fl-1] == ')');
1468+
fieldvar[fl-1] = 0; /* get rid of ) */
1469+
1470+
/*
1471+
* Lookup the first word
1472+
*/
1473+
ns1 = plpgsql_ns_lookup(cp[0], NULL);
1474+
if ( ns1 == NULL )
1475+
{
1476+
pfree(cp[0]);
1477+
pfree(cp[1]);
1478+
return T_ERROR;
1479+
}
1480+
1481+
ns2 = plpgsql_ns_lookup(fieldvar, NULL);
1482+
pfree(cp[0]);
1483+
pfree(cp[1]);
1484+
if ( ns2 == NULL ) /* name lookup failed */
1485+
return T_ERROR;
1486+
1487+
switch (ns1->itemtype)
1488+
{
1489+
case PLPGSQL_NSTYPE_REC:
1490+
{
1491+
/*
1492+
* First word is a record name, so second word must be an
1493+
* variable holding the field name in this record.
1494+
*/
1495+
if ( ns2->itemtype == PLPGSQL_NSTYPE_VAR ) {
1496+
PLpgSQL_recfield *new;
1497+
1498+
new = palloc(sizeof(PLpgSQL_recfield));
1499+
new->dtype = PLPGSQL_DTYPE_RECFIELD;
1500+
new->fieldindex.indexvar_no = ns2->itemno;
1501+
new->fieldindex_flag = RECFIELD_USE_INDEX_VAR;
1502+
new->recparentno = ns1->itemno;
1503+
1504+
plpgsql_adddatum((PLpgSQL_datum *) new);
1505+
1506+
plpgsql_yylval.scalar = (PLpgSQL_datum *) new;
1507+
ret = T_SCALAR;
1508+
}
1509+
break;
1510+
}
1511+
default:
1512+
break;
1513+
}
1514+
return ret;
1515+
}
1516+
1517+
1518+
/* ----------
1519+
* plpgsql_parse_recfieldnames
1520+
* create fieldnames of a record
1521+
* ----------
1522+
*/
1523+
int
1524+
plpgsql_parse_recfieldnames(char *word)
1525+
{
1526+
PLpgSQL_nsitem *ns1;
1527+
char *cp[2];
1528+
int ret = T_ERROR;
1529+
1530+
/* Do case conversion and word separation */
1531+
plpgsql_convert_ident(word, cp, 2);
1532+
1533+
/*
1534+
* Lookup the first word
1535+
*/
1536+
ns1 = plpgsql_ns_lookup(cp[0], NULL);
1537+
if ( ns1 == NULL )
1538+
{
1539+
pfree(cp[0]);
1540+
pfree(cp[1]);
1541+
return T_ERROR;
1542+
}
1543+
1544+
pfree(cp[0]);
1545+
pfree(cp[1]);
1546+
1547+
switch (ns1->itemtype)
1548+
{
1549+
case PLPGSQL_NSTYPE_REC:
1550+
{
1551+
PLpgSQL_recfieldproperties *new;
1552+
1553+
new = palloc(sizeof(PLpgSQL_recfieldproperties));
1554+
new->dtype = PLPGSQL_DTYPE_RECFIELDNAMES;
1555+
new->recparentno = ns1->itemno;
1556+
new->save_fieldnames = NULL;
1557+
plpgsql_adddatum((PLpgSQL_datum *) new);
1558+
plpgsql_yylval.scalar = (PLpgSQL_datum *) new;
1559+
ret = T_SCALAR; /* ??? */
1560+
break;
1561+
}
1562+
default:
1563+
break;
1564+
}
1565+
return ret;
1566+
}
1567+
1568+
14411569
/*
14421570
* plpgsql_build_variable - build a datum-array entry of a given
14431571
* datatype

0 commit comments

Comments
 (0)