我正在使用宏来简化返回本地化字符串的过程,如下所示:
#define GetLocalStr(key, ...) \
[NSString stringWithFormat:[[NSBundle mainBundle] localizedStringForKey:key value:@"" table:nil], ##__VA_ARGS__]
基本上,如果您在本地化字符串文件中有一个条目,例如
"name" = "My name is %@";
,则调用GetLocalStr( @"name", @"Foo" );
将返回NSString
@"My name is Foo"
但是,当我运行它时,例如:
NSString * str = GetLocalStr( @"name", @"Foo" );
我收到“格式字符串不是字符串文字”的警告。即使遵循关于此警告的其他答案的建议,也将其替换为:
NSString * str = [NSString stringWithFormat:@"%@", GetLocalStr( @"name", @"Foo" )];
我仍然得到警告,此外,它还打破了宏的观点,使生活更轻松。
在将所有
GetLocalStr
调用包装在#pragma抑制器中之后,如何摆脱警告呢?编辑27/08
在浏览完CRD的答案并进行了更多测试之后,似乎我对错误做出了错误的假设。澄清:
本地化字符串文件:
"TestNoArgs" = "Hello world";
"TestArgs" = "Hello world %@";
代码:
NSString * str1 = GetLocalStr( @"TestNoArgs" ); // gives warning
NSString * str2 = GetLocalStr( @"TestArgs", @"Foo" ); // doesn't give warning
我的大部分翻译都没有论据,而那些只是发出警告,但直到阅读完CRD的回答后,我才建立联系。
我将单个宏更改为两个,如下所示:
#define GetLocalStrNoArgs(key) \
[[NSBundle mainBundle] localizedStringForKey:key value:@"" table:nil]
#define GetLocalStrArgs(key, ...) \
[NSString stringWithFormat:[[NSBundle mainBundle] localizedStringForKey:key value:@"" table:nil], ##__VA_ARGS__]
而且,如果我分别给每个人打电话,则不会发出警告。
我希望
GetLocalStr
扩展为GetLocalStrNoArgs
或GetLocalStrArgs
,具体取决于是否传递了任何参数,但是到目前为止,我一直没有运气(宏不是我的强项:D)。我正在使用
sizeof(#__VA_ARGS__)
来确定是否传递了任何参数-它对参数进行字符串化,并且如果大小为1,则为空(即\0)。也许这不是最理想的方法,但似乎可行。如果我将
GetLocalStr
宏重写为:#define GetLocalStr(key,...) (sizeof(#__VA_ARGS__) == 1) ? GetLocalStrNoArgs(key) : GetLocalStrArgs(key,##__VA_ARGS__)
我可以使用它,但是在所有使用它的地方仍会收到警告,并且没有传递任何参数,而类似
#define GetLocalStr( key,...) \
#if ( sizeof(#__VA_ARGS__) == 1 ) \
GetLocalStrNoArgs(key) \
#else \
GetLocalStrArgs(key,##__VA_ARGS__)
不会编译。我如何才能使
GetLocalStr
宏正确展开? 最佳答案
Clang&GCC编译器会检查格式字符串和提供的参数是否一致,如果格式字符串不是文字,它们将无法执行此操作-因此,从软件包中获取格式字符串时会看到错误消息。
为了解决这个问题,有一个属性format_arg(n)
(docs),用于标记采用格式字符串的函数。在不更改实际格式说明符的情况下以某种方式对其进行更改,例如将其翻译;然后将其退回。 Cocoa为此属性提供了方便的宏NS_FORMAT_ARG(n)
。
要解决您的问题,您需要做两件事:
NSBundle
的调用;和其次,您的字符串文件应包含:
"name %@" = "My name is %@"
因此该键具有与结果相同的格式说明符(如果您需要对特定语言的说明符重新排序,请使用位置格式说明符)。
现在定义一个简单的函数来进行查找,并将其归为格式转换函数。注意,我们将其标记为
static inline
,并使用NS_INLINE
宏作为编译器的提示,以将其内联到您的宏扩展中; static
允许您将其包含在多个文件中,而不会引起符号冲突:NS_INLINE NSString *localize(NSString *string) NS_FORMAT_ARGUMENT(1);
NSString *localize(NSString *string)
{
return [[NSBundle mainBundle] localizedStringForKey:string value:@"" table:nil];
}
并且您的宏变为:
#define GetLocalStr(key, ...) [NSString stringWithFormat:localize(key), ##__VA_ARGS__]
现在,当您:
GetLocalStr(@"name %@", @"Foo")
您将同时获得本地化的格式字符串和格式检查。
更新
在Greg发表评论后,我回过头来检查-我重现了您的错误,因此认为是归因于缺少的属性。但是,正如Greg所指出的,
localizedStringForKey:value:table:
已经具有该属性,那么为什么会出错呢?在复制您的错误时,我专心做的是:NSLog( GetLocalStr( @"name %@", @"Foo" ) );
并且编译器指向宏定义而不是那一行-我应该发现编译器误导了我。
那那会留在哪里呢?也许您做了类似的事情?关键是格式字符串必须是文字或归因于格式转换函数的函数/方法的结果。并且不要忘记,您还必须像上面一样为 key 设置格式说明符。
更新2
在附加注释之后,您需要使用函数而不是宏以及
format
属性,为此Cocoa提供了便利的NS_FORMAT_FUNCTION(f,a)
宏。此属性通知编译器该函数是格式格式,f
的值是格式字符串的编号,a
是格式的第一个参数的编号。这给出了函数声明:NSString *GetLocalStr(NSString *key, ...) NS_FORMAT_FUNCTION(1,2);
和定义(假设ARC):
NSString *GetLocalStr(NSString *key, ...)
{
va_list args;
va_start(args, key);
NSString *format = [[NSBundle mainBundle] localizedStringForKey:key value:@"" table:nil];
NSString *result = [[NSString alloc] initWithFormat:format arguments:args];
va_end (args);
return result;
}
(与@ A-Live的基本相同)。
将对此进行适当检查,例如:
int x;
...
NSString *s1 = GetLocalStr(@"name = %d", x); // OK
NSString *s2 = GetLocalStr(@"name = %d"); // compile warning - More '%" conversions than data arguments
NSString *s3 = GetLocalStr(@"name", x); // compile warning - Data argument not used by format string
NSString *s4 = GetLocalStr(@"name"); // OK