Xcode 14.1中Swift将C char buffer转为String报错的解决方法

在Xcode 14.1开发场景下，将C结构体MY_C_STRUCT中UTF-8编码的空终止char数组buff[256]转换为Swift String时，调用String(cString:)初始化器会抛出“No exact matches in call to initializer”错误。

相关代码 #

C结构体定义

struct MY_C_STRUCT
{
    char buff[256];   // 存储UTF-8编码的空终止C字符串
};

Swift类代码

class MyStruct : ObservableObject
{
    @Published public var Buff : String = ""

    func from_MY_C_STRUCT(mi : MY_C_STRUCT)
    {
         Buff = String(cString: mi.buff) // 此处报错：No exact matches in call to initializer
    }
}

问题原因 #

Swift导入固定长度的C char数组后，会将其映射为元组类型（比如(UInt8, UInt8, ...)，共256个元素），而String(cString:)需要的参数类型是UnsafePointer<CChar>，类型不匹配导致报错。

解决方法 #

方法一：内存重新绑定获取指针

通过withUnsafePointer获取元组的内存地址，再将其重新绑定为CChar类型的指针，直接传入String(cString:)：

func from_MY_C_STRUCT(mi : MY_C_STRUCT) {
    Buff = withUnsafePointer(to: mi.buff) { tuplePtr in
        tuplePtr.withMemoryRebound(to: CChar.self, capacity: 256) { cCharPtr in
            String(cString: cCharPtr)
        }
    }
}

方法二：通过字节缓冲区处理（更安全）

将元组转为UnsafeRawBufferPointer，手动查找空终止符的位置，再截取有效字节转换为String，还能兼容无空终止符的情况：

func from_MY_C_STRUCT(mi : MY_C_STRUCT) {
    let byteBuffer = withUnsafeBytes(of: mi.buff) { $0 }
    // 查找第一个空字节的位置
    if let nullTerminatorIndex = byteBuffer.firstIndex(where: { $0 == 0 }) {
        // 截取空终止符之前的字节转成String
        Buff = String(bytes: byteBuffer[..<nullTerminatorIndex], encoding: .utf8) ?? ""
    } else {
        // 没有空终止符时，取全部256字节转换（需确保数据是合法UTF-8）
        Buff = String(bytes: byteBuffer, encoding: .utf8) ?? ""
    }
}

注意事项 #

• 确保C字符串是标准UTF-8编码，否则转换后的String会出现乱码；
• 如果C字符串长度超过255字节（含空终止符），会被截断，需提前处理内存越界风险；
• 若有权限修改C结构体定义，可将char buff[256]改为char* buff，Swift导入后直接兼容String(cString:)初始化器。

内容的提问来源于stack exchange，提问作者c00000fd