|
|
|
|
|
|
Fname, Fname32(3fml)
Name
Fname(), Fname32() - map field identifier to field name
Synopsis
#include <stdio.h>
#include "fml.h"
char *
Fname(FLDID fieldid)
#include "fml32.h"
char *
Fname32(FLDID32 fieldid)
Description
Fname() provides a run-time translation of a field identifier, fieldid, to its field name and returns a pointer to a character string containing the name corresponding to its argument. The first invocation causes space to be dynamically allocated for the field tables and the tables to be loaded. The table space used by the mapping tables created by Fname() may be recovered by a call to the function Fidnm_unload().
Fname32() is used with 32-bit FML.
A thread in a multithreaded application may issue a call to Fname() or Fname32() while running in any context state, including TPINVALIDCONTEXT.
Return Values
This function returns NULL on error and sets Ferror to indicate the error condition.
Errors
Under the following conditions, Fname() fails and sets Ferror to:
A field number is specified for which a field name cannot be found or is invalid (0).
Allocation of space dynamically using malloc() failed.
See Also
Introduction to FML Functions, Ffprint, Ffprint32(3fml), Fidnm_unload, Fidnm_unload32(3fml), Fldid, Fldid32(3fml), Fprint, Fprint32(3fml)
|
|
|
|
|
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|