getstrzoffset

Function: getstrzoffset
Library: stringlib
Prototype: int getstrzoffset(int strnum, char *strzaddr)

Parameters

Parameter Type Description
strnum int Required string number
strzaddr char * Pointer to strz data

Return values

Value/Range Meaning
RETVNULLPTR -1 The provided strzaddr address is a nullpointer
RETVBADNUM -3 The given string number is not a positive integer greater than or equal to one
RETVNOTFOUND -8 The given string number is greater than the number of strings in the strz container
NON NEGATIVE Start of string offset from given strzaddr address

Description

The getstrzoffset function returns the offset of the specified numbered string from the given strz container address

Filenames: getstrzoffset.c
Include files: ascnames.h, logicals.h, stringlib.h, retvals.h
Dependencies: mheaders

Developer Information

Proposer: Mark Hobley
Lead programmer: Mark Hobley
Documentation by:
Manual page by:

Test Status

Lead test planner:
Lead test developer:
Test sign off:
Test plan: PENDING
Test programs: