Function annotation with two or more return parametersWhat does ** (double star/asterisk) and * (star/asterisk) do for parameters?How to merge two dictionaries in a single expression?How to flush output of print function?How to return multiple values from a function?Using global variables in a functionLimiting floats to two decimal pointsHow to make a chain of function decorators?How do I concatenate two lists in Python?Why didn't PEP 3107 (or 484) include syntax for annotating global/local variables?function annotations in python

Working hours and productivity expectations for game artists and programmers

Bash Array of Word-Splitting Headaches

Why does snapping your fingers activate the Infinity Gauntlet?

Isn't Kirchhoff's junction law a violation of conservation of charge?

How to safely discharge oneself

Will this series of events work to drown the Tarrasque?

Can 2 light bulbs of 120V in series be used on 230V AC?

How could the B-29 bomber back up under its own power?

Why are Marine Le Pen's possible connections with Steve Bannon something worth investigating?

Does the Aboleth have expertise in history and perception?

Is being an extrovert a necessary condition to be a manager?

Parse a C++14 integer literal

How to convince boss to spend notice period on documentation instead of new projects

Have I found a major security issue with login

Managing heat dissipation in a magic wand

Does science define life as "beginning at conception"?

Greek theta instead of lower case þ (Icelandic) in TexStudio

Why didn't Daenerys' advisers suggest assassinating Cersei?

Why could the Lunar Ascent Engine be used only once?

400 - 430 degrees celsius heated bath

Was Tyrion always a poor strategist?

Head-internal relative clauses

What city and town structures are important in a low fantasy medieval world?

Why favour the standard WP loop over iterating over (new WP_Query())->get_posts()?



Function annotation with two or more return parameters


What does ** (double star/asterisk) and * (star/asterisk) do for parameters?How to merge two dictionaries in a single expression?How to flush output of print function?How to return multiple values from a function?Using global variables in a functionLimiting floats to two decimal pointsHow to make a chain of function decorators?How do I concatenate two lists in Python?Why didn't PEP 3107 (or 484) include syntax for annotating global/local variables?function annotations in python






.everyoneloves__top-leaderboard:empty,.everyoneloves__mid-leaderboard:empty,.everyoneloves__bot-mid-leaderboard:empty height:90px;width:728px;box-sizing:border-box;








15















When I write an annotation for a function which returns one parameter, I have no problems.



def func() -> str:
return "ok"


However, when I write an annotation with two or more parameters, my PyCharm gives me SyntaxError: invalid syntax.



def func() -> str, str:
return "ok - 1", "ok - 2"


I think that the parameters can be combined with a tuple, but I don't think that's the best way to do it.



My question is: how can I properly annotate a function with two or more return parameters?



Please include a PEP link, if any, in your response. I looked for the answer at PEP 484 and PEP 3107 and could not find it.










share|improve this question
























  • It should be noted that the second func is equivalent to tmp = ('ok - 1', 'ok - 2') return tmp, making it immediately apparent why it requires Tuple.

    – Peilonrayz
    May 7 at 9:01

















15















When I write an annotation for a function which returns one parameter, I have no problems.



def func() -> str:
return "ok"


However, when I write an annotation with two or more parameters, my PyCharm gives me SyntaxError: invalid syntax.



def func() -> str, str:
return "ok - 1", "ok - 2"


I think that the parameters can be combined with a tuple, but I don't think that's the best way to do it.



My question is: how can I properly annotate a function with two or more return parameters?



Please include a PEP link, if any, in your response. I looked for the answer at PEP 484 and PEP 3107 and could not find it.










share|improve this question
























  • It should be noted that the second func is equivalent to tmp = ('ok - 1', 'ok - 2') return tmp, making it immediately apparent why it requires Tuple.

    – Peilonrayz
    May 7 at 9:01













15












15








15


2






When I write an annotation for a function which returns one parameter, I have no problems.



def func() -> str:
return "ok"


