它是一个函数注释。

更详细的，Python 2。X具有文档字符串，允许您将元数据字符串附加到各种类型的对象。这非常方便，所以Python 3扩展了这个特性，允许你将元数据附加到函数上，描述它们的参数和返回值。

没有先入为主的用例，但是PEP建议了几个用例。一个非常方便的方法是允许你用参数的预期类型来注释参数;这样就很容易编写一个装饰器来验证注释或将参数强制转换为正确的类型。另一种是允许特定于参数的文档，而不是将其编码到文档字符串中。

正如其他答案所述，->符号用作函数注释的一部分。不过，在Python >= 3.5的最新版本中，它有明确的含义。

PEP 3107——函数注释描述了规范，定义了语法的变化，func的存在。__annotations__，它们被存储在其中，事实上，它的用例仍然是开放的。

但在Python 3.5中，PEP 484——类型提示附加了一个含义:->用于指示函数返回的类型。这似乎也将在未来的版本中强制执行，如注释的现有用法所述:

最快的方案是在3.6中无声地弃用非类型提示注释，在3.7中完全弃用，并将类型提示声明为Python 3.8中唯一允许使用的注释。

(强调我的)

据我所知，这在3.6版还没有实现，所以它可能会被推到未来的版本中。

根据这一点，你提供的例子:

def f(x) -> 123:
    return x

未来将被禁止(在当前版本中会令人困惑)，它将需要更改为:

def f(x) -> int:
    return x

为了有效地描述该函数，f返回一个int类型的对象。

Python本身并不以任何方式使用注释，它基本上填充并忽略它们。这取决于第三方库与他们一起工作。

def f(x) -> 123:
    return x

我的总结:

Simply -> is introduced to get developers to optionally specify the return type of the function. See Python Enhancement Proposal 3107 This is an indication of how things may develop in future as Python is adopted extensively - an indication towards strong typing - this is my personal observation. You can specify types for arguments as well. Specifying return type of the functions and arguments will help in reducing logical errors and improving code enhancements. You can have expressions as return type (for both at function and parameter level) and the result of the expressions can be accessed via annotations object's 'return' attribute. annotations will be empty for the expression/return value for lambda inline functions.

这些是PEP 3107中包含的函数注释。具体来说，->标记返回函数注释。

例子:

def kinetic_energy(m:'in KG', v:'in M/S')->'Joules': 
    return 1/2*m*v**2
 
>>> kinetic_energy.__annotations__
{'return': 'Joules', 'v': 'in M/S', 'm': 'in KG'}

注释是字典，所以你可以这样做:

>>> '{:,} {}'.format(kinetic_energy(12,30),
      kinetic_energy.__annotations__['return'])
'5,400.0 Joules'

你也可以有一个python数据结构，而不仅仅是字符串:

rd={'type':float,'units':'Joules',
    'docstring':'Given mass and velocity returns kinetic energy in Joules'}
def f()->rd:
    pass

>>> f.__annotations__['return']['type']
<class 'float'>
>>> f.__annotations__['return']['units']
'Joules'
>>> f.__annotations__['return']['docstring']
'Given mass and velocity returns kinetic energy in Joules'

或者，你可以使用函数属性来验证调用的值:

def validate(func, locals):
    for var, test in func.__annotations__.items():
        value = locals[var]
        try: 
            pr=test.__name__+': '+test.__docstring__
        except AttributeError:
            pr=test.__name__   
        msg = '{}=={}; Test: {}'.format(var, value, pr)
        assert test(value), msg

def between(lo, hi):
    def _between(x):
            return lo <= x <= hi
    _between.__docstring__='must be between {} and {}'.format(lo,hi)       
    return _between

def f(x: between(3,10), y:lambda _y: isinstance(_y,int)):
    validate(f, locals())
    print(x,y)

打印

>>> f(2,2) 
AssertionError: x==2; Test: _between: must be between 3 and 10
>>> f(3,2.1)
AssertionError: y==2.1; Test: <lambda>

def f(x) -> str:
return x+4

print(f(45))

将给出结果:49。

换句话说，'-> str'对返回类型没有影响:

print(f(45).__class__)

<class 'int'>

这意味着函数返回的结果类型，但它可以是None。

它在面向Python 3.x的现代库中广泛存在。

例如，它在很多地方的库panda -profiling代码中有:

def get_description(self) -> dict:

def get_rejected_variables(self, threshold: float = 0.9) -> list:

def to_file(self, output_file: Path or str, silent: bool = True) -> None:
"""Write the report to a file.