Difference between revisions of "Ns adp registerproc"

From AOLserver Wiki
Jump to navigation Jump to search
(Removed contents from ns_register_proc, this is a different command)
Line 1: Line 1:
Man page: http://aolserver.com/docs/tcl/ns_register_proc.html
 
 
----
 
 
 
'''NAME'''
 
'''NAME'''
  
:       ns_adp_registerproc - Register an ADP tag that invokes a procedure
+
: ns_adp_registerproc - Register an XML-like tag for use within an ADP.
  
 
'''SYNOPSIS'''
 
'''SYNOPSIS'''
  
:       '''ns_register_proc'''  
+
: '''ns_adp_registerproc''' tag ''?endtag?'' proc
  
 
'''DESCRIPTION'''
 
'''DESCRIPTION'''
  
 +
: '''ns_adp_registerproc''' registers a procedure to be called when the specified beginning and ending tags are used in an ADP. The ''tag'' is the beginning tag to look for, and the ''endtag'' is the ending tag to look for. The proc is the procedure that will be called when AOLserver encounters those tags when processing an ADP.
 +
 +
: Try not to confuse '''ns_adp_registerproc''' with [[ns_adp_registerscript]]. Both register a Tcl script/proc that is run by the tag. However, this one receives individual arguments for the tag attributes and the other receives them in a single ns_set.
 +
 +
: There are two ways to use '''ns_adp_registerproc''', with and without the ''endtag'' parameter:
 +
 +
* If the endtag parameter is specified, the procedure you specify with proc must be of the form:
 +
 +
    proc myadpproc { args }
 +
 +
: In args, the proc will receive a variable number of arguments for the attributes that were specified with the beginning tag and the last argument will be the string of characters between the beginning tag and the ending tag. The return value of the procedure will be sent to the browser in place of the string of text that was specified between the beginning and ending tags.
 +
 +
: In AOLserver 4.0 and older, the string is not parsed, which means that you could not include ADP tags in the string unless you execute [[ns_adp_parse]] on the string inside the procedure that processes the registered ADP tag.  In AOLserver 4.5, <% %> ADP tags in the string do get parsed.
 +
 +
* If ''endtag'' is not specified, then no closing tag is required. The procedure (proc) will be called every time the specified command is encountered. The procedure will receive variable number of arguments for the attributes to the tag:
 +
 +
    proc myadpproc { args }
 +
 +
 +
'''EXAMPLE'''
 +
 +
: Suppose you want to register a tag that formats the enclosed text only if it is Christmas. You could register the tag as follows:
 +
 +
    ns_adp_registerscript "christmas" "/christmas" xmas
 +
 +
    # Note: We are registering a Tcl proc.
 +
    proc xmas {string args} {
 +
        if {[ns_fmttime [ns_time] "%m/%d"] == "12/25"}  then {
 +
            return $string
 +
        }
 +
    }
 +
 +
: Then, in an ADP, you use these tags:
 +
 +
    <christmas>Merry Christmas to all, and to all a good night!</christmas>
 +
 +
: In another example we show how to use a registered tag without an ''endtag''. The tag is registered as follows:
 +
 +
    ns_adp_registerscript hello helloproc
 +
 +
    # Note: We are registering a Tcl proc.
 +
    proc helloproc { tags } {
 +
        return "Hello, [ns_set get $tags name]."
 +
    }
 +
 +
: In an ADP, you use this tag:
 +
 +
    <hello name=Bob>
 +
 +
: This can be extended to provide XML-like template pages for content.
  
 
'''SEE ALSO'''
 
'''SEE ALSO'''
 +
 +
: [[ns_adp_registerproc]], [[ns_adp_parse]]
 +
 +
[[Category:Documentation]] [[Category:Core Tcl API]]

Revision as of 07:57, 14 October 2009

NAME

ns_adp_registerproc - Register an XML-like tag for use within an ADP.

SYNOPSIS

ns_adp_registerproc tag ?endtag? proc

DESCRIPTION

ns_adp_registerproc registers a procedure to be called when the specified beginning and ending tags are used in an ADP. The tag is the beginning tag to look for, and the endtag is the ending tag to look for. The proc is the procedure that will be called when AOLserver encounters those tags when processing an ADP.
Try not to confuse ns_adp_registerproc with ns_adp_registerscript. Both register a Tcl script/proc that is run by the tag. However, this one receives individual arguments for the tag attributes and the other receives them in a single ns_set.
There are two ways to use ns_adp_registerproc, with and without the endtag parameter:
  • If the endtag parameter is specified, the procedure you specify with proc must be of the form:
   proc myadpproc { args }
In args, the proc will receive a variable number of arguments for the attributes that were specified with the beginning tag and the last argument will be the string of characters between the beginning tag and the ending tag. The return value of the procedure will be sent to the browser in place of the string of text that was specified between the beginning and ending tags.
In AOLserver 4.0 and older, the string is not parsed, which means that you could not include ADP tags in the string unless you execute ns_adp_parse on the string inside the procedure that processes the registered ADP tag. In AOLserver 4.5, <% %> ADP tags in the string do get parsed.
  • If endtag is not specified, then no closing tag is required. The procedure (proc) will be called every time the specified command is encountered. The procedure will receive variable number of arguments for the attributes to the tag:
   proc myadpproc { args }


EXAMPLE

Suppose you want to register a tag that formats the enclosed text only if it is Christmas. You could register the tag as follows:
   ns_adp_registerscript "christmas" "/christmas" xmas
   # Note: We are registering a Tcl proc.
   proc xmas {string args} {
       if {[ns_fmttime [ns_time] "%m/%d"] == "12/25"}  then {
           return $string
       }
   }
Then, in an ADP, you use these tags:
   <christmas>Merry Christmas to all, and to all a good night!</christmas>
In another example we show how to use a registered tag without an endtag. The tag is registered as follows:
   ns_adp_registerscript hello helloproc
   # Note: We are registering a Tcl proc.
   proc helloproc { tags } {
       return "Hello, [ns_set get $tags name]."
   }
In an ADP, you use this tag:
   <hello name=Bob>
This can be extended to provide XML-like template pages for content.

SEE ALSO

ns_adp_registerproc, ns_adp_parse