However, when I write an annotation with two or more parameters, my PyCharm gives me SyntaxError: invalid syntax.



def func() -> str, str:
return "ok - 1", "ok - 2"


I think that the parameters can be combined with a tuple, but I don't think that's the best way to do it.



My question is: how can I properly annotate a function with two or more return parameters?



Please include a PEP link, if any, in your response. I looked for the answer at PEP 484 and PEP 3107 and could not find it.










share|improve this question
















When I write an annotation for a function which returns one parameter, I have no problems.



def func() -> str:
return "ok"


However, when I write an annotation with two or more parameters, my PyCharm gives me SyntaxError: invalid syntax.



def func() -> str, str:
return "ok - 1", "ok - 2"


I think that the parameters can be combined with a tuple, but I don't think that's the best way to do it.



My question is: how can I properly annotate a function with two or more return parameters?



Please include a PEP link, if any, in your response. I looked for the answer at PEP 484 and PEP 3107 and could not find it.







python python-3.x type-hinting






share|improve this question















share|improve this question













share|improve this question




share|improve this question








edited May 7 at 2:47









gmds

10.9k11038




10.9k11038










asked May 7 at 2:05









KirillKirill

1809




1809












  • It should be noted that the second func is equivalent to tmp = ('ok - 1', 'ok - 2') return tmp, making it immediately apparent why it requires Tuple.

    – Peilonrayz
    May 7 at 9:01

















  • It should be noted that the second func is equivalent to tmp = ('ok - 1', 'ok - 2') return tmp, making it immediately apparent why it requires Tuple.

    – Peilonrayz
    May 7 at 9:01
















It should be noted that the second func is equivalent to tmp = ('ok - 1', 'ok - 2') return tmp, making it immediately apparent why it requires Tuple.

– Peilonrayz
May 7 at 9:01





It should be noted that the second func is equivalent to tmp = ('ok - 1', 'ok - 2') return tmp, making it immediately apparent why it requires Tuple.

– Peilonrayz
May 7 at 9:01












1 Answer
1






active

oldest

votes


















23














Use typing.Tuple:



from typing import Tuple

def func() -> Tuple[str, str]:
return 'a', 'b'


This is appropriate because, conceptually, you are actually returning a single tuple containing those values. Note:



print(type(func()))


Output:



<class 'tuple'>


Note that except for the empty tuple (()), parentheses are not necessary to define a tuple, which means that 'a', 'b' is created as a tuple, rather than being separate values gathered into one by the return statement.






share|improve this answer




















  • 1





    Tuple is reasonable. It may be too strict in some cases, but there isn’t a better alternative without different tradeoffs as far as I can tell.

    – kojiro
    May 7 at 2:48












  • @kojiro It seems to me that that would not apply in the case of return values...?

    – gmds
    May 7 at 2:50











  • I think it still applies. The main thing about the signature isn’t that the function returns a tuple per se, but that it return an unpackable with a specific length. There are plenty of sequence types that are unpackable, but no generic unpackable type that also has length and inner-type specifiers. Tuple can specify everything, but is too strict.

    – kojiro
    May 7 at 2:54







  • 4





    @kojiro I might be misunderstanding you, but is it not the case that functions with multiple return values specifically return tuple, as opposed to a function with a single return value that also happens to be an unpackable object that knows its length and elements' types, which would require such a specifier?

    – gmds
    May 7 at 2:57







  • 1





    A tuple is still a single object that happens to be unpackable. That’s what I’m saying. There isn’t a way to express python returning multiple values from a function because python can’t return multiple values from a function. But it can return a sequence, and a tuple is one kind of sequence.

    – kojiro
    May 7 at 3:05











Your Answer






StackExchange.ifUsing("editor", function ()
StackExchange.using("externalEditor", function ()
StackExchange.using("snippets", function ()
StackExchange.snippets.init();
);
);
, "code-snippets");

