@modern-kit/utils/dist/string/extractLetters/index.d.ts

modern-kit/utils

interface ExtractLettersOptions {
    letters?: boolean;
    numbers?: boolean;
    specialCharacters?: boolean;
    whiteSpace?: boolean;
}
/**
 * @description 주어진 문자열에서 특정 옵션에 따라 문자를 추출하는 함수입니다.
 *
 * @param {string} value - 처리할 입력 문자열입니다.
 * @param {ExtractLettersOptions} [options] - 추출할 문자의 유형을 지정하는 옵션 객체입니다. 기본적으로 문자만 추출합니다.
 * - `letters` (boolean): 문자열에서 문자를 추출할지 여부를 지정합니다.
 * - `numbers` (boolean): 문자열에서 숫자를 추출할지 여부를 지정합니다.
 * - `specialCharacters` (boolean): 문자열에서 특수 문자를 추출할지 여부를 지정합니다.
 * - `whiteSpace` (boolean): 문자열에서 공백을 추출할지 여부를 지정합니다.
 *
 * @returns {string} - 주어진 옵션에 따라 필터링된 문자를 포함하는 문자열을 반환합니다.
 *
 * @example
 * // 문자를 추출
 * extractLetters('abc123!@#', { letters: true }); // 'abc'
 *
 * @example
 * // 숫자를 추출
 * extractLetters('abc123!@#', { numbers: true }); // '123'
 *
 * @example
 * // 문자와 숫자를 추출
 * extractLetters('abc123!@#', { letters: true, numbers: true }); // 'abc123'
 *
 * @example
 * // 공백과 숫자를 추출
 * extractLetters('abc  123 !@#', { whiteSpace: true, numbers: true }); // '  123 '
 */
declare function extractLetters(value: string, options?: ExtractLettersOptions): string;

export { extractLetters };