improve realpath and readlink return type

vimeo · Feb 1, 2024 · d2e5a07 · d2e5a07
1 parent d79f772
commit d2e5a07
Show file tree

Hide file tree

Showing 2 changed files with 22 additions and 22 deletions.
diff --git a/dictionaries/CallMap.php b/dictionaries/CallMap.php
@@ -1590,7 +1590,7 @@
 'DirectoryIterator::getPathInfo' => ['?SplFileInfo', 'class='=>'?class-string'],
 'DirectoryIterator::getPathname' => ['string'],
 'DirectoryIterator::getPerms' => ['int'],
-'DirectoryIterator::getRealPath' => ['string'],
+'DirectoryIterator::getRealPath' => ['non-falsy-string'],
 'DirectoryIterator::getSize' => ['int'],
 'DirectoryIterator::getType' => ['string'],
 'DirectoryIterator::isDir' => ['bool'],
@@ -2827,7 +2827,7 @@
 'FilesystemIterator::getPathInfo' => ['?SplFileInfo', 'class='=>'?class-string'],
 'FilesystemIterator::getPathname' => ['string'],
 'FilesystemIterator::getPerms' => ['int'],
-'FilesystemIterator::getRealPath' => ['string'],
+'FilesystemIterator::getRealPath' => ['non-falsy-string'],
 'FilesystemIterator::getSize' => ['int'],
 'FilesystemIterator::getType' => ['string'],
 'FilesystemIterator::isDir' => ['bool'],
@@ -3343,7 +3343,7 @@
 'GlobIterator::getPathInfo' => ['?SplFileInfo', 'class='=>'?class-string'],
 'GlobIterator::getPathname' => ['string'],
 'GlobIterator::getPerms' => ['int'],
-'GlobIterator::getRealPath' => ['string|false'],
+'GlobIterator::getRealPath' => ['non-falsy-string|false'],
 'GlobIterator::getSize' => ['int'],
 'GlobIterator::getType' => ['string|false'],
 'GlobIterator::isDir' => ['bool'],
@@ -9722,8 +9722,8 @@
 'readline_read_history' => ['bool', 'filename='=>'?string'],
 'readline_redisplay' => ['void'],
 'readline_write_history' => ['bool', 'filename='=>'?string'],
-'readlink' => ['string|false', 'path'=>'string'],
-'realpath' => ['string|false', 'path'=>'string'],
+'readlink' => ['non-falsy-string|false', 'path'=>'string'],
+'realpath' => ['non-falsy-string|false', 'path'=>'string'],
 'realpath_cache_get' => ['array'],
 'realpath_cache_size' => ['int'],
 'recode' => ['string', 'request'=>'string', 'string'=>'string'],
@@ -9811,7 +9811,7 @@
 'RecursiveDirectoryIterator::getPathInfo' => ['?SplFileInfo', 'class='=>'?class-string'],
 'RecursiveDirectoryIterator::getPathname' => ['string'],
 'RecursiveDirectoryIterator::getPerms' => ['int'],
-'RecursiveDirectoryIterator::getRealPath' => ['string'],
+'RecursiveDirectoryIterator::getRealPath' => ['non-falsy-string'],
 'RecursiveDirectoryIterator::getSize' => ['int'],
 'RecursiveDirectoryIterator::getSubPath' => ['string'],
 'RecursiveDirectoryIterator::getSubPathname' => ['string'],
@@ -12238,7 +12238,7 @@
 'SplFileInfo::getPathInfo' => ['SplFileInfo|null', 'class='=>'?class-string'],
 'SplFileInfo::getPathname' => ['string'],
 'SplFileInfo::getPerms' => ['int|false'],
-'SplFileInfo::getRealPath' => ['string|false'],
+'SplFileInfo::getRealPath' => ['non-falsy-string|false'],
 'SplFileInfo::getSize' => ['int|false'],
 'SplFileInfo::getType' => ['string|false'],
 'SplFileInfo::isDir' => ['bool'],
@@ -12288,7 +12288,7 @@
 'SplFileObject::getPathInfo' => ['SplFileInfo|null', 'class='=>'?class-string'],
 'SplFileObject::getPathname' => ['string'],
 'SplFileObject::getPerms' => ['int|false'],
-'SplFileObject::getRealPath' => ['false|string'],
+'SplFileObject::getRealPath' => ['false|non-falsy-string'],
 'SplFileObject::getSize' => ['int|false'],
 'SplFileObject::getType' => ['string|false'],
 'SplFileObject::hasChildren' => ['false'],
@@ -12475,7 +12475,7 @@
 'SplTempFileObject::getPathInfo' => ['SplFileInfo|null', 'class='=>'?class-string'],
 'SplTempFileObject::getPathname' => ['string'],
 'SplTempFileObject::getPerms' => ['int|false'],
