Netscape ENTERPRISE SERVER 6.1, Руководство пользователя

Страница: 198 / 373

NSAPI Functions (in Alphabetical Order)
198 Netscape Enterprise Server NSAPI Programmer’s Guide • April 2002 (Draft)
util_getline
The
util_getline
function scans the specified file buffer to find a line-feed or
carriage-return/line-feed terminated string. The string is copied into the specified
buffer, and NULL-terminates it. The function returns a value that indicates
whether the operation stored a string in the buffer, encountered an error, or
reached the end of the file.
Use this function to scan lines out of a text file, such as a configuration file.
Syntax
int util_getline(filebuf *buf, int lineno, int maxlen, char *line);
Returns
0 if successful.
line
contains the string.
1 if the end of file was reached.
line
contains the string.
-1 if an error occurred.
line
contains a description of the error.
Parameters
filebuf *buf
is the file buffer to be scanned.
int lineno
is used to include the line number in the error message when an error
occurs. The caller is responsible for making sure the line number is accurate.
int maxlen
is the maximum number of characters that can be written into
l.
char *l
is the buffer in which to store the string. The user is responsible for
allocating and deallocating
line
.
See also
util_can_exec, util_env_create, util_hostname
util_hostname
The
util_hostname
function retrieves the local host name and returns it as a
string. If the function cannot find a fully-qualified domain name, it returns NULL.
You may reallocate or free this string. Use this function to determine the name of
the system you are on.
Syntax
char *util_hostname(void);
Returns
If a fully-qualified domain name was found, returns a string containing that name
otherwise returns NULL if the fully-qualified domain name was not found.