File: pdb_CopyRecord.3

package info (click to toggle)
coldsync 3.0%2Bpre3-3
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 3,188 kB
  • ctags: 2,033
  • sloc: ansic: 20,386; perl: 2,302; cpp: 1,640; yacc: 1,102; lex: 802; makefile: 533; sh: 177
file content (68 lines) | stat: -rw-r--r-- 1,779 bytes parent folder | download | duplicates (3)
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
66
67
68
.\" pdb_CopyRecord.3
.\" 
.\" Copyright 2001, Andrew Arensburger.
.\" You may distribute this file under the terms of the Artistic
.\" License, as specified in the README file.
.\"
.\" $Id: pdb_CopyRecord.3,v 1.1 2001/11/20 14:35:20 arensb Exp $
.\"
.\" This man page uses the 'mdoc' formatting macros. If your 'man' uses
.\" the old 'man' package, you may run into problems.
.\"
.Dd Aug 16, 2001
.Dt pdb_CopyRecord 3
.Sh NAME
.Nm pdb_CopyRecord
.Nm pdb_CopyResource
.Nd short description
.Sh LIBRARY
.Pa libpdb
.Sh SYNOPSIS
.Fd #include <pdb.h>
.Ft struct pdb_record *
.Fn pdb_CopyRecord "const struct pdb *db" "const struct pdb_record *rec"
.Ft struct pdb_resource *
.Fn pdb_CopyResource "const struct pdb *db" "const struct pdb_resource *rsrc"
.Sh DESCRIPTION
.Nm pdb_CopyRecord
allocates a new
.Ft struct pdb_record ,
copies to it the record pointed to by
.Fa rec
in database
.Fa db ,
and returns a pointer to the newly-allocated
.Ft struct pdb_record .
This pointer must later be freed with
.Fn pdb_FreeRecord ,
unless it is added to another database using a function such as
.Fn pdb_AppendRecord .
.Pp
.Nm pdb_CopyResource
allocates a new
.Ft struct pdb_resource ,
copies to it the resource pointed to by
.Fa rsrc
in database
.Fa db ,
and returns a pointer to the newly-allocated
.Ft struct pdb_resource .
This pointer must later be freed with
.Fn pdb_FreeResource ,
unless it is added to another database using a function such as
.Fn pdb_AppendResource .
.Sh RETURN VALUE
.Nm pdb_CopyRecord
and
.Nm pdb_CopyResource
return a pointer to the newly-allocated
.Ft struct pdb_record
or
.Ft struct pdb_resource
if successful, or NULL otherwise.
.Sh SEE ALSO
.Xr libpdb 3 ,
.Xr pdb_FreeRecord 3 ,
.Xr pdb_FreeResource 3 .
.Sh AUTHORS
.An Andrew Arensburger Aq arensb@ooblick.com