toolutil.h revision 51cfa1a9a96cad34675a6415fe86dfdf3f525bb6 
1/*
2*******************************************************************************
3*
4*   Copyright (C) 1999-2005, 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 */
39U_CAPI const char * U_EXPORT2
40getLongPathname(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 */
49U_CAPI const char * U_EXPORT2
50findBasename(const char *filename);
51
52/*
53 * Creates a diretory with pathname.
54 *
55 * @param status Set to an error code when mkdir failed.
56 */
57U_CAPI void U_EXPORT2
58uprv_mkdir(const char *pathname, UErrorCode *status);
59
60/*
61 * UToolMemory is used for generic, custom memory management.
62 * It is allocated with enough space for count*size bytes starting
63 * at array.
64 * The array is declared with a union of large data types so
65 * that its base address is aligned for any types.
66 * If size is a multiple of a data type size, then such items
67 * can be safely allocated inside the array, at offsets that
68 * are themselves multiples of size.
69 */
70struct UToolMemory;
71typedef struct UToolMemory UToolMemory;
72
73/**
74 * Open a UToolMemory object for allocation of initialCapacity to maxCapacity
75 * items with size bytes each.
76 */
77U_CAPI UToolMemory * U_EXPORT2
78utm_open(const char *name, int32_t initialCapacity, int32_t maxCapacity, int32_t size);
79
80/**
81 * Close a UToolMemory object.
82 */
83U_CAPI void U_EXPORT2
84utm_close(UToolMemory *mem);
85
86/**
87 * Get the pointer to the beginning of the array of items.
88 * The pointer becomes invalid after allocation of new items.
89 */
90U_CAPI void * U_EXPORT2
91utm_getStart(UToolMemory *mem);
92
93/**
94 * Get the current number of items.
95 */
96U_CAPI int32_t U_EXPORT2
97utm_countItems(UToolMemory *mem);
98
99/**
100 * Allocate one more item and return the pointer to its start in the array.
101 */
102U_CAPI void * U_EXPORT2
103utm_alloc(UToolMemory *mem);
104
105/**
106 * Allocate n items and return the pointer to the start of the first one in the array.
107 */
108U_CAPI void * U_EXPORT2
109utm_allocN(UToolMemory *mem, int32_t n);
110
111#endif
112