Requesting Values (The GNU Awk User’s Guide)
From Get docs
Gawk/docs/latest/Requesting-Values
Next: Accessing Parameters, Previous: Updating ERRNO
, Up: Extension API Description [Contents][Index]
17.4.8 Requesting Values
All of the functions that return values from gawk
work in the same way. You pass in an awk_valtype_t
value to indicate what kind of value you expect. If the actual value matches what you requested, the function returns true and fills in the awk_value_t
result. Otherwise, the function returns false, and the val_type
member indicates the type of the actual value. You may then print an error message or reissue the request for the actual value type, as appropriate. This behavior is summarized in Table 17.2.
Type of Actual Value |
---|
String | Strnum | Number | Regex | Array | Undefined | ||
---|---|---|---|---|---|---|---|
String | String | String | String | String | false | false | |
Strnum | false | Strnum | Strnum | false | false | false | |
Number | Number | Number | Number | false | false | false | |
Type | Regex | false | false | false | Regex | false | false |
Requested | Array | false | false | false | false | Array | false |
Scalar | Scalar | Scalar | Scalar | Scalar | false | false | |
Undefined | String | Strnum | Number | Regex | Array | Undefined | |
Value cookie | false | false | false | false | false | false |