/* * Copyright 2026 mingliqiye * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * * ProjectName mingli-utils * ModuleName mingli-utils.main * CurrentFile ByteUtils.kt * LastUpdate 2026-03-11 08:46:40 * UpdateUser MingLiPro */ @file:JvmName("ByteUtils") package com.mingliqiye.utils.bytes import com.mingliqiye.utils.base.code.Base16 import com.mingliqiye.utils.stream.SuperStream /** * 转义字符常量定义 * 定义了用于数据传输或协议通信中的特殊控制字节值 */ const val ESC_ASC: Byte = 0x10 /** * 转义字符常量定义 * 定义了用于数据传输或协议通信中的特殊控制字节值 */ const val ESC_DESC: Byte = 0x1B /** * 转义字符常量定义 * 定义了用于数据传输或协议通信中的特殊控制字节值 */ const val ESC_NONE: Byte = 0x00 /** * 转义字符常量定义 * 定义了用于数据传输或协议通信中的特殊控制字节值 */ const val ESC_START: Byte = 0x01 /** * 转义字符常量定义 * 定义了用于数据传输或协议通信中的特殊控制字节值 */ const val ESC_END: Byte = 0x02 /** * 转义字符常量定义 * 定义了用于数据传输或协议通信中的特殊控制字节值 */ const val ESC_ESC: Byte = 0x03 /** * 转义字符常量定义 * 定义了用于数据传输或协议通信中的特殊控制字节值 */ const val ESC_CONTROL: Byte = 0x04 /** * 转义字符常量定义 * 定义了用于数据传输或协议通信中的特殊控制字节值 */ const val ESC_DATA: Byte = 0x05 /** * 转义字符常量定义 * 定义了用于数据传输或协议通信中的特殊控制字节值 */ const val ESC_RESERVED: Byte = 0x06 /** * 将字节数组转换为十六进制字符串列表 * @receiver 字节数组 * @return 包含每个字节对应十六进制字符串的列表 */ fun ByteArray.getByteArrayString(): MutableList { return this.toList().stream().map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) } .collect(SuperStream.toList()) as MutableList } /** * 将十六进制字符转换为对应的数值 * @receiver 十六进制字符 * @return 对应的数值(0-15) * @throws NumberFormatException 当字符不是有效的十六进制字符时抛出 */ fun Char.hexDigitToValue(): Int { return when (this) { in '0'..'9' -> this - '0' in 'A'..'F' -> this - 'A' + 10 in 'a'..'f' -> this - 'a' + 10 else -> throw NumberFormatException("Invalid hex character: $this") } } /** * 将十六进制字符串转换为字节数组 * * @param string 输入的十六进制字符串 * @return 转换后的字节数组 */ fun hexStringToByteArray(string: String): ByteArray { return string.hexToByteArray() } /** * 将字节数组转换为十六进制字符串表示。 * * @param bytes 输入的字节数组 * @return 对应的十六进制字符串 */ fun bytesToHex(bytes: ByteArray): String { return Base16.encode(bytes) }