| | 1 | /* |
| | 2 | ******************************************************************************* |
| | 3 | * |
| | 4 | * Copyright (C) 1999-2003, International Business Machines |
| | 5 | * Corporation and others. All Rights Reserved. |
| | 6 | * |
| | 7 | ******************************************************************************* |
| | 8 | * file name: toolutil.h |
| | 9 | * encoding: US-ASCII |
| | 10 | * tab size: 8 (not used) |
| | 11 | * indentation:4 |
| | 12 | * |
| | 13 | * created on: 1999nov19 |
| | 14 | * created by: Markus W. Scherer |
| | 15 | * |
| | 16 | * This file defines utility functions for ICU tools like genccode. |
| | 17 | */ |
| | 18 | |
| | 19 | #ifndef __TOOLUTIL_H__ |
| | 20 | #define __TOOLUTIL_H__ |
| | 21 | |
| | 22 | #include "unicode/utypes.h" |
| | 23 | |
| | 24 | /* |
| | 25 | * For Windows, a path/filename may be the short (8.3) version |
| | 26 | * of the "real", long one. In this case, the short one |
| | 27 | * is abbreviated and contains a tilde etc. |
| | 28 | * This function returns a pointer to the original pathname |
| | 29 | * if it is the "real" one itself, and a pointer to a static |
| | 30 | * buffer (not thread-safe) containing the long version |
| | 31 | * if the pathname is indeed abbreviated. |
| | 32 | * |
| | 33 | * On platforms other than Windows, this function always returns |
| | 34 | * the input pathname pointer. |
| | 35 | * |
| | 36 | * This function is especially useful in tools that are called |
| | 37 | * by a batch file for loop, which yields short pathnames on Win9x. |
| | 38 | */ |
| | 39 | U_CAPI const char * U_EXPORT2 |
| | 40 | getLongPathname(const char *pathname); |
| | 41 | |
| | 42 | /* |
| | 43 | * Find the basename at the end of a pathname, i.e., the part |
| | 44 | * after the last file separator, and return a pointer |
| | 45 | * to this part of the pathname. |
| | 46 | * If the pathname only contains a basename and no file separator, |
| | 47 | * then the pathname pointer itself is returned. |
| | 48 | */ |
| | 49 | U_CAPI const char * U_EXPORT2 |
| | 50 | findBasename(const char *filename); |
| | 51 | |
| | 52 | /* |
| | 53 | * UToolMemory is used for generic, custom memory management. |
| | 54 | * It is allocated with enough space for count*size bytes starting |
| | 55 | * at array. |
| | 56 | * The array is declared with a union of large data types so |
| | 57 | * that its base address is aligned for any types. |
| | 58 | * If size is a multiple of a data type size, then such items |
| | 59 | * can be safely allocated inside the array, at offsets that |
| | 60 | * are themselves multiples of size. |
| | 61 | */ |
| | 62 | struct UToolMemory; |
| | 63 | typedef struct UToolMemory UToolMemory; |
| | 64 | |
| | 65 | /** |
| | 66 | * Open a UToolMemory object for allocation of initialCapacity to maxCapacity |
| | 67 | * items with size bytes each. |
| | 68 | */ |
| | 69 | U_CAPI UToolMemory * U_EXPORT2 |
| | 70 | utm_open(const char *name, int32_t initialCapacity, int32_t maxCapacity, int32_t size); |
| | 71 | |
| | 72 | /** |
| | 73 | * Close a UToolMemory object. |
| | 74 | */ |
| | 75 | U_CAPI void U_EXPORT2 |
| | 76 | utm_close(UToolMemory *mem); |
| | 77 | |
| | 78 | /** |
| | 79 | * Get the pointer to the beginning of the array of items. |
| | 80 | * The pointer becomes invalid after allocation of new items. |
| | 81 | */ |
| | 82 | U_CAPI void * U_EXPORT2 |
| | 83 | utm_getStart(UToolMemory *mem); |
| | 84 | |
| | 85 | /** |
| | 86 | * Get the current number of items. |
| | 87 | */ |
| | 88 | U_CAPI int32_t U_EXPORT2 |
| | 89 | utm_countItems(UToolMemory *mem); |
| | 90 | |
| | 91 | /** |
| | 92 | * Allocate one more item and return the pointer to its start in the array. |
| | 93 | */ |
| | 94 | U_CAPI void * U_EXPORT2 |
| | 95 | utm_alloc(UToolMemory *mem); |
| | 96 | |
| | 97 | /** |
| | 98 | * Allocate n items and return the pointer to the start of the first one in the array. |
| | 99 | */ |
| | 100 | U_CAPI void * U_EXPORT2 |
| | 101 | utm_allocN(UToolMemory *mem, int32_t n); |
| | 102 | |
| | 103 | #endif |
projects / apple / icu.git / blame_incremental