int Ini_GetRawStringIntoBuffer (IniText handle, const char sectionName[], const char tagName[], char buffer[], int bufferSize);
Copies the string associated with tagName into buffer in the section identified by sectionName.
Buffer must be able to contain at least as many bytes as indicated by bufferSize.
![]() |
Note This function is exactly like Ini_GetStringIntoBuffer except that backslash characters in the string are not interpreted as denoting escape codes for unprintable characters. One possible use for this function is to read a pathname in PC format. Since PC pathnames contain backslashes and since the escape character used by Ini_GetStringIntoBuffer is also the backslash, you must use Ini_GetRawStringIntoBuffer if you do not want the back slashes in the pathname to be interpreted as escape codes. This is only an issue if you are using the inifile instrument to read entries that were not created by the Ini_PutString function. The non–raw versions of the Ini_GetString functions automatically recognize and remove the escape codes inserted by Ini_PutString. |
Input | ||
Name | Type | Description |
handle | IniText | A handle returned from Ini_New. It represents the list of in-memory tag/value pairs. |
sectionName | const char [] | The section name under which to find the tag/value pair. |
tagName | const char [] | The tag name in the tag/value pair. |
bufferSize | integer | The maximum number of bytes (including the ASCII NUL byte) to be written into buffer. |
Output | ||
Name | Type | Description |
buffer | char [] | The buffer into which to copy the string associated with tagName. The buffer must be large enough to contain at least as many bytes as specified by bufferSize. If an error occurs or the Tag Name cannot be found in the section, the first byte of buffer is set to ASCII NUL. |
Name | Type | Description | ||
status | integer | Indicates whether a tag/string pair was found with the specified tagName in the section specified by sectionName. A positive return value indicates that a tag/string pair was found. If the string portion of the tag/string pair was empty, such as in tag 1 = "" the string is considered to have been found, and it is the empty string (""). If the tag's value is empty, such as in tag 1 = no tag/value pair is found. A zero indicates that no tag/string pair was found. A negative value indicates an error. If the value is from For this function, the only error you are likely to encounter is:
|