我正在使用宏来简化返回本地化字符串的过程,如下所示:

#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扩展为GetLocalStrNoArgsGetLocalStrArgs,具体取决于是否传递了任何参数,但是到目前为止,我一直没有运气(宏不是我的强项: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
    

    10-07 19:53
    查看更多