
 NAME
 ====
 stbl - string table functions

 SYNOPSIS
 ========

 - NIFFIOStblWrite()

 SEE ALSO
 ========

 - NIFFIOStoreStbl()



 NIFFIOStblWrite
 =====================
 Write a single string table entry to a RIFFIOFile.

| RIFFIOSuccess
| NIFFIOStblWrite(NIFFIOFile *pnf, 
|                 RIFFIOChunk *pchunkSTBL, 
|                 NIFFIOStbl *pstbl)

 ENTRY
 -----
 T <*pchunkSTBL> must be newly created by RIFFIOChunkCreate() and not
 yet finalized by RIFFIOChunkFinalize().

 EXIT
 ----
 Writes < pstbl->str > (including its terminating NUL character) to
 a string table chunk <*pchunkSTBL> in the NIFFIOFile <*pnf>.

 Writing takes place at the current file position.
 
 Calculates the string offset from pchunkSTBL's data offset and
 returns it in <pstbl->offset>.

 RETURN
 ------ 
 RIFFIO_RESULT_OK on success.

