78 lines
2.2 KiB
C
78 lines
2.2 KiB
C
#pragma once
|
||
|
||
#if defined(_WIN32) || defined(_WIN64)
|
||
#include <Windows.h>
|
||
#ifndef uint32_t
|
||
typedef unsigned int uint32_t;
|
||
#endif
|
||
#ifndef LANG_EXPORT
|
||
#ifdef _DEBUG
|
||
#pragma comment(lib, "Debug/lang.lib")
|
||
#else
|
||
#pragma comment(lib, "Release/lang.lib")
|
||
#endif
|
||
#endif
|
||
#endif
|
||
|
||
// purpose: APP language utility
|
||
//
|
||
// Date: 2023-01-16
|
||
//
|
||
// Implement: 语言包封装为独立的模块,提供以下API供程序调用
|
||
//
|
||
// 所需语言包按代码页区分为独立的文件，安装时部署在安装目录下的“lang”子目录下，扩展名为“.pak”
|
||
|
||
extern "C"
|
||
{
|
||
#pragma pack(push)
|
||
#pragma pack(1)
|
||
typedef struct _lan_attr
|
||
{
|
||
int cp; // code page
|
||
uint32_t id; // 语言名称全局唯一ID
|
||
char *name; // 以当前语言环境显示的名称，UTF-8
|
||
}LANATTR;
|
||
#pragma pack(pop)
|
||
|
||
// Function: 初始化语言包
|
||
//
|
||
// Parameter: param - 保留供后期扩展
|
||
//
|
||
// Return: 返回当前应用的语言包代码页，-1为语言包文件丢失，需要提醒用户程序文件损坏并退出
|
||
extern int lang_initialize(void* param = nullptr);
|
||
|
||
// Function: 获取APP当前支持的所有语言包
|
||
//
|
||
// Parameter: 无
|
||
//
|
||
// Return: LANATTR指针数组pptr，直到pptr[]为nullptr为止
|
||
extern LANATTR** lang_get_supported_languages(void);
|
||
|
||
// Function: 获取APP当前语言包/代码页
|
||
//
|
||
// Parameter: 无
|
||
//
|
||
// Return: 代码页
|
||
extern int lang_get_cur_code_page(void);
|
||
|
||
// Function: 设置APP语言包/代码页（APP运行时会自动选定当前代码页，无特殊需要不需要专门调用）
|
||
//
|
||
// Parameter: cp - 代码页，若为“0”，则自动匹配系统当前代码页
|
||
//
|
||
// Return: 0 - 成功
|
||
// ENOENT - APP不支持该代码页
|
||
extern int lang_set_code_page(int cp = 0);
|
||
|
||
// Function: 加载当前代码页的字符串资源 （UTF-8）
|
||
//
|
||
// Parameters: id - 字符串ID，全局唯一
|
||
//
|
||
// err - 获取id对应的字符串错误码
|
||
// 0 - 成功
|
||
// ENOENT - 所需ID资源，在当前代码页中没找到
|
||
//
|
||
// Return: 对应的字符串指针，如果失败返回长度为0的空字符串 ""。调用者不用释放返回指针，但也不要改动该指针内容
|
||
extern const char* lang_load_string(uint32_t id, int* err);
|
||
}
|
||
|