Status/Resolution/Reason: Closed/Fixed/
Reporter/Name(from Bugbase): CF Searching / CF Searching (CF Searching)
Created: 07/17/2009
Components: Documentation, General
Versions: 9.0
Failure Type: Unspecified
Found In Build/Fixed In Build: 0000 /
Priority/Frequency: Normal / Unknown
Locale/System: English / Platforms All
Vote Count: 0
Problem:
Documention Errors for Array Functions:1. All pages that display a summary of the available Array Functions are missing the new CF9 functions (ArrayContains, ArrayFind, etcetera)Summary PagesI. CFML Reference / ColdFusion Functions / Function ListII. CFML Reference / ColdFusion Functions / Functions by category (Array Functions)III. Developing Applications with ColdFusion 9 / The CFML Programming Language / Using Arrays and Structures 2. Under "Basic array techniques", the documentation notes that IsDefined does not work on arrays, and recommends using a try/catch block to handle exceptions due to undefined elements. While not a bad programming practice, the documentation should be updated to recommend using the new ArrayContains function instead. A try/catch block would only be required for non-supported COM and CORBA object.CFML Programming Language / Using Arrays and Structures / Basic array techniquesSee: "Note: The IsDefined function does not test the existence of array elements..." 3. The code example for ArrayContains is distorted by whitespace and is unusuable. Also, a trivial comment: the example uses html style comments <!-- -->, instead of CF comments.4. The current "Returns" description is misleading. The _array_ is searched, not the element. Also, the function description should be exapanded to provide a more complete description of the overall behavior. {Suggestions}Description:"This function searches an array for the presence of the specified object. The function can search for simple objects such as strings and numbers, or complex objects like structures. String searches are case sensitive. This function does not support searches for COM and CORBA objects."Returns:"Yes, if the specified object exists in the array"
Method:
Result:
----------------------------- Additional Watson Details -----------------------------
Watson Bug ID: 3039345
External Customer Info:
External Company:
External Customer Name: CF Searching
External Customer Email: 248D17EF472002E0992015B9
External Test Config: 07/17/2009Attachments:
Comments: