Nit: "Immutable" should be "pure"
От | PG Doc comments form |
---|---|
Тема | Nit: "Immutable" should be "pure" |
Дата | |
Msg-id | 157313627814.14272.6307248648194149757@wrigleys.postgresql.org обсуждение исходный текст |
Ответы |
Re: Nit: "Immutable" should be "pure"
|
Список | pgsql-docs |
The following documentation comment has been logged on the website: Page: https://www.postgresql.org/docs/12/sql-createindex.html Description: The adjective "immutable" describing the functions and operators used in an index (see two occurrences in doc snippet below) is incorrect and should be replaced with "pure". Both "pure" and "immutable" are in popular lexicon now because of the interest in functional programming, so conflating the two can happen, but the word immutable applies to data and pure applies to functions. See https://en.wikipedia.org/wiki/Pure_function. From the CREATE INDEX doc: All functions and operators used in an index definition must be “immutable”, that is, their results must depend only on their arguments and never on any outside influence (such as the contents of another table or the current time). This restriction ensures that the behavior of the index is well-defined. To use a user-defined function in an index expression or WHERE clause, remember to mark the function immutable when you create it.
В списке pgsql-docs по дате отправления: