This function populates the associative array with the set of known properties for the user identified by the unique id user. If the optional set parameter is non-zero, the user is added to the internal table if needed, and the properties in the array are associated with that user in the internal user table.

The keys of the associative array of properties for a new user will include:

fullname — The user's full name.

Any key/value pair may be added.

The internal user table data for a given user is saved with any document that has change records created by that user at the time that the document is written out. A document's user table, including all user properties, is merged into the internal user table when that document is read in a future session.