Sets the array count to a value guaranteed to be large enough to store an array of N bytes. Will round up to the nearest positive <int32> if the byte count provided does not align with the number of bytes per element. For example, <float64> values are 8 bytes each, so providing a value of 16 bytes ensures the array count is set to 2. Similarly, providing a value of 17 bytes, which is not a multiple of 8, ensures the array count is set to 3.
int32 ConvertBytesToCount( int32 p_nCount )
Parameter Type | Parameter Name | Documentation |
---|---|---|
int32 | p_nCount | The number of bytes to convert to an array count. |
import library "app_service_console_util.ssl";
import library "type_color565_array_util.ssl";
int base = 2; // min 2 bytes per Color565 object.
auto Color565Array a;
a.ConvertBytesToCount( base + 2 ); // Rounds up to 4 bytes...
LibColor565Array.Out( a ); // Prints 'garbage' values since uninitialized...
Console.Out( "---" );
a.ConvertBytesToCount( 16 );
LibColor565Array.Out( a ); // Prints 'garbage' values since uninitialized...
COLOR565ARRAY OUTPUT generated by TYPE_COLOR565_ARRAY_UTIL.SSL
6,
2,
0,
3,
6,
3,
6,
101
---
COLOR565ARRAY OUTPUT generated by TYPE_COLOR565_ARRAY_UTIL.SSL
6,
2,
0,
3,
6,
3,
6,
101,
0,
1,
6,
102,
6,
114,
0,
3