-'SplTempFileObject::getRealPath' => ['false|string'],
+'SplTempFileObject::getRealPath' => ['false|non-falsy-string'],
 'SplTempFileObject::getSize' => ['int|false'],
 'SplTempFileObject::getType' => ['string|false'],
 'SplTempFileObject::hasChildren' => ['false'],
@@ -12690,8 +12690,8 @@
 'ssh2_sftp_chmod' => ['bool', 'sftp'=>'resource', 'filename'=>'string', 'mode'=>'int'],
 'ssh2_sftp_lstat' => ['array{0: int, 1: int, 2: int, 3: int, 4: int, 5: int, 6: int, 7: int, 8: int, 9: int, 10: int, 11: int, 12: int, dev: int, ino: int, mode: int, nlink: int, uid: int, gid: int, rdev: int, size: int, atime: int, mtime: int, ctime: int, blksize: int, blocks: int}|false', 'sftp'=>'resource', 'path'=>'string'],
 'ssh2_sftp_mkdir' => ['bool', 'sftp'=>'resource', 'dirname'=>'string', 'mode='=>'int', 'recursive='=>'bool'],
-'ssh2_sftp_readlink' => ['string|false', 'sftp'=>'resource', 'link'=>'string'],
-'ssh2_sftp_realpath' => ['string|false', 'sftp'=>'resource', 'filename'=>'string'],
+'ssh2_sftp_readlink' => ['non-falsy-string|false', 'sftp'=>'resource', 'link'=>'string'],
+'ssh2_sftp_realpath' => ['non-falsy-string|false', 'sftp'=>'resource', 'filename'=>'string'],
 'ssh2_sftp_rename' => ['bool', 'sftp'=>'resource', 'from'=>'string', 'to'=>'string'],
 'ssh2_sftp_rmdir' => ['bool', 'sftp'=>'resource', 'dirname'=>'string'],
 'ssh2_sftp_stat' => ['array{0: int, 1: int, 2: int, 3: int, 4: int, 5: int, 6: int, 7: int, 8: int, 9: int, 10: int, 11: int, 12: int, dev: int, ino: int, mode: int, nlink: int, uid: int, gid: int, rdev: int, size: int, atime: int, mtime: int, ctime: int, blksize: int, blocks: int}|false', 'sftp'=>'resource', 'path'=>'string'],

diff --git a/dictionaries/CallMap_historical.php b/dictionaries/CallMap_historical.php
@@ -877,7 +877,7 @@
     'DirectoryIterator::getPathInfo' => ['?SplFileInfo', 'class='=>'class-string'],
     'DirectoryIterator::getPathname' => ['string'],
     'DirectoryIterator::getPerms' => ['int'],
-    'DirectoryIterator::getRealPath' => ['string'],
+    'DirectoryIterator::getRealPath' => ['non-falsy-string'],
     'DirectoryIterator::getSize' => ['int'],
     'DirectoryIterator::getType' => ['string'],
     'DirectoryIterator::isDir' => ['bool'],
@@ -1507,7 +1507,7 @@
     'FilesystemIterator::getPathInfo' => ['?SplFileInfo', 'class='=>'class-string'],
     'FilesystemIterator::getPathname' => ['string'],
     'FilesystemIterator::getPerms' => ['int'],
-    'FilesystemIterator::getRealPath' => ['string'],
+    'FilesystemIterator::getRealPath' => ['non-falsy-string'],
     'FilesystemIterator::getSize' => ['int'],
     'FilesystemIterator::getType' => ['string'],
     'FilesystemIterator::isDir' => ['bool'],
@@ -1762,7 +1762,7 @@
     'GlobIterator::getPathInfo' => ['?SplFileInfo', 'class='=>'class-string'],
     'GlobIterator::getPathname' => ['string'],
     'GlobIterator::getPerms' => ['int'],
-    'GlobIterator::getRealPath' => ['string|false'],
+    'GlobIterator::getRealPath' => ['non-falsy-string|false'],
     'GlobIterator::getSize' => ['int'],
     'GlobIterator::getType' => ['string|false'],
     'GlobIterator::isDir' => ['bool'],
@@ -5155,7 +5155,7 @@
     'RecursiveDirectoryIterator::getPathInfo' => ['?SplFileInfo', 'class='=>'class-string'],
     'RecursiveDirectoryIterator::getPathname' => ['string'],
     'RecursiveDirectoryIterator::getPerms' => ['int'],
-    'RecursiveDirectoryIterator::getRealPath' => ['string'],
+    'RecursiveDirectoryIterator::getRealPath' => ['non-falsy-string'],
     'RecursiveDirectoryIterator::getSize' => ['int'],
     'RecursiveDirectoryIterator::getSubPath' => ['string'],
     'RecursiveDirectoryIterator::getSubPathname' => ['string'],
@@ -7481,7 +7481,7 @@
     'SplFileInfo::getPathInfo' => ['SplFileInfo|null', 'class='=>'class-string'],
     'SplFileInfo::getPathname' => ['string'],
     'SplFileInfo::getPerms' => ['int|false'],
-    'SplFileInfo::getRealPath' => ['string|false'],
+    'SplFileInfo::getRealPath' => ['non-falsy-string|false'],
     'SplFileInfo::getSize' => ['int|false'],
     'SplFileInfo::getType' => ['string|false'],
     'SplFileInfo::isDir' => ['bool'],
@@ -7532,7 +7532,7 @@
     'SplFileObject::getPathInfo' => ['SplFileInfo|null', 'class='=>'class-string'],
     'SplFileObject::getPathname' => ['string'],
     'SplFileObject::getPerms' => ['int|false'],
-    'SplFileObject::getRealPath' => ['false|string'],
+    'SplFileObject::getRealPath' => ['false|non-falsy-string'],
     'SplFileObject::getSize' => ['int|false'],
     'SplFileObject::getType' => ['string|false'],
     'SplFileObject::hasChildren' => ['false'],
@@ -7723,7 +7723,7 @@
     'SplTempFileObject::getPathInfo' => ['SplFileInfo|null', 'class='=>'class-string'],
     'SplTempFileObject::getPathname' => ['string'],
     'SplTempFileObject::getPerms' => ['int|false'],
-    'SplTempFileObject::getRealPath' => ['false|string'],
+    'SplTempFileObject::getRealPath' => ['false|non-falsy-string'],
     'SplTempFileObject::getSize' => ['int|false'],
     'SplTempFileObject::getType' => ['string|false'],
     'SplTempFileObject::hasChildren' => ['false'],
@@ -13718,8 +13718,8 @@
     'readline_read_history' => ['bool', 'filename='=>'string'],
     'readline_redisplay' => ['void'],
     'readline_write_history' => ['bool', 'filename='=>'string'],
-    'readlink' => ['string|false', 'path'=>'string'],
-    'realpath' => ['string|false', 'path'=>'string'],
+    'readlink' => ['non-falsy-string|false', 'path'=>'string'],
+    'realpath' => ['non-falsy-string|false', 'path'=>'string'],
     'realpath_cache_get' => ['array'],
     'realpath_cache_size' => ['int'],
     'recode' => ['string', 'request'=>'string', 'string'=>'string'],
@@ -14120,8 +14120,8 @@
     'ssh2_sftp_chmod' => ['bool', 'sftp'=>'resource', 'filename'=>'string', 'mode'=>'int'],
     'ssh2_sftp_lstat' => ['array{0: int, 1: int, 2: int, 3: int, 4: int, 5: int, 6: int, 7: int, 8: int, 9: int, 10: int, 11: int, 12: int, dev: int, ino: int, mode: int, nlink: int, uid: int, gid: int, rdev: int, size: int, atime: int, mtime: int, ctime: int, blksize: int, blocks: int}|false', 'sftp'=>'resource', 'path'=>'string'],
     'ssh2_sftp_mkdir' => ['bool', 'sftp'=>'resource', 'dirname'=>'string', 'mode='=>'int', 'recursive='=>'bool'],
-    'ssh2_sftp_readlink' => ['string|false', 'sftp'=>'resource', 'link'=>'string'],
-    'ssh2_sftp_realpath' => ['string|false', 'sftp'=>'resource', 'filename'=>'string'],
+    'ssh2_sftp_readlink' => ['non-falsy-string|false', 'sftp'=>'resource', 'link'=>'string'],
+    'ssh2_sftp_realpath' => ['non-falsy-string|false', 'sftp'=>'resource', 'filename'=>'string'],
     'ssh2_sftp_rename' => ['bool', 'sftp'=>'resource', 'from'=>'string', 'to'=>'string'],
     'ssh2_sftp_rmdir' => ['bool', 'sftp'=>'resource', 'dirname'=>'string'],
     'ssh2_sftp_stat' => ['array{0: int, 1: int, 2: int, 3: int, 4: int, 5: int, 6: int, 7: int, 8: int, 9: int, 10: int, 11: int, 12: int, dev: int, ino: int, mode: int, nlink: int, uid: int, gid: int, rdev: int, size: int, atime: int, mtime: int, ctime: int, blksize: int, blocks: int}|false', 'sftp'=>'resource', 'path'=>'string'],