scroll/src/common/utils.ts

91 lines
2.0 KiB
JavaScript

// ----------------------------------------------------------------------------
// Misc
// ----------------------------------------------------------------------------
export const noop = () => {};
// ----------------------------------------------------------------------------
// Strings
// ----------------------------------------------------------------------------
/**
* Get the codepoint of the first byte of a string. If the string
* is empty, this will return 256
*
* @param s - the string
*/
export function ord(s: string): number {
if (s.length > 0) {
return s.codePointAt(0)!;
}
return 256;
}
/**
* Split a string by graphemes, not just bytes
*
* @param s - the string to split into 'characters'
*/
export function chars(s: string): string[] {
return s.split(/(?:)/u);
}
/**
* Get the 'character length' of a string, not its UTF16 byte count
*
* @param s - the string to check
*/
export function strlen(s: string): number {
return chars(s).length;
}
/**
* Are all the characters in the string in ASCII range?
*
* @param char - string to check
*/
export function isAscii(char: string): boolean {
return chars(char).every((char) => ord(char) < 0x80);
}
/**
* Is the one char in the string an ascii control character?
*
* @param char - a one character string to check
*/
export function isControl(char: string): boolean {
const code = ord(char);
return isAscii(char) && (code === 0x7f || code < 0x20);
}
/**
* Get the key code for a ctrl chord
*
* @param char - a one character string
*/
export function ctrlKey(char: string): string {
// This is the normal use case, of course
if (isAscii(char)) {
const point = ord(char);
return String.fromCodePoint(point & 0x1f);
}
// If it's not ascii, just return the input key code
return char;
}
/**
* Trim a string to a max number of characters
* @param s
* @param maxLen
*/
export function truncate(s: string, maxLen: number): string {
const chin = chars(s);
if (maxLen >= chin.length) {
return s;
}
return chin.slice(0, maxLen).join('');
}