GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  USTRZNCPY (3)

NAME

ustrzncpy - Copies a string into another one, specifying size. Allegro game programming library.

CONTENTS

Synopsis
Description
See Also

SYNOPSIS

#include <allegro.h>

char *ustrzncpy(char *dest, int size, const char *src, int n);

DESCRIPTION

This function is like ustrzcpy() except that no more than ‘n’ characters from ‘src’ are copied into ‘dest’ whose length in bytes is specified by ‘size’ and which is guaranteed to be null-terminated even if ‘src’ is bigger than ‘size’. If ‘src’ is shorter than ‘n’ characters, null characters are appended to ‘dest’ as padding until ‘n’ characters have been written. In any case, ‘dest’ is guaranteed to be null-terminated.

Note that, even for empty strings, your destination string must have at least enough bytes to store the terminating null character of the string, and your parameter ‘size’ must reflect this. Otherwise, the debug version of Allegro will abort at an assertion, and the release version of Allegro will overrun the destination buffer.

RETURN VALUE

The return value is the value of ‘dest’.

SEE ALSO

uconvert(3), ustrzcpy(3), ustrncpy(3), exkeys(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro USTRZNCPY (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.