StackExchange.ready(function()
var channelOptions =
tags: "".split(" "),
id: "1"
;
initTagRenderer("".split(" "), "".split(" "), channelOptions);

StackExchange.using("externalEditor", function()
// Have to fire editor after snippets, if snippets enabled
if (StackExchange.settings.snippets.snippetsEnabled)
StackExchange.using("snippets", function()
createEditor();
);

else
createEditor();

);

function createEditor()
StackExchange.prepareEditor(
heartbeatType: 'answer',
autoActivateHeartbeat: false,
convertImagesToLinks: true,
noModals: true,
showLowRepImageUploadWarning: true,
reputationToPostImages: 10,
bindNavPrevention: true,
postfix: "",
imageUploader:
brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
allowUrls: true
,
onDemand: true,
discardSelector: ".discard-answer"
,immediatelyShowMarkdownHelp:true
);



);













draft saved

draft discarded


















StackExchange.ready(
function ()
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f56014563%2ffunction-annotation-with-two-or-more-return-parameters%23new-answer', 'question_page');

);

Post as a guest















Required, but never shown

























1 Answer
1






active

oldest

votes








1 Answer
1






active

oldest

votes









active

oldest

votes






active

oldest

votes









23














Use typing.Tuple:



from typing import Tuple

def func() -> Tuple[str, str]:
return 'a', 'b'


This is appropriate because, conceptually, you are actually returning a single tuple containing those values. Note:



print(type(func()))


Output:



<class 'tuple'>


Note that except for the empty tuple (()), parentheses are not necessary to define a tuple, which means that 'a', 'b' is created as a tuple, rather than being separate values gathered into one by the return statement.






share|improve this answer




















  • 1





    Tuple is reasonable. It may be too strict in some cases, but there isn’t a better alternative without different tradeoffs as far as I can tell.

    – kojiro
    May 7 at 2:48












  • @kojiro It seems to me that that would not apply in the case of return values...?

    – gmds
    May 7 at 2:50











  • I think it still applies. The main thing about the signature isn’t that the function returns a tuple per se, but that it return an unpackable with a specific length. There are plenty of sequence types that are unpackable, but no generic unpackable type that also has length and inner-type specifiers. Tuple can specify everything, but is too strict.

    – kojiro
    May 7 at 2:54







  • 4





    @kojiro I might be misunderstanding you, but is it not the case that functions with multiple return values specifically return tuple, as opposed to a function with a single return value that also happens to be an unpackable object that knows its length and elements' types, which would require such a specifier?

    – gmds
    May 7 at 2:57







  • 1





    A tuple is still a single object that happens to be unpackable. That’s what I’m saying. There isn’t a way to express python returning multiple values from a function because python can’t return multiple values from a function. But it can return a sequence, and a tuple is one kind of sequence.

    – kojiro
    May 7 at 3:05















23














Use typing.Tuple:



from typing import Tuple

def func() -> Tuple[str, str]:
return 'a', 'b'


This is appropriate because, conceptually, you are actually returning a single tuple containing those values. Note:



print(type(func()))


Output:



<class 'tuple'>


Note that except for the empty tuple (()), parentheses are not necessary to define a tuple, which means that 'a', 'b' is created as a tuple, rather than being separate values gathered into one by the return statement.






share|improve this answer




















  • 1





    Tuple is reasonable. It may be too strict in some cases, but there isn’t a better alternative without different tradeoffs as far as I can tell.

    – kojiro
    May 7 at 2:48












  • @kojiro It seems to me that that would not apply in the case of return values...?

    – gmds
    May 7 at 2:50











  • I think it still applies. The main thing about the signature isn’t that the function returns a tuple per se, but that it return an unpackable with a specific length. There are plenty of sequence types that are unpackable, but no generic unpackable type that also has length and inner-type specifiers. Tuple can specify everything, but is too strict.

    – kojiro
    May 7 at 2:54







  • 4





    @kojiro I might be misunderstanding you, but is it not the case that functions with multiple return values specifically return tuple, as opposed to a function with a single return value that also happens to be an unpackable object that knows its length and elements' types, which would require such a specifier?

    – gmds
    May 7 at 2:57







  • 1





    A tuple is still a single object that happens to be unpackable. That’s what I’m saying. There isn’t a way to express python returning multiple values from a function because python can’t return multiple values from a function. But it can return a sequence, and a tuple is one kind of sequence.

    – kojiro
    May 7 at 3:05













