User Guide

1066 Chapter 7: ColdFusion C++ CFX Reference
Returns
Returns the value of the attribute passed to the tag. If no attribute of that name was passed to the
tag, an empty string is returned.
Parameters
Example
The following example retrieves an attribute named DESTINATION and writes its value back to the
user:
LPCSTR lpszDestination = pRequest->GetAttribute("DESTINATION") ;
pRequest->Write( "The destination is: " ) ;
pRequest->Write( lpszDestination ) ;
CCFXRequest::GetAttributeList
Syntax
CCFXStringSet* CCFXRequest::GetAttributeList(void)
Description
Gets an array of attribute names passed to the tag. To get the value of one attribute, use
CCFXRequest::GetAttribute.
Returns
Returns an object of class CCFXStringSet class that contains a list of attributes passed to the
tag. The memory allocated for the returned string set is freed automatically by ColdFusion after
the request is completed.
Example
The following example gets the list of attributes and iterates over the list, writing each attribute
and its value back to the user.
LPCSTR lpszName, lpszValue ;
CCFXStringSet* pAttribs = pRequest->GetAttributeList() ;
int nNumAttribs = pAttribs->GetCount() ;
for( int i=1; i<=nNumAttribs; i++ )
{
lpszName = pAttribs->GetString( i ) ;
lpszValue = pRequest->GetAttribute( lpszName ) ;
pRequest->Write( lpszName ) ;
pRequest->Write( " = " ) ;
pRequest->Write( lpszValue ) ;
pRequest->Write( "<BR>" ) ;
}
Parameter Description
lpszName Name of the attribute to retrieve (case insensitive)