File: tryapplyd.doc

package info (click to toggle)
hol-light 20120602-1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 23,452 kB
  • sloc: ml: 348,797; cpp: 438; java: 279; makefile: 252; sh: 183; yacc: 108; perl: 78; ansic: 57; sed: 39
file content (32 lines) | stat: -rw-r--r-- 911 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
\DOC tryapplyd

\TYPE {tryapplyd : ('a, 'b) func -> 'a -> 'b -> 'b}

\SYNOPSIS
Applies a finite partial function, with a default for undefined points.

\DESCRIBE
This is one of a suite of operations on finite partial functions, type 
{('a,'b)func}. These may sometimes be preferable to ordinary functions since
they permit more operations such as equality comparison, extraction of domain
etc. If {f} is a finite partial function, {x} an element of its domain type and 
{y} of its range type, the call {tryapplyd f x y} tries to apply {f} to the 
value {x}, as with {apply f x}, but if it is undefined, simply returns {y} 

\FAILURE
Never fails.

\EXAMPLE
{
  # tryapplyd (1 |=> 2) 1 (-1);;
  val it : int = 2
  
  # tryapplyd undefined 1 (-1);;
  val it : int = -1
}

\SEEALSO
|->, |=>, apply, applyd, choose, combine, defined, dom, foldl, foldr, 
graph, is_undefined, mapf, ran, undefine, undefined.

\ENDDOC