Studio:Scl ptr flist - Revision history

Timd: Text replace - 'Category: Function Pointers' to 'Category:Studio:Function Pointers'

2009-08-21T00:49:56Z

Text replace - 'Category: Function Pointers' to 'Category:Studio:Function Pointers'

← Older revision		Revision as of 00:49, 21 August 2009
Line 49:		Line 49:
	* For additional information on scl_ptr_flist(), including constraints, refer to the section on scl_ptr_flist() in the [[Media:s2sSCLReferenceGuide.pdf\|SCL Reference Guide]].		* For additional information on scl_ptr_flist(), including constraints, refer to the section on scl_ptr_flist() in the [[Media:s2sSCLReferenceGuide.pdf\|SCL Reference Guide]].

	[[Category: Function Pointers]]		[[Category:Studio:Function Pointers]]
	[[Category:Studio:SCL]]		[[Category:Studio:SCL]]

Timd: Text replace - 'Category: SCL' to 'Category:Studio:SCL'

2009-08-21T00:11:44Z

Text replace - 'Category: SCL' to 'Category:Studio:SCL'

← Older revision		Revision as of 00:11, 21 August 2009
Line 50:		Line 50:

	[[Category: Function Pointers]]		[[Category: Function Pointers]]
	[[Category: SCL]]		[[Category:Studio:SCL]]

Timd: Scl ptr flist moved to Studio:Scl ptr flist

2009-08-18T22:41:25Z

Scl ptr flist moved to Studio:Scl ptr flist

← Older revision	Revision as of 22:41, 18 August 2009
(No difference)

Stevel: /* See Also */

2008-10-08T20:24:01Z

See Also