23












23








23







Use typing.Tuple:



from typing import Tuple

def func() -> Tuple[str, str]:
return 'a', 'b'


This is appropriate because, conceptually, you are actually returning a single tuple containing those values. Note:



print(type(func()))


Output:



<class 'tuple'>


Note that except for the empty tuple (()), parentheses are not necessary to define a tuple, which means that 'a', 'b' is created as a tuple, rather than being separate values gathered into one by the return statement.






share|improve this answer















Use typing.Tuple:



from typing import Tuple

def func() -> Tuple[str, str]:
return 'a', 'b'


This is appropriate because, conceptually, you are actually returning a single tuple containing those values. Note:



print(type(func()))


Output:



<class 'tuple'>


Note that except for the empty tuple (()), parentheses are not necessary to define a tuple, which means that 'a', 'b' is created as a tuple, rather than being separate values gathered into one by the return statement.







share|improve this answer














share|improve this answer



share|improve this answer








edited 2 hours ago

























answered May 7 at 2:07









gmdsgmds

10.9k11038




10.9k11038







  • 1





    Tuple is reasonable. It may be too strict in some cases, but there isn’t a better alternative without different tradeoffs as far as I can tell.

    – kojiro
    May 7 at 2:48












  • @kojiro It seems to me that that would not apply in the case of return values...?

    – gmds
    May 7 at 2:50











  • I think it still applies. The main thing about the signature isn’t that the function returns a tuple per se, but that it return an unpackable with a specific length. There are plenty of sequence types that are unpackable, but no generic unpackable type that also has length and inner-type specifiers. Tuple can specify everything, but is too strict.

    – kojiro
    May 7 at 2:54







  • 4





    @kojiro I might be misunderstanding you, but is it not the case that functions with multiple return values specifically return tuple, as opposed to a function with a single return value that also happens to be an unpackable object that knows its length and elements' types, which would require such a specifier?

    – gmds
    May 7 at 2:57







  • 1





    A tuple is still a single object that happens to be unpackable. That’s what I’m saying. There isn’t a way to express python returning multiple values from a function because python can’t return multiple values from a function. But it can return a sequence, and a tuple is one kind of sequence.

    – kojiro
    May 7 at 3:05












  • 1





    Tuple is reasonable. It may be too strict in some cases, but there isn’t a better alternative without different tradeoffs as far as I can tell.

    – kojiro
    May 7 at 2:48












  • @kojiro It seems to me that that would not apply in the case of return values...?

    – gmds
    May 7 at 2:50











  • I think it still applies. The main thing about the signature isn’t that the function returns a tuple per se, but that it return an unpackable with a specific length. There are plenty of sequence types that are unpackable, but no generic unpackable type that also has length and inner-type specifiers. Tuple can specify everything, but is too strict.

    – kojiro
    May 7 at 2:54







  • 4





    @kojiro I might be misunderstanding you, but is it not the case that functions with multiple return values specifically return tuple, as opposed to a function with a single return value that also happens to be an unpackable object that knows its length and elements' types, which would require such a specifier?

    – gmds
    May 7 at 2:57







  • 1





    A tuple is still a single object that happens to be unpackable. That’s what I’m saying. There isn’t a way to express python returning multiple values from a function because python can’t return multiple values from a function. But it can return a sequence, and a tuple is one kind of sequence.

    – kojiro
    May 7 at 3:05







1




1





Tuple is reasonable. It may be too strict in some cases, but there isn’t a better alternative without different tradeoffs as far as I can tell.

– kojiro
May 7 at 2:48






Tuple is reasonable. It may be too strict in some cases, but there isn’t a better alternative without different tradeoffs as far as I can tell.

