1 (* Copyright (C) Doom 2D: Forever Developers
3 * This program is free software: you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License as published by
5 * the Free Software Foundation, either version 3 of the License, or
6 * (at your option) any later version.
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
13 * You should have received a copy of the GNU General Public License
14 * along with this program. If not, see <http://www.gnu.org/licenses/>.
16 {$INCLUDE a_modes.inc}
25 // ////////////////////////////////////////////////////////////////////////// //
27 SSArray
= array of ShortString;
30 // ////////////////////////////////////////////////////////////////////////// //
32 TUtf8DecoderFast
= packed record
34 const Replacement
= $FFFD; // replacement char for invalid unicode
42 codepoint
: LongWord; // decoded codepoint (valid only when decoder is in "complete" state)
45 constructor Create (v
: Boolean{fuck you, fpc});
47 procedure reset (); inline;
49 function complete (): Boolean; inline; // is current character complete? take `codepoint` then
50 function invalid (): Boolean; inline;
51 function completeOrInvalid (): Boolean; inline;
53 // process one byte, return `true` if codepoint is ready
54 function decode (b
: Byte): Boolean; inline; overload
;
55 function decode (c
: AnsiChar): Boolean; inline; overload
;
59 // ////////////////////////////////////////////////////////////////////////// //
60 function getFilenameExt (const fn
: AnsiString): AnsiString;
61 function setFilenameExt (const fn
, ext
: AnsiString): AnsiString;
62 function forceFilenameExt (const fn
, ext
: AnsiString): AnsiString;
64 // strips out name from `fn`, leaving trailing slash
65 function getFilenamePath (const fn
: AnsiString): AnsiString;
67 // ends with '/' or '\'?
68 function isFilenamePath (const fn
: AnsiString): Boolean;
70 // strips extra trailing slashes in `path, and extra leading slashes in `fn`
71 // will add slash to `path`, even if `fn` is empty!
72 function filenameConcat (const path
, fn
: AnsiString): AnsiString;
74 // does filename have one of ".wad", ".pk3", ".zip" extensions?
75 function hasWadExtension (const fn
: AnsiString): Boolean;
77 // does filepath have ".XXX:\" in it?
78 function isWadPath (const fn
: AnsiString): Boolean;
80 // adds ".wad" extension if filename doesn't have one of ".wad", ".pk3", ".zip"
81 function addWadExtension (const fn
: AnsiString): AnsiString;
83 // convert number to strig with nice commas
84 function int64ToStrComma (i
: Int64): AnsiString;
86 function upcase1251 (ch
: AnsiChar): AnsiChar; inline;
87 function locase1251 (ch
: AnsiChar): AnsiChar; inline;
89 function toLowerCase1251 (const s
: AnsiString): AnsiString;
91 // `true` if strings are equal; ignoring case for cp1251
92 function strEquCI1251 (const s0
, s1
: AnsiString): Boolean;
94 function utf8Valid (const s
: AnsiString): Boolean;
96 function utf8to1251 (s
: AnsiString): AnsiString;
98 // `pathname` will be modified if path is valid
99 // `lastIsDir` should be `true` if we are searching for directory
100 // nobody cares about shitdoze, so i'll use the same code path for it
101 function findFileCI (var pathname
: AnsiString; lastIsDir
: Boolean=false): Boolean;
103 // return fixed AnsiString or empty AnsiString
104 function findDiskWad (fname
: AnsiString): AnsiString;
107 function openDiskFileRO (pathname
: AnsiString): TStream
;
108 function createDiskFile (pathname
: AnsiString): TStream
;
111 procedure writeSign (st
: TStream
; const sign
: AnsiString);
112 function checkSign (st
: TStream
; const sign
: AnsiString): Boolean;
114 procedure writeBool (st
: TStream
; b
: Boolean);
115 function readBool (st
: TStream
): Boolean;
117 procedure writeStr (st
: TStream
; const str
: AnsiString; maxlen
: LongWord=65535);
118 function readStr (st
: TStream
; maxlen
: LongWord=65535): AnsiString;
120 procedure writeInt (st
: TStream
; v
: Byte); overload
;
121 procedure writeInt (st
: TStream
; v
: ShortInt); overload
;
122 procedure writeInt (st
: TStream
; v
: Word); overload
;
123 procedure writeInt (st
: TStream
; v
: SmallInt); overload
;
124 procedure writeInt (st
: TStream
; v
: LongWord); overload
;
125 procedure writeInt (st
: TStream
; v
: LongInt); overload
;
126 procedure writeInt (st
: TStream
; v
: Int64); overload
;
127 procedure writeInt (st
: TStream
; v
: UInt64); overload
;
129 function readByte (st
: TStream
): Byte;
130 function readShortInt (st
: TStream
): ShortInt;
131 function readWord (st
: TStream
): Word;
132 function readSmallInt (st
: TStream
): SmallInt;
133 function readLongWord (st
: TStream
): LongWord;
134 function readLongInt (st
: TStream
): LongInt;
135 function readInt64 (st
: TStream
): Int64;
136 function readUInt64 (st
: TStream
): UInt64;
139 procedure writeIntBE (st
: TStream
; v
: Byte); overload
;
140 procedure writeIntBE (st
: TStream
; v
: ShortInt); overload
;
141 procedure writeIntBE (st
: TStream
; v
: Word); overload
;
142 procedure writeIntBE (st
: TStream
; v
: SmallInt); overload
;
143 procedure writeIntBE (st
: TStream
; v
: LongWord); overload
;
144 procedure writeIntBE (st
: TStream
; v
: LongInt); overload
;
145 procedure writeIntBE (st
: TStream
; v
: Int64); overload
;
146 procedure writeIntBE (st
: TStream
; v
: UInt64); overload
;
148 function readByteBE (st
: TStream
): Byte;
149 function readShortIntBE (st
: TStream
): ShortInt;
150 function readWordBE (st
: TStream
): Word;
151 function readSmallIntBE (st
: TStream
): SmallInt;
152 function readLongWordBE (st
: TStream
): LongWord;
153 function readLongIntBE (st
: TStream
): LongInt;
154 function readInt64BE (st
: TStream
): Int64;
155 function readUInt64BE (st
: TStream
): UInt64;
158 function nmin (a
, b
: Byte): Byte; inline; overload
;
159 function nmin (a
, b
: ShortInt): ShortInt; inline; overload
;
160 function nmin (a
, b
: Word): Word; inline; overload
;
161 function nmin (a
, b
: SmallInt): SmallInt; inline; overload
;
162 function nmin (a
, b
: LongWord): LongWord; inline; overload
;
163 function nmin (a
, b
: LongInt): LongInt; inline; overload
;
164 function nmin (a
, b
: Int64): Int64; inline; overload
;
165 function nmin (a
, b
: UInt64): UInt64; inline; overload
;
166 function nmin (a
, b
: Single): Single; inline; overload
;
167 function nmin (a
, b
: Double): Double; inline; overload
;
168 {$IF DEFINED(CPU386) OR DEFINED(CPUAMD64)}
169 function nmin (a
, b
: Extended
): Extended
; inline; overload
;
172 function nmax (a
, b
: Byte): Byte; inline; overload
;
173 function nmax (a
, b
: ShortInt): ShortInt; inline; overload
;
174 function nmax (a
, b
: Word): Word; inline; overload
;
175 function nmax (a
, b
: SmallInt): SmallInt; inline; overload
;
176 function nmax (a
, b
: LongWord): LongWord; inline; overload
;
177 function nmax (a
, b
: LongInt): LongInt; inline; overload
;
178 function nmax (a
, b
: Int64): Int64; inline; overload
;
179 function nmax (a
, b
: UInt64): UInt64; inline; overload
;
180 function nmax (a
, b
: Single): Single; inline; overload
;
181 function nmax (a
, b
: Double): Double; inline; overload
;
182 {$IF DEFINED(CPU386) OR DEFINED(CPUAMD64)}
183 function nmax (a
, b
: Extended
): Extended
; inline; overload
;
185 function nclamp (v
, a
, b
: Byte): Byte; inline; overload
;
186 function nclamp (v
, a
, b
: ShortInt): ShortInt; inline; overload
;
187 function nclamp (v
, a
, b
: Word): Word; inline; overload
;
188 function nclamp (v
, a
, b
: SmallInt): SmallInt; inline; overload
;
189 function nclamp (v
, a
, b
: LongWord): LongWord; inline; overload
;
190 function nclamp (v
, a
, b
: LongInt): LongInt; inline; overload
;
191 function nclamp (v
, a
, b
: Int64): Int64; inline; overload
;
192 function nclamp (v
, a
, b
: UInt64): UInt64; inline; overload
;
193 function nclamp (v
, a
, b
: Single): Single; inline; overload
;
194 function nclamp (v
, a
, b
: Double): Double; inline; overload
;
195 {$IF DEFINED(CPU386) OR DEFINED(CPUAMD64)}
196 function nclamp (v
, a
, b
: Extended
): Extended
; inline; overload
;
200 TFormatStrFCallback
= procedure (constref buf
; len
: SizeUInt
);
202 // returns formatted string if `writerCB` is `nil`, empty string otherwise
203 function formatstrf (const fmt
: AnsiString; const args
: array of const; writerCB
: TFormatStrFCallback
=nil): AnsiString;
205 function wchar2win (wc
: WideChar): AnsiChar; inline;
206 function utf2win (const s
: AnsiString): AnsiString;
207 function win2utf (const s
: AnsiString): AnsiString;
208 function digitInBase (ch
: AnsiChar; base
: Integer): Integer;
210 // returns string in single or double quotes
211 // single quotes supports only pascal-style '' for single quote char
212 // double quotes supports c-style escapes
213 // function will select quote mode automatically
214 function quoteStr (const s
: AnsiString): AnsiString;
218 generic TSimpleList
<ItemT
> = class
220 //type PItemT = ^ItemT;
221 type TItemArr
= array of ItemT
;
231 constructor Create (const aitems
: TItemArr
; acount
: Integer);
232 function MoveNext
: Boolean;
233 function getCurrent (): ItemT
;
234 property Current
: ItemT read getCurrent
;
239 mCount
: Integer; // can be less than `mItems` size
242 function getAt (idx
: Integer): ItemT
; inline;
243 procedure setAt (idx
: Integer; const it
: ItemT
); inline;
245 function getCapacity (): Integer; inline;
246 procedure setCapacity (v
: Integer); inline;
249 constructor Create (acapacity
: Integer=-1);
250 destructor Destroy (); override;
252 //WARNING! don't change list contents in `for ... in`!
253 function GetEnumerator (): TEnumerator
;
255 procedure reset (); inline; // won't resize `mItems`
256 procedure clear (); inline;
258 procedure append (constref it
: ItemT
); inline;
259 procedure delete (idx
: Integer); inline;
260 function remove (idx
: Integer): ItemT
; inline;
263 property count
: Integer read mCount
;
264 property capacity
: Integer read getCapacity write setCapacity
;
265 property at
[idx
: Integer]: ItemT read getAt write setAt
; default
;
269 procedure FillMemory (Dest
: Pointer; Len
: LongWord; Ch
: Byte); inline;
270 procedure CopyMemory (Dest
: Pointer; Src
: Pointer; Len
: LongWord); inline;
271 procedure ZeroMemory (Dest
: Pointer; Len
: LongWord); inline;
280 // ////////////////////////////////////////////////////////////////////////// //
281 procedure CopyMemory (Dest
: Pointer; Src
: Pointer; Len
: LongWord); inline;
283 Move(Src
^, Dest
^, Len
);
286 procedure FillMemory (Dest
: Pointer; Len
: LongWord; Ch
: Byte); inline;
288 FillChar(Dest
^, Len
, Ch
);
291 procedure ZeroMemory (Dest
: Pointer; Len
: LongWord); inline;
293 FillChar(Dest
^, Len
, 0);
297 // ////////////////////////////////////////////////////////////////////////// //
298 constructor TSimpleList
.TEnumerator
.Create (const aitems
: TItemArr
; acount
: Integer);
305 function TSimpleList
.TEnumerator
.MoveNext
: Boolean;
308 result
:= (mCurrent
< mCount
);
311 function TSimpleList
.TEnumerator
.getCurrent (): ItemT
;
313 result
:= mItems
[mCurrent
];
317 // ////////////////////////////////////////////////////////////////////////// //
318 constructor TSimpleList
.Create (acapacity
: Integer=-1);
321 if (acapacity
> 0) then SetLength(mItems
, acapacity
);
326 destructor TSimpleList
.Destroy ();
333 function TSimpleList
.getCapacity (): Integer; inline;
335 result
:= Length(mItems
);
339 procedure TSimpleList
.setCapacity (v
: Integer); inline;
341 if (v
< mCount
) then v
:= mCount
;
342 if (v
<> Length(mItems
)) then SetLength(mItems
, v
);
346 function TSimpleList
.GetEnumerator (): TEnumerator
;
348 if (Length(mItems
) > 0) then result
:= TEnumerator
.Create(mItems
, mCount
)
349 else result
:= TEnumerator
.Create(nil, -1);
353 procedure TSimpleList
.reset (); inline;
359 procedure TSimpleList
.clear (); inline;
366 function TSimpleList
.getAt (idx
: Integer): ItemT
; inline;
368 if (idx
>= 0) and (idx
< mCount
) then result
:= mItems
[idx
] else result
:= Default(ItemT
);
372 procedure TSimpleList
.setAt (idx
: Integer; const it
: ItemT
); inline;
374 if (idx
>= 0) and (idx
< mCount
) then mItems
[idx
] := it
;
378 procedure TSimpleList
.append (constref it
: ItemT
); inline;
382 if (mCount
>= Length(mItems
)) then
384 newsz
:= mCount
+(mCount
div 3)+128;
385 SetLength(mItems
, newsz
);
387 mItems
[mCount
] := it
;
392 procedure TSimpleList
.delete (idx
: Integer); inline;
396 if (idx
>= 0) and (idx
< mCount
) then
398 for f
:= idx
+1 to mCount
-1 do mItems
[f
-1] := mItems
[f
];
403 function TSimpleList
.remove (idx
: Integer): ItemT
; inline;
407 if (idx
>= 0) and (idx
< mCount
) then
409 result
:= mItems
[idx
];
410 for f
:= idx
+1 to mCount
-1 do mItems
[f
-1] := mItems
[f
];
414 result
:= Default(ItemT
);
419 // ////////////////////////////////////////////////////////////////////////// //
421 wc2shitmap
: array[0..65535] of AnsiChar;
422 wc2shitmapInited
: Boolean = false;
425 // ////////////////////////////////////////////////////////////////////////// //
427 cp1251
: array[0..127] of Word = (
428 $0402,$0403,$201A,$0453,$201E,$2026,$2020,$2021,$20AC,$2030,$0409,$2039,$040A,$040C,$040B,$040F,
429 $0452,$2018,$2019,$201C,$201D,$2022,$2013,$2014,$003F,$2122,$0459,$203A,$045A,$045C,$045B,$045F,
430 $00A0,$040E,$045E,$0408,$00A4,$0490,$00A6,$00A7,$0401,$00A9,$0404,$00AB,$00AC,$00AD,$00AE,$0407,
431 $00B0,$00B1,$0406,$0456,$0491,$00B5,$00B6,$00B7,$0451,$2116,$0454,$00BB,$0458,$0405,$0455,$0457,
432 $0410,$0411,$0412,$0413,$0414,$0415,$0416,$0417,$0418,$0419,$041A,$041B,$041C,$041D,$041E,$041F,
433 $0420,$0421,$0422,$0423,$0424,$0425,$0426,$0427,$0428,$0429,$042A,$042B,$042C,$042D,$042E,$042F,
434 $0430,$0431,$0432,$0433,$0434,$0435,$0436,$0437,$0438,$0439,$043A,$043B,$043C,$043D,$043E,$043F,
435 $0440,$0441,$0442,$0443,$0444,$0445,$0446,$0447,$0448,$0449,$044A,$044B,$044C,$044D,$044E,$044F
439 procedure initShitMap ();
443 for f
:= 0 to High(wc2shitmap
) do wc2shitmap
[f
] := '?';
444 for f
:= 0 to 127 do wc2shitmap
[f
] := AnsiChar(f
);
445 for f
:= 0 to 127 do wc2shitmap
[cp1251
[f
]] := AnsiChar(f
+128);
446 wc2shitmapInited
:= true;
450 // ////////////////////////////////////////////////////////////////////////// //
451 // fast state-machine based UTF-8 decoder; using 8 bytes of memory
452 // code points from invalid range will never be valid, this is the property of the state machine
454 // see http://bjoern.hoehrmann.de/utf-8/decoder/dfa/
455 utf8dfa
: array[0..$16c-1] of Byte = (
456 // maps bytes to character classes
457 $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00, // 00-0f
458 $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00, // 10-1f
459 $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00, // 20-2f
460 $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00, // 30-3f
461 $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00, // 40-4f
462 $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00, // 50-5f
463 $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00, // 60-6f
464 $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00, // 70-7f
465 $01,$01,$01,$01,$01,$01,$01,$01,$01,$01,$01,$01,$01,$01,$01,$01, // 80-8f
466 $09,$09,$09,$09,$09,$09,$09,$09,$09,$09,$09,$09,$09,$09,$09,$09, // 90-9f
467 $07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07, // a0-af
468 $07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07,$07, // b0-bf
469 $08,$08,$02,$02,$02,$02,$02,$02,$02,$02,$02,$02,$02,$02,$02,$02, // c0-cf
470 $02,$02,$02,$02,$02,$02,$02,$02,$02,$02,$02,$02,$02,$02,$02,$02, // d0-df
471 $0a,$03,$03,$03,$03,$03,$03,$03,$03,$03,$03,$03,$03,$04,$03,$03, // e0-ef
472 $0b,$06,$06,$06,$05,$08,$08,$08,$08,$08,$08,$08,$08,$08,$08,$08, // f0-ff
473 // maps a combination of a state of the automaton and a character class to a state
474 $00,$0c,$18,$24,$3c,$60,$54,$0c,$0c,$0c,$30,$48,$0c,$0c,$0c,$0c, // 100-10f
475 $0c,$0c,$0c,$0c,$0c,$0c,$0c,$0c,$0c,$00,$0c,$0c,$0c,$0c,$0c,$00, // 110-11f
476 $0c,$00,$0c,$0c,$0c,$18,$0c,$0c,$0c,$0c,$0c,$18,$0c,$18,$0c,$0c, // 120-12f
477 $0c,$0c,$0c,$0c,$0c,$0c,$0c,$18,$0c,$0c,$0c,$0c,$0c,$18,$0c,$0c, // 130-13f
478 $0c,$0c,$0c,$0c,$0c,$18,$0c,$0c,$0c,$0c,$0c,$0c,$0c,$0c,$0c,$24, // 140-14f
479 $0c,$24,$0c,$0c,$0c,$24,$0c,$0c,$0c,$0c,$0c,$24,$0c,$24,$0c,$0c, // 150-15f
480 $0c,$24,$0c,$0c,$0c,$0c,$0c,$0c,$0c,$0c,$0c,$0c);
483 // ////////////////////////////////////////////////////////////////////////// //
484 constructor TUtf8DecoderFast
.Create (v
: Boolean{fuck you, fpc}); begin state
:= Accept
; codepoint
:= 0; end;
486 procedure TUtf8DecoderFast
.reset (); inline; begin state
:= Accept
; codepoint
:= 0; end;
488 function TUtf8DecoderFast
.complete (): Boolean; inline; begin result
:= (state
= Accept
); end;
489 function TUtf8DecoderFast
.invalid (): Boolean; inline; begin result
:= (state
= Reject
); end;
490 function TUtf8DecoderFast
.completeOrInvalid (): Boolean; inline; begin result
:= (state
= Accept
) or (state
= Reject
); end;
492 function TUtf8DecoderFast
.decode (c
: AnsiChar): Boolean; inline; overload
; begin result
:= decode(Byte(c
)); end;
494 function TUtf8DecoderFast
.decode (b
: Byte): Boolean; inline; overload
;
498 if (state
= Reject
) then begin state
:= Accept
; codepoint
:= 0; end;
500 if (state
<> Accept
) then codepoint
:= (b
and $3f) or (codepoint
shl 6) else codepoint
:= ($ff shr tp
) and b
;
501 state
:= utf8dfa
[256+state
+tp
];
502 if (state
= Reject
) then begin codepoint
:= Replacement
; state
:= Accept
; end;
503 result
:= (state
= Accept
);
507 // ////////////////////////////////////////////////////////////////////////// //
508 function wchar2win (wc
: WideChar): AnsiChar; inline;
510 if not wc2shitmapInited
then initShitMap();
511 if (LongWord(wc
) > 65535) then result
:= '?' else result
:= wc2shitmap
[LongWord(wc
)];
515 // ////////////////////////////////////////////////////////////////////////// //
516 function utf2win (const s
: AnsiString): AnsiString;
519 ud
: TUtf8DecoderFast
;
521 for f
:= 1 to Length(s
) do
523 if (Byte(s
[f
]) > 127) then
525 ud
:= TUtf8DecoderFast
.Create(true);
527 for c
:= 1 to Length(s
) do
529 if ud
.decode(s
[c
]) then result
+= wchar2win(WideChar(ud
.codepoint
));
538 function win2utf (const s
: AnsiString): AnsiString;
542 function utf8Encode (code
: Integer): AnsiString;
544 if (code
< 0) or (code
> $10FFFF) then begin result
:= '?'; exit
; end;
545 if (code
<= $7f) then
547 result
:= AnsiChar(code
and $ff);
549 else if (code
<= $7FF) then
551 result
:= AnsiChar($C0 or (code
shr 6));
552 result
+= AnsiChar($80 or (code
and $3F));
554 else if (code
<= $FFFF) then
556 result
:= AnsiChar($E0 or (code
shr 12));
557 result
+= AnsiChar($80 or ((code
shr 6) and $3F));
558 result
+= AnsiChar($80 or (code
and $3F));
560 else if (code
<= $10FFFF) then
562 result
:= AnsiChar($F0 or (code
shr 18));
563 result
+= AnsiChar($80 or ((code
shr 12) and $3F));
564 result
+= AnsiChar($80 or ((code
shr 6) and $3F));
565 result
+= AnsiChar($80 or (code
and $3F));
574 for f
:= 1 to Length(s
) do
576 if (Byte(s
[f
]) > 127) then
579 for c
:= 1 to Length(s
) do
581 if (Byte(s
[c
]) < 128) then
587 result
+= utf8Encode(cp1251
[Byte(s
[c
])-128])
597 // ////////////////////////////////////////////////////////////////////////// //
598 function digitInBase (ch
: AnsiChar; base
: Integer): Integer;
601 if (base
< 1) or (base
> 36) then exit
;
602 if (ch
< '0') then exit
;
605 if (Integer(ch
) >= 48+base
) then exit
;
606 result
:= Integer(ch
)-48;
610 if (ch
>= '0') and (ch
<= '9') then begin result
:= Integer(ch
)-48; exit
; end;
611 if (ch
>= 'a') and (ch
<= 'z') then Dec(ch
, 32); // poor man's tolower()
612 if (ch
< 'A') or (Integer(ch
) >= 65+(base
-10)) then exit
;
613 result
:= Integer(ch
)-65+10;
618 // ////////////////////////////////////////////////////////////////////////// //
619 function quoteStr (const s
: AnsiString): AnsiString;
621 function squote (const s
: AnsiString): AnsiString;
626 for f
:= 1 to Length(s
) do
628 if (s
[f
] = '''') then result
+= '''';
634 function dquote (const s
: AnsiString): AnsiString;
640 for f
:= 1 to Length(s
) do
643 if (ch
= #0) then result
+= '\z'
644 else if (ch
= #9) then result
+= '\t'
645 else if (ch
= #10) then result
+= '\n'
646 else if (ch
= #13) then result
+= '\r'
647 else if (ch
= #27) then result
+= '\e'
648 else if (ch
< ' ') or (ch
= #127) then
651 result
+= LowerCase(IntToHex(Integer(ch
), 2));
653 else if (ch
= '"') or (ch
= '\') then
667 needSingle
: Boolean = false;
670 for f
:= 1 to Length(s
) do
672 if (s
[f
] = '''') then begin needSingle
:= true; continue
; end;
673 if (s
[f
] < ' ') or (s
[f
] = #127) then begin result
:= dquote(s
); exit
; end;
675 if needSingle
then result
:= squote(s
) else result
:= ''''+s
+'''';
679 // ////////////////////////////////////////////////////////////////////////// //
680 function getFilenameExt (const fn
: AnsiString): AnsiString;
691 if (pos
= Length(fn
)) then result
:= '' else result
:= Copy(fn
, pos
, Length(fn
)-pos
+1);
694 if (ch
= '/') or (ch
= '\') then break
;
697 result
:= ''; // no extension
701 function setFilenameExt (const fn
, ext
: AnsiString): AnsiString;
707 if (Length(ext
) = 0) or (ext
= '.') then exit
;
712 if (ch
= '.') then exit
;
713 if (ch
= '/') or (ch
= '\') then break
;
716 if (ext
[1] <> '.') then result
+= '.';
721 function forceFilenameExt (const fn
, ext
: AnsiString): AnsiString;
733 if (Length(ext
) = 0) or (ext
= '.') then
735 result
:= Copy(fn
, 1, pos
-1);
739 if (ext
[1] = '.') then result
:= Copy(fn
, 1, pos
-1) else result
:= Copy(fn
, 1, pos
);
744 if (ch
= '/') or (ch
= '\') then break
;
747 if (Length(ext
) > 0) then
749 if (ext
[1] <> '.') then result
+= '.';
755 // strips out name from `fn`, leaving trailing slash
756 function getFilenamePath (const fn
: AnsiString): AnsiString;
761 if (Length(fn
) = 0) then begin result
:= './'; exit
; end;
762 if (fn
[Length(fn
)] = '/') or (fn
[Length(fn
)] = '\') then begin result
:= fn
; exit
; end;
767 if (ch
= '/') or (ch
= '\') then begin result
:= Copy(fn
, 1, pos
); exit
; end;
770 result
:= './'; // no path -> current dir
774 // ends with '/' or '\'?
775 function isFilenamePath (const fn
: AnsiString): Boolean;
777 if (Length(fn
) = 0) then
783 result
:= (fn
[Length(fn
)] = '/') or (fn
[Length(fn
)] = '\');
788 // strips extra trailing slashes in `path, and extra leading slashes in `fn`
789 // will add slash to `path`, even if `fn` is empty!
790 function filenameConcat (const path
, fn
: AnsiString): AnsiString;
795 while (pos
<= Length(fn
)) and ((fn
[pos
] = '/') or (fn
[pos
] = '\')) do Inc(pos
);
797 if (Length(result
) > 0) and ((result
[Length(result
)] <> '/') and (result
[Length(result
)] <> '\')) then result
+= '/';
798 if (pos
<= Length(fn
)) then
800 result
+= Copy(fn
, pos
, Length(fn
)-pos
+1);
801 //FIXME: make this faster!
802 while (Length(result
) > 0) and ((result
[Length(result
)] = '/') or (result
[Length(result
)] = '\')) do
804 Delete(result
, Length(result
), 1);
806 if (fn
[Length(fn
)] = '/') or (fn
[Length(fn
)] = '\') then result
+= '/';
811 function hasWadExtension (const fn
: AnsiString): Boolean;
815 ext
:= getFilenameExt(fn
);
816 result
:= StrEquCI1251(ext
, '.wad') or StrEquCI1251(ext
, '.pk3') or StrEquCI1251(ext
, '.zip');
820 function addWadExtension (const fn
: AnsiString): AnsiString;
823 if not hasWadExtension(result
) then result
:= result
+'.wad';
827 function isWadPath (const fn
: AnsiString): Boolean;
834 while (pos
<= Length(fn
)) do
836 if (fn
[pos
] = ':') then
838 if (Length(fn
)-pos
< 1) then break
;
839 if (pos
-4 > 1) and (fn
[pos
-4] = '.') and ((fn
[pos
+1] = '\') or (fn
[pos
+1] = '/')) then
841 s
:= Copy(fn
, pos
-4, 4);
842 if StrEquCI1251(s
, '.wad') or StrEquCI1251(s
, '.pk3') or StrEquCI1251(s
, '.zip') then
854 function int64ToStrComma (i
: Int64): AnsiString;
859 f
:= Length(result
)+1;
862 Dec(f
, 3); Insert(',', result
, f
);
867 function upcase1251 (ch
: AnsiChar): AnsiChar; inline;
871 if (ch
>= 'a') and (ch
<= 'z') then Dec(ch
, 32);
875 if (ch
>= #224) and (ch
<= #255) then
882 #184, #186, #191: Dec(ch
, 16);
891 function locase1251 (ch
: AnsiChar): AnsiChar; inline;
895 if (ch
>= 'A') and (ch
<= 'Z') then Inc(ch
, 32);
899 if (ch
>= #192) and (ch
<= #223) then
906 #168, #170, #175: Inc(ch
, 16);
915 function strEquCI1251 (const s0
, s1
: AnsiString): Boolean;
920 if length(s0
) <> length(s1
) then exit
;
921 for i
:= 1 to length(s0
) do if UpCase1251(s0
[i
]) <> UpCase1251(s1
[i
]) then exit
;
926 function toLowerCase1251 (const s
: AnsiString): AnsiString;
933 if (ch
<> LoCase1251(ch
)) then
936 SetLength(result
, Length(s
));
937 for f
:= 1 to Length(s
) do result
[f
] := LoCase1251(s
[f
]);
946 // ////////////////////////////////////////////////////////////////////////// //
950 function utf8CodeLen (ch
: Word): Integer;
952 if ch
< $80 then begin result
:= 1; exit
; end;
953 if (ch
and $FE) = $FC then begin result
:= 6; exit
; end;
954 if (ch
and $FC) = $F8 then begin result
:= 5; exit
; end;
955 if (ch
and $F8) = $F0 then begin result
:= 4; exit
; end;
956 if (ch
and $F0) = $E0 then begin result
:= 3; exit
; end;
957 if (ch
and $E0) = $C0 then begin result
:= 2; exit
; end;
958 result
:= -1; // invalid
962 function utf8Valid (const s
: AnsiString): Boolean;
968 while pos
<= length(s
) do
970 len
:= utf8CodeLen(Byte(s
[pos
]));
971 if len
< 1 then exit
; // invalid sequence start
972 if pos
+len
-1 > length(s
) then exit
; // out of chars in string
975 // check other sequence bytes
978 if (Byte(s
[pos
]) and $C0) <> $80 then exit
;
987 // ////////////////////////////////////////////////////////////////////////// //
989 uni2wint
: array [128..255] of Word = (
990 $0402,$0403,$201A,$0453,$201E,$2026,$2020,$2021,$20AC,$2030,$0409,$2039,$040A,$040C,$040B,$040F,
991 $0452,$2018,$2019,$201C,$201D,$2022,$2013,$2014,$003F,$2122,$0459,$203A,$045A,$045C,$045B,$045F,
992 $00A0,$040E,$045E,$0408,$00A4,$0490,$00A6,$00A7,$0401,$00A9,$0404,$00AB,$00AC,$00AD,$00AE,$0407,
993 $00B0,$00B1,$0406,$0456,$0491,$00B5,$00B6,$00B7,$0451,$2116,$0454,$00BB,$0458,$0405,$0455,$0457,
994 $0410,$0411,$0412,$0413,$0414,$0415,$0416,$0417,$0418,$0419,$041A,$041B,$041C,$041D,$041E,$041F,
995 $0420,$0421,$0422,$0423,$0424,$0425,$0426,$0427,$0428,$0429,$042A,$042B,$042C,$042D,$042E,$042F,
996 $0430,$0431,$0432,$0433,$0434,$0435,$0436,$0437,$0438,$0439,$043A,$043B,$043C,$043D,$043E,$043F,
997 $0440,$0441,$0442,$0443,$0444,$0445,$0446,$0447,$0448,$0449,$044A,$044B,$044C,$044D,$044E,$044F
1001 function decodeUtf8Char (s
: AnsiString; var pos
: Integer): AnsiChar;
1005 (* The following encodings are valid, except for the 5 and 6 byte
1009 * 1110xxxx 10xxxxxx 10xxxxxx
1010 * 11110xxx 10xxxxxx 10xxxxxx 10xxxxxx
1011 * 111110xx 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx
1012 * 1111110x 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx
1015 if pos
> length(s
) then exit
;
1019 if b
< $80 then begin result
:= AnsiChar(b
); exit
; end;
1021 // mask out unused bits
1022 if (b
and $FE) = $FC then b
:= b
and $01
1023 else if (b
and $FC) = $F8 then b
:= b
and $03
1024 else if (b
and $F8) = $F0 then b
:= b
and $07
1025 else if (b
and $F0) = $E0 then b
:= b
and $0F
1026 else if (b
and $E0) = $C0 then b
:= b
and $1F
1027 else exit
; // invalid utf8
1030 while pos
<= length(s
) do
1033 if (c
and $C0) <> $80 then break
; // no more
1035 b
:= b
or (c
and $3F);
1040 for c
:= 128 to 255 do if uni2wint
[c
] = b
then begin result
:= AnsiChar(c
and $FF); exit
; end;
1045 function utf8to1251 (s
: AnsiString): AnsiString;
1049 if not utf8Valid(s
) then begin result
:= s
; exit
; end;
1051 while pos
<= length(s
) do
1053 if Byte(s
[pos
]) >= $80 then break
;
1056 if pos
> length(s
) then begin result
:= s
; exit
; end; // nothing to do here
1059 while pos
<= length(s
) do result
:= result
+decodeUtf8Char(s
, pos
);
1063 // ////////////////////////////////////////////////////////////////////////// //
1064 // `pathname` will be modified if path is valid
1065 // `lastIsDir` should be `true` if we are searching for directory
1066 // nobody cares about shitdoze, so i'll use the same code path for it
1067 function findFileCI (var pathname
: AnsiString; lastIsDir
: Boolean=false): Boolean;
1071 newname
: AnsiString = '';
1072 curname
: AnsiString;
1078 result
:= (length(npt
) > 0);
1079 if (length(npt
) > 0) and ((npt
[1] = '/') or (npt
[1] = '\')) then newname
:= '/';
1080 while length(npt
) > 0 do
1082 // remove trailing slashes
1083 while (length(npt
) > 0) and ((npt
[1] = '/') or (npt
[1] = '\')) do Delete(npt
, 1, 1);
1084 if length(npt
) = 0 then break
;
1087 while (length(npt
) > 0) and (npt
[1] <> '/') and (npt
[1] <> '\') do
1089 curname
:= curname
+npt
[1];
1092 // remove trailing slashes again
1093 while (length(npt
) > 0) and ((npt
[1] = '/') or (npt
[1] = '\')) do Delete(npt
, 1, 1);
1094 wantdir
:= lastIsDir
or (length(npt
) > 0); // do we want directory here?
1095 //writeln(Format('npt=[%s]; newname=[%s]; curname=[%s]; wantdir=%d', [npt, newname, curname, Integer(wantdir)]));
1096 // try the easiest case first
1097 attr
:= FileGetAttr(newname
+curname
);
1100 if wantdir
= ((attr
and faDirectory
) <> 0) then
1103 newname
:= newname
+curname
;
1104 if wantdir
then newname
:= newname
+'/';
1108 //writeln(Format('npt=[%s]; newname=[%s]; curname=[%s]; wantdir=%d', [npt, newname, curname, Integer(wantdir)]));
1109 // alas, either not found, or invalid attributes
1112 if FindFirst(newname
+'*', faAnyFile
, sr
) = 0 then
1114 if (wantdir
= ((sr
.attr
and faDirectory
) <> 0)) and StrEquCI1251(sr
.name
, curname
) then
1117 newname
:= newname
+sr
.name
;
1118 if wantdir
then newname
:= newname
+'/';
1122 until FindNext(sr
) <> 0;
1126 if not foundher
then begin newname
:= ''; result
:= false; break
; end;
1128 if result
then pathname
:= newname
;
1132 const fileExtensions
: array [0..5] of AnsiString = ('.wad', '.dfzip', '.dfwad', '.pk3', '.pak', '.zip');
1134 function findDiskWad (fname
: AnsiString): AnsiString;
1136 origExt
: AnsiString = '';
1137 newExt
: AnsiString = '';
1140 //writeln('findDiskWad00: fname=<', fname, '>');
1141 if (findFileCI(fname
)) then begin result
:= fname
; exit
; end;
1142 origExt
:= getFilenameExt(fname
);
1143 fname
:= forceFilenameExt(fname
, '');
1144 //writeln(' findDiskWad01: fname=<', fname, '>; origExt=<', origExt, '>');
1145 for newExt
in fileExtensions
do
1147 //writeln(' findDiskWad02: fname=<', fname, '>; origExt=<', origExt, '>; newExt=<', newExt, '>');
1148 if (StrEquCI1251(newExt
, origExt
)) then
1153 result
:= fname
+newExt
;
1154 if (findFileCI(result
)) then exit
;
1160 function openDiskFileRO (pathname
: AnsiString): TStream
;
1162 if not findFileCI(pathname
) then raise Exception
.Create('can''t open file "'+pathname
+'"');
1163 result
:= TFileStream
.Create(pathname
, fmOpenRead
or {fmShareDenyWrite}fmShareDenyNone
);
1166 function createDiskFile (pathname
: AnsiString): TStream
;
1170 path
:= ExtractFilePath(pathname
);
1171 if length(path
) > 0 then
1173 if not findFileCI(path
, true) then raise Exception
.Create('can''t create file "'+pathname
+'"');
1175 result
:= TFileStream
.Create(path
+ExtractFileName(pathname
), fmCreate
);
1179 procedure writeIntegerLE (st
: TStream
; vp
: Pointer; size
: Integer);
1180 {$IFDEF ENDIAN_LITTLE}
1182 st
.writeBuffer(vp
^, size
);
1188 p
:= PByte(vp
)+size
-1;
1191 st
.writeBuffer(p
^, 1);
1198 procedure writeIntegerBE (st
: TStream
; vp
: Pointer; size
: Integer);
1199 {$IFDEF ENDIAN_LITTLE}
1203 p
:= PByte(vp
)+size
-1;
1206 st
.writeBuffer(p
^, 1);
1213 st
.writeBuffer(vp
^, size
);
1217 procedure writeSign (st
: TStream
; const sign
: AnsiString);
1219 if (Length(sign
) > 0) then st
.WriteBuffer(sign
[1], Length(sign
));
1222 function checkSign (st
: TStream
; const sign
: AnsiString): Boolean;
1224 buf
: packed array[0..7] of AnsiChar;
1228 if (Length(sign
) > 0) then
1230 if (Length(sign
) <= 8) then
1232 st
.ReadBuffer(buf
[0], Length(sign
));
1233 for f
:= 1 to Length(sign
) do if (buf
[f
-1] <> sign
[f
]) then exit
;
1237 for f
:= 1 to Length(sign
) do
1239 st
.ReadBuffer(buf
[0], 1);
1240 if (buf
[0] <> sign
[f
]) then exit
;
1247 procedure writeInt (st
: TStream
; v
: Byte); overload
; begin writeIntegerLE(st
, @v
, 1); end;
1248 procedure writeInt (st
: TStream
; v
: ShortInt); overload
; begin writeIntegerLE(st
, @v
, 1); end;
1249 procedure writeInt (st
: TStream
; v
: Word); overload
; begin writeIntegerLE(st
, @v
, 2); end;
1250 procedure writeInt (st
: TStream
; v
: SmallInt); overload
; begin writeIntegerLE(st
, @v
, 2); end;
1251 procedure writeInt (st
: TStream
; v
: LongWord); overload
; begin writeIntegerLE(st
, @v
, 4); end;
1252 procedure writeInt (st
: TStream
; v
: LongInt); overload
; begin writeIntegerLE(st
, @v
, 4); end;
1253 procedure writeInt (st
: TStream
; v
: Int64); overload
; begin writeIntegerLE(st
, @v
, 8); end;
1254 procedure writeInt (st
: TStream
; v
: UInt64); overload
; begin writeIntegerLE(st
, @v
, 8); end;
1256 procedure writeIntBE (st
: TStream
; v
: Byte); overload
; begin writeIntegerBE(st
, @v
, 1); end;
1257 procedure writeIntBE (st
: TStream
; v
: ShortInt); overload
; begin writeIntegerBE(st
, @v
, 1); end;
1258 procedure writeIntBE (st
: TStream
; v
: Word); overload
; begin writeIntegerBE(st
, @v
, 2); end;
1259 procedure writeIntBE (st
: TStream
; v
: SmallInt); overload
; begin writeIntegerBE(st
, @v
, 2); end;
1260 procedure writeIntBE (st
: TStream
; v
: LongWord); overload
; begin writeIntegerBE(st
, @v
, 4); end;
1261 procedure writeIntBE (st
: TStream
; v
: LongInt); overload
; begin writeIntegerBE(st
, @v
, 4); end;
1262 procedure writeIntBE (st
: TStream
; v
: Int64); overload
; begin writeIntegerBE(st
, @v
, 8); end;
1263 procedure writeIntBE (st
: TStream
; v
: UInt64); overload
; begin writeIntegerBE(st
, @v
, 8); end;
1265 procedure writeBool (st
: TStream
; b
: Boolean); begin writeInt(st
, Byte(b
)); end;
1266 function readBool (st
: TStream
): Boolean; begin result
:= (readByte(st
) <> 0); end;
1269 procedure writeStr (st
: TStream
; const str
: AnsiString; maxlen
: LongWord=65535);
1271 if (Length(str
) > maxlen
) then raise XStreamError
.Create('string too long');
1272 if (maxlen
<= 65535) then writeInt(st
, Word(Length(str
))) else writeInt(st
, LongWord(Length(str
)));
1273 if (Length(str
) > 0) then st
.WriteBuffer(str
[1], Length(str
));
1276 function readStr (st
: TStream
; maxlen
: LongWord=65535): AnsiString;
1281 if (maxlen
<= 65535) then len
:= readWord(st
) else len
:= Integer(readLongWord(st
));
1282 if (len
< 0) or (len
> maxlen
) then raise XStreamError
.Create('string too long');
1285 SetLength(result
, len
);
1286 st
.ReadBuffer(result
[1], len
);
1291 procedure readIntegerLE (st
: TStream
; vp
: Pointer; size
: Integer);
1292 {$IFDEF ENDIAN_LITTLE}
1294 st
.readBuffer(vp
^, size
);
1300 p
:= PByte(vp
)+size
-1;
1303 st
.readBuffer(p
^, 1);
1310 procedure readIntegerBE (st
: TStream
; vp
: Pointer; size
: Integer);
1311 {$IFDEF ENDIAN_LITTLE}
1315 p
:= PByte(vp
)+size
-1;
1318 st
.readBuffer(p
^, 1);
1325 st
.readBuffer(vp
^, size
);
1329 function readByte (st
: TStream
): Byte; begin readIntegerLE(st
, @result
, 1); end;
1330 function readShortInt (st
: TStream
): ShortInt; begin readIntegerLE(st
, @result
, 1); end;
1331 function readWord (st
: TStream
): Word; begin readIntegerLE(st
, @result
, 2); end;
1332 function readSmallInt (st
: TStream
): SmallInt; begin readIntegerLE(st
, @result
, 2); end;
1333 function readLongWord (st
: TStream
): LongWord; begin readIntegerLE(st
, @result
, 4); end;
1334 function readLongInt (st
: TStream
): LongInt; begin readIntegerLE(st
, @result
, 4); end;
1335 function readInt64 (st
: TStream
): Int64; begin readIntegerLE(st
, @result
, 8); end;
1336 function readUInt64 (st
: TStream
): UInt64; begin readIntegerLE(st
, @result
, 8); end;
1338 function readByteBE (st
: TStream
): Byte; begin readIntegerBE(st
, @result
, 1); end;
1339 function readShortIntBE (st
: TStream
): ShortInt; begin readIntegerBE(st
, @result
, 1); end;
1340 function readWordBE (st
: TStream
): Word; begin readIntegerBE(st
, @result
, 2); end;
1341 function readSmallIntBE (st
: TStream
): SmallInt; begin readIntegerBE(st
, @result
, 2); end;
1342 function readLongWordBE (st
: TStream
): LongWord; begin readIntegerBE(st
, @result
, 4); end;
1343 function readLongIntBE (st
: TStream
): LongInt; begin readIntegerBE(st
, @result
, 4); end;
1344 function readInt64BE (st
: TStream
): Int64; begin readIntegerBE(st
, @result
, 8); end;
1345 function readUInt64BE (st
: TStream
): UInt64; begin readIntegerBE(st
, @result
, 8); end;
1348 // ////////////////////////////////////////////////////////////////////////// //
1349 function nmin (a
, b
: Byte): Byte; inline; overload
; begin if (a
< b
) then result
:= a
else result
:= b
; end;
1350 function nmin (a
, b
: ShortInt): ShortInt; inline; overload
; begin if (a
< b
) then result
:= a
else result
:= b
; end;
1351 function nmin (a
, b
: Word): Word; inline; overload
; begin if (a
< b
) then result
:= a
else result
:= b
; end;
1352 function nmin (a
, b
: SmallInt): SmallInt; inline; overload
; begin if (a
< b
) then result
:= a
else result
:= b
; end;
1353 function nmin (a
, b
: LongWord): LongWord; inline; overload
; begin if (a
< b
) then result
:= a
else result
:= b
; end;
1354 function nmin (a
, b
: LongInt): LongInt; inline; overload
; begin if (a
< b
) then result
:= a
else result
:= b
; end;
1355 function nmin (a
, b
: Int64): Int64; inline; overload
; begin if (a
< b
) then result
:= a
else result
:= b
; end;
1356 function nmin (a
, b
: UInt64): UInt64; inline; overload
; begin if (a
< b
) then result
:= a
else result
:= b
; end;
1357 function nmin (a
, b
: Single): Single; inline; overload
; begin if (a
< b
) then result
:= a
else result
:= b
; end;
1358 function nmin (a
, b
: Double): Double; inline; overload
; begin if (a
< b
) then result
:= a
else result
:= b
; end;
1359 {$IF DEFINED(CPU386) OR DEFINED(CPUAMD64)}
1360 function nmin (a
, b
: Extended
): Extended
; inline; overload
; begin if (a
< b
) then result
:= a
else result
:= b
; end;
1363 function nmax (a
, b
: Byte): Byte; inline; overload
; begin if (a
> b
) then result
:= a
else result
:= b
; end;
1364 function nmax (a
, b
: ShortInt): ShortInt; inline; overload
; begin if (a
> b
) then result
:= a
else result
:= b
; end;
1365 function nmax (a
, b
: Word): Word; inline; overload
; begin if (a
> b
) then result
:= a
else result
:= b
; end;
1366 function nmax (a
, b
: SmallInt): SmallInt; inline; overload
; begin if (a
> b
) then result
:= a
else result
:= b
; end;
1367 function nmax (a
, b
: LongWord): LongWord; inline; overload
; begin if (a
> b
) then result
:= a
else result
:= b
; end;
1368 function nmax (a
, b
: LongInt): LongInt; inline; overload
; begin if (a
> b
) then result
:= a
else result
:= b
; end;
1369 function nmax (a
, b
: Int64): Int64; inline; overload
; begin if (a
> b
) then result
:= a
else result
:= b
; end;
1370 function nmax (a
, b
: UInt64): UInt64; inline; overload
; begin if (a
> b
) then result
:= a
else result
:= b
; end;
1371 function nmax (a
, b
: Single): Single; inline; overload
; begin if (a
> b
) then result
:= a
else result
:= b
; end;
1372 function nmax (a
, b
: Double): Double; inline; overload
; begin if (a
> b
) then result
:= a
else result
:= b
; end;
1373 {$IF DEFINED(CPU386) OR DEFINED(CPUAMD64)}
1374 function nmax (a
, b
: Extended
): Extended
; inline; overload
; begin if (a
> b
) then result
:= a
else result
:= b
; end;
1377 function nclamp (v
, a
, b
: Byte): Byte; inline; overload
; begin if (v
< a
) then result
:= a
else if (v
> b
) then result
:= b
else result
:= v
; end;
1378 function nclamp (v
, a
, b
: ShortInt): ShortInt; inline; overload
; begin if (v
< a
) then result
:= a
else if (v
> b
) then result
:= b
else result
:= v
; end;
1379 function nclamp (v
, a
, b
: Word): Word; inline; overload
; begin if (v
< a
) then result
:= a
else if (v
> b
) then result
:= b
else result
:= v
; end;
1380 function nclamp (v
, a
, b
: SmallInt): SmallInt; inline; overload
; begin if (v
< a
) then result
:= a
else if (v
> b
) then result
:= b
else result
:= v
; end;
1381 function nclamp (v
, a
, b
: LongWord): LongWord; inline; overload
; begin if (v
< a
) then result
:= a
else if (v
> b
) then result
:= b
else result
:= v
; end;
1382 function nclamp (v
, a
, b
: LongInt): LongInt; inline; overload
; begin if (v
< a
) then result
:= a
else if (v
> b
) then result
:= b
else result
:= v
; end;
1383 function nclamp (v
, a
, b
: Int64): Int64; inline; overload
; begin if (v
< a
) then result
:= a
else if (v
> b
) then result
:= b
else result
:= v
; end;
1384 function nclamp (v
, a
, b
: UInt64): UInt64; inline; overload
; begin if (v
< a
) then result
:= a
else if (v
> b
) then result
:= b
else result
:= v
; end;
1385 function nclamp (v
, a
, b
: Single): Single; inline; overload
; begin if (v
< a
) then result
:= a
else if (v
> b
) then result
:= b
else result
:= v
; end;
1386 function nclamp (v
, a
, b
: Double): Double; inline; overload
; begin if (v
< a
) then result
:= a
else if (v
> b
) then result
:= b
else result
:= v
; end;
1387 {$IF DEFINED(CPU386) OR DEFINED(CPUAMD64)}
1388 function nclamp (v
, a
, b
: Extended
): Extended
; inline; overload
; begin if (v
< a
) then result
:= a
else if (v
> b
) then result
:= b
else result
:= v
; end;
1391 // ////////////////////////////////////////////////////////////////////////// //
1393 function snprintf (buf
: PAnsiChar; bufsize
: SizeUInt
; const fmt
: PAnsiChar): SizeUInt
; cdecl; varargs
; external 'msvcrt.dll' name
'_snprintf';
1395 function snprintf (buf
: PAnsiChar; bufsize
: SizeUInt
; const fmt
: PAnsiChar): SizeUInt
; cdecl; varargs
; external 'libc' name
'snprintf';
1400 procedure conwriter (constref buf; len: SizeUInt);
1406 if (len < 1) then exit;
1410 if (len > 255) then slen := 255 else slen := Integer(len);
1411 Move(b^, ss[1], len);
1412 ss[0] := AnsiChar(slen);
1421 function formatstrf (const fmt
: AnsiString; const args
: array of const; writerCB
: TFormatStrFCallback
=nil): AnsiString;
1423 PadSpaces
: AnsiString = ' ';
1424 PadZeroes
: AnsiString = '00000000000000000000000000000000000000000000000000000000000000000000000';
1426 curarg
: Integer = 0; // current arg in `args`
1427 sign
, fmtch
: AnsiChar;
1429 width
, prec
: Integer; // width and precision
1430 spos
, epos
: Integer;
1432 strbuf
: array[0..256] of AnsiChar;
1434 fmtbuf
: array[0..256] of AnsiChar;
1438 ccname
: ShortString;
1440 procedure writer (constref buf
; len
: SizeUInt
);
1446 if (len
< 1) then exit
;
1448 if assigned(writerCB
) then
1456 if (len
> 255) then slen
:= 255 else slen
:= Integer(len
);
1457 Move(b
^, ss
[1], slen
);
1458 ss
[0] := AnsiChar(slen
);
1466 procedure xwrite (const s
: AnsiString);
1468 if (Length(s
) > 0) then writer(PAnsiChar(s
)^, Length(s
));
1471 procedure putFmtChar (ch
: AnsiChar);
1473 fmtbuf
[fmtblen
] := ch
;
1477 procedure putFmtInt (n
: Integer);
1481 len
:= snprintf(@fmtbuf
[fmtblen
], Length(fmtbuf
)-fmtblen
, '%d', n
);
1482 if (len
> 0) then Inc(fmtblen
, len
);
1485 procedure buildCFormat (const pfx
: AnsiString='');
1490 for f
:= 1 to Length(pfx
) do putFmtChar(pfx
[f
]);
1492 if (sign
<> ' ') then putFmtChar(sign
);
1493 if (width
>= 0) then
1495 if (zeropad
) then putFmtChar('0');
1504 fmtbuf
[fmtblen
] := #0;
1507 procedure writeStrBuf ();
1509 if (strblen
> 0) then writer(strbuf
, strblen
);
1512 function i642str (n
: Int64; hex
: Boolean; hexup
: Boolean): PAnsiChar;
1517 if (n
= $8000000000000000) then
1519 if hex
then snprintf(@strbuf
[0], Length(strbuf
), '-8000000000000000')
1520 else snprintf(@strbuf
[0], Length(strbuf
), '-9223372036854775808');
1521 result
:= @strbuf
[0];
1526 if neg
then n
:= -n
;
1527 xpos
:= High(strbuf
);
1528 strbuf
[xpos
] := #0; Dec(xpos
);
1532 strbuf
[xpos
] := AnsiChar((n
mod 10)+48);
1538 if (n
mod 16 > 9) then
1540 strbuf
[xpos
] := AnsiChar((n
mod 16)+48+7);
1541 if not hexup
then Inc(strbuf
[xpos
], 32);
1543 else strbuf
[xpos
] := AnsiChar((n
mod 16)+48);
1548 if neg
then begin strbuf
[xpos
] := '-'; Dec(xpos
); end;
1549 result
:= @strbuf
[xpos
+1];
1553 function ui642str (n
: UInt64; hex
: Boolean; hexup
: Boolean): PAnsiChar;
1557 xpos
:= High(strbuf
);
1558 strbuf
[xpos
] := #0; Dec(xpos
);
1562 strbuf
[xpos
] := AnsiChar((n
mod 10)+48);
1568 if (n
mod 16 > 9) then
1570 strbuf
[xpos
] := AnsiChar((n
mod 16)+48+7);
1571 if not hexup
then Inc(strbuf
[xpos
], 32);
1573 else strbuf
[xpos
] := AnsiChar((n
mod 16)+48);
1578 result
:= @strbuf
[xpos
+1];
1581 procedure indent (len
: Integer);
1587 if (len
> Length(PadSpaces
)) then ilen
:= Length(PadSpaces
) else ilen
:= len
;
1588 writer(PAnsiChar(PadSpaces
)^, ilen
);
1593 procedure indent0 (len
: Integer);
1599 if (len
> Length(PadZeroes
)) then ilen
:= Length(PadZeroes
) else ilen
:= len
;
1600 writer(PAnsiChar(PadZeroes
)^, ilen
);
1608 while (spos
<= Length(fmt
)) do
1610 // print literal part
1612 while (epos
<= Length(fmt
)) and (fmt
[epos
] <> '%') do Inc(epos
);
1613 // output literal part
1614 if (epos
> spos
) then
1616 if (epos
> Length(fmt
)) then
1618 writer((PAnsiChar(fmt
)+spos
-1)^, epos
-spos
);
1621 if (epos
+1 > Length(fmt
)) then Inc(epos
) // last percent, output literally
1622 else if (fmt
[epos
+1] = '%') then // special case
1625 writer((PAnsiChar(fmt
)+spos
-1)^, epos
-spos
);
1630 writer((PAnsiChar(fmt
)+spos
-1)^, epos
-spos
);
1635 // check if we have argument for this format string
1636 if (curarg
> High(args
)) then
1638 xwrite('<OUT OF ARGS>');
1639 writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1);
1643 if (spos
+1 > Length(fmt
)) then break
; // oops
1644 assert(fmt
[spos
] = '%');
1646 // parse format; check for sign
1647 if (fmt
[spos
] = '-') then begin sign
:= '-'; Inc(spos
); end
1648 else if (fmt
[spos
] = '+') then begin sign
:= '+'; Inc(spos
); end
1651 if (spos
> Length(fmt
)) then begin xwrite('<INVALID FORMAT>'); break
; end;
1652 if (sign
<> ' ') or ((fmt
[spos
] >= '0') and (fmt
[spos
] <= '9')) then
1654 if (fmt
[spos
] < '0') or (fmt
[spos
] > '9') then begin xwrite('<INVALID FORMAT>'); writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1); break
; end;
1655 zeropad
:= (fmt
[spos
] = '0');
1657 while (spos
<= Length(fmt
)) do
1660 if (ch
< '0') or (ch
> '9') then break
;
1661 width
:= width
*10+Integer(ch
)-48;
1672 if (spos
<= Length(fmt
)) and (fmt
[spos
] = '.') then
1675 if (spos
> Length(fmt
)) then begin xwrite('<INVALID FORMAT>'); break
; end;
1676 if (fmt
[spos
] < '0') or (fmt
[spos
] > '9') then begin xwrite('<INVALID FORMAT>'); writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1); break
; end;
1678 while (spos
<= Length(fmt
)) do
1681 if (ch
< '0') or (ch
> '9') then break
;
1682 prec
:= prec
*10+Integer(ch
)-48;
1687 if (spos
> Length(fmt
)) then begin xwrite('<INVALID FORMAT>'); break
; end;
1690 // done parsing format, check for valid format chars
1691 if not (fmtch
in ['s','u','d','x','X','p','f','g','c']) then begin xwrite('<INVALID FORMAT CHAR>'); writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1); break
; end;
1692 // now write formatted string
1693 case args
[curarg
].VType
of
1694 vtInteger
: // args[curarg].VInteger
1696 if not (fmtch
in ['s','u','d','x','X']) then begin xwrite('<INVALID FORMAT CHAR>'); writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1); break
; end;
1697 if (fmtch
= 's') then fmtch
:= 'd';
1699 strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], args
[curarg
].VInteger
);
1702 vtBoolean
: // args[curarg].VBoolean
1707 if args
[curarg
].VBoolean
then strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], 'true')
1708 else strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], 'false');
1714 if args
[curarg
].VBoolean
then strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], AnsiChar('t'))
1715 else strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], AnsiChar('f'));
1721 strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], Integer(args
[curarg
].VBoolean
));
1726 xwrite('<INVALID FORMAT CHAR>');
1727 writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1);
1731 vtChar
: // args[curarg].VChar
1737 strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], args
[curarg
].VChar
);
1743 strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], Integer(args
[curarg
].VChar
));
1748 xwrite('<INVALID FORMAT CHAR>');
1749 writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1);
1753 //vtWideChar: begin end; // args[curarg].VWideChar (WideChar)
1754 vtExtended
: // args[curarg].VExtended^
1760 strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], Double(args
[curarg
].VExtended
^));
1766 strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], Double(args
[curarg
].VExtended
^));
1772 strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], Integer(trunc(args
[curarg
].VExtended
^)));
1778 strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], LongWord(trunc(args
[curarg
].VExtended
^)));
1783 xwrite('<INVALID FORMAT CHAR>');
1784 writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1);
1788 vtString
: // args[curarg].VString^ (PShortString)
1790 if (sign
<> '-') then indent(width
-Length(args
[curarg
].VString
^));
1791 writer(args
[curarg
].VString
^[1], Length(args
[curarg
].VString
^));
1792 if (sign
= '-') then indent(width
-Length(args
[curarg
].VString
^));
1794 vtPointer
: // args[curarg].VPointer
1799 if (width
< 8) then width
:= 8;
1802 strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], PtrUInt(args
[curarg
].VPointer
));
1805 'u', 'd', 'x', 'p', 'X':
1807 if (fmtch
= 'p') then fmtch
:= 'x';
1808 if (width
< 8) then width
:= 8;
1811 strblen
:= snprintf(@strbuf
[0], Length(strbuf
), @fmtbuf
[0], PtrUInt(args
[curarg
].VPointer
));
1816 xwrite('<INVALID FORMAT CHAR>');
1817 writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1);
1821 vtPChar
: // args[curarg].VPChar
1822 if (args
[curarg
].VPChar
= nil) then
1824 if (sign
<> '-') then indent(width
-3);
1826 if (sign
= '-') then indent(width
-3);
1831 while (args
[curarg
].VPChar
[pclen
] <> #0) do Inc(pclen
);
1832 if (sign
<> '-') then indent(width
-pclen
);
1833 writer(args
[curarg
].VPChar
^, pclen
);
1834 if (sign
= '-') then indent(width
-pclen
);
1836 vtObject
: // args[curarg].VObject.Classname (TObject)
1838 if (args
[curarg
].VObject
<> nil) then ccname
:= args
[curarg
].VObject
.Classname
else ccname
:= '<nil>';
1839 if (sign
<> '-') then indent(width
-Length(ccname
));
1841 if (sign
= '-') then indent(width
-Length(ccname
));
1843 vtClass
: // args[curarg].VClass.Classname (TClass)
1845 if (args
[curarg
].VClass
<> nil) then ccname
:= args
[curarg
].VClass
.Classname
else ccname
:= '<nil>';
1846 if (sign
<> '-') then indent(width
-Length(ccname
));
1848 if (sign
= '-') then indent(width
-Length(ccname
));
1850 //vtPWideChar: begin end; // args[curarg].VPWideChar (PWideChar)
1851 vtAnsiString
: // AnsiString(args[curarg].VAnsiString) (Pointer)
1853 if (sign
<> '-') then indent(width
-Length(AnsiString(args
[curarg
].VAnsiString
)));
1854 xwrite(AnsiString(args
[curarg
].VAnsiString
));
1855 if (sign
= '-') then indent(width
-Length(AnsiString(args
[curarg
].VAnsiString
)));
1857 //vtCurrency: begin end; // args[curarg].VCurrency (PCurrency)
1858 //vtVariant: begin end; // args[curarg].VVariant^ (PVariant)
1859 //vtInterface: begin end; // args[curarg].VInterface (Pointer);
1860 //vtWideString: begin end; // args[curarg].VWideString (Pointer);
1861 vtInt64
: // args[curarg].VInt64^ (PInt64)
1864 's','d','u': pc
:= i642str(args
[curarg
].VInt64
^, false, false);
1865 'x': pc
:= i642str(args
[curarg
].VInt64
^, true, false);
1866 'X': pc
:= i642str(args
[curarg
].VInt64
^, true, true);
1867 else begin xwrite('<INVALID FORMAT CHAR>'); writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1); break
; end;
1870 while (pc
[pclen
] <> #0) do Inc(pclen
);
1871 if (sign
<> '-') and (width
> pclen
) then
1875 if (pc
[0] = '-') or (pc
[0] = '+') then
1878 indent0(width
-pclen
-1);
1884 indent0(width
-pclen
);
1889 indent(width
-pclen
);
1893 if (sign
= '-') then indent(width
-pclen
);
1895 vtQWord
: // args[curarg].VQWord^ (PQWord)
1898 's','d','u': pc
:= ui642str(args
[curarg
].VInt64
^, false, false);
1899 'x': pc
:= ui642str(args
[curarg
].VInt64
^, true, false);
1900 'X': pc
:= ui642str(args
[curarg
].VInt64
^, true, true);
1901 else begin xwrite('<INVALID FORMAT CHAR>'); writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1); break
; end;
1904 while (pc
[pclen
] <> #0) do Inc(pclen
);
1905 if (sign
<> '-') then begin if zeropad
then indent0(width
-pclen
) else indent(width
-pclen
); end;
1907 if (sign
= '-') then indent(width
-pclen
);
1911 xwrite('<INVALID TYPE>');
1912 writer((PAnsiChar(fmt
)+spos
-1)^, Length(fmt
)-spos
+1);
1925 i64: Int64 = -$A000000000;
1926 ui64: UInt64 = $A000000000;
1928 writef(conwriter, 'test int:<%s> bool:<%s:%02d:%c> bool:<%s:%02d:%c>; char:<%2s;%c;%d>!'#10, [42, true, true, true, false, false, false, 'A', 'A', 'A']);
1929 writef(conwriter, 'test float:<%s;%u;%f;%g>'#10, [666.6942, 666.6942, 666.6942, 666.6942]);
1932 writef(conwriter, 'test ss:<%5s;%040s>'#10, [ss, ss]);
1933 writef(conwriter, 'test ls:<%5s;%040s>'#10, [ls, ls]);
1934 writef(conwriter, 'test pointer:<%s;%x;%p>'#10, [@ss, @ss, @ss]);
1935 writef(conwriter, 'test i64:<%s;%x;%015d;%u;%X>'#10, [i64, i64, i64, i64, i64]);
1936 writef(conwriter, 'test ui64:<%s;%x;%15d;%015u;%X>'#10, [ui64, ui64, ui64, ui64, ui64]);