[This is preliminary documentation and is subject to change.]
Compares this instance with an array.
Declaration Syntax| C# | Visual Basic | Visual C++ |
public bool Equals( params Object[] objects )
Public Function Equals ( _ ParamArray objects As Object() _ ) As Boolean
public: bool Equals( ... array<Object^>^ objects )
Parameters- objects (array< Object >[]()[])
- The array to compare with.
Return ValueBoolean indicating if they are equal.
Remarks
This instance and the array are considered equal when:
- Both contain the same number of values/elements.
- The String representations of the individual values/elements are the same.
When spaces are non-significant according to part 5, they are left out, when comparing, like specified below.
When the attribute, this instance belongs to, has VR AE, CS, DS, IS, LO or SH, all leading and trailing spaces are removed before comparing.
When the attribute, this instance belongs to, has VR LT, PN, ST, TM or UT, all trailing spaces are removed before comparing.
When the attribute, this instance belongs to, has VR DA or DT, all trailing spaces are removed before comparing although nothing is mentioned in part 5 about non-significant spaces. This is because trailing spaces may be present in queries with range matching.
- Both contain the same number of values/elements.
- The String representations of the individual values/elements are the same.
When spaces are non-significant according to part 5, they are left out, when comparing, like specified below.
When the attribute, this instance belongs to, has VR AE, CS, DS, IS, LO or SH, all leading and trailing spaces are removed before comparing.
When the attribute, this instance belongs to, has VR LT, PN, ST, TM or UT, all trailing spaces are removed before comparing.
When the attribute, this instance belongs to, has VR DA or DT, all trailing spaces are removed before comparing although nothing is mentioned in part 5 about non-significant spaces. This is because trailing spaces may be present in queries with range matching.