– kojiro
May 7 at 2:48














@kojiro It seems to me that that would not apply in the case of return values...?

– gmds
May 7 at 2:50





@kojiro It seems to me that that would not apply in the case of return values...?

– gmds
May 7 at 2:50













I think it still applies. The main thing about the signature isn’t that the function returns a tuple per se, but that it return an unpackable with a specific length. There are plenty of sequence types that are unpackable, but no generic unpackable type that also has length and inner-type specifiers. Tuple can specify everything, but is too strict.

– kojiro
May 7 at 2:54






I think it still applies. The main thing about the signature isn’t that the function returns a tuple per se, but that it return an unpackable with a specific length. There are plenty of sequence types that are unpackable, but no generic unpackable type that also has length and inner-type specifiers. Tuple can specify everything, but is too strict.

– kojiro
May 7 at 2:54





4




4





@kojiro I might be misunderstanding you, but is it not the case that functions with multiple return values specifically return tuple, as opposed to a function with a single return value that also happens to be an unpackable object that knows its length and elements' types, which would require such a specifier?

– gmds
May 7 at 2:57






@kojiro I might be misunderstanding you, but is it not the case that functions with multiple return values specifically return tuple, as opposed to a function with a single return value that also happens to be an unpackable object that knows its length and elements' types, which would require such a specifier?

– gmds
May 7 at 2:57





1




1





A tuple is still a single object that happens to be unpackable. That’s what I’m saying. There isn’t a way to express python returning multiple values from a function because python can’t return multiple values from a function. But it can return a sequence, and a tuple is one kind of sequence.

– kojiro
May 7 at 3:05





A tuple is still a single object that happens to be unpackable. That’s what I’m saying. There isn’t a way to express python returning multiple values from a function because python can’t return multiple values from a function. But it can return a sequence, and a tuple is one kind of sequence.

– kojiro
May 7 at 3:05



















draft saved

draft discarded
















































Thanks for contributing an answer to Stack Overflow!


  • Please be sure to answer the question. Provide details and share your research!

But avoid


  • Asking for help, clarification, or responding to other answers.

  • Making statements based on opinion; back them up with references or personal experience.

To learn more, see our tips on writing great answers.




draft saved


draft discarded














StackExchange.ready(
function ()
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f56014563%2ffunction-annotation-with-two-or-more-return-parameters%23new-answer', 'question_page');

);

Post as a guest















Required, but never shown





















































Required, but never shown














Required, but never shown












Required, but never shown







Required, but never shown

































Required, but never shown














Required, but never shown












Required, but never shown







Required, but never shown







Popular posts from this blog

