qt4cg / qtspecs

QT4 specifications
https://qt4cg.org/
Other
28 stars 15 forks source link

Editorial: `array:values`, `map:values` #1179

Open ChristianGruen opened 3 months ago

ChristianGruen commented 3 months ago

Triggered by #1087:

  1. Align map:values with array:values
  2. Revise notes.
  3. Rename the functions.

@michaelhkay You suggested that content might be a better name – rather than item – for retrieving the sequence-concatenation of values in map lookups in https://github.com/qt4cg/qtspecs/issues/1169#issuecomment-2074378446. Should we rename the functions to array:contents, map:contents or use array:items and map:items?

michaelhkay commented 3 months ago

"content" does seem a better name than "values". The current name "values" suggests that it simply returns the values that are already present, without any hint of a flattening operation.