blob: abf2b4b9883783ff55d8e990f6eb2670300c5f68 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
// Copyright (C) 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
*******************************************************************************
* Copyright (C) 2015, International Business Machines
* Corporation and others. All Rights Reserved.
*******************************************************************************
* smallintformatter.h
*
* created on: 2015jan06
* created by: Travis Keep
*/
#ifndef __SMALLINTFORMATTER_H__
#define __SMALLINTFORMATTER_H__
#include "unicode/uobject.h"
#include "unicode/utypes.h"
U_NAMESPACE_BEGIN
class UnicodeString;
/**
* A representation an acceptable range of digit counts for integers.
*/
class U_I18N_API IntDigitCountRange : public UMemory {
public:
/**
* No constraints: 0 up to INT32_MAX
*/
IntDigitCountRange() : fMin(0), fMax(INT32_MAX) { }
IntDigitCountRange(int32_t min, int32_t max);
int32_t pin(int32_t digitCount) const;
int32_t getMax() const { return fMax; }
int32_t getMin() const { return fMin; }
private:
int32_t fMin;
int32_t fMax;
};
/**
* A formatter for small, positive integers.
*/
class U_I18N_API SmallIntFormatter : public UMemory {
public:
/**
* Estimates the actual digit count needed to format positiveValue
* using the given range of digit counts.
* Returns a value that is at least the actual digit count needed.
*
* @param positiveValue the value to format
* @param range the acceptable range of digit counts.
*/
static int32_t estimateDigitCount(
int32_t positiveValue, const IntDigitCountRange &range);
/**
* Returns TRUE if this class can format positiveValue using
* the given range of digit counts.
*
* @param positiveValue the value to format
* @param range the acceptable range of digit counts.
*/
static UBool canFormat(
int32_t positiveValue, const IntDigitCountRange &range);
/**
* Formats positiveValue using the given range of digit counts.
* Always uses standard digits '0' through '9'. Formatted value is
* left padded with '0' as necessary to achieve minimum digit count.
* Does not produce any grouping separators or trailing decimal point.
* Calling format to format a value with a particular digit count range
* when canFormat indicates that the same value and digit count range
* cannot be formatted results in undefined behavior.
*
* @param positiveValue the value to format
* @param range the acceptable range of digit counts.
*/
static UnicodeString &format(
int32_t positiveValue,
const IntDigitCountRange &range,
UnicodeString &appendTo);
};
U_NAMESPACE_END
#endif // __SMALLINTFORMATTER_H__
|
