MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame^] | 1 | |
| 2 | ********************************************************** |
| 3 | * ACHTUNG: EFUN EXISTIERT NICHT MEHR! NICHT VERWENDEN! * |
| 4 | ********************************************************** |
| 5 | |
| 6 | SYNOPSIS: |
| 7 | mapping m_allocate(int size, int width) |
| 8 | |
| 9 | DESCRIPTION: |
| 10 | Reserve memory for a mapping. |
| 11 | |
| 12 | size is the number of entries (i.e. keys) to reserve, width is |
| 13 | the number of data items per entry. If the optional width is |
| 14 | omitted, 1 is used as default. |
| 15 | |
| 16 | This is useful only when you are going to construct a mapping |
| 17 | whose approximate size you know beforehand, to save on malloc |
| 18 | overhead. If you don't fill in data for all the allocated |
| 19 | elements, any leftovers will be freed after the current |
| 20 | function execution ended. It is also useful if you want the |
| 21 | mapping to have a certain width even if you don't provide |
| 22 | all the data items for the keys yet. |
| 23 | |
| 24 | HISTORY |
| 25 | Renamed to 'm_allocate()' in LDMud 3.2.6 and LP "03.02.1@150". |
| 26 | Since LDMud 3.2.9, not available if driver is compiled without |
| 27 | USE_DEPRECATED. |
| 28 | Removed in LDMud 3.3 and LP "03.02.1@150" |
| 29 | |
| 30 | SEE ALSO: |
| 31 | mappings(LPC), walk_mapping(E), get_type_info(E) |
| 32 | |
| 33 | 29.10.2006 Zesstra |