File: stpncpy.3

package info (click to toggle)
manpages-pt 20011020-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 3,052 kB
  • ctags: 5
  • sloc: makefile: 49
file content (45 lines) | stat: -rw-r--r-- 1,797 bytes parent folder | download | duplicates (6)
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
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"
.\" Corrected, aeb, 990824
.TH STPNCPY 3  "July 25, 1999" "GNU" "Manual do Programador Linux"
.SH NOME
stpncpy \- copia uma seqncia de caracteres de tamanho fixo,
retornando um ponteiro para o seu final
.SH SINOPSE
.nf
.B #include <string.h>
.sp
.BI "char *stpncpy (char *" dest ", const char *" src ", size_t " n );
.fi
.SH DESCRIO
A funo \fBstpncpy\fP copia no mximo \fIn\fP caracteres da seqncia 
apontada por \fIsrc\fP, incluindo o caracter de  terminao '\\0', para
a cadeia apontada por \fIdest\fP. Exatamente \fIn\fP caracteres so
escritos em \fIdest\fP. Se o comprimento \fIstrlen(src)\fP  menor que
\fIn\fP, os caracteres restantes na cadeia apontada por \fIdest\fP so
preenchidos com caracteres '\\0'. Se o comprimento \fIstrlen(src)\fP 
maior ou igual a \fIn\fP, a seqncia apontada por \fIdest\fP no ser 
terminada por '\\0'.
.PP
As cadeias de caracteres no podem se sobrepor.
.PP
O programador deve assegurar que h espao para no mnimo \fIn\fP
caracteres em \fIdest\fP.
.SH "VALOR DE RETORNO"
\fBstpncpy\fP retorna um ponteiro para a terminao nula em \fIdest\fP,
ou, se \fIdest\fP no  terminado por '\\0', \fIdest + n\fP.
.SH "CONFORMIDADE"
Esta funo  uma extenso GNU.
.SH "VEJA TAMBM"
.BR strncpy (3)
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWKenzo Marcelo Okamura <kenzo.okamura@poli.usp.br> (traduo)\fR
\&\fR\&\f(CWxxxxx <xxxxx@xxx.xxx.xx> (reviso)\fR