File: attr.gd

package info (click to toggle)
gap 4r4p10-2
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 29,224 kB
  • ctags: 7,084
  • sloc: ansic: 98,591; sh: 3,284; perl: 2,263; makefile: 467; awk: 6
file content (65 lines) | stat: -rw-r--r-- 2,743 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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
#############################################################################
##
#W  attr.gd                     GAP library                      Steve Linton
##
#H  @(#)$Id: attr.gd,v 4.7 2002/04/15 10:04:26 sal Exp $
##
#Y  Copyright (C)  1996,  Lehrstuhl D fuer Mathematik,  RWTH Aachen,  Germany
#Y  (C) 1998 School Math and Comp. Sci., University of St.  Andrews, Scotland
#Y  Copyright (C) 2002 The GAP Group
Revision.attr_gd :=
  "@(#)$Id: attr.gd,v 4.7 2002/04/15 10:04:26 sal Exp $";

#1  
##  The normal behaviour of attributes (when called with just one argument)
##  is that once a method has been selected and executed, and has returned a
##  value the setter of the attribute is called, to (possibly) store the
##  computed value. In special circumstances, this behaviour can be altered
##  dynamically on an attribute-by-attribute basis, using the functions
##  `DisableAttributeValueStoring' and `EnableAttributeValueStoring'.
##
##  In general, the code in the library assumes, for efficiency, but not for
##  correctness, that attribute values *will* be stored (in suitable
##  objects), so disabling storing may cause substantial computations to be
##  repeated.
##

#############################################################################
##
#V  InfoAttributes . . . info class for reporting on attribute tweaking
##
##  This info class (together with `InfoWarning'; see~"InfoWarning") is  used
##  for messages about attribute storing  being  disabled  (at  level  2)  or
##  enabled (level 3). It may be  used  in  the  future  for  other  messages
##  concerning changes to attribute behaviour.
##

DeclareInfoClass("InfoAttributes");

#############################################################################
##
#F  EnableAttributeValueStoring( <attr> ) tell attr. to resume storing values
##
##  enables the usual call of `Setter( <attr> )' when  a  method  for  <attr>
##  returns a value. In consequence the  values  may  be  stored.  This  will
##  usually  have  no  effect   unless   `DisableAttributeValueStoring'   has
##  previously been used for <attr>. Note that <attr> must  be  an  attribute
##  and *not* a property.
##

DeclareGlobalFunction("EnableAttributeValueStoring");

#############################################################################
##
#F  DisableAttributeValueStoring( <attr> ) tell attr. to stop storing values
##
##  disables the usual call of `Setter( <attr> )' when a  method  for  <attr>
##  returns a value. In consequence the values will  never  be  stored.  Note
##  that <attr> must be an attribute and *not* a property.
##

DeclareGlobalFunction("DisableAttributeValueStoring");

#############################################################################
##
#E