Home Accessibility Courses Twitter The Mouth Facebook Resources Site Map About Us Contact
For 2021 - online Python 3 training - see ((here)).

Our plans were to retire in summer 2020 and see the world, but Coronavirus has lead us into a lot of lockdown programming in Python 3 and PHP 7.
We can now offer tailored online training - small groups, real tutors - works really well for groups of 4 to 14 delegates. Anywhere in the world; course language English.

Please ask about private 'maintenance' training for Python 2, Tcl, Perl, PHP, Lua, etc.
proc coverage example
Other Facilities in Tcl example from a Well House Consultants training course
More on Other Facilities in Tcl [link]

This example is described in the following article(s):
   • Coverage map in Tcl - how many times has each proc been called? - [link]

Source code: times Module: T214

# Provision of a simple coverage map in Tcl
# Shows how you can find the number of calls made to each proc in your code

# Globals needed during coverage analysis
# (Have to use globals as we cannot change arguments)

# Namespace resolution needs adding if you use namepaces

set call_order ""
set procnames ""

# Define here any procs that we do NOT want analysed, such as our own ones relating to coverage

proc report {} {
        global call_order
        foreach call $call_order {
                incr callcounter($call)
        puts [format "\n%20s %5s" "proc name" count]
        puts [format "%20s %5s" --------- -----]
        # change to loop through procnames if you want to include procs not called
        foreach fn [array names callcounter] {
                puts [format "%20s %5d" $fn $callcounter($fn)]

# Hide the original proc command and write a new one
# which wraps (decorates) the original with our coverage code

rename proc my_proc
my_proc proc {name arglist body} {

        # stuff to log as we apply the wrapping
        # (making note of all the names of the things we wrap
        global procnames
        lappend procnames $name

        # Within the body, add in extra code to note each call made
        # This is a bit crude - simply a long list of calls
        # Use of quotes rather than braces to ensure dollar expansion at the right time
        # semicolon to end statements, as backslash-return become a space not a return
        my_proc $name $arglist " \
                global call_order; \
                lappend call_order $name; \
                $body \

# ------------------------------------------------------------------------

# The application

proc area {a b} {
        # area of rectangular table
        return [expr $a * $b]
proc circum {a b} {
        # circumference of rectangular table
        return [expr 2 * ($a + $b)]
proc doggydistance {a b} {
        # Shortest distance from edge to middle of table
        set closest [expr (($a > $b) ? $b : $a) / 2.0]
        return $closest

set a [area 100 200]
set b [circum 100 200]
set b [circum 100 200]
set b [circum 100 200]
set b [circum 100 200]

puts $a
puts $b

# ---------------------------------------------------------

# Reporting on coverage after it's run

puts "-------------------------------"
puts "\n** List of calls made in order"
puts $call_order

puts "\n** Counts of calls to each wrapped proc"

puts "\n** List of procs wrapped"
puts $procnames

# ------------------------------------------------------

# Sample Output

# WomanWithCat:demo grahamellis$ tclsh times
# 20000
# 600
# -------------------------------
# ** List of calls made in order
# area circum circum circum circum
# ** Counts of calls to each wrapped proc
# proc name count
# --------- -----
# area 1
# circum 4
# ** List of procs wrapped
# area circum doggydistance
# WomanWithCat:demo grahamellis$
Learn about this subject
This module and example are covered on the following public courses:
 * Learning to program in Tcl
 * Tcl Programming
 * Tcl Programming
Also available on on site courses for larger groups

Books covering this topic
Yes. We have over 700 books in our library. Books covering Tcl, Tk and Expect are listed here and when you've selected a relevant book we'll link you on to Amazon to order.

Other Examples
This example comes from our "Other Facilities in Tcl" training module. You'll find a description of the topic and some other closely related examples on the "Other Facilities in Tcl" module index page.

Full description of the source code
You can learn more about this example on the training courses listed on this page, on which you'll be given a full set of training notes.

Many other training modules are available for download (for limited use) from our download centre under an Open Training Notes License.

Other resources
• Our Solutions centre provides a number of longer technical articles.
• Our Opentalk forum archive provides a question and answer centre.
The Horse's mouth provides a daily tip or thought.
• Further resources are available via the resources centre.
• All of these resources can be searched through through our search engine
• And there's a global index here.

Web site author
This web site is written and maintained by Well House Consultants.

Purpose of this website
This is a sample program, class demonstration or answer from a training course. It's main purpose is to provide an after-course service to customers who have attended our public private or on site courses, but the examples are made generally available under conditions described below.

Conditions of use
Past attendees on our training courses are welcome to use individual examples in the course of their programming, but must check the examples they use to ensure that they are suitable for their job. Remember that some of our examples show you how not to do things - check in your notes. Well House Consultants take no responsibility for the suitability of these example programs to customer's needs.

This program is copyright Well House Consultants Ltd. You are forbidden from using it for running your own training courses without our prior written permission. See our page on courseware provision for more details.

Any of our images within this code may NOT be reused on a public URL without our prior permission. For Bona Fide personal use, we will often grant you permission provided that you provide a link back. Commercial use on a website will incur a license fee for each image used - details on request.

You can Add a comment or ranking to this page

© WELL HOUSE CONSULTANTS LTD., 2021: 48 Spa Road • Melksham, Wiltshire • United Kingdom • SN12 7NY
PH: 01144 1225 708225 • EMAIL: info@wellho.net • WEB: http://www.wellho.net • SKYPE: wellho

PAGE: http://www.wellho.net/resources/ex.php • PAGE BUILT: Sun Oct 11 14:50:09 2020 • BUILD SYSTEM: JelliaJamb