[OASIS Issue Tracker] Created: (ODATA-401) Replace "substringof" canonical function with "contains"

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

Replace "substringof" canonical function with "contains"
--------------------------------------------------------

                 Key: ODATA-401
                 URL: http://tools.oasis-open.org/issues/browse/ODATA-401
             Project: OASIS Open Data Protocol (OData) TC
          Issue Type: Improvement
          Components: OData ABNF Construction Rules, OData Protocol , OData URL Conventions 
    Affects Versions: V4.0_CSD01
         Environment: [Proposed]
            Reporter: Michael Pizzo
             Fix For: V4.0_CSD02


The current definition of substringof takes first the string being searched for, and second the string being searched in.
This is widely held to be the wrong order, especially since other string functions generally take the string as the first argument.
This issue has long been a source of confusion in OData, made worse by the fact that the documentation often disagreed with the examples, and the documentation has changed several times.

To prevent any confusion with legacy, I propose we retire the "substringof" function all together and replace it with "contains" with the argument in the more intuitive order (sourcestring, searchtext)

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira