所有分类
  • 所有分类
  • 后端开发

敲代码必备:如何利用@return标签,让你的函数秒变通透

敲代码之前得搞清楚每个函数能回什么东西,这样写出来的代码才能顺手又好看你肯定见过函数后面那小标签@return?要是还不明白咋办?试试给它加上类型提示呗;或者直接去类文档里找答案咯。别急我这就给你普及一下。

使用@return标签

教给你一个简单的小技巧。在编程过程中,只要加一句神奇的’@return’符号,大家都能直观地了解到你的函数会return什么结果了!例如,假设你有一个生成字符串的函数,只需要在注释上标明’@returnstring’这个小提示,就搞定~

我们在码字的时候,伙伴们都知道要用@return这个家伙来告知大家函数会给出什么样的结果。

敲代码必备:如何利用@return标签,让你的函数秒变通透

php
/**
*获取用户名
*
*给我个用户名,然后我会给你个字符串~
*/
functiongetUsername(){
//函数实现
}
/**
 * 获取用户的名称
 *
 * @return string 用户的名称
 */
function getUserName(): string {}

简单来说,getUserName()这个函数就是从数据库里把你的用户名找出来,然后展示给你看!

使用类型提示

听说了没?PHP7多了个超级棒的功能——类型提示。这个功能能帮咱们明确告诉编译器函数里参数和返回值应该是啥样的,以后函数返回值出错的问题就能轻松搞定!就跟给变量做说明似的,PHP编译器立刻明白咱们要什么值。

比如说,要让某个函数直接输出字符串,就得这么来:

function getUserName(): string {}

获取用户名函数的简要说明如下

看到“string”后面那个冒号没?这代表我们在谈论getUsername这个东西,它就是用来取字符串的。现在你应该明白它能干什么了!

检查类文档

你了解怎样迅速找到PHP内建函数和自定类方法的返回值类型吗?这个技巧很有用,尤其是用PHP函数的时候。

哈喽,这边来看看。只需敲入”getdoc”,马上就能找到”array_merge”函数怎么用!

*合并一个或多个数组

*

$ getdoc -j array_merge | jq '.tags[]'
"return"

*@paramarray$array1第一个数组

*@paramarray$array2第二个数组

告诉我,有哪些数组你想要合起来?比如这几个:$array和其它那些$arrays!

*@returnarray返回一个合并后的数组

function calculateArea($length, $width) {
  return $length * $width;
}

来说说怎么把几个数组合并起来!这个工具叫“数组合并”,告诉我你要合并的三个数组就好了,搞定后它还会送你一个新的数组当小礼物~

我刚看到那个array_merge的函数说明,原来真的能合并多个数组啊!这么一来编程就容易多了,速度和精确度肯定也会提高。

确定函数返回值类型的方法

帮你看看php函数能生出些什么鬼的小窍门儿:

记得,给你的函数加上个@return,告诉别人这个函数会回传啥信息。

直接告诉PHP那个小家伙在函数中输出哪个数据类型,它就知道你的想法!

/**
 * 计算矩形的面积
 *
 * @param float $length 矩形的长度
 * @param float $width 矩形的宽度
 * @return float 矩形的面积
 */
function calculateArea($length, $width) {
  return $length * $width;
}

看看文档吧:要是不懂内置函数或者自己写的类方法的话,就翻翻那个类文件,里面可能会提到它们是啥意思~

搞明白函数回调值,PHP编程就能轻松应对~这样写出来的代码也好看得多!

原文链接:https://www.icz.com/technicalinformation/web3/2024/04/15795.html,转载请注明出处~~~
0

评论0

请先
注意:请收藏好网址www.icz.com,防止失联!站内免费资源持续上传中…!赞助我们
显示验证码
没有账号?注册  忘记密码?