Club Baloncesto Breogán Índice Historia | Pavillón | Nome | O Breogán na cultura popular | Xogadores | Adestradores | Presidentes | Palmarés | Historial | Líderes | Notas | Véxase tamén | Menú de navegacióncbbreogan.galCadroGuía oficial da ACB 2009-10, páxina 201Guía oficial ACB 1992, páxina 183. Editorial DB.É de 6.500 espectadores sentados axeitándose á última normativa"Estudiantes Junior, entre as mellores canteiras"o orixinalHemeroteca El Mundo Deportivo, 16 setembro de 1970, páxina 12Historia do BreogánAlfredo Pérez, o último canoneiroHistoria C.B. BreogánHemeroteca de El Mundo DeportivoJimmy Wright, norteamericano do Breogán deixará Lugo por ameazas de morteResultados de Breogán en 1986-87Resultados de Breogán en 1990-91Ficha de Velimir Perasović en acb.comResultados de Breogán en 1994-95Breogán arrasa al Barça. "El Mundo Deportivo", 27 de setembro de 1999, páxina 58CB Breogán - FC BarcelonaA FEB invita a participar nunha nova Liga EuropeaCharlie Bell na prensa estatalMáximos anotadores 2005Tempada 2005-06 : Tódolos Xogadores da Xornada""Non quero pensar nunha man negra, mais pregúntome que está a pasar""o orixinalRaúl López, orgulloso dos xogadores, presume da boa saúde económica do BreogánJulio González confirma que cesa como presidente del BreogánHomenaxe a Lisardo GómezA tempada do rexurdimento celesteEntrevista a Lisardo GómezEl COB dinamita el Pazo para forzar el quinto (69-73)Cafés Candelas, patrocinador del CB Breogán"Suso Lázare, novo presidente do Breogán"o orixinalCafés Candelas Breogán firma el mayor triunfo de la historiaEl Breogán realizará 17 homenajes por su cincuenta aniversario"O Breogán honra ao seu fundador e primeiro presidente"o orixinalMiguel Giao recibiu a homenaxe do PazoHomenaxe aos primeiros gladiadores celestesO home que nos amosa como ver o Breo co corazónTita Franco será homenaxeada polos #50anosdeBreoJulio Vila recibirá unha homenaxe in memoriam polos #50anosdeBreo"O Breogán homenaxeará aos seus aboados máis veteráns"Pechada ovación a «Capi» Sanmartín e Ricardo «Corazón de González»Homenaxe por décadas de informaciónPaco García volve ao Pazo con motivo do 50 aniversario"Resultados y clasificaciones""O Cafés Candelas Breogán, campión da Copa Princesa""O Cafés Candelas Breogán, equipo ACB"C.B. Breogán"Proxecto social"o orixinal"Centros asociados"o orixinalFicha en imdb.comMario Camus trata la recuperación del amor en 'La vieja música', su última película"Páxina web oficial""Club Baloncesto Breogán""C. B. Breogán S.A.D."eehttp://www.fegaba.com

Vilaño, A Laracha Índice Patrimonio | Lugares e parroquias | Véxase tamén | Menú de navegación43°14′52″N 8°36′03″O / 43.24775, -8.60070

Cegueira Índice Epidemioloxía | Deficiencia visual | Tipos de cegueira | Principais causas de cegueira | Tratamento | Técnicas de adaptación e axudas | Vida dos cegos | Primeiros auxilios | Crenzas respecto das persoas cegas | Crenzas das persoas cegas | O neno deficiente visual | Aspectos psicolóxicos da cegueira | Notas | Véxase tamén | Menú de navegación54.054.154.436928256blindnessDicionario da Real Academia GalegaPortal das Palabras"International Standards: Visual Standards — Aspects and Ranges of Vision Loss with Emphasis on Population Surveys.""Visual impairment and blindness""Presentan un plan para previr a cegueira"o orixinalACCDV Associació Catalana de Cecs i Disminuïts Visuals - PMFTrachoma"Effect of gene therapy on visual function in Leber's congenital amaurosis"1844137110.1056/NEJMoa0802268Cans guía - os mellores amigos dos cegosArquivadoEscola de cans guía para cegos en Mortágua, PortugalArquivado"Tecnología para ciegos y deficientes visuales. Recopilación de recursos gratuitos en la Red""Colorino""‘COL.diesis’, escuchar los sonidos del color""COL.diesis: Transforming Colour into Melody and Implementing the Result in a Colour Sensor Device"o orixinal"Sistema de desarrollo de sinestesia color-sonido para invidentes utilizando un protocolo de audio""Enseñanza táctil - geometría y color. Juegos didácticos para niños ciegos y videntes""Sistema Constanz"L'ocupació laboral dels cecs a l'Estat espanyol està pràcticament equiparada a la de les persones amb visió, entrevista amb Pedro ZuritaONCE (Organización Nacional de Cegos de España)Prevención da cegueiraDescrición de deficiencias visuais (Disc@pnet)Braillín, un boneco atractivo para calquera neno, con ou sen discapacidade, que permite familiarizarse co sistema de escritura e lectura brailleAxudas Técnicas36838ID00897494007150-90057129528256DOID:1432HP:0000618D001766C10.597.751.941.162C97109C0155020