← Older revision		Revision as of 20:24, 8 October 2008
Line 47:		Line 47:

	== See Also ==		== See Also ==
	* For additional information on scl_ptr_flist(), including constraints, refer to the section on scl_ptr_flist() in the [~~http~~:~~//www.s2technologies.com/pdf/~~s2sSCLReferenceGuide.pdf SCL Reference Guide].		* For additional information on scl_ptr_flist(), including constraints, refer to the section on scl_ptr_flist() in the [[Media:s2sSCLReferenceGuide.pdf\|SCL Reference Guide]].

	[[Category: Function Pointers]]		[[Category: Function Pointers]]
	[[Category: SCL]]		[[Category: SCL]]

Ivailop: /* See Also */

2008-10-02T17:55:21Z

See Also

← Older revision		Revision as of 17:55, 2 October 2008
Line 50:		Line 50:

	[[Category: Function Pointers]]		[[Category: Function Pointers]]
	[[Category: ~~SCL_Reference~~]]		[[Category: SCL]]

Ivailop: /* See Also */

2008-10-02T17:39:05Z

See Also

← Older revision		Revision as of 17:39, 2 October 2008
Line 49:		Line 49:
	* For additional information on scl_ptr_flist(), including constraints, refer to the section on scl_ptr_flist() in the [http://www.s2technologies.com/pdf/s2sSCLReferenceGuide.pdf SCL Reference Guide].		* For additional information on scl_ptr_flist(), including constraints, refer to the section on scl_ptr_flist() in the [http://www.s2technologies.com/pdf/s2sSCLReferenceGuide.pdf SCL Reference Guide].

			[[Category: Function Pointers]]
	[[Category: SCL_Reference]]		[[Category: SCL_Reference]]

Ivailop: /* See Also */

2008-10-02T00:21:11Z

See Also

← Older revision		Revision as of 00:21, 2 October 2008
Line 47:		Line 47:

	== See Also ==		== See Also ==
	* For additional information on scl_ptr_flist(), including constraints, refer to the section on scl_ptr_flist() in the [http://www.s2technologies.com/pdf/s2sSCLReferenceGuide.pdf SCL Reference Guide]].		* For additional information on scl_ptr_flist(), including constraints, refer to the section on scl_ptr_flist() in the [http://www.s2technologies.com/pdf/s2sSCLReferenceGuide.pdf SCL Reference Guide].

	[[Category: SCL_Reference]]		[[Category: SCL_Reference]]

Stevel at 17:55, 16 July 2008

2008-07-16T17:55:15Z

← Older revision		Revision as of 17:55, 16 July 2008
Line 46:		Line 46:
	* Payload fields of type pointer to function that are not explicitly associated with a list of candidates are treated as if they have been declared as void *.		* Payload fields of type pointer to function that are not explicitly associated with a list of candidates are treated as if they have been declared as void *.

	For additional information on scl_ptr_flist(), including constraints, refer to the section on scl_ptr_flist() in the [http://www.s2technologies.com/pdf/s2sSCLReferenceGuide.pdf SCL Reference Guide]].		== See Also ==
			* For additional information on scl_ptr_flist(), including constraints, refer to the section on scl_ptr_flist() in the [http://www.s2technologies.com/pdf/s2sSCLReferenceGuide.pdf SCL Reference Guide]].

			[[Category: SCL_Reference]]

Stevel: New page: = The scl_ptr_flist pragma= The scl_ptr_flist() pragma is used to specify the candidate functions that are available for a specific function pointer data type. #pragma scl_ptr_flist(typ...

2008-07-10T22:02:36Z

New page: = The scl_ptr_flist pragma= The scl_ptr_flist() pragma is used to specify the candidate functions that are available for a specific function pointer data type. #pragma scl_ptr_flist(typ...

New page

= The scl_ptr_flist pragma=

The scl_ptr_flist() pragma is used to specify the candidate functions that are available for a specific function pointer data type.

#pragma scl_ptr_flist(type-name, default-name)

#pragma scl_ptr_flist(type-name, field-name, default-name)

#pragma scl_ptr_flist(type-name, candidate-1, candidate-2..n)

#pragma scl_ptr_flist(type-name, field-name, candidate-1, candidate-2..n)

== Syntax ==

{| border="1" cellspacing="0" cellpadding="10" style="align:left;"
| '''Parameters'''
| '''Type'''
| '''Description'''
|-
| ''type-name''
| String
| Name of the type that contains the function pointer
|-
| ''field-name''
| Member
| Name of the pointer member within the struct/union or in the parameter list of the function
|-
| ''candidate-1''
| String
| Name of the candidate function
|-
| ''candidate-2..n [Optional]''
| String
| Optional name(s) of additional candidate function(s)
|-
| ''default-name''
| Quoted string
| Name to be assigned to the default function (quoted string)
|}

== Notes ==
* The syntax shown in form 1 of 4 above should only be used when function pointers are part of the command payload.
* The syntax shown in form 2 of 4 above should only be used when returning function pointers.
* A function pointer data type as written in ANSI C merely specifies the format of the prototype. The format of the prototype is the data type of the return value and the datatypes of the parameters, if any. The scl_ptr_flist() pragma is therefore required by the SCL compiler to indicate which SCL-compatible interfaces are associated with a particular function pointer data type.
* When a payload contains a field that is a pointer to a function, it is possible that the receiver of such a payload may make a call using the value received. Because the set of possible functions that might be passed is very large, and because all remotable methods must be identified with a SUID, each such payload value be constrained to identify the specific set of functions that might be passed. These are referred to as the candidates. Each candidate must be known by its name. The [[scl_brew_class|scl_brew_class()]] and scl_ptr_flist() pragmas are used for constraining fields of type pointer to function in this way.
* Payload fields of type pointer to function that are not explicitly associated with a list of candidates are treated as if they have been declared as void *.

For additional information on scl_ptr_flist(), including constraints, refer to the section on scl_ptr_flist() in the [http://www.s2technologies.com/pdf/s2sSCLReferenceGuide.pdf SCL Reference Guide]].