xref: /netbsd-src/lib/libc/locale/wcsftime.3 (revision 7a25a0c726960631a7ebfddfd8edba473b9df5a9)
1*7a25a0c7Srillig.\" $NetBSD: wcsftime.3,v 1.4 2024/09/10 04:43:39 rillig Exp $
2215d7976Swiz.\"
3215d7976Swiz.\" Copyright (c) 2002 Tim J. Robbins
4215d7976Swiz.\" All rights reserved.
5215d7976Swiz.\"
6215d7976Swiz.\" Redistribution and use in source and binary forms, with or without
7215d7976Swiz.\" modification, are permitted provided that the following conditions
8215d7976Swiz.\" are met:
9215d7976Swiz.\" 1. Redistributions of source code must retain the above copyright
10215d7976Swiz.\"    notice, this list of conditions and the following disclaimer.
11215d7976Swiz.\" 2. Redistributions in binary form must reproduce the above copyright
12215d7976Swiz.\"    notice, this list of conditions and the following disclaimer in the
13215d7976Swiz.\"    documentation and/or other materials provided with the distribution.
14215d7976Swiz.\"
15215d7976Swiz.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16215d7976Swiz.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17215d7976Swiz.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18215d7976Swiz.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19215d7976Swiz.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20215d7976Swiz.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21215d7976Swiz.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22215d7976Swiz.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23215d7976Swiz.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24215d7976Swiz.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25215d7976Swiz.\" SUCH DAMAGE.
26215d7976Swiz.\"
27215d7976Swiz.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/locale/wcsftime.3,v 1.2 2002/11/29 17:35:09 ru Exp $
28215d7976Swiz.\"
29ff8dfca3Sjruoho.Dd April 14, 2011
30215d7976Swiz.Dt WCSFTIME 3
31215d7976Swiz.Os
32215d7976Swiz.Sh NAME
33215d7976Swiz.Nm wcsftime
34215d7976Swiz.Nd "convert date and time to a wide-character string"
35215d7976Swiz.Sh LIBRARY
36215d7976Swiz.Lb libc
37215d7976Swiz.Sh SYNOPSIS
38215d7976Swiz.In wchar.h
39215d7976Swiz.Ft size_t
40215d7976Swiz.Fo wcsftime
41*7a25a0c7Srillig.Fa "wchar_t * restrict wcs"
42*7a25a0c7Srillig.Fa "size_t maxsize"
43*7a25a0c7Srillig.Fa "const wchar_t * restrict format"
44*7a25a0c7Srillig.Fa "const struct tm * restrict timeptr"
45215d7976Swiz.Fc
46215d7976Swiz.Sh DESCRIPTION
47215d7976SwizThe
48215d7976Swiz.Fn wcsftime
49215d7976Swizfunction is equivalent to the
50215d7976Swiz.Fn strftime
51fb4f5145Skleinkfunction except for the types of its arguments
52fb4f5145Skleinkand the return value indicating the number of wide characters.
53215d7976SwizRefer to
54215d7976Swiz.Xr strftime 3
55215d7976Swizfor a detailed description.
56215d7976Swiz.Sh COMPATIBILITY
57215d7976SwizSome early implementations of
58215d7976Swiz.Fn wcsftime
59215d7976Swizhad a
60215d7976Swiz.Fa format
61215d7976Swizargument with type
62215d7976Swiz.Vt "const char *"
63215d7976Swizinstead of
64215d7976Swiz.Vt "const wchar_t *" .
65215d7976Swiz.Sh SEE ALSO
66ff8dfca3Sjruoho.Xr strftime 3 ,
67ff8dfca3Sjruoho.Xr tm 3
68215d7976Swiz.Sh STANDARDS
69215d7976SwizThe
70215d7976Swiz.Fn wcsftime
71215d7976Swizfunction conforms to
72215d7976Swiz.St -isoC-99 .
73