Libc-997.1.1.tar.gz

[apple/libc.git] / stdlib / FreeBSD / hcreate.3

diff --git a/stdlib/FreeBSD/hcreate.3 b/stdlib/FreeBSD/hcreate.3
index e6a5e44f0b7964d81041678a1a298bd701f2600c..10cbbafa7eda0cb8cc039248a7860ded636842f5 100644 (file)
--- a/stdlib/FreeBSD/hcreate.3
+++ b/stdlib/FreeBSD/hcreate.3
@@ -1,6 +1,34 @@
-.\" $FreeBSD: src/lib/libc/stdlib/hcreate.3,v 1.4 2003/09/08 19:57:15 ru Exp $
+.\"-
+.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
+.\" All rights reserved.

 .\"
 .\"

-.Dd May 8, 2001
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Klaus Klein.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.\" $FreeBSD: src/lib/libc/stdlib/hcreate.3,v 1.7 2008/07/06 17:03:37 danger Exp $
+.\"
+.Dd July 6, 2008

 .Os
 .Dt HCREATE 3
 .Sh NAME
 .Os
 .Dt HCREATE 3
 .Sh NAME


@@ -111,8 +139,10 @@ is called.
 .Sh RETURN VALUES
 The
 .Fn hcreate
 .Sh RETURN VALUES
 The
 .Fn hcreate

-function returns 0 if it cannot allocate sufficient space for the table;
-otherwise, it returns non-zero.
+function returns 0 if the table creation failed and the global variable
+.Va errno
+is set to indicate the error;
+otherwise, a non-zero value is returned.

 .Pp
 The
 .Fn hdestroy
 .Pp
 The
 .Fn hdestroy


@@ -133,16 +163,6 @@ could not be found or the
 is
 .Dv ENTER
 and the table is full.
 is
 .Dv ENTER
 and the table is full.

-.Sh ERRORS
-The
-.Fn hcreate
-and
-.Fn hsearch
-functions may fail if:
-.Bl -tag -width Er
-.It Bq Er ENOMEM
-Insufficient storage space is available.
-.El

 .Sh EXAMPLES
 The following example reads in strings followed by two numbers
 and stores them in a hash table, discarding duplicates.
 .Sh EXAMPLES
 The following example reads in strings followed by two numbers
 and stores them in a hash table, discarding duplicates.


@@ -200,6 +220,18 @@ main(void)
        return 0;
 }
 .Ed
        return 0;
 }
 .Ed

+.Sh ERRORS
+The
+.Fn hcreate
+and
+.Fn hsearch
+functions may fail if:
+.Bl -tag -width Er
+.It Bq Er ENOMEM
+Insufficient storage space is available.
+.It Bq Er EINVAL
+A table already exists.
+.El

 .Sh SEE ALSO
 .Xr bsearch 3 ,
 .Xr lsearch 3 ,
 .Sh SEE ALSO
 .Xr bsearch 3 ,
 .Xr lsearch 3 ,