Skip to content

sintern_range

Category: string
GitHub: cute_string.h

Stores unique, static copy of a string in a global string interning table.

#define sintern_range(start, end) cf_sintern_range(start, end)
Parameters Description
start A pointer to the start of the string to insert into the global table.
end A pointer to the end of the string to insert into the global table. Should point just before the nul-byte (if there is a nul-byte).

Return Value

Returns a static, unique, stable, read-only copy of the string. The pointer is stable until sinuke is called.

Remarks

Only one copy of each unique string is stored. The purpose is primarily a memory optimization to reduce duplicate strings. You can not modify this string in any way. It is 100% immutable. Some major benefits come from placing strings into this table.

  • You can hash returned pointers directly into hash tables (instead of hashing the entire string).
  • You can simply compare pointers for equality, as opposed to comparing the string contents, as long as both strings came from this function.
  • You may optionally call sinuke to free all resources used by the global string table.
  • This function is very fast if the string was already stored previously.

sintern
sinuke
sivalid
silen