summaryrefslogtreecommitdiff
path: root/xc/unsupported/doc/PHIGS/man3/p028
blob: 2d535854c47591a2094c1335f937bef4676b2e69 (plain)
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
.\"
.\" $XConsortium: p028,v 5.1 91/02/16 09:37:13 rws Exp $
.\"
.\" 
$XMCOPY
.\" Copyright (c) 1990, 1991 by Sun Microsystems, Inc. and the X Consortium.
.\" 
.\"                         All Rights Reserved
.\" 
.\" Permission to use, copy, modify, and distribute this software and its 
.\" documentation for any purpose and without fee is hereby granted, 
.\" provided that the above copyright notice appear in all copies and that
.\" both that copyright notice and this permission notice appear in 
.\" supporting documentation, and that the names of Sun Microsystems,
.\" and the X Consortium not be used in advertising or publicity 
.\" pertaining to distribution of the software without specific, written 
.\" prior permission.  
.\" 
.\" SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
.\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\" EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\" CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\" USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\" OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.TH "DELETE ALL STRUCTURES" 3P "29 February 1991"
.SH NAME
DELETE ALL STRUCTURES \- remove all existing structures from the Central Structure Store
.IX "Structures" "DELETE ALL STRUCTURES"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pdel_all_structs ()
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, *, *)
.SH DESCRIPTION
.SS Purpose
Use \s-2DELETE ALL STRUCTURES\s+2 to remove all the existing structures from the Central Structure Store.
.SS C Input Parameters
None
.SS Execution
The \s-2DELETE ALL STRUCTURES\s+2 subroutine removes all the existing structures from the Central Structure Store. To do this, \s-2DELETE ALL STRUCTURES\s+2 executes the \s-2DELETE STRUCTURE\s+2 function for each existing structure.  All structure identifiers and structure elements are deleted, with the exception of an open structure.
.LP
If a structure is open, \s-2DELETE ALL STRUCTURES\s+2 retains the structure with its current structure identifier, but removes all the structure elements from it. The result is to replace the open structure with an empty structure.
.LP
Any structure that is posted to a workstation is unposted.
.SH ERRORS
.IP 002
Ignoring function, function requires state (\s-2PHOP, *, *, *\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "DELETE STRUCTURE (3P)"
.SM "DELETE STRUCTURE NETWORK (3P)"
.SM "DELETE ALL STRUCTURES FROM ARCHIVE (3P)"
.fi