atImplode

  • Article

atImplode

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

This method concatenates all members of a text list and returns a string or array of strings.

The optional Separator parameter has a default value of " ".

Availability

This method is available in the following object models: Microsoft® Outlook®, Collaboration Data Objects (CDO), and Microsoft ActiveX® Data Objects (ADO).

Syntax



String = atImplode
(

    TextList,
[Separator As String]
)


Remarks




You need to use the Concat method in conjunction with the atImplode method.


Assume you have a Lotus Notes form that contains a field named Flowers and another field named Plants. Calling the Notes @Implode function as shown here




@Implode (Plants + "/" + Flowers)





takes one element from each field, adds a slash, generates a cross product (combines every member of one list with every member of the other list), and returns a text list. For example, if the Plants field contains the string "Plants" and the Flowers field contains "Daisy" and "Tulip", the result would be these strings: "Plants / Daisy", "Plants / Tulip".


To do this using the atImplode atFunction, you need to also use the Concat method, which is available on all three objects of the MXAT library. The following example shows how to use atImplode and Concat together:




Variant1 = AtObject.atImplode(AtObject.Concat(Item.UserProperties("Plants").Value,
AtObject.Concat("/", Item.UserProperties("Flowers")))



Send us your feedback about the Microsoft Exchange Server 2003 SDK.


Build: June 2007 (2007.618.1)


© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.